87a201a23df0f97e0a3ba22c88ff6db73cc4ed16
[geeqie.git] / doc / options_editor_commands.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>Editor Options - Geeqie User Manual</title>
10   <meta name="CREATED" content="20040805;23590500" />
11   <meta name="CHANGED" content="20050613;17101000" />
12 <style type="text/css">
13 /*<![CDATA[*/
14  p.gq-editor-commands-7 {margin-bottom: 0in}
15  p.gq-editor-commands-6 {font-weight: bold}
16  p.gq-editor-commands-5 {font-weight: bold; text-align: center}
17  div.gq-editor-commands-4 {text-align: center}
18  table.gq-editor-commands-3 {page-break-before: always}
19  p.gq-editor-commands-2 {text-align: right}
20  p.gq-editor-commands-1 {text-align: center}
21 /*]]>*/
22 </style>
23 </head>
24
25 <body lang="en-US" dir="ltr" xml:lang="en-US">
26   <div class="gq-editor-commands-4">
27     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-editor-commands-3">
28       <col width="85*" />
29       <col width="85*" />
30       <col width="85*" />
31
32       <thead>
33         <tr valign="top">
34           <td width="33%">
35             <p><a href="options_filtering.html">Previous</a>
36             </p>
37           </td>
38
39           <td width="33%">
40             <p class="gq-editor-commands-1">Editors &ndash; Options Explained</p>
41           </td>
42
43           <td width="33%">
44             <p class="gq-editor-commands-2"><a href="options_advanced.html">Next</a>
45             </p>
46           </td>
47         </tr>
48       </thead>
49     </table>
50   </div>
51
52   <hr />
53
54   <h1>Editor Commands</h1>
55
56   <p>This section describes the options presented under the Editors Tab of the preferences dialog.</p>
57
58   <p>Geeqie includes ten entries that can be used for executing other applications or shell commands with the selected image. These commands are accessible by menu and keyboard shortcuts. The keyboard shortcuts use [Control] + [1] through [Control] + [0], which correspond to lines one through ten in the preferences dialog.</p>
59
60   <p><br />
61   <br />
62   </p>
63
64   <p><b>Menu name</b>: This field is used to represent the command in the menus of Geeqie, it is intended to describe the application or function that results from executing the command in the <u>Command Line</u> field.</p>
65
66   <p><br />
67   <br />
68   </p>
69
70   <p><b>Command Line</b>: This field is the command to execute. Several macros are available to position image file names within the command. If no macro is specified, the behavior will be to append the filenames onto the end of the command (the result will be the same as &ldquo;<i>command %f</i>&rdquo;).</p>
71
72   <dl>
73     <dd>
74       <dl>
75         <dd>
76           <table width="80%" border="0" cellpadding="4" cellspacing="0">
77             <col width="51*" />
78             <col width="205*" />
79
80             <tr valign="top">
81               <td width="20%">
82                 <p class="gq-editor-commands-5">Macro</p>
83               </td>
84
85               <td width="80%">
86                 <p class="gq-editor-commands-6">Description</p>
87               </td>
88             </tr>
89
90             <tr valign="top">
91               <td width="20%">
92                 <p class="gq-editor-commands-1">%f</p>
93               </td>
94
95               <td width="80%">
96                 <p>Inserts list of selected files, may occur only once.</p>
97               </td>
98             </tr>
99
100             <tr valign="top">
101               <td width="20%">
102                 <p class="gq-editor-commands-1">%p</p>
103               </td>
104
105               <td width="80%">
106                 <p>Command is executed once for each selected file, may occur multiple times.</p>
107               </td>
108             </tr>
109
110             <tr valign="top">
111               <td width="20%">
112                 <p class="gq-editor-commands-1">%v</p>
113               </td>
114
115               <td width="80%">
116                 <p>Display the result of the command in an output window. Must occur as the first two characters, or immediately after the &ldquo;%w&rdquo; macro.</p>
117               </td>
118             </tr>
119
120             <tr valign="top">
121               <td width="20%">
122                 <p class="gq-editor-commands-1">%V</p>
123               </td>
124
125               <td width="80%">
126                 <p>Like %v above, but when used with %p, only displays output window when multiple files are selected; The output of a single file is suppressed.</p>
127               </td>
128             </tr>
129
130             <tr valign="top">
131               <td width="20%">
132                 <p class="gq-editor-commands-1">%w</p>
133               </td>
134
135               <td width="80%">
136                 <p>Prevent full screen from deactivating when command is executed. Must occur as the first two characters.</p>
137               </td>
138             </tr>
139           </table>
140         </dd>
141       </dl>
142     </dd>
143   </dl>
144
145   <p><br />
146   <br />
147   </p>
148
149   <p><b>Help</b> button: Displays reference list of the supported command macros.</p>
150
151   <p><b>Defaults</b> button: Resets all commands to the default settings, discarding any customizations made by the user.</p>
152
153   <p><br />
154   <br />
155   </p>
156
157   <p><br />
158   <br />
159   </p>
160
161   <hr />
162
163   <div class="gq-editor-commands-4">
164     <table width="100%" border="0" cellpadding="4" cellspacing="0">
165       <col width="85*" />
166       <col width="85*" />
167       <col width="85*" />
168
169       <thead>
170         <tr valign="top">
171           <td width="33%">
172             <p><a href="options_filtering.html">Previous</a>
173             </p>
174           </td>
175
176           <td width="33%">
177             <p class="gq-editor-commands-1"><a href="index.html">Contents</a>
178             </p>
179           </td>
180
181           <td width="33%">
182             <p class="gq-editor-commands-2"><a href="options_advanced.html">Next</a>
183             </p>
184           </td>
185         </tr>
186       </thead>
187
188       <tbody>
189         <tr valign="top">
190           <td width="33%">
191             <p><br />
192             </p>
193           </td>
194
195           <td width="33%">
196             <p class="gq-editor-commands-1"><br />
197             </p>
198           </td>
199
200           <td width="33%">
201             <p class="gq-editor-commands-2">Geeqie User Manual</p>
202           </td>
203         </tr>
204       </tbody>
205     </table>
206   </div>
207
208   <p class="gq-editor-commands-7"><br />
209   </p>
210 </body>
211 </html>