[gthumb] more manual updates

[Michael J. Chudobiak <mjc src gnome org>]

commit e65eb0352390dab5c098923891df800ae3456d6a
Author: Michael J. Chudobiak <mjc avtechpulse com>
Date:   Wed Jun 23 08:45:24 2010 -0400

    more manual updates

 help/C/gthumb.xml |   71 ++++++++++++++++++++++++++++++++++++++++++----------
 1 files changed, 57 insertions(+), 14 deletions(-)
---
diff --git a/help/C/gthumb.xml b/help/C/gthumb.xml
index a6066b6..551321f 100644
--- a/help/C/gthumb.xml
+++ b/help/C/gthumb.xml
@@ -2,9 +2,9 @@
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd";[
   <!ENTITY legal SYSTEM "legal.xml">
-  <!ENTITY appversion "2.11.2">
-  <!ENTITY manualversion "2.11.2">
-  <!ENTITY date "February 2010">
+  <!ENTITY appversion "2.11.3">
+  <!ENTITY manualversion "2.11.3">
+  <!ENTITY date "June 2010">
   <!ENTITY appname "gThumb">
   <!ENTITY app "<application>gThumb</application>">
 <!-- replace version above with actual application version number -->
@@ -304,6 +304,54 @@
 </sect2>
 </sect1>
 
+<sect1 id="gthumb-thumbnails">
+  <title>About Thumbnails</title>
+    <para>
+	The browser window normally shows the thumbnails of the images
+	and movies in the selected folder. Generic icons for other files
+	(audio files, for instance) may also be shown.
+    </para>
+   <para>
+	You can select what types of files to show in the browser view
+	using the <menuchoice><guimenu>View</guimenu><guimenuitem>Filter</guimenuitem></menuchoice>
+	dialog. The default is to show all media files (images, movies,
+	audio), but this can be made more or less restrictive.
+    </para>
+   <para>
+	The thumbnails may be generated by a number of different methods.
+	&app; will first check for existing thumbnails in the system cache.
+    </para>
+   <para>
+	If no cached thumbnail is found, and an image file contains an 
+	embedded thumbnail (jpeg files generated
+	by digital cameras normally do), &app; will attempt to use that.
+	&app; will confirm that the aspect ratio of the thumbnail is 
+	similar to that of the main image, and ignore thumbnails that
+	do not appear to match the main image.
+    </para>
+   <para>
+	If that doesn't work, &app; will attempt to load the entire file and
+	generate a scaled-down thumbnail.
+    </para>
+   <para>
+	Lastly, &app; will use any system-defined scripts for thumbnailing
+	particular media types. For example, some systems may use
+	mplayer or totem or other movie viewers to generate movie
+	thumbnails.
+    </para>
+   <para>
+	gThumb will save thumbnails to a system cache, to share them with
+	other applications. By default, Gnome
+	systems prune cached thumbnails when they are older than 180 days,
+	or when the thumbnail cache exceeds 512 MB. Technically-inclined
+	users can explore these settings with gconf-editor. See the
+	/desktop/gnome/thumbnail_cache/maximum_age and 
+	/desktop/gnome/thumbnail_cache/maximum_size keys in particular.
+	Certain applications (like F-Spot) may automatically increase
+	these settings greatly.
+    </para>
+</sect1>
+
   <!-- ============= Browsing Folders ==============================  -->
   <sect1 id="gthumb-browsing">
   <title>Browsing Folders</title>
@@ -742,19 +790,14 @@
         <para>Go to the folder or catalog where the images are.</para>
       </listitem>
       <listitem>
-        <para>Select the images and choose
-        <menuchoice><guimenu>File</guimenu><guimenuitem>Open With</guimenuitem></menuchoice>
-        to display the <guilabel>Open</guilabel> dialog.</para>
+        <para>Select the images and right-click to open the pop-up menu.
+	Click on <menuchoice><guimenuitem>Open With</guimenuitem></menuchoice>.
+	This will display the applications that are registered with the
+	system as being suitable for the type of file selected.</para>
       </listitem>
       <listitem>
-        <para>Select an application from the <guilabel>Available
-        applications</guilabel> list, or from the <guilabel>Recent
-        applications</guilabel> list; or type a command in the
-        <guilabel>Application</guilabel> entry.</para>
-      </listitem>
-      <listitem>
-        <para>Click on <guibutton>Open</guibutton>. &app; opens the
-        images.</para>
+        <para>
+	Select the desired program, and it will be launched.</para>
       </listitem>
     </orderedlist>
   </para>