<?xml version="1.0" standalone="no"?>
<!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 gthumb-version "2.4">
  <!ENTITY manual-version "2.4">
  <!ENTITY date "September 2003">
  <!ENTITY gthumb "<application>gThumb</application>">
<!-- replace version above with actual application version number -->
<!--  Template Version: 1.0.1  (do not remove this line) -->
]>

<!-- =============Document Header ============================= -->

<article id="index" lang="en"> <!-- please do not change the id -->

  <articleinfo>
    <title>&gthumb; Manual V&manual-version;</title>
    <copyright>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <holder>Paolo Bacchilega</holder>
    </copyright>

    <!-- translators: uncomment this:

    <copyright>
     <year>2000</year>
     <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>

    -->

    <!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

    &legal; 

    <authorgroup>
      <author>
        <firstname>Paolo</firstname>
	<surname>Bacchilega</surname>
	<affiliation>
	  <address> <email>paolo.bacchilega@libero.it</email> </address>
        </affiliation>
      </author>
      <author> 
	<firstname>Alexander</firstname> 
	<surname>Kirillov</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>kirillov@math.sunysb.edu</email> </address> 
	</affiliation> 
      </author> 
    </authorgroup>

    <!-- do not put authorname in the header except in copyright - use
         section "authors" below -->

    <!-- this is version of manual, not application --> 
    <releaseinfo>
      This is manual describes version &gthumb-version; of &gthumb;
    </releaseinfo>
  </articleinfo>

  <indexterm> 
    <primary>gThumb</primary> 
  </indexterm> 
  <indexterm> 
    <primary>image viewer</primary> 
  </indexterm> 
  <indexterm> 
    <secondary>viewer</secondary> 
  </indexterm> 

  <!-- ============= Document Body ============================= -->

  <!-- ============= Introduction ============================== -->

  <sect1 id="intro">
    <title>Introduction</title>
    <para>
      &gthumb; is an image viewer and browser 
      written for the GNOME environment.  It lets you browse your hard disk, 
      showing you thumbnails of image files and view single images
      of many different formats.
    </para>
    <para>
      The most common image formats are JPEG and GIF. The JPEG format 
      is good for medium and big sized images because it has a high
      compression rate keeping a good image quality.  
      The GIF format is used in Web pages for displaying little
      animations or little static images.
      Another important image format is PNG, this format is very
      common on Unix platforms and is considered
      a replacement of the GIF format which has  
      <ulink url="http://www.gnu.org/philosophy/gif.html"
      type="http">license issues</ulink>.
    </para>
    <para>
      &gthumb; supports all this formats and many others, it also displays
      GIF animations.
    </para>
    <para>
      &gthumb; not only lets you view image files but has many other features
      such as add comments to images, organize images
      in catalogs, print images, view slideshows, set your desktop
      background, and more.
    </para>
  </sect1>
  
  <!-- ============= Getting Started ==============================  -->
  <sect1 id="gthumb-getting-started">
  <title>Getting Started</title>
  <para>
    This section provides information on how to start &gthumb;, and
    describes the main window interface. 
  </para>
  <sect2 id="get-start">
    <title>To Start &gthumb;</title>
    <para>
      You can start &gthumb; in the following ways:</para>
      <variablelist>
        <varlistentry>
          <term><guimenu>Applications</guimenu> menu</term>
          <listitem>
            <para>Choose
            <menuchoice><guisubmenu>Graphics</guisubmenu><guimenuitem>gThumb</guimenuitem></menuchoice>.
            </para> 
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Command line</term>
          <listitem>
            <para>Type <command>gthumb</command>, then press
            <keycap>Return</keycap>.</para> 
          </listitem>
        </varlistentry>
      </variablelist>
    <para>If you start &gthumb; from the command line you can specify
      the following options:
    </para>
      <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="50.00*"/>
          <colspec colname="COLSPEC1" colwidth="50.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Command</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Explanation</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry><para><command>gthumb <replaceable>folder</replaceable></command></para></entry>
              <entry align="left"><para>Start &gthumb; in the
              specified folder</para></entry>
            </row>
            <row valign="top">
              <entry><para><command>gthumb <replaceable>name.jpg</replaceable></command></para></entry>
              <entry align="left"><para>View the image <filename>name.jpg</filename>.</para></entry>
            </row>
            <row valign="top">
              <entry><para><command>gthumb <replaceable>*.jpg</replaceable></command></para></entry>
              <entry align="left"><para>View all the images with a
              <filename>.jpg</filename> extension.</para></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>

  </sect2>
  <sect2 id="gthumb-main-window">
  <title>When You Start &gthumb;</title>
    <para>
    When you start &gthumb; the following window is displayed:

    <!-- ==== Figure ==== -->
    <figure id="main-win-fig">
    <title>The main window</title> 
    <screenshot>
      <screeninfo>The main window</screeninfo> 
      <graphic format="png" fileref="figures/main-win.png" srccredit="Me">
      </graphic>
    </screenshot>
    </figure>
    <!-- ==== End of Figure ==== -->

    The &gthumb; <guilabel>window</guilabel> contains the following elements:
    <variablelist>
      <varlistentry> <term>Menubar</term>
        <listitem>
          <para>The menus on the menubar contain all of the commands
          that you can use in &gthumb;</para> 
        </listitem>
      </varlistentry>
      <varlistentry> <term>Toolbar</term>
        <listitem>
           <para>The toolbar contains a subset of the commands that
           you can access from the menubar. </para>
        </listitem>
      </varlistentry>
      <varlistentry> <term>Locationbar</term>
        <listitem>
          <para>The locationbar contains the current folder name. </para>
        </listitem>
      </varlistentry>
      <varlistentry> <term>Folder list</term>
      <listitem> 
        <para>The folder list shows the
	  sub-folders contained in the current folder.
	</para>
      </listitem>
      </varlistentry>
      <varlistentry> <term>Image list</term>
      <listitem>
        <para>The image list which shows the images in the current folder.
	</para>
      </listitem>
      </varlistentry>
      <varlistentry> <term>Statusbar</term>
      <listitem>
        <para>On the statusbar you can read:
	  <orderedlist>
	    <listitem>
              <para>the total number of images contained in the
	      current folder and their total size.</para>
	    </listitem>
	    <listitem>
	      <para>the number of the selected images and their size.</para>
	    </listitem>
	    <listitem>
	      <para>some properties of the currently focused image.</para>
	    </listitem>
	  </orderedlist>
	</para>
      </listitem>
      </varlistentry>
    </variablelist>
    </para>
  </sect2>
  </sect1>

  <!-- ============= Browsing Folders ==============================  -->
  <sect1 id="gthumb-browsing">
  <title>Browsing Folders</title>
    <para>
      Browser options can be found in the <xref
      linkend="preferences-browser"/> of the
      <guilabel>Preferences</guilabel> dialog.
    </para>
    <para>
      Keyboard shortcuts to browse folders are described in <xref
      linkend="gthumb-TBL-keyword-shortcuts-browser"/>.
    </para>
    <sect2 id="gthumb-change-folder">
    <title>To Change Folder</title>
    <para>
      If you want to change folder you have two ways:
      <orderedlist>
	<listitem>
	  <para>click on the folder name in the folder list.</para>
        </listitem>
        <listitem>
	  <para>type the folder name in the location entry.</para>
        </listitem>
      </orderedlist>
    </para>
    <para>
      When using the location entry you can press 
      <keycombo><keycap>Ctrl</keycap><keycap>TAB</keycap></keycombo> to
      try to automatically complete the folder name,  this simplify the 
      typing of long names.  You can quickly give focus to the
      location entry pressing
      <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo>.
    </para>
    <para>
      To go to a previously visited folder you can use the 
      toolbar <guilabel>Back</guilabel> button or click on the
      down arrow located near the button to display a menu that
      contains a list of the most recently visited folders.  When this
      menu is displayed, if you keep the pointer on a folder name, you
      can read the full folder path in the statusbar.
    </para>
    <para>
      The above commands are also present in the
      <menuchoice><guimenu>View</guimenu><guisubmenu>Go</guisubmenu></menuchoice>
      menu.
    </para>
  </sect2>
  <sect2 id="gthumb-sort">
  <title>To Sort Images</title>
    <para>
      To sort images in a different order use the <guimenuitem>Sort
      images</guimenuitem> submenu in the <guimenu>View</guimenu>
      menu, use <keycombo><keycap>Ctrl</keycap><keycap>R</keycap>
      </keycombo> to reload the current folder,  type
      <keycombo><keycap>T</keycap></keycombo> to view or hide the
      thumbnails in the images list.
    </para>
  </sect2>
  <sect2 id="gthumb-bookmarks">
  <title>To Add a Folder to the Bookmarks</title>
  <para>
      Frequently used folders can be added to the bookmark list for rapid
      access.  Just go to the folder you want to add to the bookmarks and
      press <keycombo action="simul"><keycap>Ctrl</keycap><keycap>D</keycap>
      </keycombo> or use the command
      <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Add
      Bookmark</guimenuitem></menuchoice>.
      To remove or rearrange bookmarks in a different order use the 
      <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit
      Bookmarks</guimenuitem></menuchoice> command.
  </para>
  </sect2>
  </sect1>
  <sect1 id="gthumb-folders">
    <title>
      Working with Folders
    </title>
    <para>
      &gthumb; offers the functionalities to manage folders.
      <note>
        <title>WARNING</title>
        <para>
          It's highly suggested to move and copy image folders with
          &gthumb;.  This is because if you move or copy folders with
          &gthumb; image comments will remain attached to images as
          you expect, but if you move or copy folders with the file
          manager or other applications you will loose your comments.
        </para>
      </note>
    </para>
    <sect2 id="gthumb-create-folder">
    <title>To Create a Folder</title>
    <para>To create a new folder, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder where the new folder will be created.
        </para>
      </listitem>
      <listitem>
        <para>Choose
        <menuchoice><guimenu>File</guimenu><guimenuitem>New
        Folder</guimenuitem></menuchoice> to display the <guilabel>New
        Folder</guilabel> dialog.
        </para>
      </listitem>
      <listitem>
        <para>Enter the new folder name.
        </para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Create</guibutton>. &gthumb; creates
        a new folder.
        </para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  <sect2 id="gthumb-open-folder">
    <title>To Open a Folder</title>
    <para>To open a folder with the file manager, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder you want to open.</para>
      </listitem>
      <listitem>
        <para>Choose
        <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Open
        with the File Manager</guimenuitem></menuchoice>. &gthumb;
        opens the folder with the file manager.
        </para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  <sect2 id="gthumb-rename-folder">
    <title>To Rename a Folder</title>
    <para>To rename a folder, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder you want to rename.</para>
      </listitem>
      <listitem>
        <para>Choose
        <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Rename</guimenuitem></menuchoice>
        to display the <guilabel>Rename Folder</guilabel> dialog.
        </para>
      </listitem>
      <listitem>
        <para>Enter the new folder name.
        </para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Rename</guibutton>. &gthumb; renames
        the folder.
        </para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  <sect2 id="gthumb-move-to-trash-folder">
    <title>To Delete a Folder</title>
    <para>To delete a folder, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder you want to delete.</para>
      </listitem>
      <listitem>
        <para>Choose
        <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Move
        to Trash</guimenuitem></menuchoice>. &gthumb; moves the folder
        to the system trash.
        </para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  <sect2 id="gthumb-copy-folder">
    <title>To Copy a Folder</title>
    <para>To copy a folder to a different location, perform the
    following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder you want to copy.</para>
      </listitem>
      <listitem>
        <para>Choose
        <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Copy</guimenuitem></menuchoice>
        to display the <guilabel>Copy Folder</guilabel> dialog.
        </para>
      </listitem>
      <listitem>
        <para>The <guilabel>Copy Folder</guilabel> dialog is used to
        choose the destination folder. You can type the folder name in
        the <guilabel>Folder</guilabel> entry, or click on
        <guibutton>Browse</guibutton> to select a folder from your
        disk. The <guilabel>Recents</guilabel> list contains the list
        of recently specified destination folders, while the
        <guilabel>Bookmarks</guilabel> list contains the folders you
        have a bookmark for.
        Click on a folder in these lists to insert the folder name in
        the <guilabel>Folder</guilabel> entry.
        </para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Ok</guibutton>. &gthumb; copies the
        folder to the destination folder.
        </para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  <sect2 id="gthumb-move-folder">
    <title>To Move a Folder</title>
    <para>To move a folder to a different location, perform the
    following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder you want to move.</para>
      </listitem>
      <listitem>
        <para>Choose
        <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Move</guimenuitem></menuchoice>
        to display the <guilabel>Move Folder</guilabel> dialog.
        </para>
      </listitem>
      <listitem>
        <para>The <guilabel>Move Folder</guilabel> dialog is used to
        choose the destination folder. You can type the folder name in
        the <guilabel>Folder</guilabel> entry, or click on
        <guibutton>Browse</guibutton> to select a folder from your
        disk. The <guilabel>Recents</guilabel> list contains the list
        of recently specified destination folders, while the
        <guilabel>Bookmarks</guilabel> list contains the folders you
        have a bookmark for.
        Click on a folder in these lists to insert the folder name in
        the <guilabel>Folder</guilabel> entry.
        </para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Ok</guibutton>. &gthumb; moves the
        folder to the destination folder.
        </para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  </sect1>

  <!-- ============= Viewing ================================== -->
  <sect1 id="gthumb-image-viewing">
  <title>Viewing Images</title>
  <para>
     Keyboard shortcuts to view images are described in <xref
     linkend="gthumb-TBL-keyword-shortcuts-viewer"/>.
  </para>
  <sect2 id="gthumb-view-images">
  <title>To View an Image</title>
    <para>
      In order to view an image just click on its thumbnail and the image will
      be visualized in the viewer pane.  If the image doesn't fit the viewer
      pane you can give more space to the viewer hiding the browser, this can 
      be accomplished double-clicking on the thumbnails or pressing the
      <keycap>Return</keycap> key, pressing it
      again the browser will be displayed again.  
      Another way of viewing a big image is to view it in full screen
      mode, type <keycombo><keycap>F</keycap></keycombo> to
      activate/disactivate the full screen mode.
    </para>
    <para>
      Mouse operations :
    </para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0"
                colwidth="30.65*"/>
        <colspec colname="COLSPEC1" colwidth="69.35*"/>
        <tbody>
          <row>
            <entry>
              <para>Holding down the left button and moving the mouse</para></entry>
            <entry>
              <para>move the image.</para></entry>
          </row>
          <row>
            <entry>
              <para>Left-click</para></entry>
            <entry>
              <para>Show next image.</para></entry>
          </row>
          <row>
            <entry>
              <para>Middle-click</para></entry>
            <entry>
              <para>Show previous image.</para></entry>
          </row>
          <row>
            <entry>
              <para>Right-click</para></entry>
            <entry>
              <para>Pop up the image menu.</para></entry>
          </row>
        </tbody>
        </tgroup>
      </informaltable>
    <para>
      Another way of moving images is by the navigation button :
      <screenshot> 
        <mediaobject> 
          <imageobject>
            <imagedata fileref="figures/nav-button.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
      located in the
      right bottom corner of the viewer window when the images does not fit
      in the window.  Clicking and holding this 
      button will show you a preview of the image.  Moving the mouse you will 
      move the image to the desired position.
    </para>
   </sect2>
   <sect2 id="gthumb-view-prop">
   <title>To View the Image Properties</title>
     <para>
        To view the image properties, perform the following steps:
        <orderedlist>
          <listitem>
            <para>Select the image.</para>
          </listitem>
          <listitem>
            <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties
            </guimenuitem></menuchoice>. &gthumb; displays a
            <guilabel>Properties</guilabel> dialog.</para>
          </listitem>
        </orderedlist>
     </para>
   </sect2>
  <!-- ============= EXIF ================================== -->
  <sect2 id="gthumb-exif">
  <title>To View the Image EXIF Data</title>
  <para>
     To view the exif data attached to an image, use the
     <guilabel>Properties</guilabel> dialog (<xref
      linkend="gthumb-view-prop"/>) or perform the following
     steps:
     <orderedlist>
        <listitem>
           Select the image.
        </listitem>
        <listitem>
           View the image pressing <keycap>Return</keycap> or double
           clicking on it.
        </listitem>
        <listitem>
           Choose
           <menuchoice><guimenu>View</guimenu><guisubmenu>View/Hide</guisubmenu><guimenuitem>Image
           Comment</guimenuitem></menuchoice> or press
           <keycap>I</keycap>. &gthumb; displays the exif data.
        </listitem>
     </orderedlist>
  </para>
  </sect2>
  </sect1>

  <!-- ============= working with images ================================== -->
  <sect1 id="gthumb-image-working">
  <title>Working with Images</title>
   <sect2 id="gthumb-alter-images">
   <title>To Modify an Image</title>
      <para>
	The current image can be modified in many ways.  The commands
	used to modify an image are located in the <guimenu>Image</guimenu> 
	menu.
      </para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0"
                colwidth="30.65*"/>
        <colspec colname="COLSPEC1" colwidth="69.35*"/>
        <tbody>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Enhance</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Enhance the image adjusting the color levels.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Resize</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Change the image size performing a zoom in or out.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Crop</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Crop the image.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Transform</guisubmenu>
		<guimenuitem>Rotate Right</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Rotate the image 90 degrees clockwise.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Transform</guisubmenu>
		<guimenuitem>Rotate Left</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Rotate the image 90 degrees counter-clockwise.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Transform</guisubmenu>
		<guimenuitem>Flip</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Create a mirror image by reflecting the image scanlines 
		in the vertical direction.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Transform</guisubmenu>
		<guimenuitem>Mirror</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Create a mirror image by reflecting the image scanlines 
		in the horizontal direction (as in a mirror).
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Desaturate</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        View the image in black and white.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Negative</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        View the image negative.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Color Balance</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Change the color balancement.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Hue-Saturation</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Change the image hue, lightness and saturation level.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Brightness-Contrast</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Change the image brightness and contrast.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guimenuitem>Posterize</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Reduce the number of colors.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Auto</guisubmenu>
		<guimenuitem>Equalize Histogram</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Enhance the image equalizing its histogram.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Auto</guisubmenu>
		<guimenuitem>Normalize</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Automatically normalize the contrast.
	      </para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <menuchoice>
		<guisubmenu>Auto</guisubmenu>
		<guimenuitem>Stretch Contrast</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Automatically stretch the contrast.
	      </para>
	    </entry>
	  </row>
	</tbody>
      </tgroup>
      </informaltable>
      <para>When an image is modified the label "[modified]" is
      displayed near the image filename.
      <note>
        <title>NOTE</title>
        <para>
          Please note that this modifications do not change the image file.
	  If you want to view the original image just click on its 
	  thumbnail again or use the
	  <menuchoice><guimenu>File</guimenu><guimenuitem>Revert</guimenuitem>
	 </menuchoice> command.
        </para>
      </note>
      </para>
      <para>
        You can save modified images, see <xref
        linkend="gthumb-save-images"/> to known how.
      </para>
    </sect2>
    <sect2 id="gthumb-save-images">
    <title>To Save an Image</title>
      <para>To save an image, perform the following steps:
      <orderedlist>
        <listitem>
           <para>Display the image.</para>
        </listitem>
        <listitem>
           <para>Modify the image (described in <xref
           linkend="gthumb-alter-images"/>).  Of course this step is
           optional.</para> 
        </listitem>
        <listitem>
            <para>Choose
            <menuchoice><guimenu>File</guimenu><guimenuitem>Save
            As</guimenuitem></menuchoice>.</para>
        </listitem>
        <listitem>
            <para>Choose the filename and click on
            <guibutton>Ok</guibutton>.</para>
        </listitem>
        <listitem>
           <para>&gthumb; displays the image format dialog from which
           you can choose specific file format options.  Once you are
           ok with the options click on
           <guibutton>Ok</guibutton>. &gthumb; saves the image.</para>
        </listitem>
      </orderedlist>
      </para>
    </sect2>      

  <sect2 id="gthumb-image-open">
  <title>To Open a Series of Images with Another Program</title>
  <para>
    To open a series of images with another program, perform the
    following steps:
    <orderedlist>
      <listitem>
        <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>
      </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>. &gthumb; opens the
        images.</para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>

  <sect2 id="gthumb-image-rename">
  <title>To Rename an Image</title>
  <para>
    To rename an image filename, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder or catalog where the image is.</para>
      </listitem>
      <listitem>
        <para>Select the image and choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Rename</guimenuitem></menuchoice>.</para>
      </listitem>
      <listitem>
        <para>Enter the new filename and click on
        <guibutton>Rename</guibutton>. &gthumb; renames the image
        filename.</para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>

  <sect2 id="gthumb-image-delete">
  <title>To Delete a Series of Images</title>
  <para>
    To delete a series of images, perform the
    following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder or catalog where the images are.</para>
      </listitem>
      <listitem>
        <para>Select the images and choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move to
        Trash</guimenuitem></menuchoice>. &gthumb; deletes the images
        moving them to the system trash.</para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>

  <sect2 id="gthumb-image-copy">
  <title>To Copy a Series of Images</title>
  <para>
    To copy a series of images, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder or catalog where the images are.</para>
      </listitem>
      <listitem>
        <para>Select the images and choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>
        to display the <guilabel>Choose the destination
        folder</guilabel> dialog.</para>
      </listitem>
      <listitem>
        <para>Select a folder from the <guilabel>Recents</guilabel>
        list, or from the <guilabel>Bookmarks</guilabel> list; or type
        a folder name in the
        <guilabel>Folder</guilabel> entry.</para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Ok</guibutton>. &gthumb; copies the
        images.</para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>

  <sect2 id="gthumb-image-move">
  <title>To Move a Series of Images</title>
  <para>
    To move a series of images, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder or catalog where the images are.</para>
      </listitem>
      <listitem>
        <para>Select the images and choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move</guimenuitem></menuchoice>
        to display the <guilabel>Choose the destination
        folder</guilabel> dialog.</para>
      </listitem>
      <listitem>
        <para>Select a folder from the <guilabel>Recents</guilabel>
        list, or from the <guilabel>Bookmarks</guilabel> list; or type
        a folder name in the
        <guilabel>Folder</guilabel> entry.</para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Ok</guibutton>. &gthumb; moves the
        images.</para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>

  <!-- ============= Print ================================== -->
  <sect2 id="gthumb-print-images">
  <title>To Print a Series of Images</title>
  <para>
    To print a series of images, perform the following steps:
    <orderedlist>
      <listitem>
        <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>Print</guimenuitem></menuchoice>.</para>
      </listitem>
      <listitem>
        <para> In the <guilabel>Print</guilabel> dialog there are two tags:
        <guilabel>Layout</guilabel> and <guilabel>Paper Details</guilabel>.
        </para>
        <para> From the <guilabel>Layout</guilabel> tag you can
        <itemizedlist>
        <listitem>
          <para>Choose the number of images per page.</para>
        </listitem>
        <listitem>
          <para>Include the image comment.</para>
        </listitem>
        <listitem>
          <para>Rotate an image by clicking on it.</para>
        </listitem>
        <listitem>
          <para>Move an image by clicking on it with the left mouse
          button and dragging it.</para>
        </listitem>
        <listitem>
          <para>Resize the image.</para>
        </listitem>
        <listitem>
          <para> Recenter the image on the page using the <guibutton>Center on 
	  Page</guibutton> button.</para>
        </listitem>
        </itemizedlist>
        </para>
        <para> From the <guilabel>Paper Details</guilabel> tag you can
        <itemizedlist>
        <listitem>
          <para>Choose the paper format.</para>
        </listitem>
        <listitem>
          <para>Choose the paper orientation.</para>
        </listitem>
        </itemizedlist>
        </para>
      </listitem>
      <listitem>
        <para>When you are ready to print click on
        <guibutton>Print</guibutton>. &gthumb; prints the
        images.</para>
      </listitem>
    </orderedlist>
    </para>
  </sect2>
  </sect1>

  <!-- ============= Comments ================================== -->
  <sect1 id="gthumb-comments">
  <title>Comments</title>
  <para>
    Comments are pieces of information attached to images.
    <note>
      <title>WARNING</title>
      <para>Comments are not embedded in image files, they are saved
      separately. This means that if you move images or 
      folders with other programs you will lose the comments.
      </para>
    </note>
    <note>
      <title>FOR EXPERTS</title>
      <para>Comments are saved in the folder
      <filename>$(HOME)/.gnome2/gthumb/comments</filename>. 
      </para>
    </note>
  </para>
  <sect2 id="gthumb-comment-add">
  <title>To Add a Comment</title>
  <para>
    To add a comment to an image select the image and choose 
    <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit comment</guimenuitem>
    </menuchoice> or type <keycombo><keycap>C</keycap></keycombo>.
  </para>
  <para>
    Comments are structured in various parts :
    <itemizedlist>
      <listitem>
        <para>
	  <guilabel>Comment</guilabel>: a free text describing the picture.
        </para>
      </listitem>
      <listitem>
        <para>
	  <guilabel>Place</guilabel>: the place the picture represents. 
        </para>
      </listitem>
      <listitem>
        <para>
	  <guilabel>Date</guilabel>: the date the picture was taken.
        </para>
      </listitem>
    </itemizedlist>
  </para>
  <para>
    Image comments are displayed in the image list in italic text above the 
    image filename.  If the comment is too long the simbol "[..]" is
    appended to the displayed part of the comment to signal you that
    the comment is not entirely visible, to view the whole comment use
    the image properties dialog that can be displayed using the
    <menuchoice><guimenu>File</guimenu><guimenuitem>Properties
    </guimenuitem></menuchoice> command or pressing
    <keycombo><keycap>I</keycap></keycombo>.
  </para>
    <!-- ==== Figure ==== -->
    <figure id="comment-in-list-fig">
      <title>An image comment</title> 
      <screenshot>
        <screeninfo>An image comment</screeninfo> 
        <graphic format="png" fileref="figures/comment.png" srccredit="Me">
        </graphic>
      </screenshot>
    </figure>
    <!-- ==== End of Figure ==== -->

  <sect3 id="gthumb-comment-add-multi">
  <title>To Add a Comment to Many Images</title>
  <para>
    To add a comment to many images, select the images and choose
    <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit
    comment</guimenuitem> </menuchoice> or type
    <keycombo><keycap>C</keycap></keycombo>. 
  </para>
  <para>
    The <guilabel>Comment</guilabel> dialog will fill in the fields
    that have the same value for all the images leaving all other
    fields empty.
  </para>
  <para>
    You can activate the <guilabel>Save only changed fields
    </guilabel> option (active by default) to change one or more
    fields of many comments leaving all other fields unchanged.
  </para>
  </sect3>
  </sect2>
  <sect2 id="gthumb-comment-delete">
  <title>To Remove Comments</title>
  <para>
    To remove comments, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the folder or catalog where the images are.</para>
      </listitem>
      <listitem>
        <para>Select the images and choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Remove
        comment</guimenuitem></menuchoice>. &gthumb; removes the
        comments.</para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>
  <sect2 id="gthumb-comment-view">
  <title>To View an Image Comment</title>
  <para>
     To view an image comment, use the
     <guilabel>Properties</guilabel> dialog (<xref
      linkend="gthumb-view-prop"/>) or perform the following
     steps:
     <orderedlist>
        <listitem>
           Select the image.
        </listitem>
        <listitem>
           View the image pressing <keycap>Return</keycap> or double
           clicking on it. 
        </listitem>
        <listitem>
           Choose
           <menuchoice><guimenu>View</guimenu><guisubmenu>View/Hide</guisubmenu><guimenuitem>Image
           Comment</guimenuitem></menuchoice> or press
           <keycap>I</keycap>. &gthumb; displays the image comment.
        </listitem>
     </orderedlist>
  </para>
  </sect2>
  </sect1>

  <!-- ============= Categories ================================== -->
  <sect1 id="gthumb-categories">
  <title>Categories</title>
  <para>
    Categories are keywords assigned to images and can be used to perform fine 
    grained searches as described in <xref linkend="gthumb-finding"/>.
    <note>
      <title>WARNING</title>
      <para>Categories are not embedded in image files, they are saved
      separately.  This means that if you move images or 
      folders with other programs you will lose the comments.
      </para>
    </note>
    <note>
      <title>FOR EXPERTS</title>
      <para>Categories are saved in the folder
      <filename>$(HOME)/.gnome2/gthumb/comments</filename>. 
      </para>
    </note>
  </para>
  <sect2 id="gthumb-categories-add">
  <title>To Assign Categories to a Series of Images</title>
  <para>
    To add categories to a series of images, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Select the images and choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Categories
        </guimenuitem></menuchoice>. &gthumb; shows the
        <guilabel>Categories</guilabel> dialog.</para>
      </listitem>
      <listitem>
	<para>Check the categories in the <guilabel>Available Categories
        </guilabel> List.  You can create new categories clicking on the
        <guilabel>New</guilabel> button, and delete categories from the
	list clicking on the <guilabel>Remove</guilabel> button. </para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Ok</guibutton>. &gthumb; assigns
        the catories to the images.
        </para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>
  <sect2 id="gthumb-categories-add-to-folder">
  <title>To Assign Categories to a Folder</title>
  <para>
    Instead of assigning categories to single images you can assign them
    to a folder, this is equivalent to assign the categories to all the images
    contained in the folder and in all of its sub-folders.
  </para>
  <para>
    To add categories to a folder, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Go to the parent folder in order to visualize the folder name 
	in the folder list pane, right-click on the folder name and
	select the <menuchoice><guimenuitem>Categories</guimenuitem>
        </menuchoice> command; alternatively go to the folder and select
	the <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu>
        <guimenuitem>Categories</guimenuitem></menuchoice> commands.  In both
        cases &gthumb; shows the <guilabel>Categories</guilabel> dialog.</para>
      </listitem>
      <listitem>
	<para>Check the categories in the <guilabel>Available Categories
        </guilabel> List.  You can create new categories clicking on the
        <guilabel>New</guilabel> button, and delete categories from the
	list clicking on the <guilabel>Remove</guilabel> button. </para>
      </listitem>
      <listitem>
        <para>Click on <guibutton>Ok</guibutton>. &gthumb; assigns
        the catories to the folder.
        </para>
      </listitem>
    </orderedlist>
  </para>
  </sect2>
  <sect2 id="gthumb-categories-remove">
  <title>To Remove Categories from an Image or a Folder</title>
  <para>
    To remove categories from a series of images or a folder perform the 
    same steps as described above an uncheck the categories you want
    to remove, the click on <guibutton>Ok</guibutton> to confirm the
    operation.
  </para>
  </sect2>
  </sect1>

  <!-- ============= Catalogs ================================== -->
  <sect1 id="catalogs">
  <title>Catalogs</title>
  <para>
    Catalogs lets you organize images without moving them from a folder to
    another, think of them as "playlists" for images.
  </para>
  <para>
    Catalogs can be organized in libraries.  A library is like a folder
    that can contain catalogs and other libraries.
  </para>
  <para>
  <note>
  <title>WARNING</title>
  <para>
    Catalogs are not updated when you move images, if you want a more flexible
    catalog you can use the searches described in <xref linkend="gthumb-find"/>, 
    searches are catalogs with search criteria attached, after moving
    images you can redo the search to get the catalog updated.
  </para>
  </note>
  <note>
  <title>FOR EXPERTS</title>
  <para>
    Catalogs are saved in the
    folder <filename>$(HOME)/.gnome2/gthumb/collections</filename>.
  </para>
  </note>
  </para>
    <sect2 id="gthumb-catalog-view">
    <title>To View the List of Catalogs</title>
        <para> To view the list of catalogs, perform the
        following step:
        <orderedlist>
        <listitem>
          <para>Press
          <keycombo><keycap>Alt</keycap><keycap>2</keycap></keycombo> or
          choose
          <menuchoice><guimenu>View</guimenu><guimenuitem>Catalogs</guimenuitem></menuchoice>.</para>
        </listitem>
        </orderedlist>
        </para>
    </sect2>
    <sect2 id="gthumb-catalog-view-content">
    <title>To View a Catalog</title>
        <para> To view the content of a catalog, perform the
        following steps:
        <orderedlist>
        <listitem>
          <para>Set the catalogs view (described in <xref
          linkend="gthumb-catalog-view"/>). </para>
        </listitem>
        <listitem>
          <para>Select the catalog clicking on the catalog name.</para>
        </listitem>
       </orderedlist>
       </para>
       <para>
         If you want to go to the image folder,
         select the image and use the
         <menuchoice><guimenu>View</guimenu><guisubmenu>Go</guisubmenu><guimenuitem>Go
         to the image folder </guimenuitem></menuchoice> command or
         press <keycombo
         action="simul"><keycap>Alt</keycap><keycap>End</keycap></keycombo>. 
       </para>
    </sect2>
    <sect2 id="gthumb-catalog-add">
    <title>To Add Images to a Catalog</title>
      <para>
        To add a series of images to a catalog, perform the following steps:
    <orderedlist>
      <listitem>
        <para>Select the images you want to add to the catalog and
        choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>
	  Add to Catalog</guimenuitem></menuchoice>.</para>
      </listitem>
      <listitem>
        <para>Select an existing catalog or create a new one.</para>
      </listitem>
      <listitem>
        <para>Choose <guibutton>Ok</guibutton>.  &gthumb; adds the
        selected images to the catalog.</para>
      </listitem>
    </orderedlist>
	</para>
    </sect2>
    <sect2 id="gthumb-catalog-delete">
    <title>To Remove Images from a Catalog</title>
      <para> To remove images from a catalog, perform the
      following steps:
      <orderedlist>
        <listitem>
          <para>Set the catalogs view (described in <xref
          linkend="gthumb-catalog-view"/>). </para>
        </listitem>
        <listitem>
          <para>Select the catalog.</para>
        </listitem>
        <listitem>
         <para>Select the images you want to delete
	  and choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>
	  Remove from Catalog</guimenuitem></menuchoice>. &gthumb;
	  removes the images from the catalog.</para>
        </listitem>
      </orderedlist>
      </para>
    </sect2>
    <sect2 id="gthumb-catalog-create">
    <title>To Create a Catalog</title>
        <para> To create a catalog, perform the
        following steps:
        <orderedlist>
        <listitem>
          <para>Set the catalogs view (described in <xref
          linkend="gthumb-catalog-view"/>). </para>
        </listitem>
        <listitem>
          <para>Choose 
	  <menuchoice><guimenu>File</guimenu><guimenuitem>New
	  Catalog</guimenuitem></menuchoice>.</para>
        </listitem>
        <listitem>
          <para>Enter the catalog name and click on
          <guibutton>Ok</guibutton>.  &gthumb; creates the catalog.</para>
        </listitem>
        </orderedlist>
        </para>
    </sect2>
    <sect2 id="gthumb-catalog-rename">
    <title>To Rename, Remove or Move a Catalog</title>
        <para> To rename, remove or move a catalog, perform the
        following steps:
        <orderedlist>
        <listitem>
          <para>Set the catalogs view (described in <xref
          linkend="gthumb-catalog-view"/>). </para>
        </listitem>
        <listitem>
          <para>Select the catalog.</para>
        </listitem>
        <listitem>
          <para>Choose the corrisponding command in the
	  <menuchoice><guimenu>File</guimenu><guisubmenu>Catalog</guisubmenu></menuchoice>
	  menu, or use the context menu that can be displayed pressing
	  the right mouse button on the name of the catalog in the
	  catalog list.</para>
        </listitem>
        </orderedlist>
        </para>
    </sect2>
    <sect2 id="gthumb-library-create">
    <title>To Create a Library of Catalogs</title>
        <para> To create a library of catalogs, perform the
        following steps:
        <orderedlist>
        <listitem>
          <para>Set the catalogs view (described in <xref
          linkend="gthumb-catalog-view"/>). </para>
        </listitem>
        <listitem>
          <para>Choose 
	  <menuchoice><guimenu>File</guimenu><guimenuitem>New
	  Library</guimenuitem></menuchoice>.</para>
        </listitem>
        <listitem>
          <para>Enter the library name and click on
          <guibutton>Ok</guibutton>.  &gthumb; creates the library.</para>
        </listitem>
        </orderedlist>
        </para>
    </sect2>
  </sect1>

  <!-- ============= Find ================================== -->

  <sect1 id="gthumb-finding">
    <title>Finding Images</title>
    <sect2 id="gthumb-find">
    <title>To Find Images</title>
      <para>To find images on your hard disk choose
      <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find</guimenuitem></menuchoice>.
      &gthumb; displays the <guilabel>Find</guilabel> dialog.</para>
     <sect3 id="gthumb-simple-search">
     <title>To Do a Simple Search</title>
      <para>
	From the <guilabel>Find</guilabel> dialog
	you can specify a file name or a pattern in the <guilabel>File name
	</guilabel> entry.
      </para>
      <para>
        Examples:
      <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="50.00*"/>
          <colspec colname="COLSPEC1" colwidth="50.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Value</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Explanation</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry><para>
                <userinput>foo.jpg</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images named <filename>foo.jpg</filename>
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>*.png</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images with the
                <filename>png</filename> extension. 
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>*.gif; *.jpg</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images with the
                <filename>gif</filename> or <filename>jpg</filename>
                extension. 
              </para></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      </para>
        <para>
          Click on <guibutton>Search</guibutton> to start the search.
	  Once the search has finished you will see the list of images 
	  that matches your search, if you want to see these images
	  click on <guibutton>View</guibutton>, if you want to make another 
	  search click on <guibutton>New Search</guibutton>.
	</para>
	<para>
	  If you choose to view the images, a catalog named <guilabel>Search 
	  Results</guilabel> will be created and visualized automatically.  
	  A catalog created in this way has a special icon, a magnifier, this
	  is
	  because on this type of catalogs you can perform two more operations:
	  <guibutton>Edit Search</guibutton> and <guibutton>Redo Search
	  </guibutton>.

	  These operations can be selected from the
	  <menuchoice><guimenu>File</guimenu><guisubmenu>Catalog</guisubmenu></menuchoice>
	  menu, or from the menu that pops up when pressing the right
	  mouse button on the catalog name. 
        </para>
        <para>
	  The <guilabel>Edit Search</guilabel> command lets you re-edit 
	  the search rules, while <guilabel>Redo Search</guilabel> lets
	  you restart the search, at the end of the search you can
	  decide whether to save the result in the catalog or not.
        </para>
      </sect3>

      <sect3 id="gthumb-other-search-opt">
      <title>Other Search Options</title>
          <variablelist> 
	  <varlistentry>
            <term><guilabel>Start at</guilabel></term>
	    <listitem>
	      <para>The folder where the search will start from.
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
            <term><guilabel>Include sub-folder</guilabel></term>
	    <listitem>
	      <para>
	        Whether to search even in the sub folders.
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
            <term><guilabel>Comment</guilabel></term>
	    <listitem>
	     <para>
	      A list of phrases the comment of the image must contain.
      </para>
      <para>
	Examples:
      </para>
      <para>
      <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="50.00*"/>
          <colspec colname="COLSPEC1" colwidth="50.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Value</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Explanation</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry><para>
                <userinput>paolo</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images that have "paolo" in the comment.
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>my birthday</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images that have "paolo" in the comment.
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>holiday ; rome</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images that have "holiday" OR
                "rome" in the comment. 
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>holiday in rome; my birthday</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images that have "holiday in rome"
		OR "my birthday" in the comment.
              </para></entry>
            </row>

          </tbody>
        </tgroup>
      </informaltable>

	     </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
            <term><guilabel>Place</guilabel></term>
	    <listitem>
	    <para>
	    A list of phrases the place field of the comment must
	    contain. 
         </para>
         <para>
	    Examples:
         </para>

         <para>
      <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="50.00*"/>
          <colspec colname="COLSPEC1" colwidth="50.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Value</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Explanation</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry><para>
                <userinput>rome</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images that have "rome" in the
                place field. 
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>paris; rome; london</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images that have "paris" OR
                "rome" OR "london" in the place field. 
                place field. 
              </para></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
            </para>
	  </listitem>

	  </varlistentry>
	  <varlistentry>
	    <!-- -->
            <term><guilabel>Date</guilabel></term>
	    <listitem>
	    <para>
	      The criteria the date field of the comment must respect:

	    <itemizedlist>
	      <listitem>
	        <para>
	        <guilabel>any</guilabel>: the date field is ignored.
	        </para>
              </listitem>

	      <listitem>
	        <para>
	        <guilabel>before, equal to, after</guilabel>: the date must be  less recent, equal to or more recent than the date specified.
	        </para>
              </listitem>

	    </itemizedlist>

	    </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <!-- -->
            <term><guilabel>Categories</guilabel></term>
	    <listitem>
	    <para>
	    The list of categories an images must belong to. 
	    Categories can be added to images using the
	    <menuchoice><guimenu>Edit</guimenu><guimenuitem>Categories</guimenuitem></menuchoice>
	    command or pressing
	    <keycombo><keycap>K</keycap></keycombo>. 
            </para>
	    <para>
	      You can choose to search for images that belongs to all
	      the specified categories or at least to one of them,
	      checking the corresponding option.
	    </para>
            <para>
	      Examples:
            </para>
      <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="50.00*"/>
          <colspec colname="COLSPEC1" colwidth="50.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Value</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Explanation</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry><para>
                <userinput>family</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images with "family" as one of their keywords.
              </para></entry>
            </row>
            <row valign="top">
              <entry><para>
                <userinput>me; family</userinput>
              </para></entry>
              <entry align="left"><para>
                &gthumb; searches for images with "family" and/or "me"
                in the keywords list. 
              </para></entry>
            </row>

          </tbody>
        </tgroup>
      </informaltable>
	    </listitem>
	  </varlistentry>
          </variablelist> 
        <para>
          <note>
            <title>NOTE</title>
            <para>
              If you use more than one criteria images must respect
              all of them. 
            </para>
          </note>
          <note>
            <title>NOTE</title>
            <para>
	       The search is always case insensitive.
            </para>
          </note>
        </para>
      </sect3>

     </sect2>
     <sect2 id="gthumb-find-dup">
     <title>To Find Duplicated Images</title>
     <para>
       To find duplicated images, choose
       <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find
       Duplicates</guimenuitem></menuchoice>.
     </para>
     </sect2>
  </sect1>

  <!-- ============= Slideshow ================================== -->

    <sect1 id="slideshow">
      <title>Slide Shows</title>
      <para>
        You can start a slide show of the images in the current folder by
	pressing <keycombo action="simul"><keycap>S</keycap></keycombo> or 
	selecting the <menuchoice><guimenu>View
	</guimenu><guimenuitem>Slide Show</guimenuitem></menuchoice> menu item.
        To stop the slide show press <keycombo action="simul">
	<keycap>S</keycap></keycombo> again.
      </para>
      <para>
        Switching on/off the full screen mode does not stop the
        slide show.  If the <guilabel>Switch to full screen</guilabel> option
        is on then the slide show is started in
        fullscreen mode and exiting from the fullscreen mode stops the
        slide show. 
      </para>
      <para>
        The slide show is interrupted when you change folder or re-load the
	current one.
      </para>
      <para>
        With the slideshow tool and the fullscreen mode you can do
        presetations. There are two types of presentations: automatic
        presentations and manual presentations. 
      </para>
      <sect2 id="gthumb-auto-presentation">
      <title>How To Do an Automatic Presentation</title>
      <para>To do an automatic presentation, perform the following
      steps:</para>
      <orderedlist>
        <listitem>
          <para>Go to the folder or catalog containing the images you
          want to present.</para>
        </listitem>
        <listitem>
          <para>Choose
          <menuchoice><guimenu>View</guimenu><guimenuitem>Slide Show
          </guimenuitem></menuchoice> or press <keycombo action="simul">
	  <keycap>S</keycap></keycombo>. &gthumb; starts an automatic
          presentation of the images catained in the folder or
          catalog. 
          </para>
        </listitem>
      </orderedlist>
      <para>
        To stop the presentation press <keycombo action="simul">
	<keycap>S</keycap></keycombo> or <keycombo action="simul">
	<keycap>Q</keycap></keycombo> or <keycombo action="simul">
	<keycap>Esc</keycap></keycombo>.
      </para>
      <para>
        The slide show behaviour can be personalized from the
        <guilabel>Preferences</guilabel> dialog in the <xref
        linkend="preferences-slideshow"/>
      </para>
      </sect2>
      <sect2 id="gthumb-manual-presentation">
      <title>How To Do a Manual Presentation</title>
      <para>To do a manual presentation, perform the following steps:</para> 
      <orderedlist>
        <listitem>
          <para>Go to the folder or catalog containing the images you
          want to present.</para>
        </listitem>
        <listitem>
          <para>Select the image from which you want to start the presentation.
          </para>
        </listitem>
        <listitem>
          <para>Press <keycombo action="simul">
	  <keycap>F</keycap></keycombo>. &gthumb; displays the image
	  in fullscreen mode.
          </para>
        </listitem>
        <listitem>
          <para>Press <keycombo action="simul">
	  <keycap>Space</keycap></keycombo> or <keycombo action="simul">
	  <keycap>N</keycap></keycombo>. &gthumb; displays the next image.
          </para>
        </listitem>
        <listitem>
          <para>Press <keycombo action="simul">
	  <keycap>BackSpace</keycap></keycombo> or <keycombo action="simul">
	  <keycap>B</keycap></keycombo>. &gthumb; displays the previuos image.
          </para>
        </listitem>
      </orderedlist>
      <para>
        To stop the presentation press <keycombo action="simul">
	<keycap>Q</keycap></keycombo> or <keycombo action="simul">
	<keycap>Esc</keycap></keycombo>.
      </para>
      </sect2>
    </sect1>

  <!-- ============= Tools ================================== -->
  <sect1 id="gthumb-tools">
  <title>Advanced Tools</title>

    <sect2 id="gthumb-wallpaper">
      <title>To Set the Desktop Wallpaper</title>
      <para>
        If you want to set an image as desktop wallpaper, select the
	image and choose the
	menu <menuchoice><guimenu>Tools</guimenu><guisubmenu>Set Image
	as Wallpaper</guisubmenu></menuchoice>.  This menu contains
	the following items:
        <itemizedlist>
	  <listitem>
	    <para><guilabel>Centered</guilabel>: The image will be centered on
	      the screen.</para>
	  </listitem>
	  <listitem>
	    <para><guilabel>Tiled</guilabel>: The image will be duplicated on
	      the screen as tiles on the floor.</para>
	  </listitem>
	  <listitem>
	    <para><guilabel>Scaled</guilabel>: The image will be scaled to fill 
	      the screen mantaining the aspect ratio.</para>
	  </listitem>
	  <listitem>
	    <para><guilabel>Stretched</guilabel>: The image will be scaled to 
	      fill the screen changing proportions if needed.</para>
	  </listitem>
	</itemizedlist>
      </para>
      <para>
         If you want to restore the old wallpaper choose 
	 <menuchoice>
	   <guimenu>Tools</guimenu>
           <guisubmenu>Set Image as Wallpaper</guisubmenu> 
           <guimenuitem>Restore</guimenuitem>
         </menuchoice>.
       </para>
    </sect2>
    <sect2 id="gthumb-rotate-jpeg">
      <title>To Rotate Images Without Loss of Quality</title>
      <para>
        Usually if you want to rotate an image you have to open the image with
        an editor, rotate the image and save it.  This works good for
        image formats such as PNG or GIF, but results in a loss of
        quality for JPEG images.
      </para>
      <para>
        If you want to rotate JPEG images without losing image quality,
	select the images you want to rotate and choose 
	<menuchoice><guimenu>Tools</guimenu><guimenuitem>Rotate
	Images</guimenuitem></menuchoice>.  &gthumb; displays the 
	<guilabel>Rotate Images</guilabel> dialog.
      </para>
      <para>
        Click on <guibutton>Apply</guibutton> to apply the changes.
      </para>
      <para>
        If you check the <guilabel>Adjust photo orientation</guilabel>
        option, an attempt is done to read the current orientation from
        the photo data embedded in the image, if the orientation data is
	found an automatic rotation is applied to the image in order to
	visualize the image in the right orientation.
      </para>
      <para>
        If you check the <guilabel>Apply to all images</guilabel>
        option, the rotation is applied to the
        currently displayed image as well as to all the remaining
        images you have selected;
        otherwise, once the rotation has been performed on the current
        image, the next image in the selection is displayed, and you can
        choose another type of rotation.
      <note>
        <title>NOTE</title>
        <para>
          If you check both the <guilabel>Adjust photo orientation</guilabel>
	  and the <guilabel>Apply to all images</guilabel> options, all the
	  images will be rotated by the value in the photo orientation data.
        </para>
      </note>
      <note>
        <title>NOTE</title>
        <para>
          If the selection contains some non-JPEG images, they are
          rotated as well.
        </para>
      </note>
      </para>
    </sect2>
    <sect2 id="gthumb-convert-format">
      <title>To Convert the Image Format</title>
      <para>
        To convert the image format,
        select the images you want to convert and choose 
        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Convert
        Format</guimenuitem></menuchoice>.
      </para>
      <para>
        The <guilabel>Convert Format</guilabel> dialog offers you the
        following options:
	<itemizedlist>
        <listitem>
          <para>
            <guilabel>Image type</guilabel>: this is the format you want to
            convert images into.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Overwrite mode</guilabel>: a converted image has the
	    same name of the original image except for the extension which is
	    determined by the new format, an image with the new name
	    can already exist in the destination folder, this option lets you
	    decide what to do when such a case occurs.  If you choose
	    <guilabel>skip</guilabel> the new image won't be created;
	    <guilabel>rename</guilabel> will ask you to specify a new name;
	    <guilabel>ask</guilabel> will ask you whether to overwrite the
	    old image or not and <guilabel>overwrite</guilabel> will
	    overwrite the old image without asking.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Remove original</guilabel>: lets you remove the
	    original image.  If an image is not converted because of an
	    error it will not be removed.
	  </para>
        </listitem>
	</itemizedlist>
      </para>
      <para>
        To perform the convertion click on <guibutton>Convert</guibutton>.
      </para>
    </sect2>
    <sect2 id="gthumb-rename-series">
      <title>To Rename a Series of Images</title>
      <para>
        To rename a series of images specifing a name template, choose
        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Rename
        Series</guimenuitem></menuchoice>.
      </para>
      <para>
        The name template is simply a name that must be used for all
        of the images,  furthermore you can use some special characters
        to make the new names differ each other:
      </para>
        <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="50.00*"/>
          <colspec colname="COLSPEC1" colwidth="50.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Symbol</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Description</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry>
                <para><keycap>#</keycap></para></entry>
              <entry align="left">
                <para>This symbol will be replaced with
                the value of a counter that increments itself by 1
	        passing from one image to another.  If you specify 
	        this symbols in sequence you'll get leading zeros if the
	        counter value has a lesser number of digits, for example ###
	        will produce the sequence: 001, 002, 003, etc..</para></entry>
            </row>
            <row valign="top">
              <entry>
                <para><keycap>%f</keycap></para></entry>
              <entry align="left">
                <para>This symbol will be replaced with the image
                original name.</para></entry>
            </row>
            <row valign="top">
              <entry>
                <para><keycap>%d</keycap></para></entry>
              <entry align="left">
                <para>This symbol will be replaced with the image
                modified date.</para></entry> 
            </row>
            <row valign="top">
              <entry>
                <para><keycap>%s</keycap></para></entry>
              <entry align="left">
                <para>This symbol will be replaced with the image
                dimesions.</para></entry> 
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>
        The list at the bottom of the dialog displays how the filenames
        will be renamed.
      </para>
      <para>
        To rename the images click on <guibutton>Rename</guibutton>.
      </para>
      <para>
        If the renaming of an image can overwrite an already existing
        image you will be asked how to proceed,  five options are
        available: overwrite the image; do not overwrite the image;
        always overwrite; never overwrite; specify a new name. 
      </para>
    </sect2>
    <sect2 id="gthumb-change-date">
      <title>To Change Images Date</title>
      <para>
        If you want to change the last modified date of a series of
        images, select the images and choose <menuchoice><guimenu>
        Tools</guimenu><guimenuitem>Change Date</guimenuitem></menuchoice>.
      </para>
      <para>
        Select the new date.
      </para>
      <para>
        Click on <guibutton>Ok</guibutton>. &gthumb; changes the date.
      </para>
    </sect2>
    <sect2 id="gthumb-index-image">
      <title>To Create an Index Image</title>
      <para>
        An index image is an image that contains small previews of a series of 
	images.  If you want to create an index image select the images you 
	want to insert and choose
	<menuchoice><guimenu>Tools</guimenu><guimenuitem>Create Index
	Image</guimenuitem></menuchoice>. 
      </para>
    </sect2>
    <sect2 id="gthumb-web-album">
      <title>To Create a Web Album</title>
       <para>
         To create a web album, choose
         <menuchoice><guimenu>Tools</guimenu><guimenuitem>Create Web Album
         </guimenuitem></menuchoice>.
       </para>
    </sect2>
    <sect2 id="gthumb-photo">
      <title>To Import Photos from a Digital Camera</title>
       <para>
         To import photos from a digital camera, choose
         <menuchoice><guimenu>File</guimenu><guimenuitem>Import Photos
         </guimenuitem></menuchoice>.
       </para>
    </sect2>
  </sect1>

  <!-- ============= Maintenance ================================== -->
  <sect1 id="maintenance">
      <title>Maintenance</title>
      <para>
        To get access to maintenance operations select choosee
        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Maintenance
	</guimenuitem></menuchoice>.
      </para>
      <para>
        The <guilabel>Maintenance</guilabel> dialog offers the
        following operations:
      </para>
      <para>
        <guilabel>Backup Comments</guilabel>:  With this command you
        can create an archive of all the comments you have writed.
        After pressing the button you have to enter the archive name,
        for example: <filename>comments.tgz</filename>, or 
	<filename>comments.zip</filename>.  The archive is created
        using the application <application>File Roller</application>.
      </para>
      <para>
        <guilabel>Restore Comments From a Backup File</guilabel>:  Use
        this command if
        you want to restore comments previously saved in an archive.
	After pressing the button you have to
        specify the archive where the comments are stored.  The
        archive is extracted using the application  <application>File
        Roller</application>.
      </para>
      <para>
        <guilabel>Delete Old Comments</guilabel>:  If you use
        &gthumb; to delete or move images,
        comments are deleted and moved accordingly.  Other
        applications do not handle image comments so it can happen that
        a comment exists but the relative image does not exist
        anymore. This command lets you delete such comments.
      </para>
      <para>
        <guilabel>Delete ALL Comments</guilabel>:  This command will
        delete all the comments you have written.
      </para>
      <para>
        Thumbnails are small versions of the images you have on your
        disk,  they are used to speed up browsing.  Thumbnails can use
        a lot of space, so in order to save disk space you may wish to
        delete all the thumbnails or only the thumbnails of no more
        existing images.  The commands in the
        <guilabel>Thumbnails</guilabel> section let you do this.
      </para>
  </sect1>

 <!-- ============= Preferences ================================== -->
 <sect1 id="preferences">
  <title>Preferences</title>
  <para>
    To configure &gthumb;, open the
    <guilabel>Preferences</guilabel> dialog by choosing
    <menuchoice><guimenu>Edit</guimenu><guisubmenu>Preferences</guisubmenu>
    </menuchoice>.
  </para>
  <para>
    This dialog contains four tabs described in detail below.  
    At the bottom of the dialog window, you'll find the following buttons:
  </para>
  <itemizedlist>
    <listitem>
      <para><guibutton>Help</guibutton>: shows this manual.
      </para>
    </listitem>
    <listitem>
      <para><guibutton>Close</guibutton>: closes the dialog.
      </para>
    </listitem>
  </itemizedlist>
  <para>
    Keep in mind that when you change an option it will automatically 
    applied,  this is why there is no <guibutton>Ok</guibutton> or
    <guibutton>Apply</guibutton> button.
  </para>

<!-- ########### General Tab ################## -->    
    <sect2 id="preferences-general">
      <title>General Tab</title>
      <para>
	This tab allows you to set the following 
	options:
	</para>
      <itemizedlist>
	<listitem>
	<para>Select the layout of
	  &gthumb; main window, i.e. the
	  positions of directory list window, the image (thumbnail) list
	  window, and the main image viewer window.
	  </para>
	</listitem>
	<listitem>
	  <para>The toolbar style
	  </para>
	</listitem>
	<listitem>
	  <para>Directory to show on startup
	  </para>
	</listitem>
	<listitem>
	  <para>Whether to ask confirmation when an image or a catalog
	  will be deleted.</para>
	</listitem>
	<listitem>
	  <para>Whether to ask to save a modified image.</para>
	</listitem>
      </itemizedlist>
    </sect2>

<!-- ########### Browser Tab ################## -->    
    <sect2 id="preferences-browser">
      <title>Browser Tab</title>
      <para>
	In this tab, you can configure the following options:
      </para>
      <variablelist>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>Show filenames</guilabel></term>
	  <listitem>
	    <para>This option controls whether &gthumb; should show
	    image filenames.
	    </para>
	  </listitem>
	</varlistentry>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>Show comments</guilabel></term>
	  <listitem>
	    <para>This option controls whether
	    &gthumb; should show comments
	    (including date and place) in the image list. By default,
	    &gthumb; shows the comment as a caption under the
	    thumbnail.
	    </para>
	  </listitem>
	</varlistentry>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>Show thumbnails</guilabel></term>
	  <listitem>
	    <para>This option (which you can activate simply pressing 
	    <keycombo><keycap>T</keycap></keycombo>) controls whether
	    &gthumb; should show thumbnails.
	    </para>
	  </listitem>
	</varlistentry>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>Other</guilabel></term>
	  <listitem>
	    <para>Here you can choose whether to change folder by
	    doing a single or a double click on the folder name.  The
	    single click can be usefull if you are used to quickly browse your
	    hard disk searching for images.  The default behaviour is to
	    follow the Nautilus file manager policy.
	    Furthermore you can select whether
	    &gthumb; should determine image
	    type by looking at the file extension or by looking at the
	    file content. Determining file type from the content is
	    more reliable (some applications may create files with
	    extension not matching the actual file type) but
	    slower. If you have a fast system, select <guilabel>Determine
	    image type from content</guilabel>.
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>

    </sect2>
<!-- ########### Viewer Tab ################## -->    
    <sect2 id="preferences-viewer">
      <title>Viewer Tab</title>
      <para>This tab contains options for viewer window:
      </para>
      <variablelist>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>After loading an image</guilabel></term>
	  <listitem>
	    <para>Controls initial zoom level to use for an
	    image.   
	    </para>
	  </listitem>
	</varlistentry>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>Transparency type</guilabel></term>
	  <listitem>
	    <para>Controls the background used for partly transparent
	    images. By default the transparent part of the image is
	    replaced the window background color,that is the
	    <guilabel>none</guilabel> option. 
	    </para>
	  </listitem>
	</varlistentry>
        <!-- ########### --> 
	<varlistentry>
	  <term><guilabel>Zoom quality</guilabel></term>
	  <listitem>
	    <para>This controls the method used for showing rescaled 
	    image. Possible choices are high quality (slow on old
	    machines or when viewing big images) and low
	    quality (always fast).
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>

    </sect2>
<!-- ########### Slide Show Tab ################## -->    
    <sect2 id="preferences-slideshow">
      <title>Slide Show Tab</title>
      <para>
	This tab contains the options controlling slide show mode
	(which you can start by selecting
	<menuchoice><guimenu>Tools</guimenu>
	<guisubmenu>Slide Show</guisubmenu></menuchoice> or by using
	<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo> 
	shortcut). The options include direction (forward/backwards/random),
	and delay between images. You can also specify whether the
	slide show should wrap around (i.e., after showing the last
	image start again form the beginning) and automatically switch
	to fullscreen mode. 
      </para>
     </sect2>
  </sect1>

  <!-- ============= Keyboard Shortcuts ================================== -->
  <sect1 id="shortcuts">
  <title>Quick Reference: Keyboard Shortcuts</title>
  <para><xref linkend="gthumb-TBL-keyword-shortcuts-browser"/>, <xref
    linkend="gthumb-TBL-keyword-shortcuts-viewer"/>, <xref
    linkend="gthumb-TBL-keyword-shortcuts-other"/> and <xref
    linkend="gthumb-TBL-keyword-shortcuts-fullscreen"/> provide a quick
    reference for all of the &gthumb; keyword shortcuts.  Look in the
    menus for other shortcuts.</para>  
  <para>
      <note>
        <title>NOTE</title>
        <para>
          When the <guilabel>location</guilabel> entry is focused you
          can use
          <keycombo><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo>
          to display a list of possible location completions. 
        </para>
      </note>
      <note>
        <title>WARNING</title>
        <para>
          When the <guilabel>location</guilabel> entry is focused
          keyword shortcuts are not available.
        </para>
      </note>
  </para>
  <para>
      <table id="gthumb-TBL-keyword-shortcuts-browser" frame="topbot">
      <title>Keyboard shortcuts to navigate folders</title>
      <tgroup cols="3" colsep="1" rowsep="1">
      	<colspec colanme="COLSPEC0" colwidth="50*"/>
	<colspec colanme="COLSPEC1" colwidth="50*"/>
	<colspec colanme="COLSPEC2" colwidth="50*"/>
	<thead>
	  <row valign="top" rowsep="1">
	    <entry colname="COLSPEC0">
	    	<para>Keyboard Shortcut</para></entry>
	    <entry colname="COLSPEC1">
                <para>Description</para></entry>
            <entry colname="COLSPEC2">
                <para>Available in Fullscreen Mode</para></entry>
	  </row>
	</thead>
	<tbody>
	  <row valign="top">
            <entry>
	      <para>
		<keycombo><keycap>n</keycap></keycombo> or
	        <keycombo action="simul"><keycap>Space</keycap></keycombo> or
		<keycombo action="simul"><keycap>Page Down</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View the next image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>b</keycap></keycombo> or
		<keycombo><keycap>p</keycap></keycombo> or
		<keycombo><keycap>Backspace</keycap></keycombo> or
		<keycombo action="simul"><keycap>Page Up</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View the previous image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Home</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View the first image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>End</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View the last image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Alt</keycap><keycap>Home
		</keycap></keycombo> or
	        <keycombo action="simul"><keycap>h</keycap></keycombo> 
	      </para>
	    </entry>
            <entry>
	      <para>Go to your Home folder.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row>
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Alt</keycap><keycap>Left
		</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Go to the previously visited folder.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row>
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Alt</keycap><keycap>Up
		</keycap></keycombo> or
	        <keycombo action="simul"><keycap>u</keycap></keycombo> 
	      </para>
	    </entry>
            <entry>
	      <para>Go up one level.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>Esc</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Interrupt thumbnails creation.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row>
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Ctrl</keycap><keycap>D
		</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Add the current location to the bookmarks.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Return</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View/Hide the browser.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Q</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View/Hide the image properties pane.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>q</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Change the image properties pane content or
	      display the pane if it is not visible.</para> 
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Ctrl</keycap><keycap>1
		</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Set the image preview as the image properties pane
	      content or hide the pane if this content type is already
	      visible.</para> 
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Ctrl</keycap><keycap>2
		</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Set the image exif data as the image properties pane
	      content or hide the pane if this content type is already
	      visible.</para> 
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Ctrl</keycap><keycap>3
		</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Set the image comment as the image properties pane
	      content or hide the pane if this content type is already
	      visible.</para> 
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row>
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>t</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View/Hide the thumbnails.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>F2</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Rename the current image.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>o</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Open the selected images with an application.</para>
	    </entry>
            <entry>
	      <para>no</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>Delete</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Delete the seleceted images.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	</tbody>
      </tgroup>
      </table>
  </para>

  <para>
  </para>

    <table id="gthumb-TBL-keyword-shortcuts-viewer" frame="topbot">
    <title>Keyboard shortcuts to view images</title>
    <tgroup cols="3" colsep="1" rowsep="1">
      	<colspec colanme="COLSPEC0" colwidth="50*"/>
	<colspec colanme="COLSPEC1" colwidth="50*"/>
	<colspec colanme="COLSPEC2" colwidth="50*"/>
	<thead>
	  <row valign="top">
	    <entry colname="COLSPEC0">
              <para>Keyboard Shortcut</para></entry>
	    <entry colname="COLSPEC1">
              <para>Description</para></entry>
	    <entry colname="COLSPEC2">
              <para>Available in Fullscreen Mode</para></entry>
	  </row>
	</thead>
	<tbody>
	  <row valign="top">
            <entry>
	      <para>
	        <keycombo><keycap>v</keycap></keycombo> or
	        <keycombo><keycap>f</keycap></keycombo> or
                <keycombo><keycap>F11</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Set/Unset the full screen mode.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>+</keycap></keycombo> or
		<keycombo><keycap>=</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Zoom in.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>-</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Zoom out.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>1</keycap></keycombo> or
		<keycombo><keycap>z</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Actual size.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>x</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Zoom to fit.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>l</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Flip the image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>m</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Mirror the image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>r</keycap></keycombo> or
	        <keycombo><keycap>]</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Rotate the image clockwise of 90 degrees.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>[</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Rotate the image counter-clockwise of 90 degrees.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>g</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Start/Stop the animation</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>j</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>View the next frame of a stopped animation.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>Arrows</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Scroll the image.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row>
            <entry>
	      <para>
	        <keycombo action="simul"><keycap>Shift</keycap><keycap>Arrows
		</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Scroll the image faster.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	</tbody>
     </tgroup>
   </table>

  <para>
  </para>

  <table id="gthumb-TBL-keyword-shortcuts-other" frame="topbot">
    <title>Other keyboard shortcuts.</title>
    <tgroup cols="3" colsep="0" rowsep="0">
      	<colspec colanme="COLSPEC0" colwidth="50*"/>
	<colspec colanme="COLSPEC1" colwidth="50*"/>
	<colspec colanme="COLSPEC2" colwidth="50*"/>
	<thead>
	  <row valign="top" rowsep="1">
	    <entry colname="COLSPEC0">
                <para>Keyboard Shortcut</para></entry>
	    <entry colname="COLSPEC1">
                <para>Description</para></entry>
            <entry colname="COLSPEC2">
                <para>Available in Fullscreen Mode</para></entry>
	  </row>
	</thead>
	<tbody>
	  <row valign="top">
            <entry>
	      <para>
		<keycombo><keycap>s</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Start/Stop the slideshow.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>c</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Add a comment to the selected images.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>k</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Assign categories to the selected images.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>i</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Hide/Show the image comment and properties</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	</tbody>
     </tgroup>
  </table>
  <para>
  </para>
  <table id="gthumb-TBL-keyword-shortcuts-fullscreen" frame="topbot">
    <title>Keyboard shortcuts available exclusively in fullscreen mode</title>
    <tgroup cols="2" colsep="0" rowsep="0">
      	<colspec colwidth="20.00*"/>
	<colspec colwidth="20.00*"/>
	<thead>
	  <row rowsep="1">
	    <entry><para>Keyboard Shortcut</para></entry>
	    <entry><para>Description</para></entry>
	  </row>
	</thead>
	<tbody>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>Escape</keycap></keycombo> or
	      	<keycombo><keycap>f</keycap></keycombo> or
	      	<keycombo><keycap>v</keycap></keycombo> or
		<keycombo><keycap>F11</keycap></keycombo> or
		<keycombo><keycap>q</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Exit the fullscreen mode.</para>
	    </entry>
	  </row>
	</tbody>
     </tgroup>
  </table>
  </sect1>

</article>
