root / pykota / tags / 1.24 / man / pkinvoice.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PKINVOICE "1" "April 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NAME
pkinvoice \- manual page for pkinvoice 1.24_unofficial
.SH DESCRIPTION
pkinvoice v1.24_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com
.PP
An invoice generator for PyKota.
.PP
command line usage :
.IP
pkinvoice [options] user1 user2 ... userN
.PP
options :
.TP
\fB\-v\fR | \fB\-\-version\fR
Prints pkinvoice's version number then exits.
.TP
\fB\-h\fR | \fB\-\-help\fR
Prints this message then exits.
.TP
\fB\-l\fR | \fB\-\-logo\fR img
Use the image as the invoice's logo. The logo will
be drawn at the center top of the page. The default
logo is /usr/share/pykota/logos/pykota.jpeg
.TP
\fB\-p\fR | \fB\-\-pagesize\fR sz
Sets sz as the page size. Most well known
page sizes are recognized, like 'A4' or 'Letter'
to name a few. The default size is A4.
.TP
\fB\-n\fR | \fB\-\-number\fR N
Sets the number of the first invoice. This number
will automatically be incremented for each invoice.
.TP
\fB\-o\fR | \fB\-\-output\fR f.pdf
Defines the name of the invoice file which will
be generated as a PDF document. If not set or
set to '\-', the PDF document is sent to standard
output.
.TP
\fB\-u\fR | \fB\-\-unit\fR u
Defines the name of the unit to use on the invoice.
The default unit is 'Credits', optionally translated
to your native language if it is supported by PyKota.
.TP
\fB\-V\fR | \fB\-\-vat\fR p
Sets the percent value of the applicable VAT to be
exposed. The default is 0.0, meaning no VAT
information will be included.
.TP
\fB\-s\fR | \fB\-\-start\fR date
Sets the starting date for the print jobs invoiced.
.TP
\fB\-e\fR | \fB\-\-end\fR date
Sets the ending date for the print jobs invoiced.
.IP
user1 through userN can use wildcards if needed. If no user argument is
used, a wildcard of '*' is assumed, meaning include all users.
.IP
Dates formating with \fB\-\-start\fR and \fB\-\-end\fR :
.IP
YYYY : year boundaries
YYYYMM : month boundaries
YYYYMMDD : day boundaries
YYYYMMDDhh : hour boundaries
YYYYMMDDhhmm : minute boundaries
YYYYMMDDhhmmss : second boundaries
yesterday[+\-NbDays] : yesterday more or less N days (e.g. : yesterday\-15)
today[+\-NbDays] : today more or less N days (e.g. : today\-15)
tomorrow[+\-NbDays] : tomorrow more or less N days (e.g. : tomorrow\-15)
now[+\-NbDays] : now more or less N days (e.g. now\-15)
.IP
\&'now' and 'today' are not exactly the same since today represents the first
or last second of the day depending on if it's used in a start= or end=
date expression. The utility to be able to specify dates in the future is
a question which remains to be answered :\-)
.PP
examples :
.IP
\f(CW$ pkinvoice --unit EURO --output invoices.pdf --start=now-30\fR
.IP
Will generate a PDF document containing invoices for all users
who have spent some credits last month. Invoices will be done in
EURO.  No VAT information will be included.
.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
Please report bugs to : Jerome Alet \- alet@librelogiciel.com