annotate doc/docbook/GuideOptionsWindow.xml @ 2835:bb44bd76f857

Simplify OSD settings in Preferences Move Overlay Screen Display settings in Preferences from the Windows tab to its own tab. Allow preformatted tags to be set by button click or drag-and-drop.
author Colin Clark <colin.clark@cclark.uk>
date Tue, 02 Oct 2018 13:01:06 +0100
parents 808983eb036e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
2 <section id="GuideOptionsWindow">
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
3 <title>Window Options</title>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
4 <para>This section describes the options presented under the Windows Tab of the preferences dialog.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
5 <section id="State">
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
6 <title>State</title>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
7 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
8 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
9 <term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
10 <guilabel>Remember window positions</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
11 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
12 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
13 <para>This will maintain windows size and position between Geeqie sessions.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
14 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
15 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
16 </variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
17 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
18 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
19 <term>
2453
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
20 <guilabel>Use saved window positions also for new windows</guilabel>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
21 </term>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
22 <listitem>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
23 <para>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
24 A new window opened by menu
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
25 <menuchoice>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
26 <shortcut>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
27 <keycombo>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
28 <keycap>Ctrl</keycap>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
29 <keycap>N</keycap>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
30 </keycombo>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
31 </shortcut>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
32 <guimenu>File</guimenu>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
33 <guimenuitem>New Window</guimenuitem>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
34 </menuchoice>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
35 will use the saved window positions also.
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
36 </para>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
37 </listitem>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
38 </varlistentry>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
39 </variablelist>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
40 <variablelist>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
41 <varlistentry>
7cdaa31d3b45 Documentation update for new options
Colin Clark <cclark@mcb.net>
parents: 2388
diff changeset
42 <term>
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
43 <guilabel>Remember tool state</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
44 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
45 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
46 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
47 Maintains the selection set by
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
48 <menuchoice>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
49 <shortcut>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
50 <keycombo>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
51 <keycap>L</keycap>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
52 </keycombo>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
53 </shortcut>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
54 <guimenu>View</guimenu>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
55 <guimenuitem>File and Folders</guimenuitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
56 <guimenuitem>Float File List</guimenuitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
57 </menuchoice>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
58 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
59 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
60 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
61 </variablelist>
2670
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
62 <variablelist>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
63 <varlistentry>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
64 <term>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
65 <guilabel>Remember dialog window positions</guilabel>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
66 </term>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
67 <listitem>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
68 <para>This will maintain dialog windows size and position between Geeqie sessions.</para>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
69 </listitem>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
70 </varlistentry>
ec21b78a088c Fix #543: Size of dialog windows in the GTK3 version is too small
Colin Clark <colin.clark@cclark.uk>
parents: 2490
diff changeset
71 </variablelist>
2740
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
72 <variablelist>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
73 <varlistentry>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
74 <term>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
75 <guilabel>Show window IDs</guilabel>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
76 </term>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
77 <listitem>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
78 <para>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
79 Show the window ID in the titlebar of each window. When multiple Geeqie windows are opened, this option shows a unique identifier for each window. It may be used in conjunction with the command line option:
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
80 <link linkend="Remotecommands">
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
81 <programlisting>--remote --id:&lt;ID&gt;</programlisting>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
82 </link>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
83 </para>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
84 </listitem>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
85 </varlistentry>
808983eb036e Option to display window ID
Colin Clark <colin.clark@cclark.uk>
parents: 2720
diff changeset
86 </variablelist>
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
87 </section>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
88 <section id="Size">
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
89 <title>Size</title>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
90 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
91 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
92 <term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
93 <guilabel>Fit window to image when tools are hidden/floating</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
94 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
95 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
96 <para>The main window will be resized to accommodate each image's size and proportions when the image pane is the only one visible within the window.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
97 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
98 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
99 </variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
100 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
101 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
102 <term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
103 <guilabel>Limit size when auto-sizing window</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
104 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
105 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
106 <para>This will restrict the maximum size a window can grow to automatically fit an image. The value represents the percentage of the desktop size in width and height.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
107 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
108 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
109 </variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
110 </section>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
111 <section id="FullScreen">
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
112 <title>Full Screen</title>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
113 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
114 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
115 <term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
116 <guilabel>Location</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
117 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
118 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
119 <para>Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
120 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
121 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
122 </variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
123 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
124 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
125 <term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
126 <guilabel>Smooth image flip</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
127 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
128 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
129 <para>This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
130 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
131 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
132 </variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
133 <variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
134 <varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
135 <term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
136 <guilabel>Disable screen saver</guilabel>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
137 </term>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
138 <listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
139 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
140 This option will execute
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
141 <emphasis role="i">xscreensaver-command --deactivate</emphasis>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
142 once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
143 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
144 </listitem>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
145 </varlistentry>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
146 </variablelist>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
147 </section>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 2319
diff changeset
148 </section>