[libexif-cvs] exif exif.1,1.5,1.6

[Dan F. <dfa...@us...>]

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"