[network/smb4k] doc: Update handbook.
Alexander Reinholdt
null at kde.org
Sun Jan 1 17:59:20 GMT 2023
Git commit 0db9dbc12121781f49dcbb68f66edd3384700445 by Alexander Reinholdt.
Committed on 01/01/2023 at 17:55.
Pushed by areinholdt into branch 'master'.
Update handbook.
M +39 -18 doc/index.docbook
https://invent.kde.org/network/smb4k/commit/0db9dbc12121781f49dcbb68f66edd3384700445
diff --git a/doc/index.docbook b/doc/index.docbook
index f658f4aa..766b30f9 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -251,40 +251,40 @@
</menuchoice>
</term>
<listitem>
- <para><link linkend="bookmarks_adding">Add a bookmark</link> to the currently selected remote share. This action is disabled if no share is selected.</para>
+ <para><link linkend="bookmarks_adding">Add a bookmark</link> to the selected remote shares. This action is disabled if there are no shares selected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
- <shortcut><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></shortcut>
- <guimenuitem>Open Mount Dialog</guimenuitem>
+ <shortcut><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></shortcut>
+ <guimenuitem>Add Custom Options</guimenuitem>
</menuchoice>
</term>
<listitem>
- <para>Open the <link linkend="network_neighborhood_browser_mounting">dialog</link> for mounting shares "manually". This feature may be needed if &smb4k; cannot find the server from which you want to mount a certain shared resource.</para>
+ <para>Open the <link linkend="network_neighborhood_browser_defining_custom_options">Custom Options</link> dialog where you can set several custom options for each selected server and share. If a workgroup or no item is selected, this menu entry is disabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
- <shortcut><keycombo action="simul">&Ctrl; <keycap>T</keycap></keycombo></shortcut>
- <guimenuitem>Authentication</guimenuitem>
+ <shortcut><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></shortcut>
+ <guimenuitem>Open Mount Dialog</guimenuitem>
</menuchoice>
</term>
<listitem>
- <para>Open the <link linkend="network_neighborhood_browser_authentication">authentication dialog</link>. You can provide the login and password for the selected server or share. If a workgroup or no item is selected, this action is disabled.</para>
+ <para>Open the <link linkend="network_neighborhood_browser_mounting">dialog</link> for mounting shares "manually". This feature may be needed if &smb4k; cannot find the server from which you want to mount a certain shared resource.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
- <shortcut><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></shortcut>
- <guimenuitem>Custom Options</guimenuitem>
+ <shortcut><keycombo action="simul">&Ctrl; <keycap>T</keycap></keycombo></shortcut>
+ <guimenuitem>Authentication</guimenuitem>
</menuchoice>
</term>
<listitem>
- <para>Open the <link linkend="network_neighborhood_browser_defining_custom_options">Custom Options</link> dialog. You can set several custom options for the selected server or share. If a workgroup or no item is selected, this menu entry is disabled.</para>
+ <para>Open the <link linkend="network_neighborhood_browser_authentication">authentication dialog</link> where you can provice the user name and password for each selected server and share. If a workgroup or no item is selected, this action is disabled.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -295,7 +295,7 @@
</menuchoice>
</term>
<listitem>
- <para><link linkend="network_neighborhood_browser_previewing">Preview</link> the contents of the selected remote share. This action is only enabled if a share is selected. Printer shares cannot be previewed.</para>
+ <para><link linkend="network_neighborhood_browser_previewing">Preview</link> the contents of the selected remote shares. This action is only enabled if shares are selected. Printer shares cannot be previewed.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -306,7 +306,7 @@
</menuchoice>
</term>
<listitem>
- <para><link linkend="network_neighborhood_browser_printing">Print</link> a file on a remote printer. This action is only available if a printer share is selected.</para>
+ <para><link linkend="network_neighborhood_browser_printing">Print</link> a file on a remote printer. This action is only available if at least one printer share is selected.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -317,7 +317,7 @@
</menuchoice>
</term>
<listitem>
- <para>Mount the selected remote share. By default, and if you selected anything different than a share with type "Disk" or "IPC", this action is disabled. For a mounted share, this action is replaced with the <guimenuitem>Unmount</guimenuitem> action.</para>
+ <para>Mount the selected remote shares. This action is visible if only shares are selected that are not already mounted. By default, and if you selected anything different than a share with type "Disk" or "IPC", this action is disabled.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -328,7 +328,7 @@
</menuchoice>
</term>
<listitem>
- <para>Unmount the selected share. This action is invisible by default and will only be visible instead of the <guimenuitem>Mount</guimenuitem> action when the share is currently mounted.</para>
+ <para>Unmount the selected shares. This action is invisible by default and will only be visible instead of the <guimenuitem>Mount</guimenuitem> action if at least one mounted share is selected.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -364,14 +364,14 @@
-->
<sect2 id="network_neighborhood_browser_mounting">
- <title>Mounting a Share</title>
+ <title>Mounting Shares</title>
<para>There are three options available to mount a remote share:</para>
<orderedlist>
<listitem><para>Execute the icon representing the remote share in the network neighborhood browser. (Depending on your &kde; settings, this is done by either single or double clicking the icon.)</para></listitem>
- <listitem><para>Select the remote share and click the <guimenuitem>Mount</guimenuitem> menu entry. Alternatively, you can press the <keycombo action="simul">&Ctrl; <keycap>M</keycap></keycombo> keyboard shortcut.</para></listitem>
- <listitem><para>If &smb4k; was not able to find the server where the share is located, you can press the <menuchoice><shortcut><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></shortcut><guimenuitem>Open Mount Dialog</guimenuitem></menuchoice> menu entry and a mount dialog will be opened:</para>
+ <listitem><para>Select the remote shares and click the <guimenuitem>Mount</guimenuitem> menu entry. Alternatively, you can press the <keycombo action="simul">&Ctrl; <keycap>M</keycap></keycombo> keyboard shortcut.</para></listitem>
+ <listitem><para>Press the <menuchoice><shortcut><keycombo action="simul">&Ctrl; <keycap>O</keycap></keycombo></shortcut><guimenuitem>Open Mount Dialog</guimenuitem></menuchoice> menu entry and a mount dialog will be opened:</para>
<screenshot>
<screeninfo>Screenshot of the "Mount Share" dialog</screeninfo>
<mediaobject>
@@ -632,6 +632,17 @@
<para>Read the <link linkend="bookmarks_adding">Adding Bookmarks</link> section for more details.</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></shortcut>
+ <guimenuitem>Add Custom Options</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Open the custom options dialog for the selected shares. See the section about the <link linkend="network_neighborhood_browser_defining_custom_options">Custom Options</link> dialog in the <link linkend="network_neighborhood_browser">The Network Neighborhood Browser</link> section for more details.</para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term>
<menuchoice>
@@ -759,7 +770,17 @@
<para>All shares can be unmounted at once by clicking the <menuchoice><shortcut><keycombo action="simul">&Ctrl; <keycap>N</keycap></keycombo></shortcut><guimenuitem>Unmount All</guimenuitem></menuchoice> action. Depending on your settings, this will also unmount foreign and inaccessible shares.</para>
<para>After a successful unmount process, the user is notified. If unmounting fails, a notification with the returned error message is shown.</para>
</sect2>
-
+
+<!--
+ Using Smb4K : The Mounted Shares View : Adding Custom Options
+ -->
+
+ <sect2 id="shares_view_adding_custom_options">
+ <title>Defining Custom Options</title>
+
+ <para>For the selected shares custom options can be defined. Click the <menuchoice><shortcut><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></shortcut><guimenuitem>Add Custom Options</guimenuitem></menuchoice> action to open the Custom Options dialog. For more details, please see <link linkend="network_neighborhood_browser_defining_custom_options">here</link>.</para>
+ </sect2>
+
<!--
Using Smb4K : The Mounted Shares View : Synchronization
-->
More information about the kde-doc-english
mailing list