Sync to GQview 1.5.9 release.
[geeqie.git] / doc / 11_4_management.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3 <HEAD>
4         <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
5         <TITLE>Cache and Data Management - GQview User Manual</TITLE>
6         <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3  (Linux)">
7         <META NAME="CREATED" CONTENT="20040805;23590500">
8         <META NAME="CHANGED" CONTENT="20050208;15085100">
9 </HEAD>
10 <BODY LANG="en-US" DIR="LTR">
11 <CENTER>
12         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
13                 <COL WIDTH=85*>
14                 <COL WIDTH=85*>
15                 <COL WIDTH=85*>
16                 <THEAD>
17                         <TR VALIGN=TOP>
18                                 <TD WIDTH=33%>
19                                         <P><A HREF="11_3_thumbnails.html">Previous</A></P>
20                                 </TD>
21                                 <TD WIDTH=33%>
22                                         <P ALIGN=CENTER>Cache and Data Management - Reference</P>
23                                 </TD>
24                                 <TD WIDTH=33%>
25                                         <P ALIGN=RIGHT><A HREF="12_credits.html">Next</A></P>
26                                 </TD>
27                         </TR>
28                 </THEAD>
29         </TABLE>
30 </CENTER>
31 <HR>
32 <H1>11.4 Cache and Data Maintenance</H1>
33 <P>Thumbnails and other cached data can be maintained from the dialog
34 accessible by selecting Thumbnail maintenance from the Edit menu of
35 the main window.</P>
36 <P><BR><BR>
37 </P>
38 <P><U>GQview thumbnail cache</U></P>
39 <P STYLE="margin-left: 0.79in">The utilities listed here operate on
40 the GQview caching mechanism. This also includes the data cached for
41 the <A HREF="5_1_search.html">search</A> and <A HREF="5_2_finding_duplicates.html">find
42 duplicates</A> utilities.</P>
43 <P STYLE="margin-left: 0.79in"><B>Clean up</B>: Removes thumbnails
44 and data for which the source image is no longer present, or has been
45 modified since the thumbnail was generated.</P>
46 <P STYLE="margin-left: 0.79in"><B>Clear cache:</B> Removes all
47 thumbnails and data stored in the user's home folder:
48 $HOME/.gqview/thumbnails.</P>
49 <P><BR><BR>
50 </P>
51 <P><U>Shared thumbnail cache</U></P>
52 <P STYLE="margin-left: 0.79in">The utilities listed here operate on
53 the shared thumbnail mechanism.</P>
54 <P STYLE="margin-left: 0.79in"><B>Clean up:</B> Removes thumbnails
55 for which the source image is no longer present, or has been modified
56 since the thumbnail was generated.</P>
57 <P STYLE="margin-left: 0.79in"><B>Clear cache:</B> Removes all
58 thumbnails stored in the user's home folder: $HOME/.thumbnails.</P>
59 <P><BR><BR>
60 </P>
61 <P><U>Create thumbnails</U></P>
62 <P STYLE="margin-left: 0.79in">This utility will render thumbnails
63 using the current thumbnail caching mechanism, as determined in
64 <A HREF="10_1_general.html">preferences</A>.</P>
65 <P STYLE="margin-left: 0.79in"><B>Render:</B> Pre-render thumbnails
66 for a specific folder, the utility has the following options:</P>
67 <P STYLE="margin-left: 1.58in"><B>Include subfolders:</B> Enable to
68 include all images contained in the subfolders of folder.</P>
69 <P STYLE="margin-left: 1.58in"><B>Store thumbnails local to source
70 images:</B> The generated thumbnails will be stored local to the
71 source images, if you have the permissions to write to the folder
72 containing the images.</P>
73 <P><BR><BR>
74 </P>
75 <P><U>Metadata</U></P>
76 <P STYLE="margin-left: 0.79in">This utility operates on the data
77 store for <A HREF="7_3_keywords.html">keywords and comments</A>
78 located in the user's home folder: $HOME/.gqview/metadata.</P>
79 <P STYLE="margin-left: 0.79in"><B>Clean up:</B> Removes keywords and
80 comments for which the source image is no longer present.</P>
81 <P><BR><BR>
82 </P>
83 <P><U>File locations</U></P>
84 <P STYLE="margin-left: 0.79in">The various file locations and their
85 use are listed below. <I>&lt;HOME&gt;</I> refers to your home folder
86 and <I>&lt;SOURCE&gt;</I> refers to the folder containing the image.</P>
87 <CENTER>
88         <TABLE WIDTH=80% BORDER=1 BORDERCOLOR="#cccccc" CELLPADDING=4 CELLSPACING=0>
89                 <COL WIDTH=128*>
90                 <COL WIDTH=128*>
91                 <TR VALIGN=TOP>
92                         <TH WIDTH=50%>
93                                 <P>Folder or File name</P>
94                         </TH>
95                         <TH WIDTH=50%>
96                                 <P>Description</P>
97                         </TH>
98                 </TR>
99                 <TR>
100                         <TD COLSPAN=2 WIDTH=100% VALIGN=TOP>
101                                 <P><B>Thumbnails</B></P>
102                         </TD>
103                 </TR>
104                 <TR VALIGN=TOP>
105                         <TD WIDTH=50%>
106                                 <P><I>&lt;HOME&gt;</I>/.thumbnails</P>
107                         </TD>
108                         <TD WIDTH=50%>
109                                 <P>Shared thumbnail cache folder.</P>
110                         </TD>
111                 </TR>
112                 <TR VALIGN=TOP>
113                         <TD WIDTH=50%>
114                                 <P><I>&lt;HOME&gt;</I>/.gqview/thumbnails</P>
115                         </TD>
116                         <TD WIDTH=50%>
117                                 <P>Classic GQview thumbnail cache folder. Also used to cache data
118                                 used for the search and find duplicates utilities to increase the
119                                 speed for subsequent searches.</P>
120                         </TD>
121                 </TR>
122                 <TR VALIGN=TOP>
123                         <TD WIDTH=50%>
124                                 <P><I>&lt;SOURCE&gt;/.</I><SPAN STYLE="font-style: normal">thumbnails</SPAN></P>
125                         </TD>
126                         <TD WIDTH=50%>
127                                 <P>Local thumbnail cache folder.</P>
128                         </TD>
129                 </TR>
130                 <TR>
131                         <TD COLSPAN=2 WIDTH=100% VALIGN=TOP>
132                                 <P><B>Metadata</B><SPAN STYLE="font-weight: medium"> (keywords
133                                 and comments)</SPAN></P>
134                         </TD>
135                 </TR>
136                 <TR VALIGN=TOP>
137                         <TD WIDTH=50%>
138                                 <P><I>&lt;HOME&gt;</I>/.gqview/metadata</P>
139                         </TD>
140                         <TD WIDTH=50%>
141                                 <P>Metadata stored in user's home folder.</P>
142                         </TD>
143                 </TR>
144                 <TR VALIGN=TOP>
145                         <TD WIDTH=50%>
146                                 <P><I>&lt;SOURCE&gt;</I>/.metadata</P>
147                         </TD>
148                         <TD WIDTH=50%>
149                                 <P>Metadata stored local to source image. Requires option to be
150                                 enabled in advanced preferences.</P>
151                         </TD>
152                 </TR>
153                 <TR>
154                         <TD COLSPAN=2 WIDTH=100% VALIGN=TOP>
155                                 <P><B>Collections</B></P>
156                         </TD>
157                 </TR>
158                 <TR VALIGN=TOP>
159                         <TD WIDTH=50%>
160                                 <P><I>&lt;HOME&gt;</I>/.gqview/collections</P>
161                         </TD>
162                         <TD WIDTH=50%>
163                                 <P>Default location for GQview collections, collections in this
164                                 folder will appear in the <A HREF="7_2_sort_manager.html">sort
165                                 manager</A> sidebar.</P>
166                         </TD>
167                 </TR>
168                 <TR>
169                         <TD COLSPAN=2 WIDTH=100% VALIGN=TOP>
170                                 <P><B>Preferences</B></P>
171                         </TD>
172                 </TR>
173                 <TR VALIGN=TOP>
174                         <TD WIDTH=50%>
175                                 <P><I>&lt;HOME&gt;</I>/.gqview</P>
176                         </TD>
177                         <TD WIDTH=50%>
178                                 <P>GQview preferences folder.</P>
179                         </TD>
180                 </TR>
181                 <TR VALIGN=TOP>
182                         <TD WIDTH=50%>
183                                 <P><I>&lt;HOME&gt;</I>/.gqview/gqviewrc</P>
184                         </TD>
185                         <TD WIDTH=50%>
186                                 <P>GQview preferences rc file.</P>
187                         </TD>
188                 </TR>
189                 <TR VALIGN=TOP>
190                         <TD WIDTH=50%>
191                                 <P><I>&lt;HOME&gt;</I>/.gqview/history</P>
192                         </TD>
193                         <TD WIDTH=50%>
194                                 <P>Historic data such as last several folders visited, bookmarks,
195                                 and recently used collections. Also contains default print
196                                 settings.</P>
197                         </TD>
198                 </TR>
199                 <TR VALIGN=TOP>
200                         <TD WIDTH=50%>
201                                 <P><I>&lt;HOME&gt;</I>/.gqview/accels</P>
202                         </TD>
203                         <TD WIDTH=50%>
204                                 <P>Keyboard shortcut mapping.</P>
205                         </TD>
206                 </TR>
207                 <TR VALIGN=TOP>
208                         <TD WIDTH=50%>
209                                 <P><B>Safe Delete</B></P>
210                         </TD>
211                         <TD WIDTH=50%>
212                                 <P><BR>
213                                 </P>
214                         </TD>
215                 </TR>
216                 <TR VALIGN=TOP>
217                         <TD WIDTH=50%>
218                                 <P><SPAN STYLE="font-weight: medium"><I>&lt;HOME&gt;</I></SPAN>/.gqview/trash</P>
219                         </TD>
220                         <TD WIDTH=50%>
221                                 <P>Default location of the safe delete folder.</P>
222                         </TD>
223                 </TR>
224         </TABLE>
225 </CENTER>
226 <P><BR><BR>
227 </P>
228 <P><BR><BR>
229 </P>
230 <P><BR><BR>
231 </P>
232 <HR>
233 <CENTER>
234         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
235                 <COL WIDTH=85*>
236                 <COL WIDTH=85*>
237                 <COL WIDTH=85*>
238                 <THEAD>
239                         <TR VALIGN=TOP>
240                                 <TD WIDTH=33%>
241                                         <P><A HREF="11_3_thumbnails.html">Previous</A></P>
242                                 </TD>
243                                 <TD WIDTH=33%>
244                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
245                                 </TD>
246                                 <TD WIDTH=33%>
247                                         <P ALIGN=RIGHT><A HREF="12_credits.html">Next</A></P>
248                                 </TD>
249                         </TR>
250                 </THEAD>
251                 <TBODY>
252                         <TR VALIGN=TOP>
253                                 <TD WIDTH=33%>
254                                         <P><BR>
255                                         </P>
256                                 </TD>
257                                 <TD WIDTH=33%>
258                                         <P ALIGN=CENTER><BR>
259                                         </P>
260                                 </TD>
261                                 <TD WIDTH=33%>
262                                         <P ALIGN=RIGHT>GQview User Manual</P>
263                                 </TD>
264                         </TR>
265                 </TBODY>
266         </TABLE>
267 </CENTER>
268 <P STYLE="margin-bottom: 0in"><BR>
269 </P>
270 </BODY>
271 </HTML>