Improvement and french translation of exiftran help

* exiftran.c : small typos + clarify help text
* exiftran.man :
  - typos;
  - clarify rotate commands;
  - improvement.
* exiftran.man.fr : French translation of exiftran.man

3 files changed, 249 insertions, 69 deletions

diff --git a/exiftran.c b/exiftran.c
index c9ab867..671dfd3 100644
--- a/exiftran.c
+++ b/exiftran.c
@@ -1,5 +1,7 @@
 /*
+ * Transform digital camera jpeg images
  *
+ * (c) 2002-2012 Gerd Hoffmann <kraxel@bytesex.org>
  */
 
 #include <stdio.h>
@@ -82,30 +84,30 @@ usage(FILE *fp, char *name)
 	    "\n"
 	    "transform options:\n"
 	    "  -a         automatic (using exif orientation tag)\n"
-	    "  -9         rotate by 90 degrees\n"
-	    "  -1         rotate by 180 degrees\n"
-	    "  -2         rotate by 270 degrees\n"
-	    "  -f         flip vertical\n"
-	    "  -F         flip horizontal\n"
-	    "  -t         transpose\n"
-	    "  -T         transverse\n"
+	    "  -9         rotate by 90 degrees clockwise\n"
+	    "  -1         rotate by 180 degrees clockwise\n"
+	    "  -2         rotate by 270 degrees clockwise\n"
+	    "  -f         mirror image vertically (top / bottom)\n"
+	    "  -F         mirror image horizontally (left to right)\n"
+	    "  -t         transpose (across UL-to-LR corner)\n"
+	    "  -T         transverse (across UR-to-LL corner)\n"
 	    "\n"
 	    "  -nt        don't rotate exif thumbnail\n"
 	    "  -ni        don't rotate jpeg image\n"
 	    "  -no        don't update the orientation tag\n"
 	    "\n"
 	    "other options:\n"
-	    "  -h         print this text\n"
+	    "  -h         print this help text\n"
 	    "  -d         dump exif data\n"
 	    "  -c <text>  create/update comment\n"
 	    "  -g         (re)generate thumbnail\n"
 	    "  -o <file>  output file\n"
 	    "  -i         change files inplace\n"
-	    "    -b       create a backup file (with -i)\n"
-	    "    -p       preserve timestamps  (with -i)\n"
+	    "  -b         create a backup file (with -i)\n"
+	    "  -p         preserve timestamps  (with -i)\n"
 	    "\n"
 	    "-- \n"
-	    "Gerd Hoffmann <kraxel@bytesex.org> [SUSE Labs]\n",
+	    "(c) 2002-2012 Gerd Hoffmann <kraxel@bytesex.org> [SUSE Labs]\n",
 	    name);
 }
 
diff --git a/exiftran.man b/exiftran.man
index 4f3efde..4249d44 100644
--- a/exiftran.man
+++ b/exiftran.man
@@ -1,106 +1,138 @@
-.TH exiftran 1 "(c) 2003,04 Gerd Knorr"
+.TH EXIFTRAN 1 "(c) 2002-2012 Gerd Knorr" "EXIFTRAN 2.08" "Transform digital camera jpeg images"
+\#
+\#
 .SH NAME
 exiftran - transform digital camera jpeg images
+\#
+\#
 .SH SYNOPSIS
-.B exiftran [ options ] file(s)
+.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
-.B exiftran
-is a command line utility to transform digital image jpeg images.  It
-can do lossless rotations like jpegtran, but unlike jpegtran it cares
-about the EXIF data: It can rotate images automatically by checking
-the exif orientation tag, it updates the exif informaton if needed
-(image dimension, orientation), it also rotates the exif thumbnail.
-It can process multiple images at once.
-.SH TRANSFORM OPTIONS
+.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)
+Automatic (using exif orientation tag).
 .TP
 .B -9
-rotate by 90 degrees
+Rotate by 90 degrees clockwise.
 .TP
 .B -1
-rotate by 180 degrees
+Rotate by 180 degrees clockwise.
 .TP
 .B -2
-rotate by 270 degrees
+Rotate by 270 degrees clockwise.
 .TP
 .B -f
-flip vertical
+Mirror image vertically (top / bottom).
 .TP
 .B -F
-flip horizontal
+Mirror image horizontally (left to right).
 .TP
 .B -t
-transpose
+Transpose (across UL-to-LR corner).
 .TP
 .B -T
-transverse
+Transverse (across UR-to-LL corner).
 .TP
 .B -nt
-Don't rotate exif thumbnail.
+Don't transform exif thumbnail.
 .TP
 .B -ni
-Don't rotate jpeg image. You might need this or or the -nt option to
-fixup things in case you rotated the image with some utility which
-ignores the exif thumbnail. Just generating a new thumbnail with -g is
-another way to fix it.
+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 exiftran sets the
-orientation to "1" (no transformation needed) to avoid other
-exif-aware applications try to rotate the already-rotated image
-again.
-.SH OTHER OPTIONS
+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.
+\#
+\#
+.SH "OTHER OPTIONS"
 .TP
 .B -h
-print a short help text
+Print a short help text.
 .TP
 .B -d
 Dump exif data for the file(s).
 .TP
-.B -c <text>
-Set jpeg comment tag to <text>.
+.BI "-c" "\ text"
+Set jpeg comment tag to \fItext\fP.
 .TP
 .B -g
-(re)generate EXIF thumbnail.
+(re)generate exif thumbnail.
 .TP
-.B -o <file>
-Specify output file.  Only one input file is allowed in this mode.
+.BI "-o" "\ file"
+Specify output \fIfile\fP. Only one input file is allowed in this mode.
 .TP
 .B -i
-Enable inplace editing of the images.  Exiftran allows multiple input
-files then.  You must specify either this option or a output file with
--o for all operations which modify the image (i.e. everything but -d
-right now).
+Enable inplace 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 inplace editing.
+Create a backup file when doing inplace editing (imply \fB-i\fP).
 .TP
 .B -p
-Preserve timestamps (atime + mtime) when doing inplace editing.
+Preserve timestamps (atime + mtime) when doing inplace editing (imply \fB-i\fP).
+\#
+\#
 .SH EXAMPLES
 Autorotate all jpeg files in the current directory:
-.nf
-   exiftran -ai *.jpeg
-.fi
-.SH SEE ALSO
-jpegtran(1), exif(1)
+.P
+.in +4n
+   \fIexiftran\ -ai\ *.jpeg\fP
+.in
+\#
+\#
+.SH "SEE ALSO"
+.BR exif (1),
+.BR exiftags (1),
+.BR jpegtran (1)
+\#
+\#
 .SH AUTHOR
-Gerd Knorr <kraxel@bytesex.org>
+Gerd Knorr
+.BR <kraxel@bytesex.org>
+\#
+\#
 .SH COPYRIGHT
-Copyright (C) 2002 Gerd Knorr <kraxel@bytesex.org>
+Copyright (c) 2002-2012 Gerd Knorr <kraxel@bytesex.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.
+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.
+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.
+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.
diff --git a/exiftran.man.fr b/exiftran.man.fr
new file mode 100644
index 0000000..fc52ceb
--- /dev/null
+++ b/exiftran.man.fr
@@ -0,0 +1,146 @@
+.TH EXIFTRAN 1 "(c) 2002-2012 Gerd Knorr" "EXIFTRAN 2.08" "Transformation d'images jpeg d'appareil photo numérique"
+\#
+\#
+.SH NOM
+exiftran - transformation d'images jpeg d'appareil photo numérique
+\#
+\#
+.SH SYNOPSIS
+.TP
+\fBexiftran\fP [\fIoptions\fP] \fIfile1 file2 ... fileN\fP
+.TP
+\fBexiftran\fP -i [\fItransformation options\fP] [\fIautres options\fP] \fIfile1 file2 ... fileN\fP
+.TP
+\fBexiftran\fP -o \fIfichiersortie\fP [\fItransformation options\fP] [\fIautres options\fP] \fIfichierentree\fP
+.TP
+\fBexiftran\fP -d \fIfile1 file2 ... fileN\fP > \fIexifinfo\fP
+\#
+\#
+.SH DESCRIPTION
+.BR Exiftran
+est un utilitaire en ligne de commande pour transformer des images \fIjpeg\fP
+d'appareil photo numérique. Il peut faire des rotations sans perte de données
+comme
+.BR "jpegtran" "(1),"
+mais au contraire de
+.BR "jpegtran" "(1)"
+il tient compte des données \fIEXIF\fP : il peut pivoter les images
+automatiquement en vérifiant la propriété exif d'orientation ; il met à jour
+les informations exif si nécessaire (dimension de l'image, orientation) ; il
+pivote aussi la miniature exif. Il peut traiter plusieurs images en une seule
+opération.
+\#
+\#
+.SH "OPTIONS DE TRANSFORMATION"
+.TP
+.B -a
+Automatique (utilise la propriété d'orientation exif).
+.TP
+.B -9
+Rotation de 90 degrés dans le sens des aiguilles d'une montre.
+.TP
+.B -1
+Rotation de 180 degrés dans le sens des aiguilles d'une montre.
+.TP
+.B -2
+Rotation de 270 degrés dans le sens des aiguilles d'une montre.
+.TP
+.B -f
+Rotation d'axe horizontal (haut / bas).
+.TP
+.B -F
+Rotation d'axe vertical (gauche / droite).
+.TP
+.B -t
+Rotation d'axe oblique (sommets HG et BD).
+.TP
+.B -T
+Rotation d'axe oblique (sommets HD et BG).
+.TP
+.B -nt
+Ne pas transformer la miniature exif.
+.TP
+.B -ni
+Ne pas transformer l'image jpeg. Vous pourriez avoir besoin de ceci ou de
+l'option \fB-nt\fP pour faire des corrections dans le cas où vous avez
+transformé une image avec des utilitaires qui ignorent la miniature exif.
+Mettre à jour la miniature seule avec \fB-g\fP est une autre solution.
+.TP
+.B -no
+Ne pas mettre à jour la propriété d'orientation. Par défaut
+.BR exiftran
+positionne l'orientation à "1" (aucune transformation nécessaire) pour
+empêcher d'autres logiciels de manipulation des données exif d'essayer de
+pivoter l'image qui l'est déjà.
+\#
+\#
+.SH "AUTRES OPTIONS"
+.TP
+.B -h
+Afficher un court message d'aide.
+.TP
+.B -d
+Extraire les données exif du ou des fichiers.
+.TP
+.BI "-c" "\ texte"
+Enregistrer un \fItexte\fP dans la propriété commentaire.
+.TP
+.B -g
+Refabriquer la miniature exif.
+.TP
+.BI "-o" "\ fichier"
+Indiquer le \fIfichier\fP de sortie. Ce mode n'autorise qu'un seul fichier en entrée.
+.TP
+.B -i
+Activer la modification directe des images.
+.BR Exiftran
+accepte plusieurs fichiers en entrée. Vous devez indiquer cette option ou
+un fichier de sortie avec \fB-o\fP pour toutes les opérations qui modifient
+l'image (c-à-d toutes sauf \fB-d\fP évidemment).
+.TP
+.B -b
+Créer un fichier de sauvegarde lors des modifications directes (implique \fB-i\fP).
+.TP
+.B -p
+Préserver l'horodatage (atime + mtime) lors des modifications directes (implique \fB-i\fP).
+\#
+\#
+.SH EXEMPLES
+Rotation automatique de tous les fichiers jpeg du répertoire courant :
+.P
+.in +4n
+   \fIexiftran\ -ai\ *.jpeg\fP
+.in
+\#
+\#
+.SH "VOIR AUSSI"
+.BR exif (1),
+.BR exiftags (1),
+.BR jpegtran (1)
+\#
+\#
+.SH TRADUCTEUR
+Stéphane Aulery
+.BR <lkppo@free.fr>
+\#
+\#
+.SH AUTEUR
+Gerd Knorr
+.BR <kraxel@bytesex.org>
+\#
+\#
+.SH COPYRIGHT
+Copyright (c) 2002-2012 Gerd Knorr <kraxel@bytesex.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.