move & rename manpages

1 files changed, 145 insertions, 0 deletions

diff --git a/man/exiftran.1 b/man/exiftran.1
new file mode 100644
index 0000000..c67400f
--- /dev/null
+++ b/man/exiftran.1
@@ -0,0 +1,145 @@
+.TH EXIFTRAN 1 "(c) 2002-2012 Gerd Hoffmann" "EXIFTRAN 2.09" "Transform digital camera jpeg images"
+\#
+\#
+.SH NAME
+exiftran - transform digital camera jpeg images
+\#
+\#
+.SH SYNOPSIS
+.TP
+\fBexiftran\fP [\fIoptions\fP] \fIfile1 file2 ... fileN\fP
+.TP
+\fBexiftran\fP -i [\fItransform options\fP] [\fIothers options\fP] \fIfile1 file2 ... fileN\fP
+.TP
+\fBexiftran\fP -o \fIoutputfile\fP [\fItransform options\fP] [\fIother options\fP] \fIinputfile\fP
+.TP
+\fBexiftran\fP -d \fIfile1 file2 ... fileN\fP > \fIexifinfo\fP
+\#
+\#
+.SH DESCRIPTION
+.BR Exiftran
+is a command line utility to transform digital camera \fIjpeg\fP images. It can do lossless
+rotations like
+.BR "jpegtran" "(1),"
+but unlike
+.BR "jpegtran" "(1)"
+it cares about the \fIEXIF\fP data: It can rotate images automatically by
+checking the exif orientation tag; it updates the exif informations if needed
+(image dimension, orientation); it also rotates the exif thumbnail. It can
+process multiple images at once.
+\#
+\#
+.SH "TRANSFORM OPTIONS"
+.TP
+.B -a
+Automatic (using exif orientation tag).
+.TP
+.B -9
+Rotate by 90 degrees clockwise.
+.TP
+.B -1
+Rotate by 180 degrees clockwise.
+.TP
+.B -2
+Rotate by 270 degrees clockwise.
+.TP
+.B -f
+Mirror image vertically (top / bottom).
+.TP
+.B -F
+Mirror image horizontally (left to right).
+.TP
+.B -t
+Transpose (across UL-to-LR corner).
+.TP
+.B -T
+Transverse (across UR-to-LL corner).
+.TP
+.B -nt
+Don't transform exif thumbnail.
+.TP
+.B -ni
+Don't transform jpeg image. You might need this or the \fB-nt\fP option to fixup
+things in case you transformed the image with some utility which ignores the
+exif thumbnail. Just generating a new thumbnail with \fB-g\fP is another way to
+fix it.
+.TP
+.B -no
+Don't update the orientation tag. By default
+.BR exiftran
+sets the orientation to "1" (no transformation needed) to avoid other exif-aware
+applications try to rotate the already-rotated image again.
+.TP
+.B -np
+Don't pare lost edges. By default
+.BR exiftran
+don't preserve image size of the images that do not meet a
+multiple of 8 pixels. He prefers to cut a strip of a few pixels rather than
+offering a damaged image. Use this option if you want them all the same.
+\#
+\#
+.SH "OTHER OPTIONS"
+.TP
+.B -h
+Print a short help text.
+.TP
+.B -d
+Dump exif data for the file(s).
+.TP
+.BI "-c" "\ text"
+Set jpeg comment tag to \fItext\fP.
+.TP
+.B -g
+(re)generate exif thumbnail.
+.TP
+.BI "-o" "\ file"
+Specify output \fIfile\fP. Only one input file is allowed in this mode.
+.TP
+.B -i
+Enable in-place editing of the images.
+.BR Exiftran
+allows multiple input files then. You must specify either this option or a
+output file with \fB-o\fP for all operations which modify the image (i.e.
+everything but \fB-d\fP right now).
+.TP
+.B -b
+Create a backup file when doing in-place editing (imply \fB-i\fP).
+.TP
+.B -p
+Preserve timestamps (atime + mtime) when doing in-place editing (imply \fB-i\fP).
+\#
+\#
+.SH EXAMPLES
+Autorotate all jpeg files in the current directory:
+.P
+.in +4n
+   \fIexiftran\ -ai\ *.jpeg\fP
+.in
+\#
+\#
+.SH "SEE ALSO"
+.BR exif (1),
+.BR exiftags (1),
+.BR jpegtran (1)
+\#
+\#
+.SH AUTHOR
+Gerd Hoffmann
+.BR <gerd@kraxel.org>
+\#
+\#
+.SH COPYRIGHT
+Copyright (c) 2002-2012 Gerd Hoffmann <gerd@kraxel.org>
+.P
+This program is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation; either version 2 of the License, or (at your option) any later
+version.
+.P
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU General Public License for more details.
+.P
+You should have received a copy of the GNU General Public License along with
+this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave,
+Cambridge, MA 02139, USA.