[2808] | 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. |
---|
[2794] | 2 | .TH PKINVOICE "1" "mars 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands" |
---|
| 3 | .SH NOM |
---|
[2808] | 4 | pkinvoice \- page de manuel de pkinvoice 1.24beta_unofficial |
---|
[2794] | 5 | .SH DESCRIPTION |
---|
[2808] | 6 | pkinvoice v1.24beta_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com |
---|
[2794] | 7 | .PP |
---|
| 8 | An invoice generator for PyKota. |
---|
| 9 | .PP |
---|
| 10 | command line usage : |
---|
| 11 | .IP |
---|
| 12 | pkinvoice [options] user1 user2 ... userN |
---|
| 13 | .PP |
---|
| 14 | options : |
---|
| 15 | .TP |
---|
| 16 | \fB\-v\fR | \fB\-\-version\fR |
---|
[2812] | 17 | Prints pkinvoice's version number then exits. |
---|
[2794] | 18 | .TP |
---|
| 19 | \fB\-h\fR | \fB\-\-help\fR |
---|
| 20 | Prints this message then exits. |
---|
| 21 | .TP |
---|
| 22 | \fB\-l\fR | \fB\-\-logo\fR img |
---|
[2812] | 23 | Use the image as the invoice's logo. The logo will |
---|
[2794] | 24 | be drawn at the center top of the page. The default |
---|
| 25 | logo is /usr/share/pykota/logos/pykota.jpeg |
---|
| 26 | .TP |
---|
| 27 | \fB\-p\fR | \fB\-\-pagesize\fR sz |
---|
| 28 | Sets sz as the page size. Most well known |
---|
| 29 | page sizes are recognized, like 'A4' or 'Letter' |
---|
| 30 | to name a few. The default size is A4. |
---|
| 31 | .TP |
---|
| 32 | \fB\-n\fR | \fB\-\-number\fR N |
---|
| 33 | Sets the number of the first invoice. This number |
---|
| 34 | will automatically be incremented for each invoice. |
---|
| 35 | .TP |
---|
| 36 | \fB\-o\fR | \fB\-\-output\fR f.pdf |
---|
| 37 | Defines the name of the invoice file which will |
---|
| 38 | be generated as a PDF document. If not set or |
---|
| 39 | set to '\-', the PDF document is sent to standard |
---|
| 40 | output. |
---|
| 41 | .TP |
---|
| 42 | \fB\-u\fR | \fB\-\-unit\fR u |
---|
| 43 | Defines the name of the unit to use on the invoice. |
---|
| 44 | The default unit is 'Credits', optionally translated |
---|
| 45 | to your native language if it is supported by PyKota. |
---|
| 46 | .TP |
---|
| 47 | \fB\-V\fR | \fB\-\-vat\fR p |
---|
| 48 | Sets the percent value of the applicable VAT to be |
---|
| 49 | exposed. The default is 0.0, meaning no VAT |
---|
| 50 | information will be included. |
---|
| 51 | .TP |
---|
| 52 | \fB\-s\fR | \fB\-\-start\fR date |
---|
| 53 | Sets the starting date for the print jobs invoiced. |
---|
| 54 | .TP |
---|
| 55 | \fB\-e\fR | \fB\-\-end\fR date |
---|
| 56 | Sets the ending date for the print jobs invoiced. |
---|
| 57 | .IP |
---|
| 58 | user1 through userN can use wildcards if needed. If no user argument is |
---|
| 59 | used, a wildcard of '*' is assumed, meaning include all users. |
---|
| 60 | .IP |
---|
| 61 | Dates formating with \fB\-\-start\fR and \fB\-\-end\fR : |
---|
| 62 | .IP |
---|
| 63 | YYYY : year boundaries |
---|
| 64 | YYYYMM : month boundaries |
---|
| 65 | YYYYMMDD : day boundaries |
---|
| 66 | YYYYMMDDhh : hour boundaries |
---|
| 67 | YYYYMMDDhhmm : minute boundaries |
---|
| 68 | YYYYMMDDhhmmss : second boundaries |
---|
| 69 | yesterday[+\-NbDays] : yesterday more or less N days (e.g. : yesterday\-15) |
---|
| 70 | today[+\-NbDays] : today more or less N days (e.g. : today\-15) |
---|
| 71 | tomorrow[+\-NbDays] : tomorrow more or less N days (e.g. : tomorrow\-15) |
---|
| 72 | now[+\-NbDays] : now more or less N days (e.g. now\-15) |
---|
| 73 | .IP |
---|
| 74 | \&'now' and 'today' are not exactly the same since today represents the first |
---|
| 75 | or last second of the day depending on if it's used in a start= or end= |
---|
| 76 | date expression. The utility to be able to specify dates in the future is |
---|
| 77 | a question which remains to be answered :\-) |
---|
| 78 | .PP |
---|
| 79 | examples : |
---|
| 80 | .IP |
---|
| 81 | \f(CW$ pkinvoice --unit EURO --output invoices.pdf --start=now-30\fR |
---|
| 82 | .IP |
---|
| 83 | Will generate a PDF document containing invoices for all users |
---|
| 84 | who have spent some credits last month. Invoices will be done in |
---|
| 85 | EURO. No VAT information will be included. |
---|
| 86 | .PP |
---|
| 87 | This program is free software; you can redistribute it and/or modify |
---|
| 88 | it under the terms of the GNU General Public License as published by |
---|
| 89 | the Free Software Foundation; either version 2 of the License, or |
---|
| 90 | (at your option) any later version. |
---|
| 91 | .PP |
---|
| 92 | This program is distributed in the hope that it will be useful, |
---|
| 93 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 94 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
| 95 | GNU General Public License for more details. |
---|
| 96 | .PP |
---|
| 97 | You should have received a copy of the GNU General Public License |
---|
| 98 | along with this program; if not, write to the Free Software |
---|
| 99 | Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA. |
---|
| 100 | .PP |
---|
| 101 | Raporty o b��ch prosz�ierowa�o : Jerome Alet \- alet@librelogiciel.com |
---|