[gnome-commander] Doc: Updated the Tips and Tricks section and related images

[Uwe Scholz <uwescholz src gnome org>]

commit f5d8ec42a9538ae9406ca44d54aa4ef020ce6154
Author: Uwe Scholz <uwescholz src gnome org>
Date:   Tue Feb 4 08:23:33 2014 +0100

    Doc: Updated the Tips and Tricks section and related images

 doc/C/figures/create_archive.png  |  Bin 18856 -> 18822 bytes
 doc/C/figures/extract_archive.png |  Bin 19837 -> 19359 bytes
 doc/C/gnome-commander.xml         |  137 +++++++++++++++++++++++--------------
 3 files changed, 86 insertions(+), 51 deletions(-)
---
diff --git a/doc/C/figures/create_archive.png b/doc/C/figures/create_archive.png
index b5b236b..78565b1 100644
Binary files a/doc/C/figures/create_archive.png and b/doc/C/figures/create_archive.png differ
diff --git a/doc/C/figures/extract_archive.png b/doc/C/figures/extract_archive.png
index 7618f22..84fa950 100644
Binary files a/doc/C/figures/extract_archive.png and b/doc/C/figures/extract_archive.png differ
diff --git a/doc/C/gnome-commander.xml b/doc/C/gnome-commander.xml
index f7dffce..fb43a05 100644
--- a/doc/C/gnome-commander.xml
+++ b/doc/C/gnome-commander.xml
@@ -7061,70 +7061,107 @@
                 </itemizedlist>
             </para>
         </sect2>
- </sect1>
-
-<!-- ============= Tips and tricks ======================== -->
-<!-- This section contains info some very simple tips and tricks.-->
-  <sect1 id="gnome-commander-tips-and-tricks">
-    <title>Tips and Tricks</title>
-    <para>Some very simple tips and tricks on using and getting the most out of &app;.</para>
-    <variablelist>
-      <varlistentry>
-        <term>
-          <guilabel>Handling archives</guilabel>
-        </term>
-        <listitem>
-          <para>&app; still lacks built in browsing of compressed archives. However the program can be 
configured so
-        that working with archives becomes quite practical anyway. This is how you do it:</para>
-          <itemizedlist>
+      </sect1>
+      
+      <!-- ============= Tips and tricks ======================== -->
+      <!-- This section contains info some very simple tips and tricks.-->
+      <sect1 id="gnome-commander-tips-and-tricks">
+       <title>Tips and Tricks</title>
+       <para>Some very simple tips and tricks on using and getting the most out of &app;.</para>
+       <sect2 id="gnome-commander-handling-archives">
+         <title>Handling Archives</title>
+         <para>&app; still lacks built in browsing of compressed archives. However the program can be 
configured so
+         that working with archives becomes quite practical anyway. This is how you do it:</para>
+         <itemizedlist>
             <listitem>
-              <para>
-                If you don&apos;t already have the program <application>Fileroller</application>,
-                download it and install it.</para>
+             <para>
+               If you don&apos;t already have the program <application>Fileroller</application>,
+              download it and install it.</para>
             </listitem>
             <listitem>
-              <para>Open the <guimenu>Options</guimenu> dialog and go to the 
<guimenuitem>Programs</guimenuitem> tab.</para>
+             <para>Open the <guimenu>Options</guimenu> dialog and go to the 
<guimenuitem>Programs</guimenuitem> tab.</para>
             </listitem>
             <listitem>
-              <para>Add two favorite apps using the values shown here and here.</para>
+             <para>Add two favorite apps using the values shown in the figures below.</para>
             </listitem>
-          </itemizedlist>
-          <para>You can now right click any file or folder and choose <guimenuitem>Create 
archive...</guimenuitem>
-        to compress it and right click compressed files and choose <guimenuitem>Extract 
archive...</guimenuitem>
-        to extract it.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>
-          <guilabel>Using removable media</guilabel>
-        </term>
-        <listitem>
+         </itemizedlist>
+         <para>You can now right click any file or folder and choose <guimenuitem>Create 
archive...</guimenuitem>
+         to compress it and right click compressed files and choose <guimenuitem>Extract 
archive...</guimenuitem>
+         to extract it.</para>
+          <!-- ==== Figure ==== -->
+         <figure id="create-archive">
+            <title>Create Archive</title>
+            <screenshot>
+              <mediaobject>
+               <imageobject>
+                 <imagedata fileref="figures/create_archive.png" format="PNG"/>
+               </imageobject>
+               <textobject>
+                 <phrase>This entry allows creating archives easily.</phrase>
+               </textobject>
+              </mediaobject>
+            </screenshot>
+         </figure>
+         <!-- ==== End of Figure ==== -->
+         <!-- ==== Figure ==== -->
+         <figure id="extract-archive">
+            <title>Extract Archive</title>
+            <screenshot>
+              <mediaobject>
+               <imageobject>
+                 <imagedata fileref="figures/extract_archive.png" format="PNG"/>
+               </imageobject>
+               <textobject>
+                 <phrase>This entry allows extract archives easily.</phrase>
+               </textobject>
+              </mediaobject>
+            </screenshot>
+         </figure>
+         <!-- ==== End of Figure ==== -->
+       </sect2>
+       <sect2 id="gnome-commander-removable-media">
+         <title>Using removable media</title>
+          <warning>
+            <para>This info might be partially outdated since modern desktop environments or Linux 
distributions use automounters to mount devices into /media.</para>
+          </warning>
           <para>If you use removable devices such as CDs, floppies and cameras a lot you can make &app;
-        automatically take care of mounting them by following this guide:</para>
+          automatically take care of mounting them by following this guide:</para>
           <itemizedlist>
             <listitem>
               <para>Open the <guimenu>Options</guimenu> dialog and go to the 
<guimenuitem>Devices</guimenuitem> tab.</para>
             </listitem>
             <listitem>
-              <para>Add the devices that you are using. This is how the program looks with a few added 
devices.
-        In the last image the red circle shows the available devices, there is also a button, in the green 
circle,
-        to press if we want to unmount the floppy, which happened to be mounted.
-        The icons that are used for the devices in the example should be available
-        in the $(prefix)/share/pixmaps/gnome-commander/device-icons folder on your computer.</para>
+              <para>Add the devices that you are using. This is how the program looks with a few added 
devices.</para>
+              <!-- ==== Figure ==== -->
+             <figure id="mounting">
+               <title>Extract Archive</title>
+               <screenshot>
+                 <mediaobject>
+                   <imageobject>
+                     <imagedata fileref="figures/mounting.png" format="PNG"/>
+                   </imageobject>
+                   <textobject>
+                     <phrase>Mounting in &app;.</phrase>
+                   </textobject>
+                 </mediaobject>
+               </screenshot>
+             </figure>
+             <!-- ==== End of Figure ==== -->
+             <para>In the last image the red circle <guimenu>A</guimenu> shows the available 
+             devices. If a device was mounted by &app; there is also a button to press if you 
+             want to unmount the device, shown in the red circle <guimenu>B</guimenu>.
+             The icons that are used for the devices in the example should be available
+             in the $(prefix)/share/pixmaps/gnome-commander/device-icons folder on your computer.</para>
             </listitem>
             <listitem>
-              <para>There is also an option to skip mounting in the option device tab,
-        this can be useful for making shortcuts to directories, or if you have some automounting feature
-        that mounts it at its mountpoint when available, or if you use Supermount that does it on access 
basis.</para>
+              <para>There is also an option to skip mounting in the option device tab.
+              This can be useful for making shortcuts to directories, or if you have some automounting 
feature
+              that mounts it at its mountpoint when available, or if you use Supermount that does it on 
access basis.</para>
             </listitem>
           </itemizedlist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>
-          <guilabel>Using Nautilus icon theme</guilabel>
-        </term>
-        <listitem>
+       </sect2>
+       <sect2 id="gnome-commander-nautilus-theme">
+         <title>Using Nautilus icon theme</title>
           <warning>
             <para>This is outdated info since Nautilus and later GNOME versions no longer use these kind of 
themes.</para>
           </warning>
@@ -7149,9 +7186,7 @@
               and you should see Unscalable Gorilla being used.</para>
             </listitem>
           </itemizedlist>
-        </listitem>
-      </varlistentry>
-    </variablelist>
+    </sect2>
   </sect1>
 
 <!-- ============= Installation =========================== -->