[smb4k/2.0] doc: Updated handbook. Reintroduced 'Command Reference' chapter.

Alexander Reinholdt null at kde.org
Sat Jan 21 17:50:10 UTC 2017


Git commit 5be250d2a27466d13b066b9e86a202d6920049ea by Alexander Reinholdt.
Committed on 21/01/2017 at 17:49.
Pushed by areinholdt into branch '2.0'.

Updated handbook. Reintroduced 'Command Reference' chapter.

(cherry picked from commit df337bc89f5976a4217157cb5554161d0814bdbc)

M  +388  -0    doc/index.docbook

https://commits.kde.org/smb4k/5be250d2a27466d13b066b9e86a202d6920049ea

diff --git a/doc/index.docbook b/doc/index.docbook
index 96cf166..4e4a58b 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -3490,6 +3490,394 @@ client ipc max protocol = NT1
 </chapter>
 
 <!-- 
+      Command Reference 
+-->
+
+<chapter id="command_reference" >
+  <title>Command Reference</title>
+
+<!-- 
+      Command Reference : The File Menu 
+  -->
+
+  <sect1 id="command_reference_file_menu">
+    <title>The File Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>File</guimenu>
+            <guimenuitem>Profiles</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Select the profile to use. This menu entry is disabled if the user did not enabled the use of profiles.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul" >&Ctrl; <keycap>Q</keycap></keycombo></shortcut>
+            <guimenu>File</guimenu>
+            <guimenuitem>Quit</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Quit &smb4k;.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+  
+<!--
+      Command Reference : The Network Menu
+  -->
+
+  <sect1 id="command_reference_network_menu">
+    <title>The Network Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycap>F5</keycap></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Scan Network|Workgroup|Computer</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>can the whole network neighborhood, the highlighted workgroup/domain or computer for new entries. This action is visible by default and will be replaced by the <guimenuitem>Abort</guimenuitem> action if a network scan is running.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>A</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Abort</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Abort any running process of the network neighborhood browser. This action is invisible by default and will only be visible instead of the <guimenuitem>Scan Network|Workgroup|Computer</guimenuitem> action when a network scan is running.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenuitem>Add Bookmark</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Add a bookmark to the currently selected remote share. This action is disabled if no share is selected.</para>
+           <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>O</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Open Mount Dialog</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 a server from which you want to mount a certain shared resource.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>T</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Authentication</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the authentication dialog where you can enter login information.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>C</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Custom Options</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open a dialog where you can define custom options for a server or share.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>V</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Preview</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the preview dialog that contains a preview of the contents of the selected share.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>P</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Print File</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the print dialog.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>M</keycap></keycombo></shortcut>
+            <guimenu>Network</guimenu>
+            <guimenuitem>Mount</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Mount the selected remote share.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+  
+<!--
+      Command Reference : The Search Menu
+  -->
+
+  <sect1 id="command_reference_search_menu">
+    <title>The Search Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>S</keycap></keycombo></shortcut>
+            <guimenu>Search</guimenu>
+            <guimenuitem>Search</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Search the network for the entered search string.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>A</keycap></keycombo></shortcut>
+            <guimenu>Search</guimenu>
+            <guimenuitem>Abort</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Abort the network search.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>Search</guimenu>
+            <guimenuitem>Clear</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Clear the network search widget, &ie; the combo box, the history and the list view.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>D</keycap></keycombo></shortcut>
+            <guimenu>Search</guimenu>
+            <guimenuitem>Mount</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Mount the selected share.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+  
+<!--
+      Command Reference : The Shares Menu
+  -->
+
+  <sect1 id="command_reference_shares_menu">
+    <title>The Shares Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>U</keycap></keycombo></shortcut>
+            <guimenu>Shares</guimenu>
+            <guimenuitem>Unmount</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Unmount the selected share.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>N</keycap></keycombo></shortcut>
+            <guimenu>Shares</guimenu>
+            <guimenuitem>Unmount All</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Unmount all of the mounted shares at once. In the default configuration this is restricted to the user's shares, but this can be altered in the <link linkend="configuration_page_shares_behavior">configuration dialog</link>. For further information read the <link linkend="shares_view_unmounting">Unmounting Shares</link> section.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>Y</keycap></keycombo></shortcut>
+            <guimenu>Shares</guimenu>
+            <guimenuitem>Synchronize</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Initiate a synchronization.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>L</keycap></keycombo></shortcut>
+            <guimenu>Shares</guimenu>
+            <guimenuitem>Open with Konsole</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the base folder of the selected share in &konsole;.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>I</keycap></keycombo></shortcut>
+            <guimenu>Shares</guimenu>
+            <guimenuitem>Open with File Manager</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the contents of the selected share in the default file manager (⪚ &dolphin;).</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+  
+<!--
+      Command Reference : The Bookmarks Menu
+  -->
+
+  <sect1 id="command_reference_bookmarks_menu">
+    <title>The Bookmarks Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>Bookmarks</guimenu>
+            <guimenuitem>Edit Bookmarks</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the bookmark editor.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <shortcut><keycombo action="simul">&Ctrl; <keycap>B</keycap></keycombo></shortcut>
+            <guimenu>Bookmarks</guimenu>
+            <guimenuitem>Add Bookmark</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Add the selected share to the bookmarks.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+  
+<!--
+      Command Reference : The Settings Menu
+  -->
+
+  <sect1 id="command_reference_settings_menu">
+    <title>The Settings Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>Settings</guimenu>
+            <guimenuitem>Toolbars Shown</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>In this submenu you can enable or disable the toolbars.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>Settings</guimenu>
+            <guimenuitem>Show Statusbar</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Hide or show the status bar.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>Settings</guimenu>
+            <guimenuitem>Dock Widgets</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Hide or show the dock widgets in the main window.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          <menuchoice>
+            <guimenu>Settings</guimenu>
+            <guimenuitem>Configure &smb4k;...</guimenuitem>
+          </menuchoice>
+        </term>
+        <listitem>
+          <para>Open the configuration dialog.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect1>
+
+<!--
+      Command Reference : The Help Menu
+  -->
+  
+  <sect1 id="command_reference_help_menu">
+    <title>The Help Menu</title>
+
+    <para>Additionally &smb4k; has the common &kde; <guimenu>Help</guimenu> menu items, for more information read the section about the <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink> of the &kde; Fundamentals.</para>
+  </sect1>
+</chapter>
+
+<!-- 
       Reporting Bugs 
   -->
 


More information about the kde-doc-english mailing list