Index: pykota/trunk/man/fr/pkrefund.1
===================================================================
--- pykota/trunk/man/fr/pkrefund.1 (revision 3279)
+++ pykota/trunk/man/fr/pkrefund.1 (revision 3485)
@@ -1,147 +1,133 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKREFUND "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKREFUND "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkrefund \- page de manuel de pkrefund 1.27alpha3_BROKEN_unofficial
+pkrefund \- page de manuel de pkrefund (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkrefund
+[\fIoptions\fR] [\fIfilterexpr\fR]
 .SH DESCRIPTION
-pkrefund v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Rembourse les travaux d'impression.
-.PP
-ligne de commande :
+Refunding tool for PyKota.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit.
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+show the version number and exit.
+.TP
+\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR
+loads additional options and arguments from a file,
+one per line.
+.TP
+\fB\-f\fR, \fB\-\-force\fR
+Doesn't ask for confirmation before refunding. Only
+needed if you specify a filename for the PDF receipts.
+If you send such receipts to stdout, \fB\-\-force\fR is
+assumed to be set.
+.TP
+\fB\-i\fR INFO, \fB\-\-info\fR=\fIINFO\fR
+The informations to be prepended to the refunding
+reason, which can include some of Python's string
+interpolations to access to certain internal values.
+If you don't want such information, set this
+explicitely to an empty string. The default is
+\&'''Refunded %(nbpages)i pages and %(nbcredits).3f
+credits by %(effectiveuser)s (%(loginname)s) on
+%(date)s'''
+.TP
+\fB\-l\fR LOGO, \fB\-\-logo\fR=\fILOGO\fR
+The image to use as a logo. The logo will be drawn at
+the center top of the page. The default logo is
+/usr/share/pykota/logos/pykota.jpeg.
+.TP
+\fB\-n\fR NUMBER, \fB\-\-number\fR=\fINUMBER\fR
+Sets the number of the first receipt. This number will
+automatically be incremented for each receipt. The
+default value is 1.
+.TP
+\fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR
+The name of the file to which the PDF receipts will be
+written. If not set or set to '\-', the PDF document
+will be sent to the standard output, and \fB\-\-force\fR will
+be assumed to be set.
+.TP
+\fB\-p\fR PAGESIZE, \fB\-\-pagesize\fR=\fIPAGESIZE\fR
+Set the size of the page. Most well known page sizes
+are recognized, like 'A4' or 'Letter' to name a few.
+The default page size is A4.
+.TP
+\fB\-r\fR REASON, \fB\-\-reason\fR=\fIREASON\fR
+The reason why there was a refund.
+.TP
+\fB\-u\fR UNIT, \fB\-\-unit\fR=\fIUNIT\fR
+The name of the unit to use on the receipts. The
+default value is 'Credits' or its locale translation.
+.SS "filtering expressions:"
 .IP
-pkrefund [options] [filtres]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de pkrefund et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-f\fR | \fB\-\-force\fR
-Ne demande pas confirmation avant de rembourser
-les travaux d'impression.
-.TP
-\fB\-r\fR | \fB\-\-reason\fR txt
-Indique la raison du remboursement.
-.TP
-\fB\-l\fR | \fB\-\-logo\fR img
-Utilise cette image comme logo sur les re�. Le
-logo sera dessin�u centre et en haut de la page.
-Le logo par d�ut est
+Use the filtering expressions to extract only parts of the datas. Allowed
+filters are of the form 'key=value'. Wildcards are not expanded as part of
+these filtering expressions, so you can't use them here.
 .IP
-/usr/share/pykota/logos/pykota.jpeg
-.TP
-\fB\-p\fR | \fB\-\-pagesize\fR sz
-Positionne la taille de page �z. La plupart des
-tailles standard sont reconnues, comme 'A4' ou 'Letter'
-par exemple. La taille par d�ut est A4.
-.TP
-\fB\-n\fR | \fB\-\-number\fR N
-Indique le num� du premier re� Ce num�
-sera automatiquement incr�nt� chaque nouveau re�
-.TP
-\fB\-o\fR | \fB\-\-output\fR f.pdf
-D�nit le nom du fichier PDF qui contiendra les
-re�. S'il n'est pas pr�s�lors aucun fichier ne
-sera g�r�Si '\-' est utilis�le fichier PDF sera
-envoy�ur la sortie standard, et l'option \fB\-\-force\fR
-sera activ�automatiquement.
-.TP
-\fB\-u\fR | \fB\-\-unit\fR u
-D�nit le nom de l'unit� utiliser sur les re�.
-Le nom par d�ut est 'Credits', ou sa traduction
-�ntuelle dans votre langage pr�r�i PyKota
-le supporte.
+allowed keys for now:
 .IP
-Utilisez les expressions de filtrage pour extraire seulement certaines
-parties des donn�. Les filtres autoris�sont de la forme :
+username : User's name
+printername : Printer's name
+hostname : Host's name
+jobid : Job's id
+billingcode : Job's billing code
+start : Job's date of printing
+end : Job's date of printing
 .IP
-cl�aleur
+formatting of dates with the 'start' and 'end' filtering keys:
 .IP
-Les cl�autoris� pour l'instant sont :
-.TP
-username
-Nom de l'utilisateur
-.TP
-printername
-Nom de l'imprimante
-.TP
-hostname
-Nom d'h�de la machine cliente
-.TP
-jobid
-Id du travail d'impression
-.TP
-billingcode
-Code de facturation du travail d'impression
-.TP
-start
-Date du travail d'impression
-.TP
-end
-Date du travail d'impression
+YYYY : year boundaries
+YYYYMM : month boundaries
+YYYYMMDD : day boundaries
+YYYYMMDDhh : hour boundaries
+YYYYMMDDhhmm : minute boundaries
+YYYYMMDDhhmmss : second boundaries
+yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15)
+today[+\-N] : today more or less N days (e.g. : today\-15)
+tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15)
+now[+\-N] : now more or less N days (e.g. now\-15)
 .IP
-Formatage des dates avec les cl�'start' et 'end' :
+\&'now' and 'today' are not exactly the same since 'today' represents the
+first or last second of the day depending on if it's used in a 'start=' or
+\&'end=' date expression.
 .IP
-AAAA : limites d'ann�AAAAMM : limites de mois
-AAAAMMJJ : limites de jour
-AAAAMMJJhh : limites d'heures
-AAAAMMJJhhmm : limites de minutes
-AAAAMMJJhhmmss : limites de secondes
-yesterday[+\-NbJours] : hier plus ou moins N jours (ex : yesterday\-15)
-today[+\-NbJours] : aujoud'hui plus ou moins N jours (ex : today\-15)
-tomorrow[+\-NbJours] : demain plus ou moins N jours (ex : tomorrow\-15)
-now[+\-NbJours] : maintenant plus ou moins N jours (ex : now\-15)
+examples:
 .IP
-\&'now' et 'today' ne sont pas exactement identiques car today repr�nte
-la premi� ou la derni� seconde du jour selon qu'il soit utilis�vec
-une expression de type start= ou end=.
-L'utilit�e pouvoir sp�fier une date dans le future est une question
-qui reste ouverte :\-)
+pkrefund \fB\-\-output\fR /tmp/receipts.pdf jobid=503
+This would refund all jobs which Id is 503. A confirmation would be
+asked for each job to refund, and a PDF file named /tmp/receipts.pdf
+would be created containing printable receipts. BEWARE of job ids
+rolling over if you reset CUPS' history.
 .IP
-Contrairement aux autres outils d'administration de PyKota, les caract�s
-jokers ne sont pas expans� aussi vous ne pouvez pas les utiliser.
-.PP
-Exemples :
+pkrefund \fB\-\-reason\fR "Hardware problem" jobid=503 start=today\-7
+This would refund all jobs which id is 503 but which would have been
+printed during the  past week. The reason would be marked as being an
+hardware problem.
 .IP
-\f(CW$ pkrefund \-\-output /tmp/recus.pdf jobid=503\fR
+pkrefund \fB\-\-force\fR username=jerome printername=HP2100
+This would refund all jobs printed by user jerome on printer HP2100.
+No confirmation would be asked.
 .IP
-Cela va rembourser tous les travaux dont l'identifiant est 503.
-ATTENTION : installer CUPS �ouveau va remettre l'identifiant �
-aussi vous voudrez certainement utiliser un filtre plus pr�s
-comme expliqu�i\-dessous. Une confirmation sera demand�pour chaque
-remboursement, et un fichier PDF nomm�tmp/recus.pdf sera cr�et
-contiendra les re� imprimables.
+pkrefund \fB\-\-force\fR printername=HP2100 start=200602 end=yesterday
+This would refund all jobs printed on printer HP2100 between February
+1st 2006 and yesterday. No confirmation would be asked.
 .IP
-\f(CW$ pkrefund \-\-reason "Probl� mat�el" jobid=503 start=today-7\fR
+licensing terms:
 .IP
-Rembourse tous les travaux dont l'identifiant est 503 et qui ont �
-imprim�la semaine derni�. La raison indiqu�sera un probl� mat�el.
-.IP
-\f(CW$ pkrefund \-\-force username=jerome printername=HP2100\fR
-.IP
-Rembourse tous les travaux imprim�par l'utilisateur jerome sur
-l'imprimante HP2100. Aucune confirmation ne sera demand�
-.IP
-\f(CW$ pkrefund \-\-force printername=HP2100 start=200602 end=yesterday\fR
-.IP
-Rembourse tous les travaux imprim�sur l'imprimante HP2100 entre le
-premier F�ier 2006 et hier. Aucune confirmation ne sera demand�
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com>
+(c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com
 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 3 of the License, or
-(at your option) any later version.
-.PP
-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.
-.PP
+the Free Software Foundation, either version 3 of the License, or (at
+your option) any later version.
+.IP
+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.
+.IP
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
-.PP
-Merci d'envoyer les rapports de bugs � Jerome Alet \- alet@librelogiciel.com
