[gnome-commander] Updated help docs

[Piotr Eljasiak <epiotr src gnome org>]

commit 35b89ed87d7a95c63b1010c89c5643dad9a00478
Author: Laurent Coudeur <laurentc iol ie>
Date:   Sun Dec 12 22:07:57 2010 +0100

    Updated help docs

 doc/C/gnome-commander.xml |  114 ++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 112 insertions(+), 2 deletions(-)
---
diff --git a/doc/C/gnome-commander.xml b/doc/C/gnome-commander.xml
index f31b01d..9a3ca69 100644
--- a/doc/C/gnome-commander.xml
+++ b/doc/C/gnome-commander.xml
@@ -709,6 +709,8 @@
       </table>
       <para>To perform the default action on an item, double-click on the item.</para>
     </sect2>
+
+    
     <!-- ================ Drag-and-Drop Subsection ======================= -->
     <sect2 id="gnome-commander-dnd">
       <title>Drag-and-Drop</title>
@@ -872,6 +874,58 @@
         <para>For more on dragging items, see <xref linkend="gnome-commander-dnd"/>.</para>
       </tip>
     </sect2>
+	 <!-- ================ Tab subsection ================================= -->
+	 <sect2 id="gnome-commander-tabs">
+		<title>Using multiple tabs</title>
+		<Para>You can open multiple tabs in both panels to speed up navigation. Gnome Commander can store the open tabs location upon closing. When you restart the application the tabs are reopened as they were before. This option can be set in <xref linkend="gnome-commander-prefs-general"/>. </Para> 	 	
+		<para>Using the mouse the middle click can be configured to open a new tab. This option can be set in <xref linkend="gnome-commander-prefs-general"/>. When it is set a middle click on a folder will open it in a new tab in the same pane.
+		</para>
+		<note>
+		<para>When using a 2 button mouse the middle click is emulated by clicking both buttons simultaneously
+		</para>
+		</note>
+		<itemizedlist>
+        <listitem>
+        <para>To open a new tab press <keycombo><keycap>Ctrl</keycap><keycap>t</keycap></keycombo> this opens a new tab in the current panel with the same folder opened.</para>
+        </listitem>
+        <listitem>
+       	 <para>To open a new tab displaying the selected folder in the current pane press the <keycombo><keycap>Ctrl</keycap><keycap>Up arrow</keycap></keycombo>. If you have configured the mouse middle click option to open a new tab (<xref linkend="gnome-commander-prefs-general"/>), then using the middle mouse button on a folder will also open a new tab displaying it in the current pane.</para> 
+        </listitem>
+        <listitem>
+       	 <para>To open a new tab displaying the selected folder in the inactive pane press the Ctrl+Shift+Up arrow </para>
+        </listitem>
+        <listitem>
+     	   <para>To navigate between tab you can you the mouse or use <keycombo><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo> as many time as needed to select the tab element. If the tabs are selected you can also use the <keycap>right arrow</keycap> or <keycap>left arrow</keycap> to select the desired tab.</para>
+        </listitem>
+        <listitem> 
+     	   <para>To close a tab you can use the mouse and double click the tab or right click on it and from the menu select <guimenu>Close tab</guimenu>. You can also close the current tab using the keyboard shortcut <keycombo><keycap>Ctrl</keycap><keycap>w</keycap></keycombo></para>
+        </listitem>
+      </itemizedlist>
+    	  <para>Right clicking on any tab will open a tab specific menu</para>
+      <itemizedlist>
+        <listitem>
+        	<para><guimenu>Open in New Tab</guimenu> this action opens a new tab with the displaying the currently opened folder. </para>
+        </listitem>
+        <listitem>
+        	<para><guimenu>Refresh Tab</guimenu> this actions refreshes the files displayed currently in the folder.
+        	</para> 
+        </listitem>
+        <listitem>
+        	<para><guimenu>Copy Tab to Other Pane</guimenu> opens a new tab in the opposite pane, this tab will display the selected tab. </para>
+        </listitem>
+        <listitem>
+	        <para><guimenu>Close Tab</guimenu> this action closes the currently selected tab.
+        </para>
+        </listitem> 
+		  <listitem>        
+        <para><guimenu>Close All Tabs</guimenu> GNOME-Commander will close all open tabs in the current pane. This leaves the current tab as the only open folder.</para>
+        </listitem> 
+        <listitem>
+        <para><guimenu>Close Duplicate Tabs</guimenu> GNOME-Commander will search for duplicated open tabs in the current pane and close them.</para> 
+        </listitem>
+      </itemizedlist>
+	 </sect2>        
+    
   </sect1>
 
 <!-- ================ Advanced features ================================ -->
@@ -3959,8 +4013,11 @@
             <para><guilabel>Left mouse button</guilabel> configures the action
             resulting from clicking the left mouse button.</para>
           </listitem>
+			<listitem>
+          	<para><guilabel>Middle mouse button</guilabel> configures the action resulting from clicking the middle mouse button.</para>
+          </listitem>
           <listitem>
-            <para><guilabel>Right mouse button</guilabel> configures the action
+          	<para><guilabel>Right mouse button</guilabel> configures the action
             resulting from clicking the right mouse button.</para>
           </listitem>
           <listitem>
@@ -3978,6 +4035,9 @@
           <listitem>
           	<para><guilabel>Multiple instances</guilabel> configures the number of &app; that can be launched</para>
           </listitem>
+          <listitem>
+          	<para><guilabel>Save on exit</guilabel> configures the storage of location when &app; is closed.</para>
+          </listitem>
         </itemizedlist>
       </para>
       <para>To modify the general options click on <menuchoice><guimenu>Settings</guimenu><guimenuitem>Options...</guimenuitem></menuchoice>,
@@ -4001,7 +4061,7 @@
       </figure>
       <!-- ==== End of Figure ==== -->
       <para/>
-      <table frame="topbot" id="gcmd-TBL-setting1">
+      <table frame="topbot" id="gcmd-TBL-setting1">      
         <title>General option tab</title>
         <tgroup cols="2" colsep="0" rowsep="0">
           <colspec colname="colspec0" colwidth="50.36*"/>
@@ -4063,6 +4123,32 @@
             <row>
               <entry colname="colspec0" valign="top">
                 <para>
+                  <guilabel>Middle Mouse button</guilabel>
+                </para>
+              </entry>
+              <entry colname="colspec2" valign="top">
+                <para>Up one directory</para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+                <para>When selecting this option a middle click with the mouse on
+                any item in &app; will display the parent directory of the current one.</para>
+                <note><para>The middle click is usually emulated by clicking both left and right buttons simultaneously on two buttons mice.</para></note>  
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+                <para/>
+              </entry>
+              <entry colname="colspec2" valign="top">
+                <para>Opens new tab</para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+                <para>When selecting this option, a middle click on a directory in &app;
+                with the mouse will open it in a new tab.</para>
+              </entry>
+            </row>            <row>
+              <entry colname="colspec0" valign="top">
+                <para>
                   <guilabel>Right Mouse button</guilabel>
                 </para>
               </entry>
@@ -4174,9 +4260,33 @@
 	              <para>By activating this option &app; can only have one instance running.</para>
               </entry>
             </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+	              <para><guilabel>Save on exit</guilabel></para>
+              </entry>
+              <entry colname="colspec2" valign="top">
+					<para>Directories</para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+	              <para>By activating this option &app; Saves the current folder location on exit. When you restart the two active location are reopened.</para>
+              </entry>
+            </row>
+            <row>
+              <entry colname="colspec0" valign="top">
+	              <para><guilabel></guilabel></para>
+              </entry>
+              <entry colname="colspec2" valign="top">
+					<para>Tabs</para>
+              </entry>
+              <entry colname="colspec3" valign="top">
+	              <para>By activating this option &app; Saves all the opened tabs locations on exit. When you restart all the tabs are reopened in their previous location.</para>
+              </entry>
+            </row>
           </tbody>
         </tgroup>
       </table>
+            
+
     </sect2>
     <!-- Format options-->
     <sect2 id="gnome-commander-prefs-format">