annotate doc/docbook/GuideOptionsGeneral.xml @ 1777:56c019ed8746

Some systems do not have SA_SIGINFO (siginfo_t), like GNU/Hurd, so just test if defined or not. Patch by Michal iha (Bug ID: 2894271).
author zas_
date Fri, 04 Dec 2009 21:01:11 +0000
parents 2ae81598b254
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1773
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
2 <section id="GuideOptionsGeneral">
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
3 <title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
4 General Options
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
5 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
6 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
7 This section describes the options presented under the General Tab of the preferences dialog.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
8 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
9 <para/><section id="Startup"><title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
10 Startup
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
11 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
12 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
13 Restore folder on startup
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
14 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
15 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
16 Enabling this will cause Geeqie to initially open to the specified folder.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
17 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
18 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
19 Use Current
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
20 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
21 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
22 Activate this button to change the setting to the current folder.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
23 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
24 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
25 Use last path
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
26 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
27 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
28 When checked, Geeqie will recall the last path used on startup.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
29 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
30 <para/></section><section id="Thumbnails"><title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
31 Thumbnails
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
32 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
33 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
34 Size
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
35 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
36 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
37 Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
38 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
39 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
40 Quality
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
41 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
42 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
43 Selects the method to use when scaling an image down for thumbnails.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
44 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
45 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
46 Nearest
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
47 </term><listitem><para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
48 Fastest scaler, but results in poor thumbnail quality.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
49 </para></listitem></varlistentry><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
50 Tiles
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
51 </term><listitem><para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
52 Thumbnail results are very close to bilinear, with better speed.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
53 </para></listitem></varlistentry><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
54 Bilinear
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
55 </term><listitem><para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
56 High quality results, moderately fast.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
57 </para></listitem></varlistentry><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
58 Hyper
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
59 </term><listitem><para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
60 Slowest scaler, sometimes gives better results than bilinear.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
61 </para></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
62 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
63 Cache thumbnails
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
64 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
65 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
66 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
67 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
68 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
69 Use shared thumbnail cache
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
70 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
71 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
72 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
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
73 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
74 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
75 Cache thumbnails into .thumbnails
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
76 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
77 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
78 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
79 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
80 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
81 Faster jpeg thumbnailing
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
82 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
83 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
84 This will speed up thumbnails generation in some cases, but may reduce the quality
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
85 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
86 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
87 Use EXIF thumbnails when available
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
88 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
89 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
90 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
91 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
92 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
93 Use xvpics thumbnails when found
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
94 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
95 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
96 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
97 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
98 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
99 Note: Support for xvpics is read only, Geeqie can not generate thumbnails in this format.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
100 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
101 <para/></section><section id="Slideshow"><title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
102 Slide show
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
103 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
104 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
105 Delay between image change
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
106 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
107 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
108 Specifies the delay between images for slide shows, in seconds.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
109 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
110 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
111 Random
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
112 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
113 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
114 When enabled, slide show images will appear in random order.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
115 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
116 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
117 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
118 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
119 <variablelist><varlistentry><term>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
120 Repeat
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
121 </term><listitem><para/></listitem></varlistentry></variablelist>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
122 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
123 When enabled, slide shows will continue at the beginning after the last image is displayed.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
124 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
125 <para/></section></section>