Mercurial > bins

comparison doc/bins-edit-gui.sgml @ 0:a84c32f131df 1.1.29

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import vendor version
author Peter Gervai <grin@grin.hu>
date Wed, 15 Oct 2008 23:28:56 +0200
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:a84c32f131df
1 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2
3 <!-- This man page is Copyright 2002 Mark Eichin and released under -->
4 <!-- the GNU General Public License, Version 2. -->
5
6 <!-- Process this file with docbook-to-man to generate an nroff manual
7 page: `docbook-to-man manpage.sgml > manpage.1'. You may view
8 the manual page with: `docbook-to-man manpage.sgml | nroff -man |
9 less'. A typical entry in a Makefile or Makefile.am is:
10
11 manpage.1: manpage.sgml
12 docbook-to-man $< > $@
13
14
15 The docbook-to-man binary is found in the docbook-to-man package.
16 Please remember that if you create the nroff version in one of the
17 debian/rules file targets (such as build), you will need to include
18 docbook-to-man in your Build-Depends control field.
19
20 -->
21
22 <!-- Fill in your name for FIRSTNAME and SURNAME. -->
23 <!ENTITY dhfirstname "<firstname>Mark</firstname>">
24 <!ENTITY dhsurname "<surname>Eichin</surname>">
25 <!-- Please adjust the date whenever revising the manpage. -->
26 <!ENTITY dhdate "<date>June 7, 2002</date>">
27 <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
28 allowed: see man(7), man(1). -->
29 <!ENTITY dhsection "<manvolnum>1</manvolnum>">
30 <!ENTITY dhemail "<email>eichin@thok.org</email>">
31 <!ENTITY dhusername "Mark W. Eichin">
32 <!ENTITY dhucpackage "<refentrytitle>BINS</refentrytitle>">
33 <!ENTITY dhpackage "bins-edit-gui">
34
35 <!ENTITY debian "<productname>Debian</productname>">
36 <!ENTITY gnu "<acronym>GNU</acronym>">
37 <!ENTITY gpl "&gnu; General Public License">
38 ]>
39
40 <refentry>
41 <refentryinfo>
42 <address>
43 &dhemail;
44 </address>
45 <author>
46 &dhfirstname;
47 &dhsurname;
48 </author>
49 <copyright>
50 <year>2002</year>
51 <holder>&dhusername;</holder>
52 </copyright>
53 &dhdate;
54 </refentryinfo>
55 <refmeta>
56 &dhucpackage;
57
58 &dhsection;
59 </refmeta>
60 <refnamediv>
61 <refname>&dhpackage;</refname>
62
63 <refpurpose>Set fields in XML picture description files for BINS
64 (using a GNOME-based GUI)</refpurpose>
65 </refnamediv>
66 <refsynopsisdiv>
67 <cmdsynopsis>
68 <command>&dhpackage;</command>
69 <arg rep="repeat"><replaceable>files</replaceable></arg>
70 </cmdsynopsis>
71 </refsynopsisdiv>
72 <refsect1>
73 <title>DESCRIPTION</title>
74
75 <para>This manual page documents briefly the
76 <command>&dhpackage;</command> command.</para>
77
78 <para><command>&dhpackage;</command> sets values in the XML
79 picture description files that <command>bins</command>(1) uses
80 to generate galleries. It displays the image (scaled down to
81 fit the window) and allows you to fill in the predefined fields
82 (or add new ones.) For command-line editing of the same data,
83 see <command>bins_edit</command>(1).
84 </para>
85 </refsect1>
86 <refsect1>
87 <title>OPTIONS</title>
88 <para>This program follows the usual GNU command line syntax,
89 with long options starting with two dashes (`-'). A summary of
90 options is included below.</para>
91
92 <variablelist>
93 <varlistentry>
94 <term><replaceable>file</replaceable></term>
95 <listitem>
96 <para><replaceable>file</replaceable> is the
97 filename of the image itself.</para>
98 </listitem>
99 </varlistentry>
100 <varlistentry><term><option>-v</option></term><term><option>--version</option></term> <listitem>
101 <para>Displays program version.</para>
102 </listitem>
103 </varlistentry>
104 <varlistentry><term><option>-v</option></term><term><option>--version</option></term> <listitem>
105 <para>Displays program version.</para>
106 </listitem>
107 </varlistentry>
108 <varlistentry><term><option>-h</option></term><term><option>--help</option></term> <listitem>
109 <para>Displays command-line options.</para>
110 </listitem>
111 </varlistentry>
112 <varlistentry><term><option>--debug</option></term> <listitem>
113 <para>Enables random developer debugging messages.</para>
114 </listitem>
115 </varlistentry>
116 </variablelist>
117 </refsect1>
118 <refsect1>
119 <title>COMMANDS</title>
120 <variablelist>
121 <varlistentry>
122 <term><keycode>C-n</keycode> <command>Next file</command></term>
123 <listitem>
124 <para>Save current tags set (if any changes have been made)
125 and move on to the next image.</para>
126 </listitem>
127 </varlistentry>
128 <varlistentry>
129 <term><keycode>M-Page Down</keycode> <command>Forward 10</command></term>
130 <listitem>
131 <para>Save current tags set (if any changes have been made)
132 and skip forward by 10 files.</para>
133 </listitem>
134 </varlistentry>
135 <varlistentry>
136 <term><keycode>C-p</keycode> <command>Previous file</command></term>
137 <listitem>
138 <para>Save current tags set (if any changes have been made)
139 and move back to the previous image.</para>
140 </listitem>
141 </varlistentry>
142 <varlistentry>
143 <term><keycode>M-Page Up</keycode> <command>Back 10</command></term>
144 <listitem>
145 <para>Save current tags set (if any changes have been made)
146 and skip backwards by 10 files.</para>
147 </listitem>
148 </varlistentry>
149 <varlistentry>
150 <term><keycode>M-Home</keycode> <command>Start of List</command></term>
151 <listitem>
152 <para>Save current tags set (if any changes have been made)
153 and jump to the first file.</para>
154 </listitem>
155 </varlistentry>
156 <varlistentry>
157 <term><keycode>M-End</keycode> <command>End of List</command></term>
158 <listitem>
159 <para>Save current tags set (if any changes have been made)
160 and jump to the last file.</para>
161 </listitem>
162 </varlistentry>
163 <varlistentry>
164 <term><keycode>M-a</keycode> <command>Auto-fill</command></term>
165 <listitem>
166 <para>Fill in any blank fields with the values from the most
167 recently seen image. Particularly useful for copying a
168 location or event across a set of images.</para>
169 </listitem>
170 </varlistentry>
171 <varlistentry>
172 <term><command>Revert</command></term>
173 <listitem>
174 <para>Reload tags from the <acronym>XML</acronym> file,
175 wiping unsaved changes.</para>
176 </listitem>
177 </varlistentry>
178 <varlistentry>
179 <term><keycode>C-s</keycode> <command>Save</command></term>
180 <listitem>
181 <para>Save changes, if any.</para>
182 </listitem>
183 </varlistentry>
184 <varlistentry>
185 <term><keycode>F2</keycode> <command>Album</command></term>
186 <listitem>
187 <para>Edit the album this picture is in. (Under
188 construction, but functional.)</para>
189 </listitem>
190 </varlistentry>
191 <varlistentry>
192 <term><keycode>F3</keycode> <command>Open</command></term>
193 <listitem>
194 <para>Not yet implemented. Should provide a file browser later.</para>
195 </listitem>
196 </varlistentry>
197 <varlistentry>
198 <term><keycode>&gt;</keycode> <command>Rotate Right</command></term>
199 <listitem>
200 <para>Rotate image to the Right (Clockwise.) Actually sets
201 the <sgmltag>Orientation</sgmltag> tag with
202 <sgmltag>priority</sgmltag> 1 so that it overrides the
203 corresponding <acronym>EXIF</acronym> tag; it does not
204 modify the image file itself.</para>
205 </listitem>
206 </varlistentry>
207 <varlistentry>
208 <term><command>Cancel rotation</command></term>
209 <listitem>
210 <para>Cancels any current changes to the rotation tags
211 (effectively, this is a "revert" function for the
212 rotation, it doesn't to back to the original
213 <acronym>EXIF</acronym> tags in the
214 <acronym>JPEG</acronym> file.)</para>
215 </listitem>
216 </varlistentry>
217 <varlistentry>
218 <term><keycode>&lt;</keycode> <command>Rotate Left</command></term>
219 <listitem>
220 <para>Rotate image to the Left (Counter Clockwise.) Actually sets
221 the <sgmltag>Orientation</sgmltag> tag with
222 <sgmltag>priority</sgmltag> 1 so that it overrides the
223 corresponding <acronym>EXIF</acronym> tag; it does not
224 modify the image file itself.</para>
225 </listitem>
226 </varlistentry>
227 <varlistentry>
228 <term><keycode>C-q</keycode> <command>Quit</command></term>
229 <listitem>
230 <para>Quit program, saving current changes (if any.)</para>
231 </listitem>
232 </varlistentry>
233 <varlistentry>
234 <term><command>About</command></term>
235 <listitem>
236 <para>Display About box.</para>
237 </listitem>
238 </varlistentry>
239 <varlistentry>
240 <term><command>License</command></term>
241 <listitem>
242 <para>Display License box.</para>
243 </listitem>
244 </varlistentry>
245 </variablelist>
246 </refsect1>
247 <refsect1>
248 <title>EXAMPLES</title>
249 <para>Edit all the images in a directory:
250 <cmdsynopsis>
251 <command>bins-edit-gui $(find bins-picture-dir -name '*.jpg')</command>
252 </cmdsynopsis>
253 </para>
254 </refsect1>
255 <refsect1>
256 <title>SEE ALSO</title>
257
258 <para>bins (1), bins_edit (1).</para>
259
260 </refsect1>
261 <refsect1>
262 <title>AUTHOR</title>
263
264 <para>This manual page was written by &dhusername; &dhemail;.</para>
265
266 </refsect1>
267 </refentry>
268
269 <!-- Keep this comment at the end of the file
270 Local variables:
271 mode: sgml
272 sgml-omittag:t
273 sgml-shorttag:t
274 sgml-minimize-attributes:nil
275 sgml-always-quote-attributes:t
276 sgml-indent-step:2
277 sgml-indent-data:t
278 sgml-parent-document:nil
279 sgml-default-dtd-file:nil
280 sgml-exposed-tags:nil
281 sgml-local-catalogs:nil
282 sgml-local-ecat-files:nil
283 End:
284 -->
285
286