Changeset 3485 for pykota/trunk/man/es/pkrefund.1
- Timestamp:
- 01/24/09 22:38:46 (15 years ago)
- Files:
-
- 1 modified
Legend:
- Unmodified
- Added
- Removed
-
pykota/trunk/man/es/pkrefund.1
r3279 r3485 1 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. 2 .TH PKREFUND "1" "janvier 200 8" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"2 .TH PKREFUND "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" 3 3 .SH NOM 4 pkrefund \- page de manuel de pkrefund 1.27alpha3_BROKEN_unofficial 4 pkrefund \- page de manuel de pkrefund (PyKota) 1.27alpha7_unofficial 5 .SH SYNOPSIS 6 .B pkrefund 7 [\fIoptions\fR] [\fIfilterexpr\fR] 5 8 .SH DESCRIPTION 6 pkrefund v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com 7 .PP 8 Refunds jobs. 9 .PP 10 command line usage : 9 Refunding tool for PyKota. 10 .SH OPTIONS 11 .TP 12 \fB\-h\fR, \fB\-\-help\fR 13 show this help message and exit. 14 .TP 15 \fB\-v\fR, \fB\-\-version\fR 16 show the version number and exit. 17 .TP 18 \fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR 19 loads additional options and arguments from a file, 20 one per line. 21 .TP 22 \fB\-f\fR, \fB\-\-force\fR 23 Doesn't ask for confirmation before refunding. Only 24 needed if you specify a filename for the PDF receipts. 25 If you send such receipts to stdout, \fB\-\-force\fR is 26 assumed to be set. 27 .TP 28 \fB\-i\fR INFO, \fB\-\-info\fR=\fIINFO\fR 29 The informations to be prepended to the refunding 30 reason, which can include some of Python's string 31 interpolations to access to certain internal values. 32 If you don't want such information, set this 33 explicitely to an empty string. The default is 34 \&'''Refunded %(nbpages)i pages and %(nbcredits).3f 35 credits by %(effectiveuser)s (%(loginname)s) on 36 %(date)s''' 37 .TP 38 \fB\-l\fR LOGO, \fB\-\-logo\fR=\fILOGO\fR 39 The image to use as a logo. The logo will be drawn at 40 the 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 44 Sets the number of the first receipt. This number will 45 automatically be incremented for each receipt. The 46 default value is 1. 47 .TP 48 \fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR 49 The name of the file to which the PDF receipts will be 50 written. If not set or set to '\-', the PDF document 51 will be sent to the standard output, and \fB\-\-force\fR will 52 be assumed to be set. 53 .TP 54 \fB\-p\fR PAGESIZE, \fB\-\-pagesize\fR=\fIPAGESIZE\fR 55 Set the size of the page. Most well known page sizes 56 are recognized, like 'A4' or 'Letter' to name a few. 57 The default page size is A4. 58 .TP 59 \fB\-r\fR REASON, \fB\-\-reason\fR=\fIREASON\fR 60 The reason why there was a refund. 61 .TP 62 \fB\-u\fR UNIT, \fB\-\-unit\fR=\fIUNIT\fR 63 The name of the unit to use on the receipts. The 64 default value is 'Credits' or its locale translation. 65 .SS "filtering expressions:" 11 66 .IP 12 pkrefund [options] [filterexpr] 13 .PP 14 options : 15 .TP 16 \fB\-v\fR | \fB\-\-version\fR 17 Prints pkrefund's version number then exits. 18 .TP 19 \fB\-h\fR | \fB\-\-help\fR 20 Prints this message then exits. 21 .TP 22 \fB\-f\fR | \fB\-\-force\fR 23 Doesn't ask for confirmation before refunding jobs. 24 .TP 25 \fB\-r\fR | \fB\-\-reason\fR txt 26 Sets textual information to explain the refunding. 27 .TP 28 \fB\-l\fR | \fB\-\-logo\fR img 29 Use the image as the receipt's logo. The logo will 30 be drawn at the center top of the page. The default 31 logo is /usr/share/pykota/logos/pykota.jpeg 32 .TP 33 \fB\-p\fR | \fB\-\-pagesize\fR sz 34 Sets sz as the page size. Most well known 35 page sizes are recognized, like 'A4' or 'Letter' 36 to name a few. The default size is A4. 37 .TP 38 \fB\-n\fR | \fB\-\-number\fR N 39 Sets the number of the first receipt. This number 40 will automatically be incremented for each receipt. 41 .TP 42 \fB\-o\fR | \fB\-\-output\fR f.pdf 43 Defines the name of the PDF file which will contain 44 the receipts. If not set, then no PDF file will 45 be created. If set to '\-', then \fB\-\-force\fR is assumed, 46 and the PDF document is sent to standard output. 47 .TP 48 \fB\-u\fR | \fB\-\-unit\fR u 49 Defines the name of the unit to use on the receipts. 50 The default unit is 'Credits', optionally translated 51 to your native language if it is supported by PyKota. 67 Use the filtering expressions to extract only parts of the datas. Allowed 68 filters are of the form 'key=value'. Wildcards are not expanded as part of 69 these filtering expressions, so you can't use them here. 52 70 .IP 53 Use the filter expressions to extract only parts of the 54 datas. Allowed filters are of the form : 71 allowed keys for now: 55 72 .IP 56 key=value 73 username : User's name 74 printername : Printer's name 75 hostname : Host's name 76 jobid : Job's id 77 billingcode : Job's billing code 78 start : Job's date of printing 79 end : Job's date of printing 57 80 .IP 58 Allowed keys for now are : 59 .TP 60 username 61 User's name 62 .TP 63 printername 64 Printer's name 65 .TP 66 hostname 67 Client's hostname 68 .TP 69 jobid 70 Job's Id 71 .TP 72 billingcode 73 Job's billing code 74 .TP 75 start 76 Job's date of printing 77 .TP 78 end 79 Job's date of printing 80 .IP 81 Dates formatting with 'start' and 'end' filter keys : 81 formatting of dates with the 'start' and 'end' filtering keys: 82 82 .IP 83 83 YYYY : year boundaries … … 87 87 YYYYMMDDhhmm : minute boundaries 88 88 YYYYMMDDhhmmss : second boundaries 89 yesterday[+\-N bDays] : yesterday more or less N days (e.g. : yesterday\-15)90 today[+\-N bDays] : today more or less N days (e.g. : today\-15)91 tomorrow[+\-N bDays] : tomorrow more or less N days (e.g. : tomorrow\-15)92 now[+\-N bDays] : now more or less N days (e.g. now\-15)89 yesterday[+\-N] : yesterday more or less N days (e.g. : yesterday\-15) 90 today[+\-N] : today more or less N days (e.g. : today\-15) 91 tomorrow[+\-N] : tomorrow more or less N days (e.g. : tomorrow\-15) 92 now[+\-N] : now more or less N days (e.g. now\-15) 93 93 .IP 94 \&'now' and 'today' are not exactly the same since today represents the first 95 or last second of the day depending on if it's used in a start= or end= 96 date expression. The utility to be able to specify dates in the future is 97 a question which remains to be answered :\-) 94 \&'now' and 'today' are not exactly the same since 'today' represents the 95 first or last second of the day depending on if it's used in a 'start=' or 96 \&'end=' date expression. 98 97 .IP 99 Contrary to other PyKota management tools, wildcard characters are not 100 expanded, so you can't use them. 101 .PP 102 Examples : 98 examples: 103 99 .IP 104 \f(CW$ pkrefund \-\-output /tmp/receipts.pdf jobid=503\fR 100 pkrefund \fB\-\-output\fR /tmp/receipts.pdf jobid=503 101 This would refund all jobs which Id is 503. A confirmation would be 102 asked for each job to refund, and a PDF file named /tmp/receipts.pdf 103 would be created containing printable receipts. BEWARE of job ids 104 rolling over if you reset CUPS' history. 105 105 .IP 106 This will refund all jobs which Id is 503. BEWARE : installing CUPS 107 afresh will reset the first job id at 1, so you probably want to use 108 a more precise filter as explained below. A confirmation will 109 be asked for each job to refund, and a PDF file named /tmp/receipts.pdf 110 will be created which will contain printable receipts. 106 pkrefund \fB\-\-reason\fR "Hardware problem" jobid=503 start=today\-7 107 This would refund all jobs which id is 503 but which would have been 108 printed during the past week. The reason would be marked as being an 109 hardware problem. 111 110 .IP 112 \f(CW$ pkrefund \-\-reason "Hardware problem" jobid=503 start=today-7\fR 111 pkrefund \fB\-\-force\fR username=jerome printername=HP2100 112 This would refund all jobs printed by user jerome on printer HP2100. 113 No confirmation would be asked. 113 114 .IP 114 Refunds all jobs which id is 503 but which were printed during the 115 past week. The reason will be marked as being an hardware problem. 115 pkrefund \fB\-\-force\fR printername=HP2100 start=200602 end=yesterday 116 This would refund all jobs printed on printer HP2100 between February 117 1st 2006 and yesterday. No confirmation would be asked. 116 118 .IP 117 \f(CW$ pkrefund \-\-force username=jerome printername=HP2100\fR 119 licensing terms: 118 120 .IP 119 Refunds all jobs printed by user jerome on printer HP2100. No 120 confirmation will be asked. 121 .IP 122 \f(CW$ pkrefund \-\-force printername=HP2100 start=200602 end=yesterday\fR 123 .IP 124 Refunds all jobs printed on printer HP2100 between February 1st 2006 125 and yesterday. No confirmation will be asked. 126 .PP 127 (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com> 121 (c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com 128 122 This program is free software: you can redistribute it and/or modify 129 123 it under the terms of the GNU General Public License as published by 130 the Free Software Foundation, either version 3 of the License, or 131 (atyour option) any later version.132 . PP133 This program is distributed in the hope that it will be useful, 134 butWITHOUT ANY WARRANTY; without even the implied warranty of135 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 136 G NU General Public License for more details.137 . PP124 the Free Software Foundation, either version 3 of the License, or (at 125 your option) any later version. 126 .IP 127 This program is distributed in the hope that it will be useful, but 128 WITHOUT ANY WARRANTY; without even the implied warranty of 129 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 130 General Public License for more details. 131 .IP 138 132 You should have received a copy of the GNU General Public License 139 133 along with this program. If not, see <http://www.gnu.org/licenses/>. 140 .PP141 Please report bugs to : Jerome Alet \- alet@librelogiciel.com