root / pykota / trunk / man / pt_BR / pkrefund.1 @ 3201

Revision 3201, 4.5 kB (checked in by jerome, 17 years ago)

v1.26beta is out

Line 
1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
2.TH PKREFUND "1" "juillet 2007" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
3.SH NOM
4pkrefund \- page de manuel de pkrefund 1.26beta_unofficial
5.SH DESCRIPTION
6pkrefund v1.26beta_unofficial (c) 2003, 2004, 2005, 2006, 2007 Jerome Alet \- alet@librelogiciel.com
7.PP
8Refunds jobs.
9.PP
10command line usage :
11.IP
12pkrefund [options] [filterexpr]
13.PP
14options :
15.TP
16\fB\-v\fR | \fB\-\-version\fR
17Prints pkrefund's version number then exits.
18.TP
19\fB\-h\fR | \fB\-\-help\fR
20Prints this message then exits.
21.TP
22\fB\-f\fR | \fB\-\-force\fR
23Doesn't ask for confirmation before refunding jobs.
24.TP
25\fB\-r\fR | \fB\-\-reason\fR txt
26Sets textual information to explain the refunding.
27.TP
28\fB\-l\fR | \fB\-\-logo\fR img
29Use the image as the receipt's logo. The logo will
30be drawn at the center top of the page. The default
31logo is /usr/share/pykota/logos/pykota.jpeg
32.TP
33\fB\-p\fR | \fB\-\-pagesize\fR sz
34Sets sz as the page size. Most well known
35page sizes are recognized, like 'A4' or 'Letter'
36to name a few. The default size is A4.
37.TP
38\fB\-n\fR | \fB\-\-number\fR N
39Sets the number of the first receipt. This number
40will automatically be incremented for each receipt.
41.TP
42\fB\-o\fR | \fB\-\-output\fR f.pdf
43Defines the name of the PDF file which will contain
44the receipts. If not set, then no PDF file will
45be created. If set to '\-', then \fB\-\-force\fR is assumed,
46and the PDF document is sent to standard output.
47.TP
48\fB\-u\fR | \fB\-\-unit\fR u
49Defines the name of the unit to use on the receipts.
50The default unit is 'Credits', optionally translated
51to your native language if it is supported by PyKota.
52.IP
53Use the filter expressions to extract only parts of the
54datas. Allowed filters are of the form :
55.IP
56key=value
57.IP
58Allowed keys for now are :
59.TP
60username
61User's name
62.TP
63printername
64Printer's name
65.TP
66hostname
67Client's hostname
68.TP
69jobid
70Job's Id
71.TP
72billingcode
73Job's billing code
74.TP
75start
76Job's date of printing
77.TP
78end
79Job's date of printing
80.IP
81Dates formatting with 'start' and 'end' filter keys :
82.IP
83YYYY : year boundaries
84YYYYMM : month boundaries
85YYYYMMDD : day boundaries
86YYYYMMDDhh : hour boundaries
87YYYYMMDDhhmm : minute boundaries
88YYYYMMDDhhmmss : second boundaries
89yesterday[+\-NbDays] : yesterday more or less N days (e.g. : yesterday\-15)
90today[+\-NbDays] : today more or less N days (e.g. : today\-15)
91tomorrow[+\-NbDays] : tomorrow more or less N days (e.g. : tomorrow\-15)
92now[+\-NbDays] : now more or less N days (e.g. now\-15)
93.IP
94\&'now' and 'today' are not exactly the same since today represents the first
95or last second of the day depending on if it's used in a start= or end=
96date expression. The utility to be able to specify dates in the future is
97a question which remains to be answered :\-)
98.IP
99Contrary to other PyKota management tools, wildcard characters are not
100expanded, so you can't use them.
101.PP
102Examples :
103.IP
104\f(CW$ pkrefund --output /tmp/receipts.pdf jobid=503\fR
105.IP
106This will refund all jobs which Id is 503. BEWARE : installing CUPS
107afresh will reset the first job id at 1, so you probably want to use
108a more precise filter as explained below. A confirmation will
109be asked for each job to refund, and a PDF file named /tmp/receipts.pdf
110will be created which will contain printable receipts.
111.IP
112\f(CW$ pkrefund --reason "Hardware problem" jobid=503 start=today-7\fR
113.IP
114Refunds all jobs which id is 503 but which were printed during the
115past week. The reason will be marked as being an hardware problem.
116.IP
117\f(CW$ pkrefund --force username=jerome printername=HP2100\fR
118.IP
119Refunds all jobs printed by user jerome on printer HP2100. No
120confirmation will be asked.
121.IP
122\f(CW$ pkrefund --force printername=HP2100 start=200602 end=yesterday\fR
123.IP
124Refunds all jobs printed on printer HP2100 between February 1st 2006
125and yesterday. No confirmation will be asked.
126.PP
127This program is free software; you can redistribute it and/or modify
128it under the terms of the GNU General Public License as published by
129the Free Software Foundation; either version 2 of the License, or
130(at your option) any later version.
131.PP
132This program is distributed in the hope that it will be useful,
133but WITHOUT ANY WARRANTY; without even the implied warranty of
134MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
135GNU General Public License for more details.
136.PP
137You should have received a copy of the GNU General Public License
138along with this program; if not, write to the Free Software
139Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
140.PP
141Please report bugs to : Jerome Alet \- alet@librelogiciel.com
Note: See TracBrowser for help on using the browser.