annotate doc/docbook/GuideOptionsGeneral.xml @ 1734:b92fc3c922ac

scripts for converting wiki documentation to docbook

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideOptionsGeneral">
    <title>
      General Options
    </title>
    <para>
      This section describes the options presented under the General Tab of the preferences dialog.
    </para>
    <para/><section id="Startup"><title>
      Startup
    </title>
    <variablelist><varlistentry><term>
        Restore folder on startup
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Enabling this will cause Geeqie to initially open to the specified folder.
    </para>
    <variablelist><varlistentry><term>
        Use Current
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Activate this button to change the setting to the current folder.
    </para>
    <variablelist><varlistentry><term>
        Use last path
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      When checked, Geeqie will recall the last path used on startup.
    </para>
    <para/></section><section id="Thumbnails"><title>
      Thumbnails
    </title>
    <variablelist><varlistentry><term>
        Size
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.
    </para>
    <variablelist><varlistentry><term>
        Quality
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Selects the method to use when scaling an image down for thumbnails.
    </para>
    <variablelist><varlistentry><term>
        Nearest
      </term><listitem><para>
        Fastest scaler, but results in poor thumbnail quality.
      </para></listitem></varlistentry><varlistentry><term>
        Tiles
      </term><listitem><para>
        Thumbnail results are very close to bilinear, with better speed.
      </para></listitem></varlistentry><varlistentry><term>
        Bilinear
      </term><listitem><para>
        High quality results, moderately fast.
      </para></listitem></varlistentry><varlistentry><term>
        Hyper
      </term><listitem><para>
        Slowest scaler, sometimes gives better results than bilinear.
      </para></listitem></varlistentry></variablelist>
    <variablelist><varlistentry><term>
        Cache thumbnails
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Enable this to save thumbnails to disk, subsequent requests for a thumbnail will be faster. Thumbnails are cached into ($HOME)/.geeqie/thumbnails. Refer to <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link> for details.
    </para>
    <variablelist><varlistentry><term>
        Use shared thumbnail cache
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      This will use a thumbnail caching method that is compatible with applications that use the standard thumbnail specification. When this option is enabled thumbnails will be stored in ($HOME)/.thumbnails
    </para>
    <variablelist><varlistentry><term>
        Cache thumbnails into .thumbnails
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      When enabled, Geeqie attempts to store cached thumbnails closer to the source image. This way multiple users can benefit from a single cache, thereby reducing wasted disk space. The resulting location is the source image's folder, in a sub folder with the name <emphasis role="strong">.thumbnails</emphasis>. When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.
    </para>
    <variablelist><varlistentry><term>
        Faster jpeg thumbnailing
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      This will speed up thumbnails generation in some cases, but may reduce the quality
    </para>
    <variablelist><varlistentry><term>
        Use EXIF thumbnails when available
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Geeqie will extract thumbnail from EXIF data if available instead of generating one. This will speed up thumbnails generation but EXIF thumbnail may be not in sync with the image if it was modified by a tool which didn't take care of the thumbnail data.
    </para>
    <variablelist><varlistentry><term>
        Use xvpics thumbnails when found
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      xvpics is a common thumbnail caching format used by several applications. Thumbnails are stored locally to the source image in a sub folder with the name <emphasis role="strong">.xvpics</emphasis>. Enabling this option will allow Geeqie to read thumbnails saved in the xvpics format.
    </para>
    <para>
      Note: Support for xvpics is read only, Geeqie can not generate thumbnails in this format.
    </para>
    <para/></section><section id="Slideshow"><title>
      Slide show
    </title>
    <variablelist><varlistentry><term>
        Delay between image change
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Specifies the delay between images for slide shows, in seconds.
    </para>
    <variablelist><varlistentry><term>
        Random
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      When enabled, slide show images will appear in random order.
    </para>
    <para>
      Note: Random images are displayed such that each image appears once per cycle of all images. When the slide show repeat option is enabled, the image order is randomized after completing each cycle.
    </para>
    <variablelist><varlistentry><term>
        Repeat
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      When enabled, slide shows will continue at the beginning after the last image is displayed.
    </para>
  <para/></section></section>