<?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 appversion "2.10.10">
  <!ENTITY manualversion "2.10.10">
  <!ENTITY date "October 2006">
  <!ENTITY appname "gThumb">
  <!ENTITY app "<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>&app; Manual V&manualversion;</title>
    <copyright>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <year>2006</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 role="maintainer">
        <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 -->
    <revhistory>
      <revision>
	<revnumber>&manualversion;</revnumber>
	<date>&date;</date>
	<revdescription>
	  <para role="author">Paolo Bacchilega</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription>
      </revision>
    </revhistory>


    <!-- this is version of manual, not application -->
    <releaseinfo>
      This is manual describes version &appversion; of &appname;
    </releaseinfo>
    <abstract role="description"><para>&app; is an image viewer and browser for the GNOME environment</para></abstract>
  </articleinfo>

  <indexterm>
    <primary>&appname;</primary>
  </indexterm>
  <indexterm>
    <primary>image viewer</primary>
  </indexterm>
  <indexterm>
    <secondary>viewer</secondary>
  </indexterm>

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

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

  <sect1 id="intro">
    <title>Introduction</title>
    <para>
      &app; 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.
    </para>
    <para>
      &app; supports all this formats and many others, it also displays
      GIF animations.
    </para>
    <para>
      &app; 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 &app;, and
    describes the main window interface.
  </para>
  <sect2 id="get-start">
    <title>To Start &app;</title>
    <para>
      You can start &app; 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 &app; 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 &app; 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 &app;</title>
    <para>
    When you start &app; 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"/>
    </screenshot>
    </figure>
    <!-- ==== End of Figure ==== -->

    The &app; <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 &app;</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
	  subfolders 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>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.
    </para>
    <para>
      Other navigation commands are located 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>
      &app; offers the functionalities to manage folders.
      <note>
        <title>WARNING</title>
        <para>
          It's highly suggested to move and copy image folders with
          &app;.  This is because if you move or copy folders with
          &app; 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 lose 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>. &app; 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>. &app;
        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>. &app; 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>. &app; 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>. &app; 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>. &app; 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>. &app; 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><para>
           Select the image.
        </para></listitem>
        <listitem><para>
           View the image pressing <keycap>Return</keycap> or double
           clicking on it.
        </para></listitem>
        <listitem><para>
           Choose
           <menuchoice><guimenu>View</guimenu><guisubmenu>View/Hide</guisubmenu><guimenuitem>Image
           Comment</guimenuitem></menuchoice> or press
           <keycap>I</keycap>. &app; displays the exif data.
        </para></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>Redeye Removal</guimenuitem>
	        </menuchoice>
	      </para>
	    </entry>
            <entry>
	      <para>
	        Remove red eyes caused by poor flashes.
		See <xref linkend="gthumb-redeye"/> for more information.
	      </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"/> for more information.
      </para>
    <sect3 id="gthumb-redeye">
    <title>Redeye Removal</title>
      <para>
      Many inexpensive cameras have a flash that is too close to the camera lens.
      As a result, the light from the flash may travel from the camera and be partially
      reflected by a subject's retina right back into the camera lens. This causes
      "redeye".
      </para>
      <para>
      &app; provides a tool to remove this unwanted redeye. When viewing an image
      with redeye, select <menuchoice><guimenu>Image</guimenu><guimenuitem>Redeye
      Removal</guimenuitem></menuchoice>. A new window will be launched. Move the mouse
      pointer over top a redeye region, and click on or near it. This should remove the
      red region, replacing it with a blacker region. If you are unhappy with the
      result, simply click <guibutton>Undo</guibutton> to revert the previous change (or changes).
      (Clicking <guibutton>Cancel</guibutton> will abandon all changes and close the window.)
      Once you are satisfied with the result, you can click on more redeye regions, or
      click <guibutton>Save</guibutton> or <guibutton>Apply</guibutton> to close the window.
      </para>
      <para>
      If you click <guibutton>Apply</guibutton>, the image must be re-saved in the usual manner after using
      <menuchoice><guimenu>Image</guimenu><guimenuitem>Redeye Removal</guimenuitem></menuchoice>.
      See <xref linkend="gthumb-save-images"/> for more information.
      </para>
      <para>
      <guibutton>Zoom In</guibutton>, <guibutton>Zoom Out</guibutton>, <guibutton>Actual Size</guibutton>,
      and <guibutton>Zoom to Fit</guibutton> buttons are provided to allow you to zoom to and from
      regions of interest. The mouse wheel can also be used to zoom in and out.
      </para>
    </sect3>
    </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>&app; 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>. &app; 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>. &app; 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>. &app; 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>. &app; 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>. &app; 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>. &app; 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>. &app; 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>The image comment is saved in a subfolder of the image
      folder named <filename>.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"/>
      </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 (which is 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>. &app; 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><para>
           Select the image.
        </para></listitem>
        <listitem><para>
           View the image pressing <keycap>Return</keycap> or double
           clicking on it.
        </para></listitem>
        <listitem><para>
           Press <keycap>I</keycap> or  choose
           <menuchoice><guimenu>View</guimenu><guisubmenu>View/Hide</guisubmenu><guimenuitem>Image
           Comment</guimenuitem></menuchoice>.
           &app; displays the image comment.
        </para></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 instead saved
      separately.  This means that if you move images or
      folders with other programs you will lose your comments.
      </para>
    </note>
    <note>
      <title>FOR EXPERTS</title>
      <para>Categories are saved in the subfolder
      <filename>.comments</filename> of the image folder and in the same file
      where the image comment is saved.
      </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>. &app; 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>Save</guibutton>. &app; 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 subfolders.
  </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 &app; 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>. &app; 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
    <filename>$(HOME)/.gnome2/gthumb/collections</filename> folder.
  </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>.
         &app; will display the image folder and will scroll the image list in
         order to make the image visible.
       </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>.  &app; 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>. &app;
	  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>.  &app; 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>.  &app; 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>.
      &app; 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>
                &app; 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>
                &app; 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>
                &app; 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 subfolder</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>
                &app; 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>
                &app; 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>
                &app; 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>
                &app; 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>
                &app; 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>
                &app; 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>
                &app; 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>
                &app; 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>
        If the current selection contains two or more images the slide show will
        be done only with the selected images, otherwise all of the images in
        the current folder or catalog will be showed.
      </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 will stop 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>Select the images you want to view in the slideshow, or select
          none to view all the images in the current folder or catalog.
          </para>
        </listitem>
        <listitem>
          <para>Press <keycombo action="simul">
	  <keycap>S</keycap></keycombo> or choose
          <menuchoice><guimenu>View</guimenu><guimenuitem>Slide Show
          </guimenuitem></menuchoice>. &app; starts an automatic
          presentation of the images.
          </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>. &app; 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>. &app; displays the next image.
          </para>
        </listitem>
        <listitem>
          <para>Press <keycombo action="simul">
	  <keycap>BackSpace</keycap></keycombo> or <keycombo action="simul">
	  <keycap>B</keycap></keycombo>. &app; 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 then save it.  This works well for
        image formats such as PNG or GIF, but results in a loss of
        quality for JPEG images. (The rotation functions in
	<menuchoice><guimenu>Image</guimenu><guimenuitem>Transform</guimenuitem>
	</menuchoice> operate this way - with loss.)
      </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>.  &app; displays the
	<guilabel>Rotate Images</guilabel> dialog.
      </para>
      <para>
        Click on <guibutton>Apply</guibutton> to apply the changes.
        The files are automatically saved after clicking <guibutton>Apply</guibutton>.
      </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 the selection contains some non-JPEG images, they are
          rotated as well. (Not all file formats are supported, however.)
        </para>
      </note>
      </para>
      <para>
        In general, there are two ways to rotate a JPEG image. The first way
        is to re-arrange the pixels inside the image file, using a "physical"
        transform. The second way is to leave the image data alone, and simply
        change the value of the Exif orientation tag inside the header of the JPEG file.
        Not all JPEG files have Exif tags however, and not all applications
        support them. If your image does not have Exif tags, the pixels will
        be re-arranged inside the image file automatically, since that is the only
        possible method.
      </para>
      <para>
        If your image has an Exif orientation tag, and the <guilabel>Apply physical transform</guilabel>
        checkbox is enabled, the physical transform will be used to re-arrange the image
        data, and the Exif orientation tag will be reset to its default value
        of "top left".
      </para>
      <para>
        If your image has an Exif orientation tag, and the <guilabel>Apply physical transform</guilabel>
        checkbox is not enabled, then only the orientation tag will be changed. The
        raw image data itself will not be transformed.
      <note>
        <title>NOTE</title>
        <para>
        For maximum compatibility with other applications, it is recommended that
        the <guilabel>Apply physical transform</guilabel> checkbox normally be enabled
        in both the rotation and import dialogs.
        </para>
      </note>
      </para>
      <para>The physical transform of pixel data inside the JPEG file will not
        degrade image quality (that is, it is lossless) under most conditions.
        However, if the image dimensions (height and width) are not both multiples
        of 8, some data corruption will occur along one or two of the edges of the
        image. If there is an Exif orientation tag, you can avoid this problem
        by disabling the <guilabel>Apply physical transform</guilabel> checkbox.
        If you must use the physical transform approach with
        images whose dimensions are not multiples of 8, &app; will allow you to
        proceed despite with possible image distortion, but it will also ask if you
        would like the trim the image slightly (by up to 7 columns and/or rows
        of pixels) to remove the problem areas.
      </para>
    </sect2>
    <sect2 id="gthumb-reset-exif">
      <title>Resetting the Exif Orientation Tag</title>
      <para>
        The previous section describes how JPEG images can be rotated using two
        methods (physical transforms or Exif orientation tag changes). &app; supports
        both methods properly as of version 2.9.0. Some previous versions
        of &app; auto-rotated images improperly when importing, by performing
        a physical transformation without resetting the Exif orientation tag
        to "top-left". These previous versions ignored the orientation tag when
        displaying the images, so no problem was apparent (although the problem
        was visible if other image viewers were used to view the same images).
        Versions 2.9.0 and later respect this tag, so the incorrect rotation will be visible.
      </para>
      <para>
        The <guilabel>Reset Exif orientation tag</guilabel> tool is provided to fix
        this problem. Simply select the affected images, and apply the
        <guilabel>Reset Exif orientation tag</guilabel> tool. This will reset
        the Exif orientation tag to "top-left".
      </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, so 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 conversion click on <guibutton>Convert</guibutton>.
      </para>
    </sect2>
    <sect2 id="gthumb-scale-series">
      <title>To Scale a Series of Images</title>
      <para>
        To scale multiple images downwards in size,
        select the images you want to scale and choose
        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Scale
	Images</guimenuitem></menuchoice>.
      </para>
      <para>
        The <guilabel>Scale Images</guilabel> dialog offers you the
        following options:
        <itemizedlist>
        <listitem>
          <para>
            <guilabel>Width</guilabel>: The desired maximum width of the scaled
	    images.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Height</guilabel>: The desired maximum height of the scaled
            images.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Keep aspect ratio</guilabel>: If this checkbox is not
            enabled, the image may be stretched by different factors in the
	    horizontal and vertical directions, in order to achieve both
	    the specified width and height. This may result in a distorted
	    image. If this checkbox is enabled, the image will be scaled
	    by the same factor in both directions. The scaling factor will
	    be calculated such that the output width and height are both
	    equal to or less than the values specified in the <guilabel>Width</guilabel>
	    and <guilabel>Height</guilabel> boxes, respectively.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Image type</guilabel>: this is the format you want to
            save the scaled images as.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Overwrite mode</guilabel>: a scaled image has the
            same name of the original image except for the extension which is
            determined by the new format, so 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 scaling click on <guibutton>Scale</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, excluding the extension.</para></entry>
            </row>
            <row valign="top">
              <entry>
                <para><keycap>%e</keycap></para></entry>
              <entry align="left">
                <para>This symbol will be replaced with the image
                original filename extension.</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
                dimensions.</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>. &app; 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, view a folder or a catalog and select the images
	 that you want to include in your album. (The usual selection methods apply -
	 you can click to select one image, shift+click or shift+arrow to expand
	 the selection continuously, ctrl+click to add images one at time, ctrl+A
	 to select everything.) Then use the <menuchoice><guimenu>Tools</guimenu>
	 <guimenuitem>Create Web Album</guimenuitem></menuchoice> function.
       </para>
       <para>
	 The web album will be generated in the  <guilabel>Destination</guilabel>
	 folder. The starting page of the album will be given by the
	 <guilabel>Index file</guilabel> setting - "index.html" is typically
	 used.
       </para>
       <para>
	 All web albums will consist of one or more "index pages" (which show
	 a series of small thumbnail images) and one or more "image pages"
	 (which show a single image at a time). If the <guilabel>Copy originals
	 to destination</guilabel> checkbox is enabled, the photo shown in the
	 image pages will link to a copy of the original image. If you
	 click this link, the raw image will be loaded in your browser (with
	 no accompanying HTML).
       </para>
       <para>
	 If desired, images can be scaled down if they exceed a certain size
	 defined in the <guilabel>Resize if larger than</guilabel> box.
       </para>
       <para>
	 The number of thumbnail images shown on each index page of the web
	 album is controlled by the <guilabel>Size</guilabel> row and column
	 boxes. Alternatively, all images can be forced onto a single index
	 page by enabling the <guilabel>use a single index page</guilabel>
	 checkbox.
       </para>
       <para>
	 Most themes will respect the row and column settings that you specify,
	 because they are based on HTML tables. However other themes (the BestFit
	 theme for example) use Cascading Style Sheets that automatically space
	 the images to make the best possible use of space. (If you resize the
	 browser window, the images will re-position themselves!) These themes
	 will not respect the row and column settings, but they will keep the
	 total number of images per index page to a maximum of ROW x COLUMNS
	 (unless the <guilabel>use a single index page</guilabel> checkbox is
	 enabled).
       </para>
       <para>
         A <guilabel>Header</guilabel> and <guilabel>Footer</guilabel> may be
	 defined. These labels will appear at the top and bottom of every page
	 in the album.  HTML markup may be used in headers and footers, as long
	 every '&gt;', '&lt;', and '&amp;' character is preceeded by a
	 backslash.  For example, "&lt;hr/&gt;" must be written as
	 "\&lt;hr/\&gt;".  Also, the sequence "%d" will be replaced by the
	 current date.  To make a literal backslash ('\') or percent symbol
	 ('%') appear in the output, it must be entered as "\\" or "%%" in the
	 header or footer fields.
       </para>
       <para>
	 A <guilabel>Theme</guilabel> must be specified. The <guilabel>Theme</guilabel>
	 controls the overall appearance of your web album. To select a
         <guilabel>Theme</guilabel>, press the <guibutton>...</guibutton> button
	 and select one from the list. The <guilabel>Thumbnail Caption</guilabel>
	 and <guilabel>Image Caption</guilabel> dialogs allow you to specify
	 what textual information (photo date, image size, camera model, etc)
	 will be displayed next to each image in the index and image pages,
	 respectively.
       </para>
    </sect2>
    <sect2 id="gthumb-import-photos">
      <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>
       <para>
         Several options are presented in the
         <menuchoice><guimenu>File</guimenu><guimenuitem>Import Photos
         </guimenuitem></menuchoice> dialog.
       </para>
       <para>
         The destination folder can be selected through the
         <guilabel>Destination</guilabel> box. The photos will
         be imported into a sub-folder of the <guilabel>Destination</guilabel>
         folder. The name of the sub-folder is set by the
         <guilabel>Film</guilabel> box. If no "Film" folder is specified,
         a sub-folder name consisting of the import data and time will
         be automatically generated.
       </para>
       <para>
         <guilabel>Categories</guilabel> can be specified for the imported
         photos using the <guilabel>Categories</guilabel> box.
       </para>
       <para>
         If the <guilabel>Delete imported images from the camera</guilabel>
         checkbox is enabled, the photos will be deleted from the camera
         after they have been imported.
       </para>
       <para>
         &app; will rename the images (in numerical re-order) when they
 	 are imported, unless the
         <guilabel>Keep original filenames</guilabel> checkbox is selected.
       </para>
       <para>
         If the <guilabel>Rotate images physically</guilabel> checkbox is selected,
         and the imported photo contains an Exif orientation tag, the image data
         will be physically transformed (losslessly) so that the viewed image
         looks the same as before but the orientation tag is reset to "top left".
         If this checkbox is not enabled, the image data and the orientation tag
         are both left unchanged. The image will be displayed identically by
         gthumb for both possibilities, but for maximum compatibility with other
         applications this checkbox should be enabled.
       </para>
       <sect3 id="gthumb-select-camera">
	<title>Selecting the Camera Model</title>
         <para>
         &app; should auto-detect your camera (if it is turned on) when you
         launch the <menuchoice><guimenu>File</guimenu><guimenuitem>Import Photos
         </guimenuitem></menuchoice> dialog. If it does, a camera icon will be
         displayed in the dialog box. If not, a camera with an "X" through it
         will be shown.
         </para>
         <para>
         If the wrong camera has been detected, click the camera icon to select
         a different one. A drop-down box listing all auto-detected cameras will
         be shown. If the <guilabel>Use manual selection instead</guilabel> checkbox
         is enabled, the user can manually set the camera model and port.
         </para>
       </sect3>
    </sect2>
    <sect2 id="gthumb-write-to-cd">
      <title>To Write Images to a CD or DVD</title>
       <para>To write a series of images to a CD or DVD, perform the following steps:
       <orderedlist>
        <listitem>
          <para>Select the images you want to write to and choose
            <menuchoice><guimenu>File</guimenu><guimenuitem>Write to CD
            </guimenuitem></menuchoice>, &app; displays the
            <guilabel>Write to CD</guilabel> dialog.
          </para>
        </listitem>
        <listitem>
          <para>Click on <guilabel>Current folder</guilabel> if you want to
            write all of the images in the current folder and its subfolders.
            Click on <guilabel>Selected images</guilabel> to write the current
            selection only.
          </para>
        </listitem>
        <listitem>
          <para>Click on <guibutton>Ok</guibutton>. &app;, after preparing the
            images for CD/DVD writing, displays the <filename>burn:///</filename>
            location with <guilabel>Nautilus</guilabel>.
          </para>
        </listitem>
        <listitem>
          <para>Click on the <guilabel>Write to CD</guilabel> toolbar button or
            choose
            <menuchoice><guimenu>File</guimenu><guimenuitem>Write to CD
            </guimenuitem></menuchoice>.  Images are written to the CD or DVD.
          </para>
        </listitem>
       </orderedlist>
      </para>
    </sect2>
  </sect1>

 <!-- ============= Preferences ================================== -->
 <sect1 id="preferences">
  <title>Preferences</title>
  <para>
    To configure &app;, 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
	  &app; 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 &app; should show
	    image filenames.
	    </para>
	  </listitem>
	</varlistentry>
        <!-- ########### -->
	<varlistentry>
	  <term><guilabel>Show comments</guilabel></term>
	  <listitem>
	    <para>This option controls whether
	    &app; should show comments
	    (including date and place) in the image list. By default,
	    &app; 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
	    &app; 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 useful 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
	    &app; 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>
        <!-- ########### -->
	<varlistentry>
	  <term><guilabel>Scrollbar positions after using Next/Previous</guilabel></term>
	  <listitem>
	    <para>
	    Depending on the selected zoom level, your images may be larger than the
	    display window. If this happens, vertical and/or horizontal scrollbars will
	    be present, allowing you to view different areas of your image.
	    </para>
	    <para>
	    When you navigate from one image to another using the Next/Previous
	    controls, the positions of the scrollbars can be retained, or they can be
	    reset to the default position.
	    </para>
	    <para>
	    If you are viewing pages of scanned text, for example, you will probably want to
	    set this to <guilabel>Reset to top-left of image</guilabel>, so that the
            top of the page is shown when you move to a new image.
            </para>
	    <para>
	    If you are trying to compare small areas on several large images
	    (perhaps to compare similar images taken at different times, such
	    as photos taken in a "continuous" mode on a digital camera, or
	    satellite images of the same area at different dates)
	    then the <guilabel>Keep same position</guilabel> mode is probably more
	    appropriate for you.
	    </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>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>

<!-- ########### Hot Keys Tab ################## -->
    <sect2 id="preferences-hotkeys">
      <title>Hot Keys Tab</title>
      <para>
	This tab contains the shell script definitions that control the 
	hot keys 0-9 on the numeric keypad.
      </para>
      <para>
	When a user presses one of these keys, an external shell script 
	will be launched. Certain codes can be including in the script.
	These codes will be replaced by &app; when the script is actually
	launched, as follows:
      </para>
      <informaltable frame="all">
        <tgroup cols="2" colsep="1" rowsep="1">
          <colspec colname="COLSPEC0" colwidth="20.00*"/>
          <colspec colname="COLSPEC1" colwidth="80.00*"/>
          <thead>
            <row valign="top">
              <entry colname="COLSPEC0">
                <para>Code</para></entry>
              <entry colname="COLSPEC1" align="left">
                <para>Explanation</para></entry>
            </row>
          </thead>
          <tbody>
            <row valign="top">
              <entry><para>%F</para></entry>
	      <entry align="left"><para>all selected filenames on one line, space delimited</para></entry>
            </row>
            <row valign="top">
              <entry><para>%f</para></entry>
              <entry align="left"><para>a single filename, including path</para></entry>
            </row>
            <row valign="top">
              <entry><para>%n</para></entry>
              <entry align="left"><para>a single filename, including path, with no extension</para></entry>
            </row>
            <row valign="top">
              <entry><para>%e</para></entry>
              <entry align="left"><para>a single extension (starting with a period)</para></entry>
            </row>
            <row valign="top">
              <entry><para>%p</para></entry>
              <entry align="left"><para>the parent folder of the single file</para></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para>
	Scripts with the %F code will be executed just once, regardless of the number of files selected.
	All other scripts will be executed once per selected file.
      </para>
      <para>
      Several default scripts are provided. These can be replaced by the user, if desired. 
      The default scripts are explained below:
      </para>
      <itemizedlist>
	  <listitem>
	    <para>
		<command>gimp %F &amp;</command>
            </para>
	    <para>
		This script tells the GNU Image Manipulation Program (gimp) to open
	        all of the select files. This is most efficient if we include all of
	 	the filenames on one line, rather than calling <command>gimp</command>
		once for each file, so we have used the %F code.
	    </para>
          </listitem>
          <listitem>
            <para>
                <command>convert %f -font Helvetica -pointsize 20 -fill white  -box '#00000080'  -gravity South -annotate +0+5 ' Copyright 2007, Your Name Here ' %n-copyright%e</command>
            </para>
            <para>
                This script makes a copy of your image file, and adds a copyright notice
                to it. The "convert" command is part of the ImageMagick package. If the
                original file is named sample.jpg, the new file will be named sample-copyright.jpg.
            </para>
          </listitem>
          <listitem>
            <para>
                <command>mkdir -p %p/approved ; cp %f %p/approved/</command>
            </para>
            <para>
                This script creates a new sub-folder called "approved", if it does not
                exist already. It then copies the select files to the "approved" sub-folder.
            </para>
          </listitem>
          <listitem>
            <para>
                <command>uuencode %f %f | mail -s Photos your@emailaddress.com</command>
            </para>
            <para>
                This script encodes images files in a format suitable for email attachments,
                and then emails each photo to the specified address. One email per photo is sent.
            </para>
          </listitem>
          <listitem>
            <para>
                <command>rm ~/myarchive.zip; zip -j ~/myarchive %F</command>
            </para>
            <para>
                This script overwrites an existing zip file, if present, with a new zip file
                containing the selected images.
            </para>
          </listitem>
          <listitem>
            <para>
                <command>rm ~/myarchive.zip; zip -j ~/myarchive %F; uuencode ~/myarchive.zip ~/myarchive.zip | mail -s Photos your@emailaddress.com</command>
            </para>
            <para>
                This combines the previous two scripts, so that the selected images are combined into
                a single zip file, which is then emailed.
            </para>
          </listitem>
      </itemizedlist>
     </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 &app; keyword shortcuts.  Look in the
    menus for other shortcuts.</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 colname="COLSPEC0" colwidth="50*"/>
	<colspec colname="COLSPEC1" colwidth="50*"/>
	<colspec colname="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>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>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>g</keycap></keycombo>
              </para>
            </entry>
            <entry>
              <para>Open the selected images with the GIMP, if installed.</para>
            </entry>
            <entry>
              <para>no</para>
            </entry>
          </row>
	  <row rowsep="0">
            <entry>
	      <para>
		<keycombo><keycap>Delete</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Delete the selected 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 colname="COLSPEC0" colwidth="50*"/>
	<colspec colname="COLSPEC1" colwidth="50*"/>
	<colspec colname="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>
	      </para>
	    </entry>
            <entry>
	      <para>Rotate the image clockwise of 90 degrees without saving.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>e</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Rotate the image counter-clockwise of 90 degrees without saving.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>

	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>]</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Rotate and save the image clockwise of 90 degrees.  The rotation is lossless for jpeg images.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>
	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>[</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Rotate and save the image counter-clockwise of 90 degrees.  The rotation is lossless for jpeg images.</para>
	    </entry>
            <entry>
	      <para>yes</para>
	    </entry>
	  </row>

	  <row rowsep="0">
            <entry>
	      <para>
	        <keycombo><keycap>a</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 colname="COLSPEC0" colwidth="50*"/>
	<colspec colname="COLSPEC1" colwidth="50*"/>
	<colspec colname="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>p</keycap></keycombo>
	      </para>
	    </entry>
            <entry>
	      <para>Pause/Resume a slideshow.</para>
	    </entry>
	  </row>
	  <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>
