Mon Jun 13 17:31:46 2005 John Ellis <johne@verizon.net>
[geeqie.git] / doc / 10_5_editor_commands.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>Editor Options - 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="20050613;17101000">
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="10_4_filtering.html">Previous</A></P>
20                                 </TD>
21                                 <TD WIDTH=33%>
22                                         <P ALIGN=CENTER>Editors &ndash; Options Explained</P>
23                                 </TD>
24                                 <TD WIDTH=33%>
25                                         <P ALIGN=RIGHT><A HREF="10_6_advanced.html">Next</A></P>
26                                 </TD>
27                         </TR>
28                 </THEAD>
29         </TABLE>
30 </CENTER>
31 <HR>
32 <H1>10.5 Editor Commands</H1>
33 <P>This section describes the options presented under the Editors Tab
34 of the preferences dialog.</P>
35 <P>GQview includes ten entries that can be used for executing other
36 applications or shell commands with the selected image. These
37 commands are accessible by menu and keyboard shortcuts. The keyboard
38 shortcuts use [Control] + [1] through [Control] + [0], which
39 correspond to lines one through ten in the preferences dialog.</P>
40 <P><BR><BR>
41 </P>
42 <P><B>Menu name</B>: This field is used to represent the command in
43 the menus of GQview, it is intended to describe the application or
44 function that results from executing the command in the <U>Command
45 Line</U> field.</P>
46 <P><BR><BR>
47 </P>
48 <P><B>Command Line</B>: This field is the command to execute. Several
49 macros are available to position image file names within the command.
50 If no macro is specified, the behavior will be to append the
51 filenames onto the end of the command (the result will be the same as
52 &ldquo;<I>command %f</I>&rdquo;).</P>
53 <DL>
54         <DL>
55                 <DD>
56                 <TABLE WIDTH=80% BORDER=0 CELLPADDING=4 CELLSPACING=0>
57                         <COL WIDTH=51*>
58                         <COL WIDTH=205*>
59                         <TR VALIGN=TOP>
60                                 <TD WIDTH=20%>
61                                         <P ALIGN=CENTER><B>Macro</B></P>
62                                 </TD>
63                                 <TD WIDTH=80%>
64                                         <P><B>Description</B></P>
65                                 </TD>
66                         </TR>
67                         <TR VALIGN=TOP>
68                                 <TD WIDTH=20%>
69                                         <P ALIGN=CENTER>%f</P>
70                                 </TD>
71                                 <TD WIDTH=80%>
72                                         <P>Inserts list of selected files, may occur only once.</P>
73                                 </TD>
74                         </TR>
75                         <TR VALIGN=TOP>
76                                 <TD WIDTH=20%>
77                                         <P ALIGN=CENTER>%p</P>
78                                 </TD>
79                                 <TD WIDTH=80%>
80                                         <P>Command is executed once for each selected file, may occur
81                                         multiple times.</P>
82                                 </TD>
83                         </TR>
84                         <TR VALIGN=TOP>
85                                 <TD WIDTH=20%>
86                                         <P ALIGN=CENTER>%v</P>
87                                 </TD>
88                                 <TD WIDTH=80%>
89                                         <P>Display the result of the command in an output window. Must
90                                         occur as the first two characters, or immediately after the &ldquo;%w&rdquo;
91                                         macro.</P>
92                                 </TD>
93                         </TR>
94                         <TR VALIGN=TOP>
95                                 <TD WIDTH=20%>
96                                         <P ALIGN=CENTER>%V</P>
97                                 </TD>
98                                 <TD WIDTH=80%>
99                                         <P>Like %v above, but when used with %p, only displays output
100                                         window when multiple files are selected; The output of a single
101                                         file is suppressed.</P>
102                                 </TD>
103                         </TR>
104                         <TR VALIGN=TOP>
105                                 <TD WIDTH=20%>
106                                         <P ALIGN=CENTER>%w</P>
107                                 </TD>
108                                 <TD WIDTH=80%>
109                                         <P>Prevent full screen from deactivating when command is
110                                         executed. Must occur as the first two characters.</P>
111                                 </TD>
112                         </TR>
113                 </TABLE>
114         </DL>
115 </DL>
116 <P><BR><BR>
117 </P>
118 <P><B>Help</B> button: Displays reference list of the supported
119 command macros.</P>
120 <P><B>Defaults</B> button: Resets all commands to the default
121 settings, discarding any customizations made by the user.</P>
122 <P><BR><BR>
123 </P>
124 <P><BR><BR>
125 </P>
126 <HR>
127 <CENTER>
128         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
129                 <COL WIDTH=85*>
130                 <COL WIDTH=85*>
131                 <COL WIDTH=85*>
132                 <THEAD>
133                         <TR VALIGN=TOP>
134                                 <TD WIDTH=33%>
135                                         <P><A HREF="10_4_filtering.html">Previous</A></P>
136                                 </TD>
137                                 <TD WIDTH=33%>
138                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
139                                 </TD>
140                                 <TD WIDTH=33%>
141                                         <P ALIGN=RIGHT><A HREF="10_6_advanced.html">Next</A></P>
142                                 </TD>
143                         </TR>
144                 </THEAD>
145                 <TBODY>
146                         <TR VALIGN=TOP>
147                                 <TD WIDTH=33%>
148                                         <P><BR>
149                                         </P>
150                                 </TD>
151                                 <TD WIDTH=33%>
152                                         <P ALIGN=CENTER><BR>
153                                         </P>
154                                 </TD>
155                                 <TD WIDTH=33%>
156                                         <P ALIGN=RIGHT>GQview User Manual</P>
157                                 </TD>
158                         </TR>
159                 </TBODY>
160         </TABLE>
161 </CENTER>
162 <P STYLE="margin-bottom: 0in"><BR>
163 </P>
164 </BODY>
165 </HTML>