view doc/reference_management.html @ 1090:6ca88a8380d4

Fix a segfault occuring when searching for comments in a directory where at least one photo doesn't have a comment. The fix modifies comment_read() function to return FALSE when a comment doesn't exist. Patch by Omari Stephens.
author zas_
date Tue, 04 Nov 2008 17:26:46 +0000
parents f00c0c5e6dff
children 31a1a3f85859
line wrap: on
line source

<?xml version="1.0" encoding="iso-8859-1"?>

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />

  <title>Cache and Data Management - Geeqie User Manual</title>
<style type="text/css">
/*<![CDATA[*/
 p.previous {text-align: left}
 p.gq-management-10 {margin-bottom: 0in}
 span.gq-management-9 {font-weight: medium}
 span.gq-management-8 {font-style: normal}
 p.gq-management-7 {font-weight: bold}
 p.gq-management-6 {margin-left: 1.58in}
 p.gq-management-5 {margin-left: 0.79in}
 div.gq-management-4 {text-align: center}
 table.gq-management-3 {page-break-before: always}
 p.gq-management-2 {text-align: right}
 p.gq-management-1 {text-align: center}
/*]]>*/
</style>
</head>

<body lang="en-US" dir="ltr">
  <div class="gq-management-4">
    <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-management-3">

      <thead>
        <tr valign="top">
          <td width="33%">
            <p class="previous"><a href="reference_thumbnails.html">Previous</a>
            </p>
          </td>

          <td width="33%">
            <p class="gq-management-1">Cache and Data Management &ndash; Reference</p>
          </td>

          <td width="33%">
            <p class="gq-management-2"><a href="credits.html">Next</a>
            </p>
          </td>
        </tr>
      </thead>
    </table>
  </div>

  <hr />

  <h1>Cache and Data Maintenance</h1>

  <p>Thumbnails and other cached data can be maintained from the dialog accessible by selecting Thumbnail maintenance from the Edit menu of the main window.</p>

  <p><br />
  <br />
  </p>

  <h2>Geeqie thumbnail cache</h2>

  <p class="gq-management-5">The utilities listed here operate on the Geeqie caching mechanism. This also includes the data cached for the <a href="image_search_search.html">search</a> and <a href="image_search_finding_duplicates.html">find duplicates</a> utilities.</p>

  <p class="gq-management-5"><b>Clean up</b>: Removes thumbnails and data for which the source image is no longer present, or has been modified since the thumbnail was generated.</p>

  <p class="gq-management-5"><b>Clear cache:</b> Removes all thumbnails and data stored in the user's home folder: $HOME/.geeqie/thumbnails.</p>

  <p><br />
  <br />
  </p>

  <h2>Shared thumbnail cache</h2>

  <p class="gq-management-5">The utilities listed here operate on the shared thumbnail mechanism.</p>

  <p class="gq-management-5"><b>Clean up:</b> Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</p>

  <p class="gq-management-5"><b>Clear cache:</b> Removes all thumbnails stored in the user's home folder: $HOME/.thumbnails.</p>

  <p><br />
  <br />
  </p>

  <h2>Create thumbnails</h2>

  <p class="gq-management-5">This utility will render thumbnails using the current thumbnail caching mechanism, as determined in <a href="options_general.html">preferences</a>.</p>

  <p class="gq-management-5"><b>Render:</b> Pre-render thumbnails for a specific folder, the utility has the following options:</p>

  <p class="gq-management-6"><b>Include subfolders:</b> Enable to include all images contained in the subfolders of folder.</p>

  <p class="gq-management-6"><b>Store thumbnails local to source images:</b> The generated thumbnails will be stored local to the source images, if you have the permissions to write to the folder containing the images.</p>

  <p><br />
  <br />
  </p>

  <h2>Metadata</h2>

  <p class="gq-management-5">This utility operates on the data store for <a href="sidebars_keywords.html">keywords and comments</a> located in the user's home folder: $HOME/.geeqie/metadata.</p>

  <p class="gq-management-5"><b>Clean up:</b> Removes keywords and comments for which the source image is no longer present.</p>

  <p><br />
  <br />
  </p>

  <h2>File locations</h2>

  <p class="gq-management-5">The various file locations and their use are listed below. <i>&lt;HOME&gt;</i> refers to your home folder and <i>&lt;SOURCE&gt;</i> refers to the folder containing the image.</p>

  <div class="gq-management-4">
    <table width="80%" border="1" cellpadding="4" cellspacing="0">

      <tr valign="top">
        <th width="50%">
          <p>Folder or File name</p>
        </th>

        <th width="50%">
          <p>Description</p>
        </th>
      </tr>

      <tr>
        <td colspan="2" width="100%" valign="top">
          <p class="gq-management-7">Thumbnails</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.thumbnails</p>
        </td>

        <td width="50%">
          <p>Shared thumbnail cache folder.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie/thumbnails</p>
        </td>

        <td width="50%">
          <p>Classic Geeqie thumbnail cache folder. Also used to cache data used for the search and find duplicates utilities to increase the speed for subsequent searches.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;SOURCE&gt;/.</i><span class="gq-management-8">thumbnails</span>
          </p>
        </td>

        <td width="50%">
          <p>Local thumbnail cache folder.</p>
        </td>
      </tr>

      <tr>
        <td colspan="2" width="100%" valign="top">
          <p><b>Metadata</b> <span class="gq-management-9">(keywords and comments)</span></p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie/metadata</p>
        </td>

        <td width="50%">
          <p>Metadata stored in user's home folder.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;SOURCE&gt;</i>/.metadata</p>
        </td>

        <td width="50%">
          <p>Metadata stored local to source image. Requires option to be enabled in advanced preferences.</p>
        </td>
      </tr>

      <tr>
        <td colspan="2" width="100%" valign="top">
          <p class="gq-management-7">Collections</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie/collections</p>
        </td>

        <td width="50%">
          <p>Default location for Geeqie collections, collections in this folder will appear in the <a href="sidebars_sort_manager.html">sort manager</a> sidebar.</p>
        </td>
      </tr>

      <tr>
        <td colspan="2" width="100%" valign="top">
          <p class="gq-management-7">Preferences</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie</p>
        </td>

        <td width="50%">
          <p>Geeqie preferences folder.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie/geeqierc</p>
        </td>

        <td width="50%">
          <p>Geeqie preferences rc file.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie/history</p>
        </td>

        <td width="50%">
          <p>Historic data such as last several folders visited, bookmarks, and recently used collections. Also contains default print settings.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><i>&lt;HOME&gt;</i>/.geeqie/accels</p>
        </td>

        <td width="50%">
          <p>Keyboard shortcut mapping.</p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p class="gq-management-7">Safe Delete</p>
        </td>

        <td width="50%">
          <p><br />
          </p>
        </td>
      </tr>

      <tr valign="top">
        <td width="50%">
          <p><span class="gq-management-9"><i>&lt;HOME&gt;</i></span>/.geeqie/trash</p>
        </td>

        <td width="50%">
          <p>Default location of the safe delete folder.</p>
        </td>
      </tr>
    </table>
  </div>

  <p><br />
  <br />
  </p>

  <p><br />
  <br />
  </p>

  <p><br />
  <br />
  </p>

  <hr />

  <div class="gq-management-4">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">

      <thead>
        <tr valign="top">
          <td width="33%">
            <p class="previous"><a href="reference_thumbnails.html">Previous</a>
            </p>
          </td>

          <td width="33%">
            <p class="gq-management-1"><a href="index.html">Contents</a>
            </p>
          </td>

          <td width="33%">
            <p class="gq-management-2"><a href="credits.html">Next</a>
            </p>
          </td>
        </tr>
      </thead>

      <tbody>
        <tr valign="top">
          <td width="33%">
            <p><br />
            </p>
          </td>

          <td width="33%">
            <p class="gq-management-1"><br />
            </p>
          </td>

          <td width="33%">
            <p class="gq-management-2">Geeqie User Manual</p>
          </td>
        </tr>
      </tbody>
    </table>
  </div>

  <p class="gq-management-10"><br />
  </p>
</body>
</html>