view doc/docbook/GuideReferenceManagement.xml @ 2566:034d8772d6d8

Fix #500: Geeqie doesn’t use shared thumbnail folder https://github.com/BestImageViewer/geeqie/issues/500
author Colin Clark <colin.clark@cclark.uk>
date Mon, 31 Jul 2017 14:36:29 +0100
parents 4879d0fc9a81
children cad1ce03590d
line wrap: on
line source

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideReferenceManagement">
  <title id="titleGuideReferenceManagement">Cache and Data Maintenance</title>
  <para>
    Thumbnails and other cached data can be maintained from the dialog accessible by selecting
    <menuchoice>
      <guimenu>Edit</guimenu>
      <guimenuitem>Preferences</guimenuitem>
      <guimenuitem>Thumbnail Maintenance</guimenuitem>
    </menuchoice>
    .
  </para>
  <para />
  <section id="Geeqiethumbnailcache">
    <title>Geeqie thumbnail cache</title>
    <para>
      The utilities listed here operate on the Geeqie caching mechanism. This also includes the data cached for the
      <link linkend="GuideImageSearchSearch">search</link>
      and
      <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>
      utilities.
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Clean up</guilabel>
        </term>
        <listitem>
          <para>Removes thumbnails and data for which the source image is no longer present, or has been modified since the thumbnail was generated.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Clear cache</guilabel>
        </term>
        <listitem>
          <para>Removes all thumbnails and data stored in the designated folder.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="Sharedthumbnailcache">
    <title>Shared thumbnail cache</title>
    <para>The utilities listed here operate on the shared thumbnail mechanism.</para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Clean up</guilabel>
        </term>
        <listitem>
          <para>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Clear cache</guilabel>
        </term>
        <listitem>
          <para>Removes all thumbnails stored in the designated folder.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="Createthumbnails">
    <title>Create thumbnails</title>
    <para>
      This utility will render thumbnails using the current thumbnail caching mechanism, as determined in
      <link linkend="GuideOptionsGeneral">Preferences</link>
      .
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Render</guilabel>
        </term>
        <listitem>
          <para>Pre-render thumbnails for a specific folder, the utility has the following options:</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Include subfolders</guilabel>
        </term>
        <listitem>
          <para>Enable to include all images contained in the subfolders of folder.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Store thumbnails local to source images</guilabel>
        </term>
        <listitem>
          <para>The generated thumbnails will be stored local to the source images, if you have the permissions to write to the folder containing the images.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
  <section id="Metadata">
    <title>Metadata</title>
    <para>
      This utility operates on the data store for
      <link linkend="MetadataWritingProcess">Metadata</link>
      located in the folder:
      <programlisting>$HOME/.local/share/Geeqie/metadata</programlisting>
      .
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>Clean up</guilabel>
        </term>
        <listitem>
          <para>Removes keywords and comments for which the source image is no longer present.</para>
          <para />
          <para />
        </listitem>
      </varlistentry>
    </variablelist>
  </section>
</section>