Changeset 3485 for pykota/trunk/man/fr

Timestamp:

01/24/09 22:38:46 (15 years ago)

Author:

jerome

Message:

Updated manual pages.

Location:

pykota/trunk/man/fr

Files:

• autopykota.1 (modified) (1 diff)
• dumpykota.1 (modified) (1 diff)
• edpykota.1 (modified) (1 diff)
• pkbanner.1 (modified) (1 diff)
• pkbcodes.1 (modified) (1 diff)
• pkinvoice.1 (modified) (1 diff)
• pkprinters.1 (modified) (1 diff)
• pkrefund.1 (modified) (1 diff)
• pksetup.1 (modified) (1 diff)
• pkturnkey.1 (modified) (1 diff)
• pkusers.1 (modified) (1 diff)
• pykosd.1 (modified) (1 diff)
• pykotme.1 (modified) (1 diff)
• repykota.1 (modified) (1 diff)
• warnpykota.1 (modified) (1 diff)

pykota/trunk/man/fr/autopykota.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH AUTOPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH AUTOPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-autopykota \- page de manuel de autopykota 1.27alpha3_BROKEN_unofficial
+autopykota \- page de manuel de autopykota (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B autopykota
+\fI{ -i | \-\-initbalance value } \fR[\fIoptions\fR]
 .SH DESCRIPTION
-autopykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un outil pour automatiser la cr�ion des comptes et l'initialisation
-du solde.
-.PP
-CET OUTIL NE DOIT PAS �RE UTILIS�SI VOUS LIMITEZ VOS UTILISATEURS PAR
-QUOTA !
-.PP
-ligne de commande :
+A tool to automate user account creation and initial balance setting. THIS
+TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART OF AN external
+policy IN pykota.conf, AND MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY
+PAGE QUOTA !
+.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\-i\fR INITBALANCE, \fB\-\-initbalance\fR=\fIINITBALANCE\fR
+Set the user's initial account balance value. If the
+user already exists, actual balance is left unchanged.
+If unset, the default value is 0.0.
+.TP
+\fB\-e\fR EMAIL, \fB\-\-email\fR=\fIEMAIL\fR
+Set the user's email address.
+.SS "examples:"
 .IP
-CET OUTIL NE DOIT PAS �RE UTILIS�DEPUIS LA LIGNE DE COMMANDE MAIS
-SEULEMENT DANS UNE external policy DANS pykota.conf
+autopykota \fB\-\-email=\fR"@example.com" \fB\-\-initbalance\fR=\fI10\fR.0
+This would set the current user's email address to
+$PYKOTAUSERNAME@example.com, and would set the initial value of his
+account balance to 10.0 credits.
+.SS "licensing terms:"
 .IP
-autopykota { \fB\-i\fR | \fB\-\-initbalance\fR valeur }
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version d'autopykota et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-i\fR | \fB\-\-initbalance\fR b Positionne le solde initial de l'utilisateur �.
-Si l'utilisateur existe d�, le solde actuel reste
-inchang�Si non indiqu�la valeur par d�ut est 0.
-.TP
-\fB\-e\fR | \fB\-\-email\fR addr
-Positionne l'adresse e\-mail de l'utilisateur.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+(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.
+.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/>.

pykota/trunk/man/fr/dumpykota.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH DUMPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH DUMPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-dumpykota \- page de manuel de dumpykota 1.27alpha3_BROKEN_unofficial
+dumpykota \- page de manuel de dumpykota (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B dumpykota
+[\fIoptions\fR] [\fIfilterexpr\fR]
 .SH DESCRIPTION
-dumpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Exporte le contenu de la base de donn� de PyKota.
-.PP
-ligne de commande :
+Data Dumper 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\-d\fR DATA, \fB\-\-data\fR=\fIDATA\fR
+Select the type of datas to dump. This option is
+mandatory. Supported data types are : history,
+payments, billingcodes, users, groups, printers,
+upquotas, gpquotas, umembers, pmembers, and all. The
+\&'all' value forces the output format to XML.
+.TP
+\fB\-f\fR FORMAT, \fB\-\-format\fR=\fIFORMAT\fR
+Select the output format, the default being comma
+separated values. Supported formats are : csv, ssv,
+tsv, xml and cups. The 'cups' output format only works
+when dumping the history, and produces CUPS' page_log
+compatible output.
+.TP
+\fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR
+The name of the file the data dump will be written to.
+The default value is '\-', which tells dumpykota to
+write the dump to stdout.
+.TP
+\fB\-O\fR ORDERBY, \fB\-\-orderby\fR=\fIORDERBY\fR
+Change the ordering of the output based on a comma
+separated list of ordering statements. For example
+\&'\-username,+printername' would sort the output by
+descending order of user names and ascending order of
+printer names. Not all expressions are supported, and
+you should not use this if you don't know the internal
+structure of PyKota's database.
+.TP
+\fB\-s\fR, \fB\-\-sum\fR
+Summarize the output. Only available when dumping the
+printing history or the payments.
+.SS "filtering expressions:"
 .IP
-dumpykota [options] [exprfiltre]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de dumpykota et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-d\fR | \fB\-\-data\fR type
-Exporte les donn� de type 'type'.
-Les types autoris�sont :
+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
-\- history : exporte l'historique des travaux.
-\- users : exporte les utilisateurs.
-\- groups : exporte les groupes d'utilisateurs.
-\- printers : exporte les imprimantes.
-\- upquotas : exporte les quotas des utilisateurs.
-\- gpquotas : exporte les quotas des groupes.
-\- payments : exporte l'historique des paiements.
-\- pmembers : exporte les membres des groupes
+allowed keys for now:
 .IP
-d'imprimantes.
+username : User's name
+groupname : Users group's name
+printername : Printer's name
+pgroupname : Printers group'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
-\- umembers : exporte les membres des groupes
+formatting of dates with the 'start' and 'end' filtering keys:
 .IP
-d'utilisateurs.
+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
-\- billingcodes : exporte les codes de facturation.
-\- all : exporte toutes les donn� de PyKota.
+\&'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
-le format de sortie est toujours XML
-dans ce cas.
+examples:
 .IP
-NB : l'option de ligne de commande \fB\-d\fR | \fB\-\-data\fR est
-OBLIGATOIRE.
-.TP
-\fB\-f\fR | \fB\-\-format\fR fmt
-Exporte les donn� dans le format 'fmt' sp�fi�Si non pr�s�le format sera csv (champs s�r�par des virgules).
-Toutes les donn� sont export� entre double quotes.
-Les formats autoris�sont :
+dumpykota \fB\-\-unit\fR EURO \fB\-\-output\fR /tmp/invoices.pdf start=now\-30
+This would generate a PDF document containing invoices for all users
+who have spent some credits last month. Amounts would be in EURO and
+not VAT information would be included.
 .IP
-\- csv : donn� s�r� par des virgules
-\- ssv : donn� s�r� par des point\-virgules
-\- tsv : donn� s�r�par des tabulations
-\- xml : donn� export� au format XML
-\- cups : donn� export� au format page_log
+dumpykota \fB\-\-data\fR history \fB\-\-format\fR csv >myfile.csv
+This would dump the whole printing history to stdout in the CSV
+format, and redirect the output to a file.
 .IP
-de CUPS : DISPONIBLE SEULEMENT
+dumpykota \fB\-\-data\fR users \fB\-\-format\fR xml \fB\-o\fR users.xml
+This would dump all users into the 'users.xml' file in the XML format.
 .IP
-AVEC \fB\-\-data\fR history
-.TP
-\fB\-o\fR | \fB\-\-output\fR nomf
-Toutes les donn� seront export� vers un fichier
-plut�ue vers la sortie standard. Le nom sp�al '\-'
-est la valeur par d�ut indiquant la sortie standard.
-ATTENTION : les fichiers existants sont tronqu�!
-.TP
-\fB\-O\fR | \fB\-\-orderby\fR exp
-Change l'ordre des r�ltats. 'exp' est une liste
-s�r�par des virgules d'instructions de tri, par
-exemple '\-\-orderby +username,\-printername'. Seules
-certaines expressions on un sens, aussi utiliser cette
-option de ligne de commande n'est pas conseill�i
-vous ne connaissez pas la structure exacte de la base
-de donn� de PyKota.
-.TP
-\fB\-s\fR | \fB\-\-sum\fR
-Effectue la somme des donn� s�ctionn�.
-DISPONIBLE SEULEMENT AVEC \fB\-\-data\fR history ou payments
+dumpykota \fB\-\-data\fR history printername=HP2100 username=jerome
+This would dump jerome's printing history on printer HP2100.
 .IP
-Utilisez les expressions de filtrage pour extraire seulement certaines
-parties des donn�. Les filtres autoris�sont de la forme :
+dumpykota \fB\-\-data\fR history start=200503 end=20050730234615
+This would dump all jobs printer between March 1st 2008 at midnight
+and July 30th 2008 at 23 hours 46 minutes and 15 seconds, included.
 .IP
-cl�aleur
+licensing terms:
 .IP
-Les cl�autoris� pour l'instant sont :
-.TP
-username
-Nom de l'utilisateur
-.TP
-groupname
-Nom du groupe d'utilisateurs
-.TP
-printername
-Nom de l'imprimante
-.TP
-pgroupname
-Nom du groupe d'imprimantes
-.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
-.IP
-Formatage des dates avec les cl�'start' et 'end' :
-.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)
-.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 :\-)
-.IP
-Contrairement aux autres outils d'administration de PyKota, les caract�s
-jokers ne sont pas expans� aussi vous ne pouvez pas les utiliser.
-.IP
-NB : toutes les cl�ne sont pas autoris� pour chaque type de donn�,
-aussi le r�ltat peut �e vide si vous utilisez une cl�ndisponible
-pour un type de donn� particulier.
-.PP
-Exemples :
-.IP
-\f(CW$ dumpykota \-\-data history \-\-format csv >monfichier.csv\fR
-.IP
-Ceci va exporter l'historique dans un fichier �hamps s�r�par des
-virgules, par exemple pour r�portation dans un tableur.
-.IP
-\f(CW$ dumpykota \-\-data users \-\-format xml -o util.xml\fR
-.IP
-Exporte toutes les donn� des utilisateurs dans le fichier util.xml
-.IP
-\f(CW$ dumpykota \-\-data history printername=HP2100 username=jerome\fR
-.IP
-Exporte l'historique des travaux de l'utilisateur jerome sur l'imprimante
-HP2100 seulement.
-.IP
-\f(CW$ dumpykota \-\-data history start=200503 end=20050730234615\fR
-.IP
-Exporte tous les travaux imprim�entre le 1er Mars 2005 �inuit et
-le 30 Juillet 2005 �3 heures 46 minutes et 15 secondes inclus.
-.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

pykota/trunk/man/fr/edpykota.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH EDPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH EDPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-edpykota \- page de manuel de edpykota 1.27alpha3_BROKEN_unofficial
+edpykota \- page de manuel de edpykota (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B edpykota
+[\fIoptions\fR] [\fIusernames|groupnames\fR]
 .SH DESCRIPTION
-edpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un �teur de quotas pour PyKota.
-.PP
-ligne de commande :
+Manages PyKota print quota entries for users or users groups. A print quota
+entry is related to both an user and a printer, or to both a group and a
+printer, meaning that for example different users can have different page
+count limits on the same printer. If an user doesn't have a print quota entry
+on a particular printer, he won't be allowed to print to it.
+.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\-a\fR, \fB\-\-add\fR
+Add new, or modify existing, users or groups print
+quota entries.
+.TP
+\fB\-d\fR, \fB\-\-delete\fR
+Delete the specified users or groups print quota
+entries. When deleting users print quota entries, the
+matching jobs are also deleted from the printing
+history.
+.TP
+\fB\-S\fR SOFTLIMIT, \fB\-\-softlimit\fR=\fISOFTLIMIT\fR
+Set the soft page count limit for the specified print
+quota entries. Users can print over this limit for a
+number of days specified in the 'gracedelay' directive
+in pykota.conf
+.TP
+\fB\-H\fR HARDLIMIT, \fB\-\-hardlimit\fR=\fIHARDLIMIT\fR
+Set the hard page count limit for the specified print
+quota entries. Users are never allowed to print over
+this limit.
+.TP
+\fB\-g\fR, \fB\-\-groups\fR
+Manage groups print quota entries instead of users
+print quota entries.
+.TP
+\fB\-I\fR INCREASE, \fB\-\-increase\fR=\fIINCREASE\fR
+Increase the existing soft and hard page count limits
+for the specified print quota entries. You can
+decrease the values instead by prefixing this
+parameter with a negative sign.
+.TP
+\fB\-L\fR, \fB\-\-list\fR
+Display detailed informations about the specified
+users or groups print quota entries.
+.TP
+\fB\-n\fR, \fB\-\-noquota\fR
+Set no limit for both soft and hard page counts for
+the specified users or groups print quota entries.
+.TP
+\fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR
+Specify a comma separated list of printers you want to
+manage print quota entries on. The default is '*',
+meaning all printers.
+.TP
+\fB\-r\fR, \fB\-\-reset\fR
+Reset the actual page counter for the specified users
+print quota entries (doesn't work for groups print
+quota entries). The life time page counter is left
+unchanged.
+.TP
+\fB\-R\fR, \fB\-\-hardreset\fR
+Reset the actual and life time page counters for the
+specified users print quota entries (doesn't work for
+groups print quota entries). This is a shortcut for
+\fB\-\-used\fR 0.
+.TP
+\fB\-s\fR, \fB\-\-skipexisting\fR
+If \fB\-\-add\fR is used, ensure that existing users or groups
+print quota entries won't be modified.
+.TP
+\fB\-U\fR USED, \fB\-\-used\fR=\fIUSED\fR
+Set the values of both the actual and life time page
+counters for the specified users print quota entries
+(doesn't work for groups print quota entries). This
+can be useful when migrating from a different print
+quota software. The values can also be increased or
+decreased by prefixing this parameter with either a
+positive or negative sign.
+.SS "examples:"
 .IP
-edpykota [options] utilisateur1 utilisateur2 ... utilisateurN
+edpykota \fB\-\-add\fR john paul george ringo
+Would create print quota entries with no page count limits for these four
+users on all existing printers.
 .IP
-edpykota [options] groupe1 groupe2 ... groupeN
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version d'edpykota et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-a\fR | \fB\-\-add\fR
-Ajoute des entr� de quota d'impression de groupes
-ou d'utilisateurs si elles n'existent pas d� dans
-la base de donn�.
-.TP
-\fB\-d\fR | \fB\-\-delete\fR
-Efface des entr� de quota d'impression de groupes
-ou d'utilisateurs.
-Les utilisateurs ou les groupes eux\-m�s ne sont
-jamais effac� vous devez utiliser la commande
-pkusers pour les effacer.
-L'historique sera purg�e tous les travaux qui
-correspondent sauf si \fB\-g\fR | \fB\-\-groups\fR est utilis�.TP
-\fB\-P\fR | \fB\-\-printer\fR p
-Edite les quotas seulement sur l'imprimante P. En fait
-P peut contenir des caract�s jokers pour ne prendre
-en compte que certaines imprimantes. La valeur par
-d�ut est * qui signifie toutes les imprimantes.
-Vous pouvez sp�fier plusieurs noms ou jokers,
-en les s�rant avec des virgules.
-.TP
-\fB\-g\fR | \fB\-\-groups\fR
-Edite les entr� de quotas de groupes au lieu de
-celles des utilisateurs.
-.TP
-\fB\-L\fR | \fB\-\-list\fR
-Liste les entr� de quotas d'impression de groupes
-ou d'utilisateurs.
-.TP
-\fB\-n\fR | \fB\-\-noquota\fR
-Positionne �a fois les limites souples et dures
-�one pour les entr� de groupes ou d'utilisateurs.
-.TP
-\fB\-r\fR | \fB\-\-reset\fR
-Remet �� le compteur de pages actuel de
-l'utilisateur ou du groupe sur les imprimantes
-sp�fi�. Le compteur '�rnel' reste inchang�.TP
-\fB\-R\fR | \fB\-\-hardreset\fR
-Remet �� les compteurs de pages actuels et
-\&'�rnel' pour l'utilisateur ou le groupe sur les
-imprimantes sp�fi�. C'est un raccourci pour
-\&'\-\-used 0'.
-.TP
-\fB\-s\fR | \fB\-\-skipexisting\fR
-Combin�vec l'option \fB\-\-add\fR ci\-dessus, indique �dpykota de ne pas modifier les entr� de quota
-d'impression d� existantes.
-.TP
-\fB\-S\fR | \fB\-\-softlimit\fR ls
-Positionne la limite souple �s pages.
-.TP
-\fB\-H\fR | \fB\-\-hardlimit\fR ld
-Positionne la limite dure �d pages.
-.TP
-\fB\-I\fR | \fB\-\-increase\fR v
-Incr�nte les limites souples et dures existantes
-de la valeur de v. Vous pouvez pr�xer v avec + ou \-,
-Si aucun signe n'est pr�nt, + est utilis�.TP
-\fB\-U\fR | \fB\-\-used\fR u
-Positionne les compteurs de pages � pages pour
-l'utilisateur sur les imprimantes sp�fi�. Ne
-fonctionne pas pour les groupes car leurs compteurs
-de pages sont la somme des compteurs de pages de tous
-leurs membres.
-Utile pour migrer des utilisateurs depuis un logiciel
-diff�nt dans lequel ils ont d� imprim�uelques
-pages. Les compteurs actuel et '�rnel' peuvent �e
-incr�nt�ou d��nt�si u est pr�d�'un signe
-+ ou \-.
-ATTENTION : les deux compteurs de pages sont modifi�dans tous les cas, donc prenez vos pr�utions.
-NB : si u est �l �0', alors l'action effectu�est
-la m� que si \fB\-\-hardreset\fR �it utilis�.IP
-utilisateur1 �tilisateurN et groupe1 �roupeN peuvent contenir des
-jokers si l'option \fB\-\-add\fR n'est pas utilis�
-.PP
-exemples :
+edpykota \fB\-\-printer\fR HP \fB\-\-softlimit\fR 50 \fB\-\-hardlimit\fR 60 jerome
+Would allow user 'jerome' to print up to 60 pages on printer 'HP'. This
+user would be warned when he would have reached 50 pages on this printer.
+Both the user and printer must have been created previously using the
+pkusers and pkprinters commands, respectively.
 .IP
-\f(CW$ edpykota \-\-add john paul george ringo\fR
+edpykota \fB\-\-groups\fR \fB\-\-softlimit\fR 500 \fB\-\-hardlimit\fR 600 support financial
+Would set soft and hard page count limits on any printer for groups
+\&'support' and 'financial'.
 .IP
-Ceci va cr� des entr� de quota d'impression pour les utilisateurs
-john, paul, george et ringo sur toutes les imprimantes. Aucune limite
-ne sera positionn�pour ces entr�.
+edpykota \fB\-\-reset\fR \fB\-\-printer\fR HP jerome "jo*"
+Would reset the actual page counter for users 'jerome' and all users whose
+name begins with 'jo' on printer 'HP'.
 .IP
-\f(CW$ edpykota \-\-printer lp -S 50 -H 60 jerome\fR
+edpykota \fB\-\-printer\fR HPCOLOR \fB\-\-noquota\fR jerome
+Would allow this user to print without any page limit on printer
+\&'HPCOLOR'. Depending on how this user is limited, he may still be subject
+to being limited by the number of available credits in his account.
 .IP
-Ceci va positionner le quota d'impression de jerome �ne limite souple
-de 50 pages, et une limite dure de 60 pages sur l'imprimante lp. A la fois
-l'utilisateur jerome et l'imprimante lp devront avoir � cr� auparavant
-avec les commandes pkusers et pkprinters, respectivement.
+edpykota \fB\-\-add\fR \fB\-\-skipexisting\fR
+Would create a print quota entry for each user on each printer for which
+none already existed. You'll most likely want to use this command at least
+once after initial setup.
+.SS "licensing terms:"
 .IP
-\f(CW$ edpykota -g -S 500 -H 550 finance technique\fR
+(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.
 .IP
-Ceci va positionner la limite souple �00 pages et la limite dure �50
-pages pour les groupes finance et technique sur toutes les imprimantes.
+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
-\f(CW$ edpykota \-\-reset jerome "jo*"\fR
-.IP
-Ceci va remettre �� le compteur de pages actuel sur toutes les
-imprimantes pour l'utilisateur jerome et pour tous les utilisateurs dont
-le nom commence par 'jo'.
-Leur compteur de pages '�rnel' sur chaque imprimante sera pr�rv�Vous pouvez aussi remettre �� le compteur de pages '�rnel' en
-utilisant l'option de ligne de commande \fB\-\-hardreset\fR | \fB\-R\fR.
-.IP
-\f(CW$ edpykota \-\-printer hpcolor \-\-noquota jerome\fR
-.IP
-Ceci va indiquer �yKota de ne pas limiter jerome lorsqu'il imprime
-sur l'imprimante hpcolor. Tous ses travaux seront autoris�sur cette
-imprimante, mais un d�mpte sera quand m� effectu�Les quotas d'impressions de jerome sur les autres imprimantes ne sont
-pas modifi�
-.IP
-\f(CW$ edpykota \-\-delete \-\-printer "HP*,XER*" jerome rachel\fR
-.IP
-Ceci va effacer toutes les entr� de quotas d'impression des utilisateurs
-jerome et rachel sur toutes les imprimantes dont le nom commence par 'HP'
-ou 'XER'. Les travaux imprim�par ces utilisateurs sur ces imprimantes
-seront effac�de l'historique.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/pkbanner.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKBANNER "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKBANNER "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkbanner \- page de manuel de pkbanner 1.27alpha3_BROKEN_unofficial
+pkbanner \- page de manuel de pkbanner (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkbanner
+[\fIoptions\fR]
 .SH DESCRIPTION
-pkbanner v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-G�re des banni�s.
-.PP
-ligne de commande :
+Banner generator for PyKota.
+.SH OPTIONS
 .TP
-pkbanner
-[options]  [plus d'info]
-.PP
-options :
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit.
 .TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche le num� de version de pkbanner et quitte.
+\fB\-v\fR, \fB\-\-version\fR
+show the version number and exit.
 .TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
+\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR
+loads additional options and arguments from a file,
+one per line.
 .TP
-\fB\-l\fR | \fB\-\-logo\fR img
-Utilise l'image img comme logo pour la banni�.
-Le logo sera dessin�n haut et au centre de la page.
-Le logo par d�ut est
+\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\-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\-s\fR SAVETONER, \fB\-\-savetoner\fR=\fISAVETONER\fR
+Set the text luminosity to this percent. This can be
+used to save toner. The default value is 0.0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR URL, \fB\-\-url\fR=\fIURL\fR
+Set the url to write at the bottom of the banner page.
+The default url is http://www.pykota.com.
+.SS "examples:"
 .IP
-/usr/share/pykota/logos/pykota.jpeg
-.TP
-\fB\-p\fR | \fB\-\-pagesize\fR sz
-Positionne la taille de la page �z. La plupart des
-tailles sont reconnues, comme 'A4' ou 'Letter' par
-exemple. La taille par d�ut est A4.
-.TP
-\fB\-s\fR | \fB\-\-savetoner\fR s
-Positionne le facteur de luminosit�u texte �%.
-Cela peut �e utilis�our �nomiser du toner. La
-valeur par d�ut est 0, qui signifie qu'aucune
-�nomie de toner ne sera r�is�
-.TP
-\fB\-u\fR | \fB\-\-url\fR u
-Utilise u comme une url qui sera imprim�en base de
-la page banni�. L'url par d�ut est :
+pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+This would generate a banner in the default page size, with no logo, and
+text luminosity would be increased by 75%.
+.SS "licensing terms:"
 .IP
-http://www.pykota.com/
-.PP
-exemples :
+(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.
 .IP
-L'utilisation directe de pkbanner depuis la ligne de commande n'est pas
-conseill� sauf pour effectuer des tests. Vous devriez plut�tiliser
-pkbanner depuis les directives 'startingbanner' ou 'endingbanner' du
-fichier pykota.conf
+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
-startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
-.IP
-Avec une telle configuration dans pykota.conf, tous les travaux
-d'impression seront pr�d�d'une banni� au format A4 sans logo,
-et la luminosit�u texte sera accrue de 75%. La sortie PostScript
-de cette commande sera directement envoy��otre imprimante.
-.IP
-Vous trouverez plus d'exemples dans le fichier de configuration exemple
-qui est inclus dans PyKota.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/pkbcodes.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKBCODES "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKBCODES "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkbcodes \- page de manuel de pkbcodes 1.27alpha3_BROKEN_unofficial
+pkbcodes \- page de manuel de pkbcodes (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkbcodes
+[\fIoptions\fR] \fIcode1 code2 \fR... \fIcodeN\fR
 .SH DESCRIPTION
-pkbcodes v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un gestionnaire de codes de facturation pour PyKota.
-.PP
-ligne de commande :
+A billing codes manager 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\-a\fR, \fB\-\-add\fR
+Add new, or modify existing, billing codes.
+.TP
+\fB\-d\fR, \fB\-\-delete\fR
+Deletes billing codes. Matching entries in the
+printing history are not deleted, on purpose.
+.TP
+\fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR
+Set a textual description for the specified billing
+codes.
+.TP
+\fB\-l\fR, \fB\-\-list\fR
+Display detailed informations about the specified
+billing codes.
+.TP
+\fB\-r\fR, \fB\-\-reset\fR
+Reset the page count and amount spent for the
+specified billing codes.
+.TP
+\fB\-s\fR, \fB\-\-skipexisting\fR
+If \fB\-\-add\fR is used, ensure that existing billing codes
+won't be modified.
+.SS "examples:"
 .IP
-pkbcodes [options] code1 code2 code3 ... codeN
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche le num� de version de pkbcodes et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-a\fR | \fB\-\-add\fR
-Ajoute les codes de facturations s'ils n'existent pas
-d� dans la base de donn� de PyKota.
-S'ils existent d�, ils sont modifi�sauf si vous
-utilisez aussi \fB\-s\fR|\-\-skipexisting.
-.TP
-\fB\-d\fR | \fB\-\-delete\fR
-Efface les codes de facturation de la base de donn�
-de PyKota.
-NB : les entr� de l'historique correspondant �es
-codes de facturation ne sont volontairement pas
-effac�.
-.HP
-\fB\-D\fR | \fB\-\-description\fR d Ajoute un texte descriptif �n code de facturation.
-.TP
-\fB\-l\fR | \fB\-\-list\fR
-Liste les informations sur les codes de facturation.
-.TP
-\fB\-r\fR | \fB\-\-reset\fR
-R�itialise � le solde et le compteur de pages des
-codes de facturation.
-.TP
-\fB\-s\fR | \fB\-\-skipexisting\fR
-Combin� l'option \fB\-\-add\fR ci\-dessus, indique �kbcodes
-de ne pas modifier les codes de facturation existants.
+pkbcodes \fB\-D\fR "Financial Department" financial
+Would create a billing code labelled 'financial' with the specified
+textual description.
 .IP
-Les codes de facturation peuvent contenir des caract�s jokers si l'option
-\fB\-\-add\fR n'est pas utilis�
-.PP
-exemples :
+pkbcodes \fB\-\-delete\fR "fin*"
+Would delete all billing codes which label begins with 'fin'. Matching
+jobs in the printing history wouldn't be deleted though.
 .IP
-\f(CW$ pkbcodes \-\-add -D "Mon projet" monproj\fR
+pkbcodes \fB\-\-list\fR
+Would display details about all existing billing codes.
+.SS "licensing terms:"
 .IP
-Va cr� le code de facturation monproj avec "Mon projet"
-comme descriptif.
+(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.
 .IP
-\f(CW$ pkbcodes \-\-delete "*"\fR
+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
-Ceci va compl�ment effacer tous les codes de facturation, mais sans
-effacer aucune entr�de l'historique. UTILISEZ QUAND MEME AVEC PARCIMONIE !
-.IP
-\f(CW$ pkbcodes \-\-list "mo*"\fR
-.IP
-Ceci va lister tous les codes de facturation dont le nom commence par 'mo'.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/pkinvoice.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKINVOICE "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKINVOICE "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkinvoice \- page de manuel de pkinvoice 1.27alpha3_BROKEN_unofficial
+pkinvoice \- page de manuel de pkinvoice (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkinvoice
+[\fIoptions\fR] [\fIfilterexpr\fR]
 .SH DESCRIPTION
-pkinvoice v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un g�rateur de factures pour PyKota.
-.PP
-ligne de commande :
+Invoice generator 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\-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\-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\-n\fR NUMBER, \fB\-\-number\fR=\fINUMBER\fR
+Set the number of the first invoice. This number will
+automatically be incremented for each invoice. The
+default value is 1.
+.TP
+\fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR
+The name of the file to which the PDF invoices will be
+written. If not set or set to '\-', the PDF document
+will be sent to the standard output.
+.TP
+\fB\-u\fR UNIT, \fB\-\-unit\fR=\fIUNIT\fR
+The name of the unit to use on the invoices. The
+default value is 'Credits' or its locale translation.
+.TP
+\fB\-V\fR VAT, \fB\-\-vat\fR=\fIVAT\fR
+The value in percent of the applicable VAT to be
+exposed. The default is 0.0, meaning no VAT.
+.SS "filtering expressions:"
 .IP
-pkinvoice [options] [filtres]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de pkinvoice et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.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
-.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� de la premi� facture. Ce num�
-sera automatiquement incr�nt� chaque facture.
-.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.
-.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.
-.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�
+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
-Utilisez les expressions de filtrage pour extraire seulement certaines
-parties des donn�. Les filtres autoris�sont de la forme :
+allowed keys for now:
 .IP
-cl�aleur
+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
-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
+formatting of dates with the 'start' and 'end' filtering keys:
 .IP
-Formatage des dates avec les cl�'start' et 'end' :
+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
-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.
 .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 :\-)
+examples:
 .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 :
+pkinvoice \fB\-\-unit\fR EURO \fB\-\-output\fR /tmp/invoices.pdf start=now\-30
+This would generate a PDF document containing invoices for all users
+who have spent some credits last month. Amounts would be in EURO and
+not VAT information would be included.
 .IP
-\f(CW$ pkinvoice \-\-unit EURO \-\-output /tmp/factures.pdf start=now-30\fR
+licensing terms:
 .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.
-.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

pykota/trunk/man/fr/pkprinters.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKPRINTERS "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKPRINTERS "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkprinters \- page de manuel de pkprinters 1.27alpha3_BROKEN_unofficial
+pkprinters \- page de manuel de pkprinters (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkprinters
+[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR
 .SH DESCRIPTION
-pkprinters v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un gestionnaire d'imprimantes pour PyKota.
-.PP
-ligne de commande :
+Manages PyKota printers.
+.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\-a\fR, \fB\-\-add\fR
+Add new, or modify existing, printers.
+.TP
+\fB\-c\fR CHARGE, \fB\-\-charge\fR=\fICHARGE\fR
+Set the cost per page, and optionally per job, for
+printing to the specified printers. If both are to be
+set, separate them with a comma. Floating point and
+negative values are allowed.
+.TP
+\fB\-C\fR, \fB\-\-cups\fR
+Tell CUPS to either start or stop managing the
+specified printers with PyKota.
+.TP
+\fB\-d\fR, \fB\-\-delete\fR
+Delete the specified printers. Also purge the print
+quota entries and printing history matching the
+specified printers.
+.TP
+\fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR
+Set a textual description for the specified printers.
+.TP
+\fB\-g\fR GROUPS, \fB\-\-groups\fR=\fIGROUPS\fR
+If the \fB\-\-remove\fR option is not used, the default action
+is to add the specified printers to the specified
+printers groups. Otherwise they are removed from these
+groups. The specified printers groups must already
+exist, and should be created beforehand just like
+normal printers with this very command.
+.TP
+\fB\-l\fR, \fB\-\-list\fR
+Display detailed informations about the specified
+printers.
+.TP
+\fB\-m\fR MAXJOBSIZE, \fB\-\-maxjobsize\fR=\fIMAXJOBSIZE\fR
+Set the maximum job size in pages allowed on the
+specified printers.
+.TP
+\fB\-n\fR, \fB\-\-nopassthrough\fR
+Deactivate passthrough mode for the specified
+printers. This is the normal mode of operations, in
+which print jobs are accounted for, and are checked
+against printing quotas and available credits.
+.TP
+\fB\-p\fR, \fB\-\-passthrough\fR
+Activate passthrough mode for the specified printers.
+In this mode, jobs sent to these printers are not
+accounted for. This can be useful for exams during
+which no user should be charged for his printouts.
+.TP
+\fB\-r\fR, \fB\-\-remove\fR
+When combined with the \fB\-\-groups\fR option, remove
+printers from the specified printers groups.
+.TP
+\fB\-s\fR, \fB\-\-skipexisting\fR
+If \fB\-\-add\fR is used, ensure that existing printers won't
+be modified.
+.SS "examples:"
 .IP
-pkprinters [options] impr1 impr2 impr3 ... imprN
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de pkprinters et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-a\fR | \fB\-\-add\fR
-Ajoute les imprimantes si elles n'existent pas d�
-dans la base de donn�. Si elles existent, alors
-elles sont modifi� sauf si l'option de ligne de
-commande \fB\-s\fR|\-\-skipexisting est aussi utilis�
-.TP
-\fB\-d\fR | \fB\-\-delete\fR
-Supprime les imprimantes de la base de donn�.
-.HP
-\fB\-D\fR | \fB\-\-description\fR d Ajoute une description textuelle aux imprimantes.
-.TP
-\fB\-C\fR | \fB\-\-cups\fR
-Modifie �lement la DeviceURI dans le fichier
-printers.conf de CUPS.
-.TP
-\fB\-c\fR | \fB\-\-charge\fR p[,j]
-Fixes les co�ar page et par travail.
-Le co�r travail d'impression est optionnel.
-Si les deux sont utilis� s�rez les nombres par
-une virgule.
-Les nombres n�tifs ou avec d�males sont autoris�
-.TP
-\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Ajoute ou supprime les imprimantes des groupes
-pg1, pg2, etc... qui doivent d� exister.
-Un groupe d'imprimantes est comme une imprimante
-normale mais est inconnu du syst� d'impression.
-On cr�les groupes d'imprimantes de la m� mani�
-que l'on cr�des imprimantes, et ensuite on leur
-ajoute des imprimantes avec cette option.
-Le d�mpte et la v�fication sont effectu�sur
-une imprimante et sur tous les groupes auxquels elle
-appartient.
-Si l'option \fB\-\-remove\fR ci\-dessous n'est pas utilis�
-l'action par d�ut est d'ajouter les imprimantes aux
-groupes d'imprimantes sp�fi�
-.TP
-\fB\-l\fR | \fB\-\-list\fR
-Liste les informations sur les imprimantes et les
-groupes dont elles sont membres.
-.TP
-\fB\-r\fR | \fB\-\-remove\fR
-Combin�avec l'option \fB\-\-groups\fR ci\-dessus, supprime
-les imprimantes des groupes sp�fi�
-.TP
-\fB\-s\fR | \fB\-\-skipexisting\fR
-Combin�avec l'option \fB\-\-add\fR ci\-dessus, indique
-�kprinters de ne pas modifier les imprimantes
-existantes.
-.TP
-\fB\-m\fR | \fB\-\-maxjobsize\fR s
-Positionne la taille maximale autoris�d'un travail
-d'impression sur l'imprimante � pages.
-.TP
-\fB\-p\fR | \fB\-\-passthrough\fR
-Active le mode 'passthrough' pour l'imprimante. Dans
-ce mode, les utilisateurs peuvent imprimer sans impact
-sur leur quota ou sur le solde de leur compte.
-.TP
-\fB\-n\fR | \fB\-\-nopassthrough\fR D�ctive le mode 'passthrough' pour l'imprimante.
-Sans \fB\-p\fR ou \fB\-n\fR, les imprimantes sont cr�s en mode
-normal, c'est �ire non 'passthrough'.
+pkprinters \fB\-\-add\fR \fB\-\-cups\fR \fB\-D\fR "HP Printer" \fB\-\-charge\fR 0.05,0.1 hp2100 hp2200
+Would create three printers named 'hp2100', and 'hp2200' in PyKota's
+database, while telling CUPS to route all print jobs through PyKota for
+these printers. Each of them would have 'HP Printer' as its description.
+Printing to any of them would cost 0.05 credit per page, plus 0.1 credit
+for each job.
 .IP
-Les noms d'imprimantes peuvent contenir des caract�s jokers si l'option
-\fB\-\-add\fR n'est pas utilis�
-.PP
-exemples :
+pkprinters \fB\-\-delete\fR "*"
+Would delete all existing printers and matching print quota entries and
+printing history from PyKota's database. USE WITH CARE.
 .IP
-\f(CW$ pkprinters \-\-add -D "Imprimante HP" \-\-charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+pkprinters \fB\-\-groups\fR Laser,HP "hp*"
+Would add all printers which name begins with 'hp' to the 'Laser' and 'HP'
+printers groups, which must already exist.
 .IP
-Ceci va cr� les trois imprimantes hp2100, hp2200 and hp8000.
-Leur co�r page sera fix� 0.05 unit�et leur co�r travail sera
-fix� 0.1 unit�Les unit�sont dans votre propre monnaie,
-ou dans ce que vous voulez qu'elles signifient.
-Leurs descriptions seront positionn� �Imprimante HP".
-Si l'une de ces imprimantes existe d�, elle sera modifi��oins que
-l'option \fB\-s\fR|\-\-skipexisting ne soit aussi utilis�
+pkprinters \fB\-\-groups\fR Lexmark \fB\-\-remove\fR hp2200
+Would remove printer 'hp2200' from the 'Lexmark' printers group.
+.SS "licensing terms:"
 .IP
-\f(CW$ pkprinters \-\-delete "*"\fR
+(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.
 .IP
-Ceci va compl�ment effacer toutes les imprimantes, leurs informations
-de quota ainsi que leurs historiques des travaux. SOYEZ PRUDENTS !
+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
-\f(CW$ pkprinters \-\-groups Laser,HP "hp*"\fR
-.IP
-Ceci ba mettre toutes les imprimantes dont le nom correspond �hp*"
-dans les groupes Laser et HP, qui DOIVENT d� exister.
-.IP
-\f(CW$ pkprinters \-\-groups LexMark \-\-remove hp2200\fR
-.IP
-Ceci va enlever l'imprimante hp2200 du groupe LexMark.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/pkrefund.1

@@ -1 +1 @@
 .\" 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

pykota/trunk/man/fr/pksetup.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKSETUP "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKSETUP "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
 pksetup \- page de manuel de pksetup 0.1

pykota/trunk/man/fr/pkturnkey.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKTURNKEY "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKTURNKEY "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkturnkey \- page de manuel de pkturnkey 1.27alpha3_BROKEN_unofficial
+pkturnkey \- page de manuel de pkturnkey (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkturnkey
+[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR
 .SH DESCRIPTION
-pkturnkey v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un outil pour transformer PyKota en une solution clefs en main.
-Lorsqu'elle est lanc� cette commande va initialiser la base de donn�
-de PyKota avec toutes les files d'impressions et plusieurs ou tous les
-utilisateurs. Pour l'instant aucun quota n'est d�ni, aussi les impressions
-sont bien d�mpt�, mais non limit�. C'est pourquoi vous voudrez sans
-doute aussi utiliser edpykota une fois la base de donn� initialis�
-.PP
-ligne de commande :
+A turn key tool for PyKota. When launched, this command will initialize
+PyKota's database with all existing print queues and some or all users. For
+now, no prices or limits are set, so printing is fully accounted for, but not
+limited. That's why you'll probably want to also use edpykota once the
+database has been initialized.
+.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\-c\fR, \fB\-\-doconf\fR
+Try to autodetect the best print accounting settings
+for existing CUPS printers. All printers must be
+switched ON beforehand.
+.TP
+\fB\-d\fR, \fB\-\-dousers\fR
+Create accounts for users, and allocate print quota
+entries for them.
+.TP
+\fB\-D\fR, \fB\-\-dogroups\fR
+Create accounts for users groups, and allocate print
+quota entries for them.
+.TP
+\fB\-e\fR, \fB\-\-emptygroups\fR
+Also include groups which don't have any member.
+.TP
+\fB\-f\fR, \fB\-\-force\fR
+Modifies PyKota's database content for real, instead
+of faking it (for safety reasons).
+.TP
+\fB\-u\fR UIDMIN, \fB\-\-uidmin\fR=\fIUIDMIN\fR
+Only include users whose uid is greater than or equal
+to this parameter. If you pass an username instead,
+his uid will be used automatically.
+.TP
+\fB\-U\fR UIDMAX, \fB\-\-uidmax\fR=\fIUIDMAX\fR
+Only include users whose uid is lesser than or equal
+to this parameter. If you pass an username instead,
+his uid will be used automatically.
+.TP
+\fB\-g\fR GIDMIN, \fB\-\-gidmin\fR=\fIGIDMIN\fR
+Only include users groups whose gid is greater than or
+equal to this parameter. If you pass a groupname
+instead, its gid will be used automatically.
+.TP
+\fB\-G\fR GIDMAX, \fB\-\-gidmax\fR=\fIGIDMAX\fR
+Only include users groups whose gid is lesser than or
+equal to this parameter. If you pass a groupname
+instead, its gid will be used automatically.
+.SS "examples:"
 .IP
-pkturnkey [options] [noms des files d'impression]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche le num� de version de pkturnkey et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-c\fR | \fB\-\-doconf\fR
-Donne des conseils sur quoi mettre dans pykota.conf
-.TP
-\fB\-d\fR | \fB\-\-dousers\fR
-G� aussi les comptes utilisateurs.
-.TP
-\fB\-D\fR | \fB\-\-dogroups\fR
-G� aussi les groupes d'utilisateurs.
-Implique \fB\-d\fR | \fB\-\-dousers\fR.
-.TP
-\fB\-e\fR | \fB\-\-emptygroups\fR
-Inclure m� les groupes vides.
-.TP
-\fB\-f\fR | \fB\-\-force\fR
-Modifie la base de donn� plut�ue d'afficher ce
-qui serait fait.
-.TP
-\fB\-u\fR | \fB\-\-uidmin\fR uid
-Ajoute seulement les utilisateurs dont l'uid est
-sup�eur ou �l �a valeur de uid. Vous pouvez
-aussi indiquer un nom d'utilisateur, et sont uid sera
-utilis�utomatiquement.
-Si non positionn�0 sera utilis�utomatiquement.
-Implique \fB\-d\fR | \fB\-\-dousers\fR.
-.TP
-\fB\-U\fR | \fB\-\-uidmax\fR uid
-Ajoute seulement les utilisateurs dont l'uid est
-inf�eur ou �l �a valeur de uid. Vous pouvez
-aussi indiquer un nom d'utilisateur, et sont uid sera
-utilis�utomatiquement.
-Si non positionn�une grande valeur sera utilis�automatiquement.
-Implique \fB\-d\fR | \fB\-\-dousers\fR.
-.TP
-\fB\-g\fR | \fB\-\-gidmin\fR gid
-Ajoute seulement les groupes dont le gid est
-sup�eur ou �l �a valeur de gid. Vous pouvez
-aussi indiquer un nom de groupe, et sont gid sera
-utilis�utomatiquement.
-Si non positionn�0 sera utilis�utomatiquement.
-Implique \fB\-D\fR | \fB\-\-dogroups\fR.
-.TP
-\fB\-G\fR | \fB\-\-gidmax\fR gid
-Ajoute seulement les groupes dont le gid est
-inf�eur ou �l �a valeur de gid. Vous pouvez
-aussi indiquer un nom de groupe, et sont gid sera
-utilis�utomatiquement.
-Si non positionn�une grande valeur sera utilis�automatiquement.
-Implique \fB\-D\fR | \fB\-\-dogroups\fR.
-.PP
-exemples :
+pkturnkey \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2
+Would simulate the creation in PyKota's database of the printing accounts
+for all users whose uid is greater than or equal to 'jerome''s. Each of
+them would be given a print quota entry on printers 'HPLASER1' and
+\&'HPLASER2'.
 .IP
-\f(CW$ pkturnkey \-\-dousers \-\-uidmin jerome\fR
+pkturnkey \fB\-\-force\fR \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2
+Would do the same as the example above, but for real. Please take great
+care when using the \fB\-\-force\fR command line option.
 .IP
-Ceci va simuler l'initialisation de la base de donn� de PyKota avec
-toutes les files d'impression existantes et les comptes d'impression pour
-tous les utilisateurs ayant un uid sup�eur ou �l �elui de jerome.
-Aucun groupe ne sera cr�
+pkturnkey \fB\-\-doconf\fR
+Would try to automatically detect the best print accounting settings for
+all active printers, and generate some lines for you to add into your
+pykota.conf
+.SS "licensing terms:"
 .IP
-Pour VRAIMENT initialiser la base de donn� plut�ue de le simuler,
-vous voudrez bien utiliser l'option de ligne de commande \fB\-f\fR|\-\-force.
+(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.
 .IP
-Vous pouvez limiter l'initialisation �n sous ensemble des files
-d'impression, en passant leurs noms �a fin de la ligne de commande.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+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/>.

pykota/trunk/man/fr/pkusers.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKUSERS "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKUSERS "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkusers \- page de manuel de pkusers 1.27alpha3_BROKEN_unofficial
+pkusers \- page de manuel de pkusers (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkusers
+[\fIoptions\fR] [\fIusernames|groupnames\fR]
 .SH DESCRIPTION
-pkusers v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un gestionnaire d'utilisateurs et de groupes pour PyKota.
-.PP
-ligne de commande :
+Manages PyKota users or users groups.
+.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\-a\fR, \fB\-\-add\fR
+Add new, or modify existing, users or groups.
+.TP
+\fB\-b\fR BALANCE, \fB\-\-balance\fR=\fIBALANCE\fR
+Set an user's account balance. The value can also be
+increased or decreased when the value is prefixed with
+\&'+' or '\-'. Users groups don't have a real account
+balance, instead the sum of their members' account
+balances is used.
+.TP
+\fB\-C\fR COMMENT, \fB\-\-comment\fR=\fICOMMENT\fR
+Associate a textual comment with a change in an user's
+account balance. Only meaningful when \fB\-\-balance\fR is
+also used.
+.TP
+\fB\-d\fR, \fB\-\-delete\fR
+Delete the specified users or groups. Also purge the
+print quota entries and printing history matching the
+specified users or groups.
+.TP
+\fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR
+Set a textual description for the specified users or
+groups.
+.TP
+\fB\-e\fR EMAIL, \fB\-\-email\fR=\fIEMAIL\fR
+Set an user's email address. If this parameter begins
+with '@' then the username is prepended to this
+parameter to form a valid email address.
+.TP
+\fB\-g\fR, \fB\-\-groups\fR
+Manage users groups instead of users.
+.TP
+\fB\-i\fR INGROUPS, \fB\-\-ingroups\fR=\fIINGROUPS\fR
+Put the specified users into the specified groups.
+When combined with the \fB\-\-remove\fR option, users are
+removed from the specified groups instead.
+.TP
+\fB\-l\fR LIMITBY, \fB\-\-limitby\fR=\fILIMITBY\fR
+Set the limiting factor for the specified users or
+groups. Can be any of 'quota' (limit by number of
+pages per printer), 'balance' (limit by number of
+credits), 'noquota' (no limit but accounting done),
+\&'nochange' (no limit and no accounting), or 'noprint'
+(printing is denied). The two latter ones are not
+supported for groups.
+.TP
+\fB\-L\fR, \fB\-\-list\fR
+Display detailed informations about the specified
+users or groups.
+.TP
+\fB\-o\fR OVERCHARGE, \fB\-\-overcharge\fR=\fIOVERCHARGE\fR
+Set the overcharging factor applied to the specified
+users when computing the cost of a print job. Any
+floating point value can be used, allowing you to
+express your creativity...
+.TP
+\fB\-r\fR, \fB\-\-remove\fR
+When combined with the \fB\-\-ingroups\fR option, remove users
+from the specified users groups.
+.TP
+\fB\-s\fR, \fB\-\-skipexisting\fR
+If \fB\-\-add\fR is used, ensure that existing users or groups
+won't be modified.
+.SS "examples:"
 .IP
-pkusers [options] utilisateur1 utilisateur2 ... utilisateurN
-.PP
-ou :
+pkusers \fB\-\-add\fR john paul george ringo/ringo@example.com
+Would make users 'john', 'paul', 'george' and 'ringo' be known to PyKota.
+User 'ringo''s email address would be set to 'ringo@example.com'.
 .IP
-pkusers \fB\-\-groups\fR [options] groupe1 groupe2 ... groupeN
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche le num� de version de pkusers et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-a\fR | \fB\-\-add\fR
-Ajoute des utilisateurs s'ils n'existent pas d�
-dans la base de donn�. S'ils existent, ils sont
-modifi�sauf si \fB\-s\fR|\-\-skipexisting est aussi utilis�.TP
-\fB\-d\fR | \fB\-\-delete\fR
-Efface des utilisateurs de la base de donn�.
-.TP
-\fB\-e\fR | \fB\-\-email\fR adr
-Positionne l'adresse email des utilisateurs.
-Si le param�e adr commence par @, alors
-cette valeur est pr�x�par le nom d'utilisateur
-pour former une adresse email valide.
-.HP
-\fB\-D\fR | \fB\-\-description\fR d Ajoute une description textuelle aux utilisateurs.
-.TP
-\fB\-g\fR | \fB\-\-groups\fR
-Modifie des groupes d'utilisateurs plut�ue des
-utilisateurs.
-.TP
-\fB\-o\fR | \fB\-\-overcharge\fR f
-Positionne le coefficient de surtaxe appliqu�
-l'utilisateur lors du calcul du co�un travail
-d'impression. Des valeurs flottantes positives ou
-negatives sont permises, ceci permet de faire des
-choses vraiment cr�ives comme par exemple donner
-de l'argent �n utilisateur chaque fois qu'il imprime.
-Le nombre de pages d'un travail d'impression n'est
-pas modifi�ar ce coefficient, seul le co� travail
-pour un utilisateur particulier l'est.
-Seuls les utilisateurs ont un tel coefficient.
-.TP
-\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
-Met les utilisateurs dans chacun des groupes
-list� separ�par des virgules. Les groupes
-doivent d� exister dans la base de donn�.
-.TP
-\fB\-L\fR | \fB\-\-list\fR
-Liste les utilisateurs ou les groupes.
-.TP
-\fB\-l\fR | \fB\-\-limitby\fR l
-Choisit si l'utilisateur/groupe est is limit�ar
-le solde de son compte ou par un quota de pages.
-La valeur par d�ut est 'quota'. Les valeurs possibles
-sont 'quota' 'balance' 'noquota' 'noprint'
-et 'nochange' :
+pkusers \fB\-\-add\fR \fB\-\-groups\fR coders it
+Would create two users groups named 'coders' and 'it'.
 .IP
-\- quota : limite en nombre de pages par imprimante.
-\- balance : limite en nombre de cr�ts sur le compte.
-\- noquota : aucune limite, mais d�mpte effectu�\- nochange : aucune limite, aucun d�mpte.
-\- noprint : impression interdite.
+pkusers \fB\-\-add\fR \fB\-\-ingroups\fR coders,it jerome
+Would add user 'jerome' and put him into the 'coders' and 'it' groups.
+Both groups would have to be existing.
 .IP
-NB : nochange et noprint ne sont pas support�pour
+pkusers \fB\-\-limitby\fR balance \fB\-\-balance\fR 10.0 john
+Would give 10.0 credits to 'john' and make his printing be limited by his
+account balance.
 .IP
-les groupes.
-.TP
-\fB\-b\fR | \fB\-\-balance\fR b
-Positionne le solde de l'utilisateur �.
-Le solde peut �e incr�nt�u d��nt�i b
-est pr�d�'un signe + ou \-.
-ATTENTION : en d��ntant le solde, le total pay�ar l'utilisateur est �lement d��nt�Les groupes n'ont pas un v�table solde, mais la somme
-des soldes de tous leurs membres.
-.TP
-\fB\-C\fR | \fB\-\-comment\fR txt
-D�nit un texte d'information qui sera associ�vec le changement de valeur du solde de l'utilisateur.
-Seulement pris en compte si \fB\-b\fR | \fB\-\-balance\fR est utilis�.TP
-\fB\-r\fR | \fB\-\-remove\fR
-Combin�vec l'option \fB\-\-ingroups\fR ci\-dessus, enl�
-les utilisateurs des groupes sp�fi�
-.TP
-\fB\-s\fR | \fB\-\-skipexisting\fR
-Combin�vec l'option \fB\-\-add\fR ci\-dessus, indique �kusers
-de ne pas modifier les utilisateurs existants.
+pkusers \fB\-\-balance\fR +10.0 \fB\-\-comment\fR "He paid with his blood." jerome
+Would add 10.0 credits to 'jerome''s account and register a comment
+associated with his payment.
 .IP
-utilisateur1 �tilisateurN et groupe1 �roupeN peuvent contenir des jokers
-si l'option \fB\-\-add\fR n'est pas utilis�
-.PP
-exemples :
+pkusers \fB\-\-delete\fR "jer*" "rach*"
+Would delete all user accounts whose names begin with either 'jer' or
+\&'rach'.
 .IP
-\f(CW$ pkusers \-\-add john paul george ringo/ringo@example.com\fR
+pkusers \fB\-\-overcharge\fR \fB\-1\fR.50 theboss
+Would make the boss earn money whenever he prints.
 .IP
-Ceci va ajouter les utilisateurs john, paul, george et ringo �a base
-de donn�. L'adresse email de ringo sera positionn��ringo@example.com'
+pkusers \fB\-\-email\fR @example.com
+Would set the email address for each existing user to username@example.com
 .IP
-\f(CW$ pkusers \-\-ingroups coders,it jerome\fR
+pkusers \fB\-\-list\fR
+Would list all users.
+.SS "licensing terms:"
 .IP
-L'utilisateur jerome sera plac�an les groupes "coders" et "it" quit
-doivent exister dans la base de donn�.
+(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.
 .IP
-\f(CW$ pkusers \-\-limitby balance jerome\fR
+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
-Ceci va indiquer �yKota que jerome doit �e limit�ar le solde de son
-compte lorsqu'il imprime.
-.IP
-\f(CW$ pkusers \-\-balance +10.0 \-\-comment "Il a pay�vec son sang !" jerome\fR
-.IP
-Ceci va incr�nter le solde de jerome de 10.0 (dans votre propre monnaie)
-Vous pouvez d��nter le solde en pr�dant la valeur du signe \-,
-et le positionner �ne valeur fix�sans aucun pr�xe.
-Un commentaire sera stock�our le changement de la valeur du solde.
-.IP
-\f(CW$ pkusers \-\-delete jerome rachel\fR
-.IP
-Ceci va compl�ment effacer les utilisateurs jerome et rachel de la base
-de donn�. Tous leurs quotas et travaux d'impression seront aussi effac�
-.IP
-\f(CW$ pkusers \-\-overcharge 2.5 pauvreetudiant\fR
-.IP
-Ceci va surtaxer l'utilisateur pauvreetudiant par un facteur de 2.5.
-.IP
-\f(CW$ pkusers \-\-overcharge -1 jerome\fR
-.IP
-L'utilisateur jerome va gagner de l'argent chaque fois qu'il imprimera.
-.IP
-\f(CW$ pkusers \-\-overcharge 0 patron\fR
-.IP
-L'utilisateur patron peut imprimer �olont�cela ne lui co� rien
-car le co� chaque job sera multipli�ar 0 avant de modifier le solde
-de son compte.
-.IP
-\f(CW$ pkusers \-\-email @example.com\fR
-.IP
-Ceci va fixer l'adresse email de chaque utilisateur �om@example.com
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/pykosd.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PYKOSD "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PYKOSD "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pykosd \- page de manuel de pykosd 1.27alpha3_BROKEN_unofficial
+pykosd \- page de manuel de pykosd (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pykosd
+[\fIoptions\fR]
 .SH DESCRIPTION
-pykosd v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Un afficheur OSD de quota d'impression pour PyKota.
-.PP
-ligne de commande :
+An On Screen Display (OSD) monitor for PyKota's end users.
+.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\-c\fR COLOR, \fB\-\-color\fR=\fICOLOR\fR, \fB\-\-colour\fR=\fICOLOR\fR
+Set the color that will be used for display, as an
+hexadecimal triplet. For example #FF0000 is 100% red.
+The default is 100% green (#00FF00).
+.TP
+\fB\-d\fR DURATION, \fB\-\-duration\fR=\fIDURATION\fR
+Set the time in seconds during which the message will
+be displayed. Defaults to 3 seconds.
+.TP
+\fB\-f\fR FONT, \fB\-\-font\fR=\fIFONT\fR
+Set the font to use. Defaults to \-*\-helveticamedium\-r\-normal\-*\-*\-360\-*\-*\-p\-*\-*\-*.
+.TP
+\fB\-l\fR LOOP, \fB\-\-loop\fR=\fILOOP\fR
+Set the number of times the info will be displayed.
+Defaults to 0, which means loop forever.
+.TP
+\fB\-s\fR SLEEP, \fB\-\-sleep\fR=\fISLEEP\fR
+Set the sleeping time in seconds between two
+refreshes. Defaults to 180 seconds.
+.SS "examples:"
 .IP
-pykosd [options]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de pykosd et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-c\fR | \fB\-\-color\fR #rrggbb Fixe la couleur �tiliser pour l'affichage �n
-triplet hexadecimal, par exemple #FF0000 est 100%
-de rouge.
-La valeur par d�ut est 100% de vert (#00FF00).
-.TP
-\fB\-d\fR | \fB\-\-duration\fR d
-Fixe la dur�de l'affichage en secondes.
-La valeur par d�ut est de 3 secondes.
-.TP
-\fB\-f\fR | \fB\-\-font\fR f
-Fixe la police de caract�s �tiliser pour
-l'affichage.
-La valeur par d�ut est celle de la librairie
-Python OSD.
-.TP
-\fB\-l\fR | \fB\-\-loop\fR n
-Fixe le nombre de fois o�nformation sera affich�
-La valeur par d�ut est 0, qui indique un nombre
-d'affichages infini.
-.TP
-\fB\-s\fR | \fB\-\-sleep\fR s
-Fixe la dur�en secondes de sommeil entre deux
-affichages. La valeur par d�ut est 180 (3 minutes).
-.PP
-exemples :
+pykosd \fB\-s\fR 60 \fB\-\-loop\fR 5
+This would tell pykosd to display the current user's status for 3 seconds
+(the default) every 60 seconds, and exit after 5 iterations.
+.SS "licensing terms:"
 .IP
-\f(CW$ pykosd -s 60 \-\-loop 5\fR
+(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.
 .IP
-Lance pykosd. L'affichage sera rafra�it toutes les 60 secondes,
-et persistera pendant 3 secondes (la valeur par d�ut) �haque fois.
-Apr�5 it�tions, le programme se terminera.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+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/>.

pykota/trunk/man/fr/pykotme.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PYKOTME "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PYKOTME "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pykotme \- page de manuel de pykotme 1.27alpha3_BROKEN_unofficial
+pykotme \- page de manuel de pykotme (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pykotme
+[\fIoptions\fR] [\fIfiles\fR]
 .SH DESCRIPTION
-pykotme v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Fait des devis d'impression aux utilisateurs.
-.PP
-ligne de commande :
+Generates print quotes for end users.
+.SH OPTIONS
 .TP
-pykotme
-[options]  [fichiers]
-.PP
-options :
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit.
 .TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de pykotme et quitte.
+\fB\-v\fR, \fB\-\-version\fR
+show the version number and exit.
 .TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
+\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR
+loads additional options and arguments from a file,
+one per line.
 .TP
-\fB\-P\fR | \fB\-\-printer\fR p
-Fait un devis sur cette imprimante seulement.
-En fait p peut contenir des caract�s jokers
-pour s�ctionner seulement certaines imprimantes.
-La valeur par d�ut est *, qui signifie toutes les
-imprimantes.
-Vous pouvez sp�fier plusieurs noms ou jokers,
-en les s�rant avec des virgules.
-.PP
-exemples :
+\fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR
+Acts on this printer only. You can specify several
+printer names by separating them with commas. The
+default value is '*', which means all printers.
+.TP
+\fB\-u\fR USER, \fB\-\-user\fR=\fIUSER\fR
+Acts on this user only. Only one username can be
+specified this way. The default value is the name of
+the user who launched this command. This option is
+ignored when the command is not launched by a PyKota
+Administrator.
+.SS "examples:"
 .IP
-\f(CW$ pykotme \-\-printer apple fichier1.ps fichier2.ps\fR
+pykotme \fB\-\-printer\fR apple file1.ps <file2.pclxl
+This would show the number of pages needed to print these two files, as
+well as the cost of printing them to the 'apple' printer for the user who
+launched this command.
 .IP
-Ceci va �blir un devis d'impression pour l'utilisateur courant.
-Ce devis indiquera la taille et le co�r l'imprimante apple d'un
-travail d'impression consitant en fichier1.ps et fichier2.ps
+pykotme \fB\-\-user\fR john
+This would show the number of pages needed to print the content of the
+standard input, and the cost of printing this on all printers for user
+\&'john'.
+.SS "licensing terms:"
 .IP
-\f(CW$ pykotme \-\-printer apple,hplaser <fichier1.ps\fR
+(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.
 .IP
-Ceci va �blir un devis d'impression pour l'utilisateur courant.
-Ce devis indiquera la taille et le co�un travail provenant de l'entr�standard dans laquelle on redirigerait le fichier fichier1.ps et qui
-serait envoy�sur les imprimantes apple ou hplaser.
+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
-\f(CW$ pykotme\fR
-.IP
-Ceci va �blir un devis d'impression pour l'utilisateur courant.
-Ce devis indiquera la taille et le co�un travail provenant de l'entr�standard, et ce pour chaque imprimante.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/repykota.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH REPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH REPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-repykota \- page de manuel de repykota 1.27alpha3_BROKEN_unofficial
+repykota \- page de manuel de repykota (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B repykota
+[\fIoptions\fR] [\fIusernames|groupnames\fR]
 .SH DESCRIPTION
-repykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-G�re des rapports de quotas d'impression.
-.PP
-ligne de commande :
+Minimalist print accounting reports for PyKota. If not launched by a PyKota
+administrator, additionnal arguments representing users or groups names are
+ignored, limiting the scope of the reports to the current user.
+.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\-g\fR, \fB\-\-groups\fR
+Generate group print quota reports instead of user
+print quota reports.
+.TP
+\fB\-i\fR INGROUPS, \fB\-\-ingroups\fR=\fIINGROUPS\fR
+Only report users who are members of the specified
+groups. This option is reserved to PyKota
+administrators.
+.TP
+\fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR
+Acts on this printer only. You can specify several
+printer names by separating them with commas. The
+default value is '*', which means all printers.
+.SS "examples:"
 .IP
-repykota [options]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de repykota et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-u\fR | \fB\-\-users\fR
-G�re un rapport sur les quotas des utilisateurs,
-c'est la valeur par d�ut.
-.TP
-\fB\-g\fR | \fB\-\-groups\fR
-G�re un rapport sur les quotas de groupes plut�ue sur ceux des utilisateurs.
-.TP
-\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
-Liste seulement les utilisateurs membres de ces
-groupes. Reserv�ux Administrateurs PyKota
-.TP
-\fB\-P\fR | \fB\-\-printer\fR p
-Renvoie les quotas pour cette imprimante seulement.
-En fait p peut contenir des caract�s jokers pour
-s�ctionner certaines imprimantes seulement.
-La valeur par d�ut est *, qui signifie de v�fier
-les quotas sur toutes les imprimantes.
-Vous pouvez pr�ser plusieurs noms ou jokers,
-en les s�rant avec des virgules.
-.PP
-exemples :
+repykota
+This would generate a report for all users on all printers.
 .IP
-\f(CW$ repykota \-\-printer lp\fR
+repykota \fB\-\-printer\fR HP2100
+This would generate a report for all users who print to printer 'HP2100'.
 .IP
-Ceci va afficher un rapport de quotas pour tous les utilisateurs de
-l'imprimante lp.
+repykota \fB\-\-printer\fR "laser*,*pson" jerome "jo*"
+This would generate a report for all users named 'jerome' or whose name
+begins with 'jo', on all printers which name begins with 'laser' or ends
+with 'pson'.
+.SS "licensing terms:"
 .IP
-\f(CW$ repykota\fR
+(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.
 .IP
-Ceci va afficher un rapport pour tous les utilisateurs sur toutes les
-imprimantes.
+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
-\f(CW$ repykota \-\-printer "laser*,*pson" jerome "jo*"\fR
-.IP
-Ceci va afficher un rapport pour l'utilisateur jerome et tous les
-utilisateurs dont le nom commence par "jo" sur toutes les imprimantes
-dont le nom commence par "laser" ou se termine par "pson".
-.IP
-Si cette commande est lanc�par un utilisateur qui n'est pas un
-administrateur PyKota, les arguments additionnels repr�ntant des noms
-d'utilisateurs ou de groupes sont ignor� et un rapport traitant seulement
-de l'utilisateur ou du groupe courant est g�r�.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.

pykota/trunk/man/fr/warnpykota.1

@@ -1 +1 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH WARNPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH WARNPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-warnpykota \- page de manuel de warnpykota 1.27alpha3_BROKEN_unofficial
+warnpykota \- page de manuel de warnpykota (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B warnpykota
+[\fIoptions\fR] [\fIusernames|groupnames\fR]
 .SH DESCRIPTION
-warnpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-Pr�ent les utilisateurs ayant atteint leurs limites.
-.PP
-ligne de commande :
+A tool to warn users and groups who have reached the limit of their printing
+quota.
+.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\-g\fR, \fB\-\-groups\fR
+Notify all members for all the named groups which have
+reached the limit of their printing quota. Without
+this option, individual users are notified instead of
+users groups.
+.TP
+\fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR
+Acts on this printer only. You can specify several
+printer names by separating them with commas. The
+default value is '*', which means all printers.
+.SS "examples:"
+.IP
 warnpykota
-[options]  [noms]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Affiche la version de warnpykota et quitte.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Affiche ce message et quitte.
-.TP
-\fB\-u\fR | \fB\-\-users\fR
-Pr�ent les utilisateur ayant atteint leurs limites,
-c'est la valeur par d�ult.
-.TP
-\fB\-g\fR | \fB\-\-groups\fR
-Pr�ent les utilisateurs dont les groupes auxquels
-ils appartiennent ont atteint leurs limites.
-.TP
-\fB\-P\fR | \fB\-\-printer\fR p
-Verifie les quotas sur cette imprimante seulement.
-En fait p peut contenir des caract�s jokers pour
-s�ctionner certaines imprimantes seulement.
-La valeur par d�ut est *, qui signifie de v�fier
-les quotas sur toutes les imprimantes.
-Vous pouvez pr�ser plusieurs noms ou jokers,
-en les s�rant avec des virgules.
-.PP
-exemples :
+This would notify all users who have reached the limit of their printing
+quota on any printer.
 .IP
-\f(CW$ warnpykota \-\-printer lp\fR
+warnpykota \fB\-\-printer\fR HP2100
+This would notify all users who have reached the limit of their printing
+quota on printer 'HP2100'.
 .IP
-Ceci va pr�nir tous les utilisateurs ayant atteint leur limite sur
-l'imprimante lp.
+warnpykota \fB\-\-groups\fR \fB\-\-printer\fR "HP*,XER*" "dev*"
+This would notify all users of the groups whose name begins with 'dev' and
+for which the printing quota limit is reached on any printer whose name
+begins with 'HP' or 'XER'.
+.SS "licensing terms:"
 .IP
-\f(CW$ warnpykota\fR
+(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.
 .IP
-Ceci va pr�nir tous les utilisateurs ayant atteint leurs limites quelle
-que soit l'imprimanter.
+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
-\f(CW$ warnpykota \-\-groups \-\-printer "laserjet*" "dev*"\fR
-.IP
-Ceci va pr�nir tous les membres des groupes dont les noms commencent
-par "dev" et qui ont atteints leurs limites sur toutes les imprimantes
-dont le nom commence par "laserjet".
-.IP
-Si cette commande est lanc�par un utilisateur qui n'est pas un
-administrateur PyKota, les arguments additionnels repr�ntant des noms
-d'utilisateurs ou de groupes sont ignor� et seulement l'utilisateur ou
-le groupe courant est pr�nu.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 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
-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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.