Changeset 3094 for pykota/trunk/man/fr/pkinvoice.1

Timestamp:

11/30/06 23:26:47 (17 years ago)

Author:

jerome

Message:

Documented the start= and end= filters for the data dumper.

Files:

• pykota/trunk/man/fr/pkinvoice.1 (modified) (1 diff)

pykota/trunk/man/fr/pkinvoice.1

@@ -2 +2 @@
 .TH PKINVOICE "1" "novembre 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkinvoice \- page de manuel de pkinvoice 1.25alpha16_unofficial
+pkinvoice \- page de manuel de pkinvoice 1.25alpha18_unofficial
 .SH DESCRIPTION
-pkinvoice v1.25alpha16_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com
+pkinvoice v1.25alpha18_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com
 .PP
-Un g�rateur de factures pour PyKota.
+An invoice generator for PyKota.
 .PP
-ligne de commande :
+command line usage :
 .IP
-pkinvoice [options] utilisateur1 utilisateur2 ... utilisateurN
+pkinvoice [options] [filterexpr]
 .PP
 options :
 .TP
 \fB\-v\fR | \fB\-\-version\fR
-Affiche la version de pkinvoice et quitte.
+Prints pkinvoice's version number then exits.
 .TP
 \fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
+Prints this message then exits.
 .TP
 \fB\-l\fR | \fB\-\-logo\fR img
-Utilise cette image comme logo sur la facture. Le logo
-sera dessin�u centre et en haut de la page. Le logo
-par d�ut est /usr/share/pykota/logos/pykota.jpeg
+Use the image as the invoice's 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\-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.
+Sets sz as the page size. Most well known
+page sizes are recognized, like 'A4' or 'Letter'
+to name a few. The default size is A4.
 .TP
 \fB\-n\fR | \fB\-\-number\fR N
-Indique le num� de la premi� facture. Ce num�
-sera automatiquement incr�nt� chaque facture.
+Sets the number of the first invoice. This number
+will automatically be incremented for each invoice.
 .TP
 \fB\-o\fR | \fB\-\-output\fR f.pdf
-D�nit le nom du fichier PDF qui contiendra les
-factures. S'il n'est pas pr�s�u positionn� '\-'
-alors le document sera envoy�ur la sortie standard.
+Defines the name of the invoice file which will
+be generated as a PDF document. If not set or
+set to '\-', the PDF document is sent to standard
+output.
 .TP
 \fB\-u\fR | \fB\-\-unit\fR u
-D�nit le nom de l'unit� utiliser sur la facture.
-Le nom par d�ut est 'Credits', ou sa traduction
-�ntuelle dans votre langage pr�r�i PyKota
-le supporte.
+Defines the name of the unit to use on the invoice.
+The default unit is 'Credits', optionally translated
+to your native language if it is supported by PyKota.
 .TP
 \fB\-V\fR | \fB\-\-vat\fR p
-Indique le taux de TVA applicable qui sera indiqu�La valeur par d�ut est 0.0, qui fait qu'aucune
-information sur la TVA ne sera indiqu�
+Sets the percent value of the applicable VAT to be
+exposed. The default is 0.0, meaning no VAT
+information will be included.
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
 .TP
-\fB\-s\fR | \fB\-\-start\fR date
-Indique la date de d�t des travaux d'impression
-qui seront factur�
+username
+User's name
 .TP
-\fB\-e\fR | \fB\-\-end\fR date
-Indique la date de fin des travaux d'impression
-qui seront factur�
+printername
+Printer's name
+.TP
+hostname
+Client's hostname
+.TP
+jobid
+Job's Id
+.TP
+billingcode
+Job's billing code
+.TP
+start
+Job's date of printing
+.TP
+end
+Job's date of printing
 .IP
-utilisateur1 jusqu'�tilisateurN peuvent contenir des caract�s jokers
-au besoin. Si aucun nom d'utilisateur n'est indiqu�c'est comme si un
-joker '*' �it pr�s�ce qui veut dire inclure tous les utilisateurs.
+Dates formatting with 'start' and 'end' filter keys :
 .IP
-Formatage des dates avec \fB\-\-start\fR et \fB\-\-end\fR :
+YYYY : year boundaries
+YYYYMM : month boundaries
+YYYYMMDD : day boundaries
+YYYYMMDDhh : hour boundaries
+YYYYMMDDhhmm : minute boundaries
+YYYYMMDDhhmmss : second boundaries
+yesterday[+\-NbDays] : yesterday more or less N days (e.g. : yesterday\-15)
+today[+\-NbDays] : today more or less N days (e.g. : today\-15)
+tomorrow[+\-NbDays] : tomorrow more or less N days (e.g. : tomorrow\-15)
+now[+\-NbDays] : now more or less N days (e.g. now\-15)
 .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)
+\&'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. The utility to be able to specify dates in the future is
+a question which remains to be answered :\-)
 .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 :\-)
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
 .PP
-exemples :
+examples :
 .IP
-\f(CW$ pkinvoice --unit EURO --output factures.pdf --start=now-30\fR
+\f(CW$ pkinvoice --unit EURO --output /tmp/invoices.pdf start=now-30\fR
 .IP
-G�rera un document PDF contenant les factures de tous les utilisateurs
-qui ont d�ns�es cr�ts durant le mois �ul�Les factures seront en
-EURO. Aucune information de TVA ne sera incluse.
+Will generate a PDF document containing invoices for all users
+who have spent some credits last month. Invoices will be done in
+EURO.  No VAT information will be included.
 .PP
 This program is free software; you can redistribute it and/or modify