.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKREFUND "1" "juillet 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NOM
pkrefund \- page de manuel de pkrefund 1.26_unofficial
.SH DESCRIPTION
pkrefund v1.26_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
.PP
Rembourse les travaux d'impression.
.PP
ligne de commande :
.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çus. Le
logo sera dessiné au centre et en haut de la page.
Le logo par défaut est
.IP
/usr/share/pykota/logos/pykota.jpeg
.TP
\fB\-p\fR | \fB\-\-pagesize\fR sz
Positionne la taille de page à sz. La plupart des
tailles standard sont reconnues, comme 'A4' ou 'Letter'
par exemple. La taille par défaut est A4.
.TP
\fB\-n\fR | \fB\-\-number\fR N
Indique le numéro du premier reçu. Ce numéro
sera automatiquement incrémenté à chaque nouveau reçu.
.TP
\fB\-o\fR | \fB\-\-output\fR f.pdf
Définit le nom du fichier PDF qui contiendra les
reçus. S'il n'est pas précisé alors aucun fichier ne
sera généré. Si '\-' est utilisé, le fichier PDF sera
envoyé sur la sortie standard, et l'option \fB\-\-force\fR
sera activée automatiquement.
.TP
\fB\-u\fR | \fB\-\-unit\fR u
Définit le nom de l'unité à utiliser sur les reçus.
Le nom par défaut est 'Credits', ou sa traduction
éventuelle dans votre langage préféré si PyKota
le supporte.
.IP
Utilisez les expressions de filtrage pour extraire seulement certaines
parties des données. Les filtres autorisés sont de la forme :
.IP
clé=valeur
.IP
Les clés autorisées pour l'instant sont :
.TP
username
Nom de l'utilisateur
.TP
printername
Nom de l'imprimante
.TP
hostname
Nom d'hôte 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és 'start' et 'end' :
.IP
AAAA : limites d'année
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ésente
la première ou la dernière seconde du jour selon qu'il soit utilisé avec
une expression de type start= ou end=.
L'utilité de pouvoir spécifier une date dans le future est une question
qui reste ouverte :\-)
.IP
Contrairement aux autres outils d'administration de PyKota, les caractères
jokers ne sont pas expansés, aussi vous ne pouvez pas les utiliser.
.PP
Exemples :
.IP
\f(CW$ pkrefund --output /tmp/recus.pdf jobid=503\fR
.IP
Cela va rembourser tous les travaux dont l'identifiant est 503.
ATTENTION : installer CUPS à nouveau va remettre l'identifiant à 1
aussi vous voudrez certainement utiliser un filtre plus précis
comme expliqué ci\-dessous. Une confirmation sera demandée pour chaque
remboursement, et un fichier PDF nommé /tmp/recus.pdf sera créé et
contiendra les reçus imprimables.
.IP
\f(CW$ pkrefund --reason "Problème matériel" jobid=503 start=today-7\fR
.IP
Rembourse tous les travaux dont l'identifiant est 503 et qui ont été
imprimés la semaine dernière. La raison indiquée sera un problème matériel.
.IP
\f(CW$ pkrefund --force username=jerome printername=HP2100\fR
.IP
Rembourse tous les travaux imprimés par l'utilisateur jerome sur
l'imprimante HP2100. Aucune confirmation ne sera demandée.
.IP
\f(CW$ pkrefund --force printername=HP2100 start=200602 end=yesterday\fR
.IP
Rembourse tous les travaux imprimés sur l'imprimante HP2100 entre le
premier Février 2006 et hier. Aucune confirmation ne sera demandée.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.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, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Merci d'envoyer les rapports de bugs à : Jerome Alet \- alet@librelogiciel.com