Revert "Typo fix: s/allows to/allows one to/"
[geeqie.git] / doc / docbook / GuideOptionsBehavior.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="GuideOptionsBehavior">
3     <title>
4       Advanced Behavior Options
5     </title>
6     <para>
7       This section describes the options presented under the Behavior Tab of the preferences dialog.
8     </para>
9     <para/><section id="Delete"><title>
10       Delete
11     </title>
12     <variablelist><varlistentry><term>
13         Confirm file delete
14       </term><listitem><para/></listitem></varlistentry></variablelist>
15     <para>
16       Prompts for confirmation before deleting files.
17     </para>
18     <variablelist><varlistentry><term>
19         Enable Delete key
20       </term><listitem><para/></listitem></varlistentry></variablelist>
21     <para>
22       Disable this to disassociate the delete file function from the Delete key. This option does not effect the Ctrl + D key sequence. May be useful in combination with “confirm file delete”, above, disabled so that accidentally hitting a single key will not result in deleted files.
23     </para>
24     <variablelist><varlistentry><term>
25         Safe Delete
26       </term><listitem><para/></listitem></varlistentry></variablelist>
27     <para>
28       Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.
29     </para>
30     <para>
31       Note: Files moved to the Safe Delete folder are prefixed with a six digit number in the format: <literal>nnnnnn_FILENAME</literal><?db2html element="br"?>
32       This is used by the delete feature to distinguish which files to remove first when clearing space for new files.<?db2html element="br"?>
33       The digit counter increments with each deleted file.
34     </para>
35     <variablelist><varlistentry><term>
36         Folder
37       </term><listitem><para/></listitem></varlistentry></variablelist>
38     <para>
39       The location of the folder used by the Safe Delete feature.
40     </para>
41     <variablelist><varlistentry><term>
42         Maximum size
43       </term><listitem><para/></listitem></varlistentry></variablelist>
44     <para>
45       The size to use for the Safe Delete folder, in megabytes. Note that setting this value to 0 (zero) will disable any limit.
46     </para>
47     <variablelist><varlistentry><term>
48         Clear button
49       </term><listitem><para/></listitem></varlistentry></variablelist>
50     <para>
51       Removes all files contained in the Safe Delete folder.
52     </para>
53     <variablelist><varlistentry><term>
54         View button
55       </term><listitem><para/></listitem></varlistentry></variablelist>
56     <para>
57       Changes the Geeqie main window to display the contents of the Safe Delete folder.
58     </para>
59     <para/></section><section id="Behavior"><title>
60       Behavior
61     </title>
62     <variablelist><varlistentry><term>
63         Rectangular selection in icon view
64       </term><listitem><para/></listitem></varlistentry></variablelist>
65     <para>
66       Enable this to change the selection method used when selecting multiple items in an icon view.
67     </para>
68     <variablelist><varlistentry><term>
69         Descend folders in tree view
70       </term><listitem><para/></listitem></varlistentry></variablelist>
71     <para>
72       This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.
73     </para>
74     <para>
75       Note: Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.
76     </para>
77     <variablelist><varlistentry><term>
78         Show date in directories list view
79       </term><listitem><para/></listitem></varlistentry></variablelist>
80     <para>
81       Enable this to display directory modification date along its name in the list view
82     </para>
83     <variablelist><varlistentry><term>
84         In place renaming
85       </term><listitem><para/></listitem></varlistentry></variablelist>
86     <para>
87       When renaming a single file, this will allow the rename entry to appear directly over the original filename.
88     </para>
89     <variablelist><varlistentry><term>
90         Show "Copy path" menu item
91       </term><listitem><para/></listitem></varlistentry></variablelist>
92     <para>
93       Enable this option to show a "Copy path" menu item in applicable menus.
94     </para>
95     <para>
96       This allows to copy path to files or directories to the clipboard, names are enclosed with double quotes and separated by space.
97     </para>
98     <variablelist><varlistentry><term>
99         Open recent list maximum size
100       </term><listitem><para/></listitem></varlistentry></variablelist>
101     <para>
102       This is the number of entries saved in the recent open file list.
103     </para>
104     <variablelist><varlistentry><term>
105         Drag'n drop icon size
106       </term><listitem><para/></listitem></varlistentry></variablelist>
107     <para>
108       This is the width and height of the icon generated from image and displayed when doing drap'n drop actions. High resolution screens may require to increase this number.
109     </para>
110     <para/></section><section id="Navigation"><title>
111       Navigation
112     </title>
113     <variablelist><varlistentry><term>
114         Progressive keyboard scrolling
115       </term><listitem><para/></listitem></varlistentry></variablelist>
116     <para>
117       This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.
118     </para>
119     <variablelist><varlistentry><term>
120         Mouse wheel scrolls image
121       </term><listitem><para/></listitem></varlistentry></variablelist>
122     <para>
123       The default is for the mouse wheel to change the image, and to scroll the image when Shift is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down Shift will change the image.
124     </para>
125     <variablelist><varlistentry><term>
126         Home button path
127       </term><listitem><para/></listitem></varlistentry></variablelist>
128     <para>
129       This defines the path to use for the "Home" button in the main window. By default or when this field is empty, this is the user's directory.
130     </para>
131     <variablelist><varlistentry><term>
132         Use current
133       </term><listitem><para/></listitem></varlistentry></variablelist>
134     <para>
135       Pressing this button will set the Home button path to the current open directory.
136     </para>
137     <para/></section><section id="Miscellaneous"><title>
138       Miscellaneous
139     </title>
140     <variablelist><varlistentry><term>
141         Custom similarity threshold
142       </term><listitem><para/></listitem></varlistentry></variablelist>
143     <para>
144       This setting is used by the compare method “similarity (custom)”, located in the Find Duplicates window.
145     </para>
146     <para/></section><section id="Debugging"><title>
147       Debugging
148     </title>
149     <variablelist><varlistentry><term>
150         Debug level
151       </term><listitem><para/></listitem></varlistentry></variablelist>
152     <para>
153       This defines the verbosity of debug info sent to console and log window (0 disables the debug output).
154     </para>
155   <para/></section></section>