Update of /cvsroot/libexif/exif
In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv26802
Modified Files:
exif.1
Log Message:
Improved the documentation
Index: exif.1
===================================================================
RCS file: /cvsroot/libexif/exif/exif.1,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -p -d -r1.5 -r1.6
--- exif.1 23 Mar 2005 15:52:19 -0000 1.5
+++ exif.1 24 Jan 2008 21:27:52 -0000 1.6
@@ -14,8 +14,9 @@
.\" License.
.\" Modified 2002-09-08 by thomas
.\" Modified 2005-03-23 by hun
+.\" Modified 2008-01-24 by dfandrich
.\"
-.TH exif 1 "2005-03-23" "" "libexif command line frontend"
+.TH exif 1 "2008-01-24" "" "libexif command line frontend"
.SH "NAME"
exif \- shows EXIF information in JPEG files
.SH "SYNOPSIS"
@@ -29,54 +30,79 @@ Most digital cameras produce EXIF files,
command line utility allows you to read EXIF information from and write EXIF information to those files.
.PP
.B "exif"
-internall uses the
+internally uses the
.B "libexif"
library.
.SH "OPTIONS"
.TP
+.BI "\-v, \-\-version"
+Display the exif version number
+.TP
.BI "\-i, \-\-ids"
-Show IDs instead of tag names
+Show ID numbers instead of tag names
.TP
.BI "\-t, \-\-tag=" "tag"
-Select
+Select only the given EXIF
.I "tag"
+which is the textual short tag name or numeric tag number (hexadecimal
+numbers are prefixed with 0x), from the IFD specified with \-\-ifd
.TP
.BI "\-\-ifd=" "IFD"
Select
.I "IFD"
+where valid IFDs are "0", "1", "EXIF", "GPS", and "Interoperability".
+Defaults to "0".
.TP
.BI "\-l, \-\-list\-tags"
-List all EXIF tags
+List all known EXIF tags. A JPEG file with valid EXIF information must
+be given to use this option, but its contents are ignored.
.TP
.BI "\-|, \-\-show\-mnote"
-Show contents of tag MakerNote
+Show contents of tag MakerNote. The contents of this tag is nonstandard (and
+often undocumented) and may therefore not be recognized, or if it is
+recognized it may not be correctly interpreted.
.TP
.BI "\-\-remove"
-Remove tag or ifd
+Remove tag or entire IFD (if no tag is specified).
.TP
.BI "\-s, \-\-show\-description"
-Show description of tag
+Show description of tag. The \-\-tag option must also be given.
.TP
.BI "\-e, \-\-extract\-thumbnail"
-Extract thumbnail
+Extract thumbnail, writing the thumbnail image to the file specified
+with \-\-output.
.TP
.BI "\-r, \-\-remove\-thumbnail"
-Remove thumbnail
+Remove thumbnail from image, writing the new image to the file specified
+with \-\-output.
.TP
.BI "-n, \-\-insert\-thumbnail=" "FILE"
Insert
.I "FILE"
-as thumbnail
+as thumbnail. No attempt is made to ensure that the contents of "FILE" is
+in a valid thumbnail format.
.TP
.BI "\-o, \-\-output=" "FILE"
-Write output to
-.I "FILE"
+Write output image to
+.IR "FILE" .
+If this option is not given and an image file must be written, the
+name used is the same as the input file with a suffix ".modified.jpeg".
.TP
.BI "\-\-set\-value=" "VALUE"
-Set value
+Set the data for the tag specified with \-\-tag and \-\-ifd to "VALUE".
+Compound values consisting of multiple components are separated with
+spaces.
.TP
.BI "\-m, \-\-machine\-readable"
Output in machine-readable (tab delimited) format
+The \-\-xml-output and \-\-machine\-readable options are mutually exclusive.
+.TP
+.BI "\-x, \-\-xml-output"
+Output in an XML format (when possible).
+The \-\-xml-output and \-\-machine\-readable options are mutually exclusive.
+.TP
+.BI "\-d, \-\-debug"
+Show debugging messages
.SS "Help options"
.TP
.BI "\-?, \-\-help"
|
