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 -->
