Show
Ignore:
Timestamp:
01/24/09 22:38:46 (15 years ago)
Author:
jerome
Message:

Updated manual pages.

Files:
1 modified

Legend:

Unmodified
Added
Removed

  • pykota/trunk/man/fr/pkrefund.1

    r3279 r3485  
    11.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36. 
    2 .TH PKREFUND "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 
     2.TH PKREFUND "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 
    33.SH NOM 
    4 pkrefund \- page de manuel de pkrefund 1.27alpha3_BROKEN_unofficial 
     4pkrefund \- page de manuel de pkrefund (PyKota) 1.27alpha7_unofficial 
     5.SH SYNOPSIS 
     6.B pkrefund 
     7[\fIoptions\fR] [\fIfilterexpr\fR] 
    58.SH DESCRIPTION 
    6 pkrefund v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 
    7 .PP 
    8 Rembourse les travaux d'impression. 
    9 .PP 
    10 ligne de commande : 
     9Refunding tool for PyKota. 
     10.SH OPTIONS 
     11.TP 
     12\fB\-h\fR, \fB\-\-help\fR 
     13show this help message and exit. 
     14.TP 
     15\fB\-v\fR, \fB\-\-version\fR 
     16show the version number and exit. 
     17.TP 
     18\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 
     19loads additional options and arguments from a file, 
     20one per line. 
     21.TP 
     22\fB\-f\fR, \fB\-\-force\fR 
     23Doesn't ask for confirmation before refunding. Only 
     24needed if you specify a filename for the PDF receipts. 
     25If you send such receipts to stdout, \fB\-\-force\fR is 
     26assumed to be set. 
     27.TP 
     28\fB\-i\fR INFO, \fB\-\-info\fR=\fIINFO\fR 
     29The informations to be prepended to the refunding 
     30reason, which can include some of Python's string 
     31interpolations to access to certain internal values. 
     32If you don't want such information, set this 
     33explicitely to an empty string. The default is 
     34\&'''Refunded %(nbpages)i pages and %(nbcredits).3f 
     35credits by %(effectiveuser)s (%(loginname)s) on 
     36%(date)s''' 
     37.TP 
     38\fB\-l\fR LOGO, \fB\-\-logo\fR=\fILOGO\fR 
     39The image to use as a logo. The logo will be drawn at 
     40the center top of the page. The default logo is 
     41/usr/share/pykota/logos/pykota.jpeg. 
     42.TP 
     43\fB\-n\fR NUMBER, \fB\-\-number\fR=\fINUMBER\fR 
     44Sets the number of the first receipt. This number will 
     45automatically be incremented for each receipt. The 
     46default value is 1. 
     47.TP 
     48\fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR 
     49The name of the file to which the PDF receipts will be 
     50written. If not set or set to '\-', the PDF document 
     51will be sent to the standard output, and \fB\-\-force\fR will 
     52be assumed to be set. 
     53.TP 
     54\fB\-p\fR PAGESIZE, \fB\-\-pagesize\fR=\fIPAGESIZE\fR 
     55Set the size of the page. Most well known page sizes 
     56are recognized, like 'A4' or 'Letter' to name a few. 
     57The default page size is A4. 
     58.TP 
     59\fB\-r\fR REASON, \fB\-\-reason\fR=\fIREASON\fR 
     60The reason why there was a refund. 
     61.TP 
     62\fB\-u\fR UNIT, \fB\-\-unit\fR=\fIUNIT\fR 
     63The name of the unit to use on the receipts. The 
     64default value is 'Credits' or its locale translation. 
     65.SS "filtering expressions:" 
    1166.IP 
    12 pkrefund [options] [filtres] 
    13 .PP 
    14 options : 
    15 .TP 
    16 \fB\-v\fR | \fB\-\-version\fR 
    17 Affiche la version de pkrefund et quitte. 
    18 .TP 
    19 \fB\-h\fR | \fB\-\-help\fR 
    20 Affiche ce message et quitte. 
    21 .TP 
    22 \fB\-f\fR | \fB\-\-force\fR 
    23 Ne demande pas confirmation avant de rembourser 
    24 les travaux d'impression. 
    25 .TP 
    26 \fB\-r\fR | \fB\-\-reason\fR txt 
    27 Indique la raison du remboursement. 
    28 .TP 
    29 \fB\-l\fR | \fB\-\-logo\fR img 
    30 Utilise cette image comme logo sur les re�. Le 
    31 logo sera dessin�u centre et en haut de la page. 
    32 Le logo par d�ut est 
     67Use the filtering expressions to extract only parts of the datas. Allowed 
     68filters are of the form 'key=value'. Wildcards are not expanded as part of 
     69these filtering expressions, so you can't use them here. 
    3370.IP 
    34 /usr/share/pykota/logos/pykota.jpeg 
    35 .TP 
    36 \fB\-p\fR | \fB\-\-pagesize\fR sz 
    37 Positionne la taille de page �z. La plupart des 
    38 tailles standard sont reconnues, comme 'A4' ou 'Letter' 
    39 par exemple. La taille par d�ut est A4. 
    40 .TP 
    41 \fB\-n\fR | \fB\-\-number\fR N 
    42 Indique le num� du premier re� Ce num� 
    43 sera automatiquement incr�nt� chaque nouveau re� 
    44 .TP 
    45 \fB\-o\fR | \fB\-\-output\fR f.pdf 
    46 D�nit le nom du fichier PDF qui contiendra les 
    47 re�. S'il n'est pas pr�s�lors aucun fichier ne 
    48 sera g�r�Si '\-' est utilis�le fichier PDF sera 
    49 envoy�ur la sortie standard, et l'option \fB\-\-force\fR 
    50 sera activ�automatiquement. 
    51 .TP 
    52 \fB\-u\fR | \fB\-\-unit\fR u 
    53 D�nit le nom de l'unit� utiliser sur les re�. 
    54 Le nom par d�ut est 'Credits', ou sa traduction 
    55 �ntuelle dans votre langage pr�r�i PyKota 
    56 le supporte. 
     71allowed keys for now: 
    5772.IP 
    58 Utilisez les expressions de filtrage pour extraire seulement certaines 
    59 parties des donn�. Les filtres autoris�sont de la forme : 
     73username : User's name 
     74printername : Printer's name 
     75hostname : Host's name 
     76jobid : Job's id 
     77billingcode : Job's billing code 
     78start : Job's date of printing 
     79end : Job's date of printing 
    6080.IP 
    61 cl�aleur 
     81formatting of dates with the 'start' and 'end' filtering keys: 
    6282.IP 
    63 Les cl�autoris� pour l'instant sont : 
    64 .TP 
    65 username 
    66 Nom de l'utilisateur 
    67 .TP 
    68 printername 
    69 Nom de l'imprimante 
    70 .TP 
    71 hostname 
    72 Nom d'h�de la machine cliente 
    73 .TP 
    74 jobid 
    75 Id du travail d'impression 
    76 .TP 
    77 billingcode 
    78 Code de facturation du travail d'impression 
    79 .TP 
    80 start 
    81 Date du travail d'impression 
    82 .TP 
    83 end 
    84 Date du travail d'impression 
     83YYYY : year boundaries 
     84YYYYMM : month boundaries 
     85YYYYMMDD : day boundaries 
     86YYYYMMDDhh : hour boundaries 
     87YYYYMMDDhhmm : minute boundaries 
     88YYYYMMDDhhmmss : second boundaries 
     89yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15) 
     90today[+\-N] : today more or less N days (e.g. : today\-15) 
     91tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15) 
     92now[+\-N] : now more or less N days (e.g. now\-15) 
    8593.IP 
    86 Formatage des dates avec les cl�'start' et 'end' : 
     94\&'now' and 'today' are not exactly the same since 'today' represents the 
     95first or last second of the day depending on if it's used in a 'start=' or 
     96\&'end=' date expression. 
    8797.IP 
    88 AAAA : limites d'ann�AAAAMM : limites de mois 
    89 AAAAMMJJ : limites de jour 
    90 AAAAMMJJhh : limites d'heures 
    91 AAAAMMJJhhmm : limites de minutes 
    92 AAAAMMJJhhmmss : limites de secondes 
    93 yesterday[+\-NbJours] : hier plus ou moins N jours (ex : yesterday\-15) 
    94 today[+\-NbJours] : aujoud'hui plus ou moins N jours (ex : today\-15) 
    95 tomorrow[+\-NbJours] : demain plus ou moins N jours (ex : tomorrow\-15) 
    96 now[+\-NbJours] : maintenant plus ou moins N jours (ex : now\-15) 
     98examples: 
    9799.IP 
    98 \&'now' et 'today' ne sont pas exactement identiques car today repr�nte 
    99 la premi� ou la derni� seconde du jour selon qu'il soit utilis�vec 
    100 une expression de type start= ou end=. 
    101 L'utilit�e pouvoir sp�fier une date dans le future est une question 
    102 qui reste ouverte :\-) 
     100pkrefund \fB\-\-output\fR /tmp/receipts.pdf jobid=503 
     101This would refund all jobs which Id is 503. A confirmation would be 
     102asked for each job to refund, and a PDF file named /tmp/receipts.pdf 
     103would be created containing printable receipts. BEWARE of job ids 
     104rolling over if you reset CUPS' history. 
    103105.IP 
    104 Contrairement aux autres outils d'administration de PyKota, les caract�s 
    105 jokers ne sont pas expans� aussi vous ne pouvez pas les utiliser. 
    106 .PP 
    107 Exemples : 
     106pkrefund \fB\-\-reason\fR "Hardware problem" jobid=503 start=today\-7 
     107This would refund all jobs which id is 503 but which would have been 
     108printed during the  past week. The reason would be marked as being an 
     109hardware problem. 
    108110.IP 
    109 \f(CW$ pkrefund \-\-output /tmp/recus.pdf jobid=503\fR 
     111pkrefund \fB\-\-force\fR username=jerome printername=HP2100 
     112This would refund all jobs printed by user jerome on printer HP2100. 
     113No confirmation would be asked. 
    110114.IP 
    111 Cela va rembourser tous les travaux dont l'identifiant est 503. 
    112 ATTENTION : installer CUPS �ouveau va remettre l'identifiant � 
    113 aussi vous voudrez certainement utiliser un filtre plus pr�s 
    114 comme expliqu�i\-dessous. Une confirmation sera demand�pour chaque 
    115 remboursement, et un fichier PDF nomm�tmp/recus.pdf sera cr�et 
    116 contiendra les re� imprimables. 
     115pkrefund \fB\-\-force\fR printername=HP2100 start=200602 end=yesterday 
     116This would refund all jobs printed on printer HP2100 between February 
     1171st 2006 and yesterday. No confirmation would be asked. 
    117118.IP 
    118 \f(CW$ pkrefund \-\-reason "Probl� mat�el" jobid=503 start=today-7\fR 
     119licensing terms: 
    119120.IP 
    120 Rembourse tous les travaux dont l'identifiant est 503 et qui ont � 
    121 imprim�la semaine derni�. La raison indiqu�sera un probl� mat�el. 
    122 .IP 
    123 \f(CW$ pkrefund \-\-force username=jerome printername=HP2100\fR 
    124 .IP 
    125 Rembourse tous les travaux imprim�par l'utilisateur jerome sur 
    126 l'imprimante HP2100. Aucune confirmation ne sera demand� 
    127 .IP 
    128 \f(CW$ pkrefund \-\-force printername=HP2100 start=200602 end=yesterday\fR 
    129 .IP 
    130 Rembourse tous les travaux imprim�sur l'imprimante HP2100 entre le 
    131 premier F�ier 2006 et hier. Aucune confirmation ne sera demand� 
    132 .PP 
    133 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 
     121(c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 
    134122This program is free software: you can redistribute it and/or modify 
    135123it under the terms of the GNU General Public License as published by 
    136 the Free Software Foundation, either version 3 of the License, or 
    137 (at your option) any later version. 
    138 .PP 
    139 This program is distributed in the hope that it will be useful, 
    140 but WITHOUT ANY WARRANTY; without even the implied warranty of 
    141 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
    142 GNU General Public License for more details. 
    143 .PP 
     124the Free Software Foundation, either version 3 of the License, or (at 
     125your option) any later version. 
     126.IP 
     127This program is distributed in the hope that it will be useful, but 
     128WITHOUT ANY WARRANTY; without even the implied warranty of 
     129MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU 
     130General Public License for more details. 
     131.IP 
    144132You should have received a copy of the GNU General Public License 
    145133along with this program.  If not, see <http://www.gnu.org/licenses/>. 
    146 .PP 
    147 Merci d'envoyer les rapports de bugs � Jerome Alet \- alet@librelogiciel.com