Index: pykota/trunk/man/edpykota.1
===================================================================
--- pykota/trunk/man/edpykota.1 (revision 1942)
+++ pykota/trunk/man/edpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH EDPYKOTA "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.21alpha6_unofficial
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-edpykota v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Print Quota editor for PyKota.
 .PP
@@ -34,4 +34,15 @@
 If both are to be set, separate them with a comma.
 Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
 .TP
 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
@@ -80,5 +91,5 @@
 Resets the actual and life time page counters
 for the user or group to zero on the specified
-printers.
+printers. This is a shortcut for '\-\-used 0'.
 .TP
 \fB\-l\fR | \fB\-\-limitby\fR l
@@ -86,7 +97,7 @@
 by its account balance or by its page quota.
 The default value is 'quota'. Allowed values
-are 'quota' 'balance' 'quota-then-balance' and
-\&'balance-then-quota'.
-WARNING : quota-then-balance and balance-then-quota
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
 are not yet implemented.
 .TP
@@ -94,5 +105,5 @@
 Sets the user's account balance to b.
 Account balance may be increase or decreased
-if b is prefixed with + or -.
+if b is prefixed with + or \-.
 WARNING : when decreasing account balance,
 the total paid so far by the user is decreased
@@ -106,4 +117,15 @@
 \fB\-H\fR | \fB\-\-hardlimit\fR hl
 Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
 .IP
 user1 through userN and group1 through groupN can use wildcards
@@ -178,4 +200,18 @@
 When printing either on hplj1 or hplj2, print quota will also be
 checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -191,5 +227,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-.PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/autopykota.1
===================================================================
--- pykota/trunk/man/sv_SE/autopykota.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/autopykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH AUTOPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-autopykota \- manual page for autopykota 1.20_unofficial
+autopykota \- manual page for autopykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-autopykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A tool to automate user account creation and initial balance setting.
 .PP
@@ -40,5 +40,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/edpykota.1
===================================================================
--- pykota/trunk/man/sv_SE/edpykota.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/edpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH EDPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.20_unofficial
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-edpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Print Quota editor for PyKota.
 .PP
@@ -34,4 +34,15 @@
 If both are to be set, separate them with a comma.
 Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
 .TP
 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
@@ -80,5 +91,5 @@
 Resets the actual and life time page counters
 for the user or group to zero on the specified
-printers.
+printers. This is a shortcut for '\-\-used 0'.
 .TP
 \fB\-l\fR | \fB\-\-limitby\fR l
@@ -86,7 +97,7 @@
 by its account balance or by its page quota.
 The default value is 'quota'. Allowed values
-are 'quota' 'balance' 'quota-then-balance' and
-\&'balance-then-quota'.
-WARNING : quota-then-balance and balance-then-quota
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
 are not yet implemented.
 .TP
@@ -94,5 +105,5 @@
 Sets the user's account balance to b.
 Account balance may be increase or decreased
-if b is prefixed with + or -.
+if b is prefixed with + or \-.
 WARNING : when decreasing account balance,
 the total paid so far by the user is decreased
@@ -106,4 +117,15 @@
 \fB\-H\fR | \fB\-\-hardlimit\fR hl
 Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
 .IP
 user1 through userN and group1 through groupN can use wildcards
@@ -178,4 +200,18 @@
 When printing either on hplj1 or hplj2, print quota will also be
 checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -191,5 +227,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-.PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/pkbanner.1
===================================================================
--- pykota/trunk/man/sv_SE/pkbanner.1 (revision 1939)
+++ pykota/trunk/man/sv_SE/pkbanner.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKBANNER "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkbanner \- manual page for pkbanner 1.21alpha5_unofficial
+pkbanner \- manual page for pkbanner 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkbanner v1.21alpha5_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates banners.
@@ -69,5 +69,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/pkprinters.1
===================================================================
--- pykota/trunk/man/sv_SE/pkprinters.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/pkprinters.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKPRINTERS "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkprinters \- manual page for pkprinters 1.20_unofficial
+pkprinters \- manual page for pkprinters 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkprinters v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Printers Manager for PyKota.
 .PP
@@ -22,5 +22,5 @@
 Adds printers if they don't exist on the Quota
 Storage Server. If they exist, they are modified
-unless \fB\-s\fR|--skipexisting is also used.
+unless \fB\-s\fR|\-\-skipexisting is also used.
 .TP
 \fB\-d\fR | \fB\-\-delete\fR
@@ -75,5 +75,5 @@
 All of their descriptions will be set to the string "HP Printer".
 If any of these printers already exists, it will also be modified
-unless the \fB\-s\fR|--skipexisting command line option is also used.
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
 .IP
 \f(CW$ pkprinters --delete "*"\fR
@@ -103,5 +103,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/pykotme.1
===================================================================
--- pykota/trunk/man/sv_SE/pykotme.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/pykotme.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOTME "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykotme \- manual page for pykotme 1.20_unofficial
+pykotme \- manual page for pykotme 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykotme v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Gives print quotes to users.
@@ -62,5 +62,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/pykosd.1
===================================================================
--- pykota/trunk/man/sv_SE/pykosd.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/pykosd.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOSD "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykosd \- manual page for pykosd 1.20_unofficial
+pykosd \- manual page for pykosd 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykosd v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 An OSD quota monitor for PyKota.
 .PP
@@ -59,5 +59,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/dumpykota.1
===================================================================
--- pykota/trunk/man/sv_SE/dumpykota.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/dumpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH DUMPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-dumpykota \- manual page for dumpykota 1.20_unofficial
+dumpykota \- manual page for dumpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-dumpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Dumps PyKota database's content.
@@ -10,5 +10,5 @@
 command line usage :
 .IP
-dumpykota [options]
+dumpykota [options] [filterexpr]
 .PP
 options :
@@ -23,13 +23,13 @@
 Dumps 'type' datas. Allowed types are :
 .IP
-- history : dumps the jobs history.
-- users : dumps users.
-- groups : dumps user groups.
-- printers : dump printers.
-- upquotas : dump user quotas.
-- gpquotas : dump user groups quotas.
-- payments : dumps user payments.
-- pmembers : dumps printer groups members.
-- umembers : dumps user groups members.
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
 .IP
 NB : the \fB\-d\fR | \fB\-\-data\fR command line option
@@ -42,14 +42,42 @@
 quotes. Allowed formats are :
 .IP
-- csv : separate datas with commas
-- ssv : separate datas with semicolons
-- tsv : separate datas with tabs
-- xml : dump data as XML
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
 .TP
 \fB\-o\fR | \fB\-\-output\fR fname
 All datas will be dumped to the file instead of
-to the standard output. The special '-' filename
+to the standard output. The special '\-' filename
 is the default value and means stdout.
 WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
 .PP
 Examples :
@@ -63,4 +91,8 @@
 .IP
 Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -76,5 +108,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/pkhint.1
===================================================================
--- pykota/trunk/man/sv_SE/pkhint.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/pkhint.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKHINT "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkhint \- manual page for pkhint 1.20_unofficial
+pkhint \- manual page for pkhint 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkhint v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A tool to give hints on what accounting method is best for each printer.
 .PP
@@ -42,5 +42,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/repykota.1
===================================================================
--- pykota/trunk/man/sv_SE/repykota.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/repykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH REPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-repykota \- manual page for repykota 1.20_unofficial
+repykota \- manual page for repykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-repykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates print quota reports.
@@ -67,5 +67,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/sv_SE/warnpykota.1
===================================================================
--- pykota/trunk/man/sv_SE/warnpykota.1 (revision 1894)
+++ pykota/trunk/man/sv_SE/warnpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH WARNPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "februari 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-warnpykota \- manual page for warnpykota 1.20_unofficial
+warnpykota \- manual page for warnpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-warnpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Sends mail to users over print quota.
@@ -72,5 +72,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/autopykota.1
===================================================================
--- pykota/trunk/man/pt/autopykota.1 (revision 2086)
+++ pykota/trunk/man/pt/autopykota.1 (revision 2086)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to automate user account creation and initial balance setting.
+.PP
+THIS TOOL MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY PAGE QUOTA !
+.PP
+command line usage :
+.IP
+THIS TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART
+OF AN external policy IN pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR value }
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints autopykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Sets the user's account initial balance value to b.
+If the user already exists, actual balance is left
+unmodified. If unset, the default value is 0.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/edpykota.1
===================================================================
--- pykota/trunk/man/pt/edpykota.1 (revision 2086)
+++ pykota/trunk/man/pt/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/pkbanner.1
===================================================================
--- pykota/trunk/man/pt/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/pt/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/pkprinters.1
===================================================================
--- pykota/trunk/man/pt/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/pt/pkprinters.1 (revision 2086)
@@ -0,0 +1,107 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Printers Manager for PyKota.
+.PP
+command line usage :
+.IP
+pkprinters [options] printer1 printer2 printer3 ... printerN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkprinters's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds printers if they don't exist on the Quota
+Storage Server. If they exist, they are modified
+unless \fB\-s\fR|\-\-skipexisting is also used.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes printers from the quota storage.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge.
+Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point and negative values are allowed.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
+groups pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+If the \fB\-\-remove\fR option below is not used, the
+default action is to add printers to the specified
+printer groups.
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+List informations about the printer(s) and the
+printers groups it is a member of.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In combination with the \fB\-\-groups\fR option above,
+remove printers from the specified printers groups.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In combination with the \fB\-\-add\fR option above, tells
+pkprinters to not modify existing printers.
+.IP
+printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
+is not set.
+.PP
+examples :
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Will create three printers named hp2100, hp2200 and hp8000.
+Their price per page will be set at 0.05 unit, and their price
+per job will be set at 0.1 unit. Units are in your own currency,
+or whatever you want them to mean.
+All of their descriptions will be set to the string "HP Printer".
+If any of these printers already exists, it will also be modified
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+This will completely delete all printers and associated quota information,
+as well as their job history. USE WITH CARE !
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+This will put all printers which name matches "hp*" into printers groups
+Laser and HP, which MUST already exist.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+This will remove the hp2200 printer from the LexMark printer group.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/pykotme.1
===================================================================
--- pykota/trunk/man/pt/pykotme.1 (revision 2086)
+++ pykota/trunk/man/pt/pykotme.1 (revision 2086)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Gives print quotes to users.
+.PP
+command line usage :
+.TP
+pykotme
+[options]  [files]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykotme's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Gives a quote for this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ pykotme --printer apple file1.ps file2.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps and file2.ps
+which would be sent to the apple printer.
+.IP
+\f(CW$ pykotme --printer apple,hplaser <file1.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps as read from
+standard input, which would be sent to the apple or hplaser
+printer.
+.IP
+\f(CW$ pykotme\fR
+.IP
+This will give a quote for a job consisting of what is on standard
+input. The quote will list the job size, and the price the job
+would cost on each printer.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/pykosd.1
===================================================================
--- pykota/trunk/man/pt/pykosd.1 (revision 2086)
+++ pykota/trunk/man/pt/pykosd.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+An OSD quota monitor for PyKota.
+.PP
+command line usage :
+.IP
+pykosd [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykosd's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Sets the color to use for display as an hexadecimal
+triplet, for example #FF0000 is 100% red.
+Defaults to 100% green (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Sets the duration of the display in seconds.
+Defaults to 3 seconds.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Sets the font to use for display.
+Defaults to the Python OSD library's default.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Sets the number of times the info will be displayed.
+Defaults to 0, which means loop forever.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Sets the sleeping duration between two displays
+in seconds. Defaults to 180 seconds (3 minutes).
+.PP
+examples :
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Will launch pykosd. Display will be refreshed every 60 seconds,
+and will last for 3 seconds (the default) each time. After five
+iterations, the program will exit.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/dumpykota.1
===================================================================
--- pykota/trunk/man/pt/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/pt/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/pkhint.1
===================================================================
--- pykota/trunk/man/pt/pkhint.1 (revision 2086)
+++ pykota/trunk/man/pt/pkhint.1 (revision 2086)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to give hints on what accounting method is best for each printer.
+.PP
+command line usage :
+.IP
+pkhint [options] [printer1 printer2 printer3 ... printerN] <file.conf
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkhint's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.PP
+examples :
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Will analyze your printing system to test which accounter
+is the best for each of the defined printer which
+name matches one of the parameters.
+.IP
+If you don't pass any argument on the command line, all
+printers will be analyzed.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/pkmail.1
===================================================================
--- pykota/trunk/man/pt/pkmail.1 (revision 2086)
+++ pykota/trunk/man/pt/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/repykota.1
===================================================================
--- pykota/trunk/man/pt/repykota.1 (revision 2086)
+++ pykota/trunk/man/pt/repykota.1 (revision 2086)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates print quota reports.
+.PP
+command line usage :
+.IP
+repykota [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints repykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Generates a report on users quota, this is
+the default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Generates a report on group quota instead of users.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Report quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+This will print the quota status for all users who use the lp printer.
+.IP
+\f(CW$ repykota\fR
+.IP
+This will print the quota status for all users on all printers.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+This will print the quota status for user jerome and all users
+whose name begins with "jo" on all printers which name begins
+with "laser" or ends with "pson".
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt/warnpykota.1
===================================================================
--- pykota/trunk/man/pt/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/pt/warnpykota.1 (revision 2086)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Sends mail to users over print quota.
+.PP
+command line usage :
+.TP
+warnpykota
+[options]  [names]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints warnpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Warns users over their print quota, this is the
+default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Warns users whose groups quota are over limit.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verify quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+This will warn all users of the lp printer who have exceeded their
+print quota.
+.IP
+\f(CW$ warnpykota\fR
+.TP
+This will warn all users
+who have exceeded their print quota on
+.IP
+any printer.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+This will warn all users of groups which names begins with "dev" and
+who have exceeded their print quota on any printer which name begins
+with "laserjet"
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/tr/autopykota.1
===================================================================
--- pykota/trunk/man/tr/autopykota.1 (revision 2086)
+++ pykota/trunk/man/tr/autopykota.1 (revision 2086)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Kullanıcı hesapları oluşumunu otomatikleştirme ve başlangıç hesap ayarları için araç.
+.PP
+BU ARAÇ KULLANICILARINIZI SAYFA KOTASI İLE SINIRLAMAK İÇİN KULLANILMAMALIDIR !
+.PP
+komut satırı kullanımı :
+.TP
+BU ARAÇ KOMUT SATIRINDAN KULLANILMAMALIDIR FAKAT SADECE
+pykota.conf İÇİNDE external policy OLARAK KULLANILABİLİR
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR değer }
+.PP
+seçenekler :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+autopykota'nın sürüm numarasını yazar ve çıkar.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+bu mesajı yazar ve çıkar.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Kullanıcının başlangıç hesabını b değeri olarak atar.
+Eğer kullanıcı zaten varsa, mevcut hesap değişmeden kalır.
+Eğer yok ise öntanımlı değer 0'dır.
+.PP
+Bu program özgür yazılımdır; bu yazılımı Özgür Yazılım Vakfı tarafından
+yayınlanan GNU Genel Kamu Lisansı'nın 2. sürümü ya da (kendi
+tercihinize bağlı) sonraki sürümü şartları altında yeniden dağıtabilir
+ve/ya da değiştirebilirsiniz.
+.PP
+Bu program faydalı olacağı düşünülerek dağıtılmaktadır, fakat HİÇBİR
+GARANTİSİ YOKTUR; BELLİ BİR AMACA UYGUNLUK ya da MAL
+DEĞERİ gibi garantileri de yoktur.  Daha fazla ayrıntı için GNU Genel
+Kamu Lisansını okuyun.
+.PP
+GNU Genel Kamu Lisansının bir nüshasını programla birlikte almış
+olmalısınız, eğer almadıysanız Özgür Yazılım Vakfı'na 59 Temple Place,
+Suite 330, Boston, MA 02111\-1307, USA adresinden ulaşın.
+.PP
+Lütfen hataları Jerome Alet \- alet@librelogiciel.com adresine mektupla bildirin
Index: pykota/trunk/man/tr/edpykota.1
===================================================================
--- pykota/trunk/man/tr/edpykota.1 (revision 2086)
+++ pykota/trunk/man/tr/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/tr/pkbanner.1
===================================================================
--- pykota/trunk/man/tr/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/tr/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/tr/pkprinters.1
===================================================================
--- pykota/trunk/man/tr/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/tr/pkprinters.1 (revision 2086)
@@ -0,0 +1,107 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Printers Manager for PyKota.
+.PP
+command line usage :
+.IP
+pkprinters [options] printer1 printer2 printer3 ... printerN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkprinters's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds printers if they don't exist on the Quota
+Storage Server. If they exist, they are modified
+unless \fB\-s\fR|\-\-skipexisting is also used.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes printers from the quota storage.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge.
+Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point and negative values are allowed.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
+groups pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+If the \fB\-\-remove\fR option below is not used, the
+default action is to add printers to the specified
+printer groups.
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+List informations about the printer(s) and the
+printers groups it is a member of.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In combination with the \fB\-\-groups\fR option above,
+remove printers from the specified printers groups.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In combination with the \fB\-\-add\fR option above, tells
+pkprinters to not modify existing printers.
+.IP
+printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
+is not set.
+.PP
+examples :
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Will create three printers named hp2100, hp2200 and hp8000.
+Their price per page will be set at 0.05 unit, and their price
+per job will be set at 0.1 unit. Units are in your own currency,
+or whatever you want them to mean.
+All of their descriptions will be set to the string "HP Printer".
+If any of these printers already exists, it will also be modified
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+This will completely delete all printers and associated quota information,
+as well as their job history. USE WITH CARE !
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+This will put all printers which name matches "hp*" into printers groups
+Laser and HP, which MUST already exist.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+This will remove the hp2200 printer from the LexMark printer group.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/tr/pykotme.1
===================================================================
--- pykota/trunk/man/tr/pykotme.1 (revision 2086)
+++ pykota/trunk/man/tr/pykotme.1 (revision 2086)
@@ -0,0 +1,64 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Kullanıcılara kota verir.
+.PP
+komut satırı kullanımı :
+.TP
+pykotme
+[seçenekler]  [dosyalar]
+.PP
+seçenekler :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+pykotme'nin sürüm numarasını gösterir ve çıkar.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Bu mesaji gösterir ve çıkar.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Sadece bu yazıcı için kota verir. p maske
+karakterlerini birden fazla yazıcı belirtmek için
+içerebilir. Öntanımlı değer *'dır, tüm yazıcılar
+anlamına gelir.
+Virgül ile ayırarak birden fazla yazıcı ve maske
+kullanabilirsiniz.
+.PP
+örnekler :
+.IP
+\f(CW$ pykotme --printer apple file1.ps file2.ps\fR
+.IP
+Mevcut kullanıcıya kota verir. Kota ücreti ve isin boyutu
+the price and size of a job consisting in file1.ps and file2.ps
+which would be sent to the apple printer.
+.IP
+\f(CW$ pykotme --printer apple,hplaser <file1.ps\fR
+.IP
+Bu mevcut kullanıcının baskı bilgisini yazdırır. Bilgiler
+apple ve hplaser yazıcılarına gönderilirse, standart girdiden
+okunacak file1.ps için iş ücreti ve işin boyutunu gösterir.
+.IP
+\f(CW$ pykotme\fR
+.IP
+Standart girdideki işin hakkında bilgi gösterir. Bilgi işin boyutunu
+ücretini ve her yazıcı için ne kadar tutacağını içerir.
+.PP
+Bu program özgür yazılımdır; bu yazılımı Özgür Yazılım Vakfı tarafından
+yayınlanan GNU Genel Kamu Lisansı'nın 2. sürümü ya da (kendi
+tercihinize bağlı) sonraki sürümü şartları altında yeniden dağıtabilir
+ve/ya da değiştirebilirsiniz.
+.PP
+Bu program faydalı olacağı düşünülerek dağıtılmaktadır, fakat HİÇBİR
+GARANTİSİ YOKTUR; BELLİ BİR AMACA UYGUNLUK ya da MAL
+DEĞERİ gibi garantileri de yoktur.  Daha fazla ayrıntı için GNU Genel
+Kamu Lisansını okuyun.
+.PP
+GNU Genel Kamu Lisansının bir nüshasını programla birlikte almış
+olmalısınız, eğer almadıysanız Özgür Yazılım Vakfı'na 59 Temple Place,
+Suite 330, Boston, MA 02111\-1307, USA adresinden ulaşın.
+.PP
+Lütfen hataları Jerome Alet \- alet@librelogiciel.com adresine mektupla bildirin
Index: pykota/trunk/man/tr/pykosd.1
===================================================================
--- pykota/trunk/man/tr/pykosd.1 (revision 2086)
+++ pykota/trunk/man/tr/pykosd.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+PyKota için bir OSD kota izleyicisi.
+.PP
+komut satırı kullanımı :
+.IP
+pykosd [seçenekler]
+.PP
+seçenekler :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+pykosd'nin sürüm numarasını yazar ve çıkar.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Bu mesajı yazar ve çıkar.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb onaltılı üçlü olarak arkaplan rengini ayarlar
+örneğin #FF0000 değeri 100% kırmızı yapar.
+Öntanımlı 100% yeşildir (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Saniye olarak gösterim süresini belirtir.
+Öntanımlı 3 saniyedir.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Gösterim için kullanılacak yazıtipini ayarlar.
+Öntanımlı Python OSD kütüphanesinin öntanımlısıdır.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Bilginin kaç kere gösterileceğini ayarlar.
+Öntanımlı 0'dır, sonsuza kadar döngü yapılacaıını belirtir.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Saniye cinsinden iki gösterim arasında beklenecek
+süreyi ayarlar. Öntanımlı 180 saniyedir (3 dakika).
+.PP
+örnekler :
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+pykosd'yi başlatır. Gösterim her 60 saniyede tazelenir,
+ve her defasında 3 saniye sonunda (ön tanımlı) sona erer. Beş
+tekrardan sonra çıkar.
+.PP
+Bu program özgür yazılımdır; bu yazılımı Özgür Yazılım Vakfı tarafından
+yayınlanan GNU Genel Kamu Lisansı'nın 2. sürümü ya da (kendi
+tercihinize bağlı) sonraki sürümü şartları altında yeniden dağıtabilir
+ve/ya da değiştirebilirsiniz.
+.PP
+Bu program faydalı olacağı düşünülerek dağıtılmaktadır, fakat HİÇBİR
+GARANTİSİ YOKTUR; BELLİ BİR AMACA UYGUNLUK ya da MAL
+DEĞERİ gibi garantileri de yoktur.  Daha fazla ayrıntı için GNU Genel
+Kamu Lisansını okuyun.
+.PP
+GNU Genel Kamu Lisansının bir nüshasını programla birlikte almış
+olmalısınız, eğer almadıysanız Özgür Yazılım Vakfı'na 59 Temple Place,
+Suite 330, Boston, MA 02111\-1307, USA adresinden ulaşın.
+.PP
+Lütfen hataları Jerome Alet \- alet@librelogiciel.com adresine mektupla bildirin
Index: pykota/trunk/man/tr/dumpykota.1
===================================================================
--- pykota/trunk/man/tr/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/tr/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/tr/pkhint.1
===================================================================
--- pykota/trunk/man/tr/pkhint.1 (revision 2086)
+++ pykota/trunk/man/tr/pkhint.1 (revision 2086)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Her yazıcı için hangi hesaplama metodunun uygun olacaıı hakkında ipucu veren bir araç.
+.PP
+komut satırı kullanımı :
+.IP
+pkhint [seçenekler] [yazıcı1 yazıcı2 yazıcı3 ... yazıcıN] <file.conf
+.PP
+seçenekler :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+pkhint'in sürüm numarasını gösterir ve çıkar.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Bu mesaji gösterir ve çıkar.
+.PP
+örnekler :
+.IP
+\f(CW$ pkhint "hp*" yazici103 </etc/cups/printers.conf\fR
+.IP
+Parametrelerde belirtilen isim ile eşleşen yazıcılar için
+hangi metodun uygun olduğunu sınamak için
+yazma sisteminizi inceler.
+.IP
+Eğer komut satırında hiçbir parametre belirtmezseniz, tüm
+yazıcılar incelenecektir.
+.PP
+Bu program özgür yazılımdır; bu yazılımı Özgür Yazılım Vakfı tarafından
+yayınlanan GNU Genel Kamu Lisansı'nın 2. sürümü ya da (kendi
+tercihinize bağlı) sonraki sürümü şartları altında yeniden dağıtabilir
+ve/ya da değiştirebilirsiniz.
+.PP
+Bu program faydalı olacağı düşünülerek dağıtılmaktadır, fakat HİÇBİR
+GARANTİSİ YOKTUR; BELLİ BİR AMACA UYGUNLUK ya da MAL
+DEĞERİ gibi garantileri de yoktur.  Daha fazla ayrıntı için GNU Genel
+Kamu Lisansını okuyun.
+.PP
+GNU Genel Kamu Lisansının bir nüshasını programla birlikte almış
+olmalısınız, eğer almadıysanız Özgür Yazılım Vakfı'na 59 Temple Place,
+Suite 330, Boston, MA 02111\-1307, USA adresinden ulaşın.
+.PP
+Lütfen hataları Jerome Alet \- alet@librelogiciel.com adresine mektupla bildirin
Index: pykota/trunk/man/tr/pkmail.1
===================================================================
--- pykota/trunk/man/tr/pkmail.1 (revision 2086)
+++ pykota/trunk/man/tr/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/tr/repykota.1
===================================================================
--- pykota/trunk/man/tr/repykota.1 (revision 2086)
+++ pykota/trunk/man/tr/repykota.1 (revision 2086)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Yacıcı kotası raporları oluşturur.
+.PP
+komut satırı kullanımı :
+.IP
+repykota [seçenekler]
+.PP
+seçenekler :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+repykota'nın sürüm numarasını gösterir ve çıkar.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Bu mesaji gösterir ve çıkar.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Kullanıcı kotaları üzerine bir rapor oluşturur, bu
+öntanımlıdır.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Kullanıcılar yerine grup kotaları üzerine rapor oluşturur.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Sadece bu yazıcı üzerindeki kotaları raporlar. p maske
+karakterleri kullanarak sadece bazı yazıcıları seçebilir.
+Öntanımlı değer *'dır, tüm yazıcılar
+anlamına gelir.
+Virgül ile ayırarak birden fazla isim ya da maske
+kullanabilirsiniz.
+.PP
+örnekler :
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+Bu lp yazıcısını kullanan tüm kullanıcıların kota durumlarını bildirir.
+.IP
+\f(CW$ repykota\fR
+.IP
+Bu tüm yacıcıların kullanıcıların kota durumlarını bildirir.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+Bu adı "laser" ile başlayan ya da "pson" ile biten tüm yazıcılar
+üzerinde adı "jo" ile başlayan ve adı jerome olan kullanıcıların kota
+durumlarını bildirir.
+.IP
+Eğer PyKota yöneticisi olmayan bir kullanıcı tarafından başlatılırsa,
+kullanıcı ve grup adlarını belirten parametreler yok sayılır, sadece mevcut
+kullanıcı ve grup hakkında bildirim yapılır.
+.PP
+Bu program özgür yazılımdır; bu yazılımı Özgür Yazılım Vakfı tarafından
+yayınlanan GNU Genel Kamu Lisansı'nın 2. sürümü ya da (kendi
+tercihinize bağlı) sonraki sürümü şartları altında yeniden dağıtabilir
+ve/ya da değiştirebilirsiniz.
+.PP
+Bu program faydalı olacağı düşünülerek dağıtılmaktadır, fakat HİÇBİR
+GARANTİSİ YOKTUR; BELLİ BİR AMACA UYGUNLUK ya da MAL
+DEĞERİ gibi garantileri de yoktur.  Daha fazla ayrıntı için GNU Genel
+Kamu Lisansını okuyun.
+.PP
+GNU Genel Kamu Lisansının bir nüshasını programla birlikte almış
+olmalısınız, eğer almadıysanız Özgür Yazılım Vakfı'na 59 Temple Place,
+Suite 330, Boston, MA 02111\-1307, USA adresinden ulaşın.
+.PP
+Lütfen hataları Jerome Alet \- alet@librelogiciel.com adresine mektupla bildirin
Index: pykota/trunk/man/tr/warnpykota.1
===================================================================
--- pykota/trunk/man/tr/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/tr/warnpykota.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Yazma kotası üzerinden kullanıcılara mektup gönderir.
+.PP
+komut satırı kullanımı :
+.TP
+warnpykota
+[seçenekler]  [adlar]
+.PP
+seçenekler :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+warnpykota'nın sürüm numarasını yaza ve çıkar.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Bu mesajı yazar ve çıkar.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Yazma kotası üzerindeki kullanıcıları uyarır, bu
+öntanımlıdır .
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Grupları yazma kotasının üzerinde olan kullanıcıları uyarır.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Sadece bu yazıcıyı denetler. p birkaç yazıcı
+seçmek için maske karakterlerini kullanabilir.
+Öntanımlı deıer *'dır, tüm yazıcılar anlamına
+gelir.
+Birden fazla ismi ya da maskeyi kullanabilirsiniz,
+onları virgül ile ayırarak kullanın.
+.PP
+örnekler :
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+Bu lp yazıcısı üzerinde yazma kotalarını geçmiş olan tüm kullanıcıları
+uyarır.
+.IP
+\f(CW$ warnpykota\fR
+.IP
+Bu herhangi bir yazıcı üzerinde yazma kotasını geçmiş olan kullanıcıları
+uyarır.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+Bu adı "dev" ile başlayan ve adı "laserjer" ile başlayan herhangi bir yazıcı
+üzerinde yazma kotasını geçmiş tüm kullanıcıları uyarır
+.IP
+Eğer PyKota yöneticisi olmayan birisi tarafından başlatılırsa, kullanıcı ve
+grup adlarını belirten isimler yoksayılır, ve sadece mevcut kullanıcı/grup
+belirtilir.
+.PP
+Bu program özgür yazılımdır; bu yazılımı Özgür Yazılım Vakfı tarafından
+yayınlanan GNU Genel Kamu Lisansı'nın 2. sürümü ya da (kendi
+tercihinize bağlı) sonraki sürümü şartları altında yeniden dağıtabilir
+ve/ya da değiştirebilirsiniz.
+.PP
+Bu program faydalı olacağı düşünülerek dağıtılmaktadır, fakat HİÇBİR
+GARANTİSİ YOKTUR; BELLİ BİR AMACA UYGUNLUK ya da MAL
+DEĞERİ gibi garantileri de yoktur.  Daha fazla ayrıntı için GNU Genel
+Kamu Lisansını okuyun.
+.PP
+GNU Genel Kamu Lisansının bir nüshasını programla birlikte almış
+olmalısınız, eğer almadıysanız Özgür Yazılım Vakfı'na 59 Temple Place,
+Suite 330, Boston, MA 02111\-1307, USA adresinden ulaşın.
+.PP
+Lütfen hataları Jerome Alet \- alet@librelogiciel.com adresine mektupla bildirin
Index: pykota/trunk/man/pykotme.1
===================================================================
--- pykota/trunk/man/pykotme.1 (revision 1942)
+++ pykota/trunk/man/pykotme.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOTME "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykotme \- manual page for pykotme 1.21alpha6_unofficial
+pykotme \- manual page for pykotme 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykotme v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Gives print quotes to users.
@@ -62,5 +62,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/autopykota.1
===================================================================
--- pykota/trunk/man/el_GR/autopykota.1 (revision 1894)
+++ pykota/trunk/man/el_GR/autopykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH AUTOPYKOTA "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-autopykota \- manual page for autopykota 1.20_unofficial
+autopykota \- manual page for autopykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-autopykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 ��� � ������������� ��� �����
 .PP
@@ -39,5 +39,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/edpykota.1
===================================================================
--- pykota/trunk/man/el_GR/edpykota.1 (revision 1894)
+++ pykota/trunk/man/el_GR/edpykota.1 (revision 2086)
@@ -1,139 +1,217 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH EDPYKOTA "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.20_unofficial
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-edpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
-�������� � �yKota.
-.PP
-���� ���
-.IP
-edpykota [��� �� �� ... ��
-.IP
-edpykota [��� �� �� ... ��
-.PP
-���:
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
 .TP
 \fB\-v\fR | \fB\-\-version\fR
-��� �����edpykota� ���.
+Prints edpykota's version number then exits.
 .TP
 \fB\-h\fR | \fB\-\-help\fR
-��� ����� ���.
+Prints this message then exits.
 .TP
 \fB\-a\fR | \fB\-\-add\fR
-�������/���� �� ��
-�����������TP
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
 \fB\-d\fR | \fB\-\-delete\fR
-������� � �������� ��. � ��� � ���
+Deletes users/groups from the quota storage.
+Printers are never deleted.
 .TP
 \fB\-c\fR | \fB\-\-charge\fR p[,j]
-����� ��� ��� � ����������� �� ���������. � ������, ��������������� ���
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
 .TP
 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
-����� ����� � ���
-���������� � ��
-����� ��������TP
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
 \fB\-u\fR | \fB\-\-users\fR
-��������� �� ������������.TP
+Edit users print quotas, this is the default.
+.TP
 \fB\-P\fR | \fB\-\-printer\fR p
-�������� �������p.
-����p ���������� ���� �������� �����
-��*, �� ���������������� ���
-�������.
-.TP
-\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] ������ ���� � ��
-����g1, pg2, �.��������.
-�������������� ����� ������� ���.
-������ ������������������� �������� �� ������������ � �������� ����� � ���� ����������
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
 .TP
 \fB\-g\fR | \fB\-\-groups\fR
-�������� � �� �����
-�� ��
-.TP
-\fB\-p\fR | \fB\-\-prototype\fR u|g �������� ����g ���
-�������
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
 .TP
 \fB\-n\fR | \fB\-\-noquota\fR
-���������� ����.
+Doesn't set a quota but only does accounting.
 .TP
 \fB\-r\fR | \fB\-\-reset\fR
-������� �� � ��� ���� � �������
-�������� �����
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
 .TP
 \fB\-R\fR | \fB\-\-hardreset\fR
-�������� � ��� ����
-� ��� ���������
-���.
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
 .TP
 \fB\-l\fR | \fB\-\-limitby\fR l
-�������������� ���                       � ��� ������������ �
-������ ��'quota' (�������� ��� 'quota' (����\&'balance' (������), 'quota-then-balance' (��������� 'balance-then-quota' (����
-���                       ����: � ��� quota-then-balance � balance-then-quota
-� �� ��� ��
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
 .TP
 \fB\-b\fR | \fB\-\-balance\fR b
-������ ��� ����� ���.
-� �������������������� � � ����+ �-.
-����: ������� ���, �����,
-�� ������� ����������
-� �� � �� ��� ������������������.
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
 .TP
 \fB\-S\fR | \fB\-\-softlimit\fR sl
-���������l ��
+Sets the quota soft limit to sl pages.
 .TP
 \fB\-H\fR | \fB\-\-hardlimit\fR hl
-����� ���� hl ��.
-.IP
-������ � �� � �� � �� �� ��������� �� ����\fB\-\-add\fR.
-.PP
-����
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
 .IP
 \f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
 .IP
-����� ��john, paul, george � ringo ������������� � � �� �� ���erome. ���jerome ������
-�������mail �� ���ingo �&'ringo@example.com'
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
 .IP
 \f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
 .IP
-�������erome � ���lp ������50 ��, � �� �0 ��. � �� ��jerome �� ��� lp � ��������������    ����
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
 .IP
 \f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
 .IP
-��� ��, ���� �� �� ��jerome ��
-��� lp ������������ ������jerome ������� "coders" � "it" ������� ������IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
 \f(CW$ edpykota -g -S 500 -H 550 financial support\fR
 .IP
-���������00 �� � ��� ��50
-�� � ��� financial � support �������IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
 \f(CW$ edpykota --reset jerome "jo*"\fR
 .IP
-����� ��������erome � �������������'jo' ������� ����� � ����� ������������ ��� � ���������������fB\-\-hardreset\fR | \fB\-R\fR .
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
 .IP
 \f(CW$ edpykota --printer hpcolor --noquota jerome\fR
 .IP
-�������� ���erome � ����hpcolor.
-�� ����������� ��� �������
-���� ��������
-� �����rome �������������.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
 \f(CW$ edpykota --limitby balance jerome\fR
 .IP
-�������erome ������ ��� �
+This will tell PyKota to limit jerome by his account's balance
+when printing.
 .IP
 \f(CW$ edpykota --balance +10.0 jerome\fR
 .IP
-������ �����jerome ��10.0 ���(������ ������� ��� ����(-) ����� ��� �� � ���
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
 .IP
 \f(CW$ edpykota --delete jerome rachel\fR
 .IP
-���������jerome � rachel � ������������ � ��� ����������
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
 .IP
 \f(CW$ edpykota --printer lp --charge 0.1\fR
 .IP
-���� ��� � �����.1. �� ����������
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
 .IP
 \f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
 .IP
-���� ��� hplj1 � hplj2 � �� ����aser � HP.
-������� ���hplj1 ��plj2, ����� ���� � ���� � � ������Laser � HP.
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -149,5 +227,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-.PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/pkbanner.1
===================================================================
--- pykota/trunk/man/el_GR/pkbanner.1 (revision 1939)
+++ pykota/trunk/man/el_GR/pkbanner.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKBANNER "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkbanner \- manual page for pkbanner 1.21alpha5_unofficial
+pkbanner \- manual page for pkbanner 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkbanner v1.21alpha5_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates banners.
@@ -69,5 +69,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/pkprinters.1
===================================================================
--- pykota/trunk/man/el_GR/pkprinters.1 (revision 1894)
+++ pykota/trunk/man/el_GR/pkprinters.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKPRINTERS "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkprinters \- manual page for pkprinters 1.20_unofficial
+pkprinters \- manual page for pkprinters 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkprinters v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 ���� ������yKota.
 .PP
@@ -20,5 +20,5 @@
 .TP
 \fB\-a\fR | \fB\-\-add\fR
-������� �� �� ���������, ����������� � ����\fB\-s\fR|--skipexisting.
+������� �� �� ���������, ����������� � ����\fB\-s\fR|\-\-skipexisting.
 .TP
 \fB\-d\fR | \fB\-\-delete\fR
@@ -57,5 +57,5 @@
 � ����0.1 ��� ��� ������������ �� ��� � ���� ����
 �� ����� ��������"HP Printer".
-� ���� � � ��� ��������������� � ����\fB\-s\fR|--skipexisting.
+� ���� � � ��� ��������������� � ����\fB\-s\fR|\-\-skipexisting.
 .IP
 \f(CW$ pkprinters --delete "*"\fR
@@ -86,5 +86,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/pykotme.1
===================================================================
--- pykota/trunk/man/el_GR/pykotme.1 (revision 1894)
+++ pykota/trunk/man/el_GR/pykotme.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOTME "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykotme \- manual page for pykotme 1.20_unofficial
+pykotme \- manual page for pykotme 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykotme v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 ��� ��� � ���� ����
@@ -57,5 +57,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/pykosd.1
===================================================================
--- pykota/trunk/man/el_GR/pykosd.1 (revision 1894)
+++ pykota/trunk/man/el_GR/pykosd.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOSD "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykosd \- manual page for pykosd 1.20_unofficial
+pykosd \- manual page for pykosd 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykosd v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 ������PyKota ��������OSD).
 .PP
@@ -51,5 +51,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/dumpykota.1
===================================================================
--- pykota/trunk/man/el_GR/dumpykota.1 (revision 1894)
+++ pykota/trunk/man/el_GR/dumpykota.1 (revision 2086)
@@ -1,54 +1,98 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH DUMPYKOTA "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-dumpykota \- manual page for dumpykota 1.20_unofficial
+dumpykota \- manual page for dumpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-dumpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
-��� ����������� PyKota.
+Dumps PyKota database's content.
 .PP
-���� ���
+command line usage :
 .IP
-dumpykota [���
+dumpykota [options] [filterexpr]
 .PP
-���:
+options :
 .TP
 \fB\-v\fR | \fB\-\-version\fR
-��� �����dumpykota� ���.
+Prints dumpykota's version number then exits.
 .TP
 \fB\-h\fR | \fB\-\-help\fR
-��� ����� ���.
+Prints this message then exits.
 .TP
 \fB\-d\fR | \fB\-\-data\fR type
-��� ���'���������
+Dumps 'type' datas. Allowed types are :
 .IP
-- history : ��� ������.
-- users : ��� ��
-- groups : ��� �� ��
-- printers : ��� ���.
-- upquotas : ��� ����- gpquotas : ��� ������- payments : ��� ��� ��
-- pmembers : ��� ������
-- umembers : ��� �������.IP
-��� ����\fB\-d\fR | \fB\-\-data\fR ��������.TP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
 \fB\-f\fR | \fB\-\-format\fR fmt
-��� ���������� ���
-��� ������sv (���������� �����������������������
-���������� ��:
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
 .IP
-- csv : ������ ��� ssv : ������ ������
-- tsv : ������ ���(tabs)
-- xml : ��� ��� �L
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
 .TP
-\fB\-o\fR | \fB\-\-output\fR ���������� �� ��'�
-���������� ��������� � '-' � ����� ����� ������ � �� ���������� �����������!
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
 .PP
-�����
+Examples :
 .IP
 \f(CW$ dumpykota --data history --format csv >myfile.csv\fR
 .IP
-���������� ���� ��������� ��������� ��.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
 \f(CW$ dumpykota --data users --format xml -o users.xml\fR
 .IP
-���� ��������� users.xml .
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -64,5 +108,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/pkhint.1
===================================================================
--- pykota/trunk/man/el_GR/pkhint.1 (revision 1894)
+++ pykota/trunk/man/el_GR/pkhint.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKHINT "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkhint \- manual page for pkhint 1.20_unofficial
+pkhint \- manual page for pkhint 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkhint v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 ���� ��� � ����� �������
 .PP
@@ -41,5 +41,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/repykota.1
===================================================================
--- pykota/trunk/man/el_GR/repykota.1 (revision 1894)
+++ pykota/trunk/man/el_GR/repykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH REPYKOTA "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-repykota \- manual page for repykota 1.20_unofficial
+repykota \- manual page for repykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-repykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 �����������PP
@@ -59,5 +59,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/el_GR/warnpykota.1
===================================================================
--- pykota/trunk/man/el_GR/warnpykota.1 (revision 1894)
+++ pykota/trunk/man/el_GR/warnpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH WARNPYKOTA "1" "����2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "����2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-warnpykota \- manual page for warnpykota 1.20_unofficial
+warnpykota \- manual page for warnpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-warnpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 ��� email ������ �� �����.
@@ -59,5 +59,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-��� ��� �� e-mail � Jerome Alet - alet@librelogiciel.com
+��� ��� �� e\-mail � Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/autopykota.1
===================================================================
--- pykota/trunk/man/de/autopykota.1 (revision 2086)
+++ pykota/trunk/man/de/autopykota.1 (revision 2086)
@@ -0,0 +1,47 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Ein Programm zum automatischen Anlegen von Benutzer\-Konti
+und zum Setzen von Anfangswerten
+.PP
+SIE D�FEN NICHT DIESES PROGRAMM VERWENDEN,
+WENN SIE DIE KONTINGENTE F� IHRE BENUTZER AUF DER BASIS VON SEITENZAHLEN SETZEN WOLLEN!
+.PP
+Gebrauch auf der Kommandozeile:
+.IP
+SIE D�FEN DIESES PROGRAMM NICHT AUF DER KOMMANDOZEILE BENUTZEN, SONDERN
+NUR ALS ALS external policy IN pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR value }
+.PP
+Optionen:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Version von autopykota aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Meldung aus und endet.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Setzt den Anfangswert der Balance des Benutzerkontos auf b.
+Wenn der Benutzer schon existiert, wird der aktuelle Balance\-Wert
+unver�ert gelassen. Wenn er nicht gesetzt wird,
+ist der Standardwert 0.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/edpykota.1
===================================================================
--- pykota/trunk/man/de/edpykota.1 (revision 2086)
+++ pykota/trunk/man/de/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/pkbanner.1
===================================================================
--- pykota/trunk/man/de/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/de/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/pkprinters.1
===================================================================
--- pykota/trunk/man/de/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/de/pkprinters.1 (revision 2086)
@@ -0,0 +1,107 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Ein Druckermanager f�ota.
+.PP
+Kommandozeilen\-Gebrauch:
+.IP
+pkprinters [Optionen] Drucker1 Drucker2 Drucker3 ... DruckerN
+.PP
+Optionen:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Versionsnummer von pkprinters aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Nachricht aus und endet.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+F�ucker hinzu, wenn sie in der Kontingentverwaltung
+noch nicht existieren. Wenn sie existieren, werden sie
+angepasst, ausser \fB\-s\fR | \fB\-\-skipexisting\fR ist auch gesetzt.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+L�t Drucker aus der Kontingentverwaltung.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d F�n Druckern eine Beschreibung hinzu.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Setzt den Preis pro Seite und pro Auftrag fest. Der Preis
+pro Auftrag ist fakultativ.
+Werden beide verwendet, trennen Sie sie mit einem Komma ab.
+Flie�ommazahlen und negative Werte sind erlaubt.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] F�n/die Drucker der Druckergruppen pg1,
+pg2, etc..., die schon existieren m� hinzu.
+Eine Druckergruppe ist wie ein normaler Drucker,
+bloss kennt man ihn �erweise im
+Drucksystem nicht. Richten Sie Druckergruppen genau
+gleich wie Drucker ein, dann f�ie andere
+Drucker mit dieser Option hinzu.
+Die Kontof� wird f�en Drucker und f�e
+Druckergruppen, denen er angeh� gemacht,
+die Kontingent��wird f� Drucker
+und f�e Druckergruppen, zu denen er geh�
+gemacht.
+Wenn die Option \fB\-\-remove\fR (siehe weiter unten) nicht
+gesetzt ist, so werden standardm�ig Drucker der
+angegebenen Druckergruppe hinzugef�TP
+\fB\-l\fR | \fB\-\-list\fR
+Gibt Informationen �en/die Drucker und die
+Druckergruppen, denen er angeh� aus.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In Kombination mit der obigen Option \fB\-\-groups\fR werden
+Drucker aus der angegebenen Druckergruppe entfernt.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In Kombination mit der obigen Option \fB\-\-add\fR verhindert
+dies, dass pkprinters existierende Drucker ver�ert.
+.IP
+Drucker1 bis DruckerN kann Platzhalter enthalten, wenn die Option \fB\-\-add\fR
+nicht gesetzt ist.
+.PP
+Beispiele:
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Dies richtet drei Drucker mit Namen hp2100, hp2200 und hp8000 ein.
+Die Seitenkosten f�se Drucker ist auf 0.05 Einheiten festgelegt und
+ihr Preis pro Auftrag auf 0.01 Einheiten. Einheiten k�n Ihrer W�ung
+entsprechen oder was immer Sie unter ihnen verstehen wollen.
+Die Beschreibung aller Drucker ist auf die Zeichenkette "HP Printer"
+gesetzt. Wenn irgendeiner dieser Drucker schon existiert, wird er
+modifiziert, ausser die Option \fB\-s\fR | \fB\-\-skipexisting\fR ist auch gesetzt.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+Dies l�t alle Drucker und dazugeh�en Kontingentinformationen
+vollst�ig, ebenso die Liste der Druckauftr�. VORSICHT!
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+Dies f�le Drucker, deren Namen zu "hp*" passen, den Druckergruppen
+Laser und HP, die schon VORHANDEN SEIN M�SEN, hinzu.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+Dies entfernt den Drucker hp2200 aus der Druckergruppe LexMark.<
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/pykotme.1
===================================================================
--- pykota/trunk/man/de/pykotme.1 (revision 2086)
+++ pykota/trunk/man/de/pykotme.1 (revision 2086)
@@ -0,0 +1,61 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Gibt den Benutzern ihre Druckkontingente an.
+.PP
+Kommandozeilen\-Gebrauch:
+.TP
+pykotme
+[Optionen]  [Dateien]
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Versionsnummer von pyktome aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Nachricht aus und endet.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Zeigt ein Kontingent ausschliesslich f�sen Drucker an.
+p kann Platzhalter enthalten um nur einige Drucker
+auszuw�en. Standardwert ist *, d.h. alle Drucker.
+Sie k�n verschiedene Namen oder Platzhalter,
+durch Kommas getrennt, angeben.
+.PP
+Beispiele:
+.IP
+\f(CW$ pykotme --printer apple Datei1.ps Datei2.ps\fR
+.IP
+Dies gibt ein Druckkontingent f� aktuellen Benutzer an. Das Kontingent
+wird mit dem Preis und der Gr�eines Auftrags auf Basis von Datei1.ps
+und Datei2.ps angegeben, wenn sie an den Drucker apple gesendet w�
+.IP
+\f(CW$ pykotme --printer apple,hplaser <Datei1.ps\fR
+.IP
+Dies gibt ein Druckkontingent f� aktuellen Benutzer an. Das Kontingent
+wird mit dem Preis und der Gr�eines Auftrags auf Basis von Datei1.ps,
+angegeben, so wie sie vom Standard Input her gelesen wird, wenn sie an
+den Drucker apple oder hplaser gesendet w�.IP
+\f(CW$ pykotme\fR
+.IP
+Dies gibt ein Kontingent f�en Auftrag an, der aus dem besteht, was
+via Standard Input ankommt. Das Kontingent zeigt die Gr�des Auftrags
+und den Preis, den der Auftrag auf jedem Drucker kosten w�.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/pykosd.1
===================================================================
--- pykota/trunk/man/de/pykosd.1 (revision 2086)
+++ pykota/trunk/man/de/pykosd.1 (revision 2086)
@@ -0,0 +1,64 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Ein OSD Kontingent\-Anzeiger f�ota.
+.PP
+Kommandozeilen\-Gebrauch:
+.IP
+pykosd [Optionen]
+.PP
+Optionen:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Versionsnummer von pykosd aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Meldung aus und endet.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Stellt die Farbe f� Anzeige in Form eines
+hexadezimalen Triplets ein; zum Beipiel: #FF0000 ist 100% rot.
+Standard ist 100% gr�0FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Stellt die Dauer der Anzeige in Sekunden ein.
+Standard ist 3 Sekunden.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Stellt die Schriftart f� Anzeige ein.
+Standard ist der Standard der Python OSD Bibliothek.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Stellt ein, wie oft die Information angezeigt wird.
+Standard ist 0, das hei� immer.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Stellt die Schlafdauer zwischen zwei Anzeigen in
+Sekunden ein.
+Standard ist 180 Sekunden (3 Minuten).
+.PP
+Beispiele:
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Startet pykosd. Die Anzeige wird alle 60 Sekunden erneuert und dauert
+jedes Mal 3 Sekunden (der Standardwert). Nach f�rchl�en endet
+das Programm.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/dumpykota.1
===================================================================
--- pykota/trunk/man/de/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/de/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/pkhint.1
===================================================================
--- pykota/trunk/man/de/pkhint.1 (revision 2086)
+++ pykota/trunk/man/de/pkhint.1 (revision 2086)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Ein Werkzeug, das Hinweise auf die beste Z�methode f�en Drucker gibt.
+.PP
+Kommandozeilen\-Gebrauch:
+.IP
+pkhint [Optionen] [Drucker1 Drucker2 Drucker3 ... DruckerN] <file.conf
+.PP
+Optionen:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Versionsnummer von pkhint aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Meldung aus und endet.
+.PP
+Beispiele:
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Analysiert Ihr Drucksystem um festzustellen, welcher Z�er
+der geeignetste ist f�en der angegebenen Drucker, dessen
+Name zu einem der Parameter passt.
+.IP
+Wenn Sie keinen Parameter auf der Kommandozeile �ben,
+werden alle Drucker analysiert.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/pkmail.1
===================================================================
--- pykota/trunk/man/de/pkmail.1 (revision 2086)
+++ pykota/trunk/man/de/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/repykota.1
===================================================================
--- pykota/trunk/man/de/repykota.1 (revision 2086)
+++ pykota/trunk/man/de/repykota.1 (revision 2086)
@@ -0,0 +1,72 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Erzeugt Berichte zu den Druckkontingenten.
+.PP
+Kommandozeilen\-Gebrauch:
+.IP
+repykota [Optionen]
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Versionsnummer von repykota aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Meldung aus und endet.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Erzeugt einen Bericht �ie Kontigente der Benutzer.
+Dies ist der Standard.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Erzeugt einen Bericht �ie Kontingente der Gruppe
+anstelle der Benutzer.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Druckkontingent nur f�sen Drucker ausgeben.
+p kann Platzhalter enthalten um nur einige Drucker
+auszuw�en. Der Standardwert ist *, d.h. alle
+Drucker.
+Sie k�n verschiedene Namen oder Platzhalter angeben,
+die Sie mit Kommas abtrennen.
+.PP
+Beispiele:
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+Dies gibt den Stand der Kontingente aller Benutzer aus, die den
+Drucker lp benutzen.
+.IP
+\f(CW$ repykota\fR
+.IP
+Dies gibt den Stand der Kontingente f�e Benutzer auf allen Druckern aus.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+Dies gibt den Stand der Kontingente f� Benutzer jerome und f�e
+Benutzer aus, deren Namen mit "jo" beginnt, auf allen Druckern, deren Namen
+mit "laser" beginnt oder mit "pson" endet.
+.IP
+Wenn das Programm von einem Benutzer aufgerufen wird, der kein
+PyKota\-Administrator ist, so werden die zus�lichen Optionen f�utzer
+oder Gruppen ignoriert und nur die Daten des aktuellen Benutzers/Gruppe
+ausgegeben.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/de/warnpykota.1
===================================================================
--- pykota/trunk/man/de/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/de/warnpykota.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Sendet Post an die Benutzer bez� Druckkontingente.
+.PP
+Befehlszeilen\-Gebrauch:
+.TP
+warnpykota
+[Optionen]  [Namen]
+.PP
+Optionen:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Gibt die Version von warnpykota aus und endet.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Gibt diese Meldung aus und endet.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Warnt die Benutzer bez� ihres Druckkontingents.
+Das ist der Standard.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Warnt die Benutzer, deren Gruppen �em Limit sind.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verfiziert die Kontingente allein f�sen Drucker.
+p kann Platzhalter enthalten um nur einige Drucker
+auszuw�en. Standardwert ist *, d.h. alle Drucker.
+Sie k�n verschiedene Namen und Platzhalter angeben,
+die Sie mit Kommas abtrennen m�
+.PP
+Beispiele:
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+Dies warnt alle Benutzer des Druckers lp, die ihr Druckkontingent
+�hritten haben.
+.IP
+\f(CW$ warnpykota\fR
+.IP
+Dies warnt alle Benutzer, die Ihr Druckkontingent auf irgendeinem
+Drucker �hritten haben.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+Dies warnt alle Benutzer der Gruppen, deren Namen mit "dev" beginnen und
+die ihr Druckkontingent auf irgendeinem Drucker, dessen Name mit
+"laserjet" beginnt.
+.IP
+Wenn das Programm von einem Benutzer aufgerufen wird, der nicht ein
+Pykota\-Administrator ist, werden die Optionen f�utzer\- und
+Gruppennamen ignoriert und nur der aktuelle Benutzer/Gruppe angezeigt.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Melden Sie bitte Fehler an: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/autopykota.1
===================================================================
--- pykota/trunk/man/nb_NO/autopykota.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/autopykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH AUTOPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-autopykota \- manual page for autopykota 1.20_unofficial
+autopykota \- manual page for autopykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-autopykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 Et verkt�r �utomatisere oppretting av brukere og oppstarten av kvotesystemet.
 .PP
@@ -40,5 +40,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/edpykota.1
===================================================================
--- pykota/trunk/man/nb_NO/edpykota.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/edpykota.1 (revision 2086)
@@ -1,27 +1,27 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH EDPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.20_unofficial
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-edpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
-En utskriftkvote behandler for PyKota.
-.PP
-kommandoline bruk:
-.IP
-edpykota [opsjoner] bruker1 bruker2 ... brukerN
-.IP
-edpykota [opsjoner] gruppe1 gruppe2 ... gruppeN
-.PP
-opsjoner :
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
 .TP
 \fB\-v\fR | \fB\-\-version\fR
-Viser edpykota's versjon nummer.
+Prints edpykota's version number then exits.
 .TP
 \fB\-h\fR | \fB\-\-help\fR
-Viser denne meldingen.
+Prints this message then exits.
 .TP
 \fB\-a\fR | \fB\-\-add\fR
-Legger til brukere og/eller skrivere hvis de ikke finnes
-p�yKotasystem serveren.
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
 .TP
 \fB\-d\fR | \fB\-\-delete\fR
@@ -34,4 +34,15 @@
 If both are to be set, separate them with a comma.
 Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
 .TP
 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
@@ -80,5 +91,5 @@
 Resets the actual and life time page counters
 for the user or group to zero on the specified
-printers.
+printers. This is a shortcut for '\-\-used 0'.
 .TP
 \fB\-l\fR | \fB\-\-limitby\fR l
@@ -86,7 +97,7 @@
 by its account balance or by its page quota.
 The default value is 'quota'. Allowed values
-are 'quota' 'balance' 'quota-then-balance' and
-\&'balance-then-quota'.
-WARNING : quota-then-balance and balance-then-quota
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
 are not yet implemented.
 .TP
@@ -94,5 +105,5 @@
 Sets the user's account balance to b.
 Account balance may be increase or decreased
-if b is prefixed with + or -.
+if b is prefixed with + or \-.
 WARNING : when decreasing account balance,
 the total paid so far by the user is decreased
@@ -106,4 +117,15 @@
 \fB\-H\fR | \fB\-\-hardlimit\fR hl
 Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
 .IP
 user1 through userN and group1 through groupN can use wildcards
@@ -178,4 +200,18 @@
 When printing either on hplj1 or hplj2, print quota will also be
 checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -191,5 +227,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-.PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/pkbanner.1
===================================================================
--- pykota/trunk/man/nb_NO/pkbanner.1 (revision 1939)
+++ pykota/trunk/man/nb_NO/pkbanner.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKBANNER "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkbanner \- manual page for pkbanner 1.21alpha5_unofficial
+pkbanner \- manual page for pkbanner 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkbanner v1.21alpha5_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates banners.
@@ -69,5 +69,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/pkprinters.1
===================================================================
--- pykota/trunk/man/nb_NO/pkprinters.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/pkprinters.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKPRINTERS "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkprinters \- manual page for pkprinters 1.20_unofficial
+pkprinters \- manual page for pkprinters 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkprinters v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 En skriverbehandler for PyKota.
 .PP
@@ -21,5 +21,5 @@
 \fB\-a\fR | \fB\-\-add\fR
 Legger til skrivere hvis de ikke allerede finnes p�yKota systemet.Hvis de allerede finnes, s�il de bli endret
-med mindre \fB\-s\fR|--skipexisting brukes samtidig.
+med mindre \fB\-s\fR|\-\-skipexisting brukes samtidig.
 .TP
 \fB\-d\fR | \fB\-\-delete\fR
@@ -71,5 +71,5 @@
 Alle deres beskrivelser settes lik med strengen "HP Printer".
 Hvis noen av disse allerede finnes s�il de bli endret,
-med mindre du ogs�ar brukt \fB\-s\fR|--skipexisting kommandolinje opsjonen.
+med mindre du ogs�ar brukt \fB\-s\fR|\-\-skipexisting kommandolinje opsjonen.
 .IP
 \f(CW$ pkprinters --delete "*"\fR
@@ -99,5 +99,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/pykotme.1
===================================================================
--- pykota/trunk/man/nb_NO/pykotme.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/pykotme.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOTME "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykotme \- manual page for pykotme 1.20_unofficial
+pykotme \- manual page for pykotme 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykotme v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Gives print quotes to users.
@@ -62,5 +62,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/pykosd.1
===================================================================
--- pykota/trunk/man/nb_NO/pykosd.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/pykosd.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOSD "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykosd \- manual page for pykosd 1.20_unofficial
+pykosd \- manual page for pykosd 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykosd v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 En OSD kvote overv�r for PyKota.
 .PP
@@ -58,5 +58,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/dumpykota.1
===================================================================
--- pykota/trunk/man/nb_NO/dumpykota.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/dumpykota.1 (revision 2086)
@@ -1,66 +1,98 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH DUMPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-dumpykota \- manual page for dumpykota 1.20_unofficial
+dumpykota \- manual page for dumpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-dumpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
-Dumper innholdet i PyKota's database.
+Dumps PyKota database's content.
 .PP
-kommandolinje bruk:
+command line usage :
 .IP
-dumpykota [opsjoner]
+dumpykota [options] [filterexpr]
 .PP
-opsjoner :
+options :
 .TP
 \fB\-v\fR | \fB\-\-version\fR
-Viser dumpykota's versjon nummer.
+Prints dumpykota's version number then exits.
 .TP
 \fB\-h\fR | \fB\-\-help\fR
-Viser denne meldingen.
+Prints this message then exits.
 .TP
 \fB\-d\fR | \fB\-\-data\fR type
-Dumper data av typen 'type'. Tillatte typer er :
+Dumps 'type' datas. Allowed types are :
 .IP
-- history : dumper utskrifts historie.
-- users : dumper brukere.
-- groups : dumper brukergrupper.
-- printers : dumper skrivere.
-- upquotas : dumper brukerkvoter.
-- gpquotas : dumper brukergruppekvoter.
-- payments : dumper brukeres innbetalinger.
-- pmembers : dumper medlemmer av skrivergrupper
-- umembers : dumper medlemmer av brukergrupper.
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
 .IP
-NB : opsjonen \fB\-d\fR | \fB\-\-data\fR p�ommandolinjen
-er N�VENDIG.
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
 .TP
 \fB\-f\fR | \fB\-\-format\fR fmt
-Dumper data i 'fmt' formatet. Hvis annet ikke er oppgitt,
-s�r formatet av typen csv  (comma
-separated values). All data som dumpes plasseres innenfor
-anf�stegn. Tillatte format er :
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
 .IP
-- csv : skiller data med komma
-- ssv : skiller data med semikolon
-- tsv : skiller data med tabulatorinnrykk
-- xml : dumper data som XML
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
 .TP
 \fB\-o\fR | \fB\-\-output\fR fname
-All data dumpes rett til filem istedenfor til
-standardutdata(stdout). Den spesielle '-' filnavn
-er standard og betyr standardutdata(stdout).
-ADVARSEL : eksisterende filer blir klippet av!
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
 .PP
-Eksempler:
+Examples :
 .IP
 \f(CW$ dumpykota --data history --format csv >myfile.csv\fR
 .IP
-Dette dumper historien til en komma separert fil, for lett import til et
-regneark
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
 .IP
 \f(CW$ dumpykota --data users --format xml -o users.xml\fR
 .IP
-Dumper alle brukeres data til fila users.xml.
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -76,5 +108,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/pkhint.1
===================================================================
--- pykota/trunk/man/nb_NO/pkhint.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/pkhint.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKHINT "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkhint \- manual page for pkhint 1.20_unofficial
+pkhint \- manual page for pkhint 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkhint v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 Et verkt�r �est avgj�va slags bokf�ssystem som best egner seg for hver skriver.
 .PP
@@ -42,5 +42,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/repykota.1
===================================================================
--- pykota/trunk/man/nb_NO/repykota.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/repykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH REPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-repykota \- manual page for repykota 1.20_unofficial
+repykota \- manual page for repykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-repykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates print quota reports.
@@ -67,5 +67,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/nb_NO/warnpykota.1
===================================================================
--- pykota/trunk/man/nb_NO/warnpykota.1 (revision 1894)
+++ pykota/trunk/man/nb_NO/warnpykota.1 (revision 2086)
@@ -1,10 +1,10 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH WARNPYKOTA "1" "november 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "februar 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-warnpykota \- manual page for warnpykota 1.20_unofficial
+warnpykota \- manual page for warnpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-warnpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
-Sender e-post til brukere som har oversetget sin utskriftskvote.
+Sender e\-post til brukere som har oversetget sin utskriftskvote.
 .PP
 kommandolinje bruk :
@@ -70,5 +70,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/autopykota.1
===================================================================
--- pykota/trunk/man/zh_TW/autopykota.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/autopykota.1 (revision 2086)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+autopykota \- manual page for autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to automate user account creation and initial balance setting.
+.PP
+THIS TOOL MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY PAGE QUOTA !
+.PP
+command line usage :
+.IP
+THIS TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART
+OF AN external policy IN pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR value }
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints autopykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Sets the user's account initial balance value to b.
+If the user already exists, actual balance is left
+unmodified. If unset, the default value is 0.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/edpykota.1
===================================================================
--- pykota/trunk/man/zh_TW/edpykota.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/pkbanner.1
===================================================================
--- pykota/trunk/man/zh_TW/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+pkbanner \- manual page for pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/pkprinters.1
===================================================================
--- pykota/trunk/man/zh_TW/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/pkprinters.1 (revision 2086)
@@ -0,0 +1,107 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+pkprinters \- manual page for pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Printers Manager for PyKota.
+.PP
+command line usage :
+.IP
+pkprinters [options] printer1 printer2 printer3 ... printerN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkprinters's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds printers if they don't exist on the Quota
+Storage Server. If they exist, they are modified
+unless \fB\-s\fR|\-\-skipexisting is also used.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes printers from the quota storage.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge.
+Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point and negative values are allowed.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
+groups pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+If the \fB\-\-remove\fR option below is not used, the
+default action is to add printers to the specified
+printer groups.
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+List informations about the printer(s) and the
+printers groups it is a member of.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In combination with the \fB\-\-groups\fR option above,
+remove printers from the specified printers groups.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In combination with the \fB\-\-add\fR option above, tells
+pkprinters to not modify existing printers.
+.IP
+printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
+is not set.
+.PP
+examples :
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Will create three printers named hp2100, hp2200 and hp8000.
+Their price per page will be set at 0.05 unit, and their price
+per job will be set at 0.1 unit. Units are in your own currency,
+or whatever you want them to mean.
+All of their descriptions will be set to the string "HP Printer".
+If any of these printers already exists, it will also be modified
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+This will completely delete all printers and associated quota information,
+as well as their job history. USE WITH CARE !
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+This will put all printers which name matches "hp*" into printers groups
+Laser and HP, which MUST already exist.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+This will remove the hp2200 printer from the LexMark printer group.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/pykotme.1
===================================================================
--- pykota/trunk/man/zh_TW/pykotme.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/pykotme.1 (revision 2086)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+pykotme \- manual page for pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Gives print quotes to users.
+.PP
+command line usage :
+.TP
+pykotme
+[options]  [files]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykotme's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Gives a quote for this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ pykotme --printer apple file1.ps file2.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps and file2.ps
+which would be sent to the apple printer.
+.IP
+\f(CW$ pykotme --printer apple,hplaser <file1.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps as read from
+standard input, which would be sent to the apple or hplaser
+printer.
+.IP
+\f(CW$ pykotme\fR
+.IP
+This will give a quote for a job consisting of what is on standard
+input. The quote will list the job size, and the price the job
+would cost on each printer.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/pykosd.1
===================================================================
--- pykota/trunk/man/zh_TW/pykosd.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/pykosd.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+pykosd \- manual page for pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+An OSD quota monitor for PyKota.
+.PP
+command line usage :
+.IP
+pykosd [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykosd's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Sets the color to use for display as an hexadecimal
+triplet, for example #FF0000 is 100% red.
+Defaults to 100% green (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Sets the duration of the display in seconds.
+Defaults to 3 seconds.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Sets the font to use for display.
+Defaults to the Python OSD library's default.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Sets the number of times the info will be displayed.
+Defaults to 0, which means loop forever.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Sets the sleeping duration between two displays
+in seconds. Defaults to 180 seconds (3 minutes).
+.PP
+examples :
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Will launch pykosd. Display will be refreshed every 60 seconds,
+and will last for 3 seconds (the default) each time. After five
+iterations, the program will exit.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/dumpykota.1
===================================================================
--- pykota/trunk/man/zh_TW/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+dumpykota \- manual page for dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/pkhint.1
===================================================================
--- pykota/trunk/man/zh_TW/pkhint.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/pkhint.1 (revision 2086)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+pkhint \- manual page for pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to give hints on what accounting method is best for each printer.
+.PP
+command line usage :
+.IP
+pkhint [options] [printer1 printer2 printer3 ... printerN] <file.conf
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkhint's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.PP
+examples :
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Will analyze your printing system to test which accounter
+is the best for each of the defined printer which
+name matches one of the parameters.
+.IP
+If you don't pass any argument on the command line, all
+printers will be analyzed.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/pkmail.1
===================================================================
--- pykota/trunk/man/zh_TW/pkmail.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+pkmail \- manual page for pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/repykota.1
===================================================================
--- pykota/trunk/man/zh_TW/repykota.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/repykota.1 (revision 2086)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+repykota \- manual page for repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates print quota reports.
+.PP
+command line usage :
+.IP
+repykota [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints repykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Generates a report on users quota, this is
+the default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Generates a report on group quota instead of users.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Report quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+This will print the quota status for all users who use the lp printer.
+.IP
+\f(CW$ repykota\fR
+.IP
+This will print the quota status for all users on all printers.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+This will print the quota status for user jerome and all users
+whose name begins with "jo" on all printers which name begins
+with "laser" or ends with "pson".
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/zh_TW/warnpykota.1
===================================================================
--- pykota/trunk/man/zh_TW/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/zh_TW/warnpykota.1 (revision 2086)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "�G��005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NAME
+warnpykota \- manual page for warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Sends mail to users over print quota.
+.PP
+command line usage :
+.TP
+warnpykota
+[options]  [names]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints warnpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Warns users over their print quota, this is the
+default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Warns users whose groups quota are over limit.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verify quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+This will warn all users of the lp printer who have exceeded their
+print quota.
+.IP
+\f(CW$ warnpykota\fR
+.TP
+This will warn all users
+who have exceeded their print quota on
+.IP
+any printer.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+This will warn all users of groups which names begins with "dev" and
+who have exceeded their print quota on any printer which name begins
+with "laserjet"
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pkhint.1
===================================================================
--- pykota/trunk/man/pkhint.1 (revision 1942)
+++ pykota/trunk/man/pkhint.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKHINT "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkhint \- manual page for pkhint 1.21alpha6_unofficial
+pkhint \- manual page for pkhint 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkhint v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A tool to give hints on what accounting method is best for each printer.
 .PP
@@ -42,5 +42,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/repykota.1
===================================================================
--- pykota/trunk/man/repykota.1 (revision 1942)
+++ pykota/trunk/man/repykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH REPYKOTA "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-repykota \- manual page for repykota 1.21alpha6_unofficial
+repykota \- manual page for repykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-repykota v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates print quota reports.
@@ -67,5 +67,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/warnpykota.1
===================================================================
--- pykota/trunk/man/warnpykota.1 (revision 1942)
+++ pykota/trunk/man/warnpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH WARNPYKOTA "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-warnpykota \- manual page for warnpykota 1.21alpha6_unofficial
+warnpykota \- manual page for warnpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-warnpykota v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Sends mail to users over print quota.
@@ -72,5 +72,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pkbanner.1
===================================================================
--- pykota/trunk/man/pkbanner.1 (revision 1942)
+++ pykota/trunk/man/pkbanner.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKBANNER "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkbanner \- manual page for pkbanner 1.21alpha6_unofficial
+pkbanner \- manual page for pkbanner 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkbanner v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates banners.
@@ -69,5 +69,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/autopykota.1
===================================================================
--- pykota/trunk/man/autopykota.1 (revision 1942)
+++ pykota/trunk/man/autopykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH AUTOPYKOTA "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-autopykota \- manual page for autopykota 1.21alpha6_unofficial
+autopykota \- manual page for autopykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-autopykota v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A tool to automate user account creation and initial balance setting.
 .PP
@@ -40,5 +40,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pkprinters.1
===================================================================
--- pykota/trunk/man/pkprinters.1 (revision 1942)
+++ pykota/trunk/man/pkprinters.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKPRINTERS "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkprinters \- manual page for pkprinters 1.21alpha6_unofficial
+pkprinters \- manual page for pkprinters 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkprinters v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Printers Manager for PyKota.
 .PP
@@ -22,5 +22,5 @@
 Adds printers if they don't exist on the Quota
 Storage Server. If they exist, they are modified
-unless \fB\-s\fR|--skipexisting is also used.
+unless \fB\-s\fR|\-\-skipexisting is also used.
 .TP
 \fB\-d\fR | \fB\-\-delete\fR
@@ -75,5 +75,5 @@
 All of their descriptions will be set to the string "HP Printer".
 If any of these printers already exists, it will also be modified
-unless the \fB\-s\fR|--skipexisting command line option is also used.
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
 .IP
 \f(CW$ pkprinters --delete "*"\fR
@@ -103,5 +103,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/autopykota.1
===================================================================
--- pykota/trunk/man/pt_BR/autopykota.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/autopykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH AUTOPYKOTA "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-autopykota \- manual page for autopykota 1.20_unofficial
+autopykota \- manual page for autopykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-autopykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A tool to automate user account creation and initial balance setting.
 .PP
@@ -40,5 +40,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/edpykota.1
===================================================================
--- pykota/trunk/man/pt_BR/edpykota.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/edpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH EDPYKOTA "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.20_unofficial
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-edpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Print Quota editor for PyKota.
 .PP
@@ -34,4 +34,15 @@
 If both are to be set, separate them with a comma.
 Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
 .TP
 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
@@ -80,5 +91,5 @@
 Resets the actual and life time page counters
 for the user or group to zero on the specified
-printers.
+printers. This is a shortcut for '\-\-used 0'.
 .TP
 \fB\-l\fR | \fB\-\-limitby\fR l
@@ -86,7 +97,7 @@
 by its account balance or by its page quota.
 The default value is 'quota'. Allowed values
-are 'quota' 'balance' 'quota-then-balance' and
-\&'balance-then-quota'.
-WARNING : quota-then-balance and balance-then-quota
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
 are not yet implemented.
 .TP
@@ -94,5 +105,5 @@
 Sets the user's account balance to b.
 Account balance may be increase or decreased
-if b is prefixed with + or -.
+if b is prefixed with + or \-.
 WARNING : when decreasing account balance,
 the total paid so far by the user is decreased
@@ -106,4 +117,15 @@
 \fB\-H\fR | \fB\-\-hardlimit\fR hl
 Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
 .IP
 user1 through userN and group1 through groupN can use wildcards
@@ -178,4 +200,18 @@
 When printing either on hplj1 or hplj2, print quota will also be
 checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -191,5 +227,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-.PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/pkbanner.1
===================================================================
--- pykota/trunk/man/pt_BR/pkbanner.1 (revision 1939)
+++ pykota/trunk/man/pt_BR/pkbanner.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKBANNER "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkbanner \- manual page for pkbanner 1.21alpha5_unofficial
+pkbanner \- manual page for pkbanner 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkbanner v1.21alpha5_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates banners.
@@ -69,5 +69,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/pkprinters.1
===================================================================
--- pykota/trunk/man/pt_BR/pkprinters.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/pkprinters.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKPRINTERS "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkprinters \- manual page for pkprinters 1.20_unofficial
+pkprinters \- manual page for pkprinters 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkprinters v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Printers Manager for PyKota.
 .PP
@@ -22,5 +22,5 @@
 Adds printers if they don't exist on the Quota
 Storage Server. If they exist, they are modified
-unless \fB\-s\fR|--skipexisting is also used.
+unless \fB\-s\fR|\-\-skipexisting is also used.
 .TP
 \fB\-d\fR | \fB\-\-delete\fR
@@ -75,5 +75,5 @@
 All of their descriptions will be set to the string "HP Printer".
 If any of these printers already exists, it will also be modified
-unless the \fB\-s\fR|--skipexisting command line option is also used.
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
 .IP
 \f(CW$ pkprinters --delete "*"\fR
@@ -103,5 +103,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/pykotme.1
===================================================================
--- pykota/trunk/man/pt_BR/pykotme.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/pykotme.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOTME "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykotme \- manual page for pykotme 1.20_unofficial
+pykotme \- manual page for pykotme 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykotme v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Gives print quotes to users.
@@ -62,5 +62,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/pykosd.1
===================================================================
--- pykota/trunk/man/pt_BR/pykosd.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/pykosd.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOSD "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykosd \- manual page for pykosd 1.20_unofficial
+pykosd \- manual page for pykosd 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykosd v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 An OSD quota monitor for PyKota.
 .PP
@@ -59,5 +59,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/dumpykota.1
===================================================================
--- pykota/trunk/man/pt_BR/dumpykota.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/dumpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH DUMPYKOTA "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-dumpykota \- manual page for dumpykota 1.20_unofficial
+dumpykota \- manual page for dumpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-dumpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Dumps PyKota database's content.
@@ -10,5 +10,5 @@
 command line usage :
 .IP
-dumpykota [options]
+dumpykota [options] [filterexpr]
 .PP
 options :
@@ -23,13 +23,13 @@
 Dumps 'type' datas. Allowed types are :
 .IP
-- history : dumps the jobs history.
-- users : dumps users.
-- groups : dumps user groups.
-- printers : dump printers.
-- upquotas : dump user quotas.
-- gpquotas : dump user groups quotas.
-- payments : dumps user payments.
-- pmembers : dumps printer groups members.
-- umembers : dumps user groups members.
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
 .IP
 NB : the \fB\-d\fR | \fB\-\-data\fR command line option
@@ -42,14 +42,42 @@
 quotes. Allowed formats are :
 .IP
-- csv : separate datas with commas
-- ssv : separate datas with semicolons
-- tsv : separate datas with tabs
-- xml : dump data as XML
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
 .TP
 \fB\-o\fR | \fB\-\-output\fR fname
 All datas will be dumped to the file instead of
-to the standard output. The special '-' filename
+to the standard output. The special '\-' filename
 is the default value and means stdout.
 WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
 .PP
 Examples :
@@ -63,4 +91,8 @@
 .IP
 Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -76,5 +108,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/pkhint.1
===================================================================
--- pykota/trunk/man/pt_BR/pkhint.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/pkhint.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKHINT "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkhint \- manual page for pkhint 1.20_unofficial
+pkhint \- manual page for pkhint 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkhint v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A tool to give hints on what accounting method is best for each printer.
 .PP
@@ -42,5 +42,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/repykota.1
===================================================================
--- pykota/trunk/man/pt_BR/repykota.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/repykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH REPYKOTA "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-repykota \- manual page for repykota 1.20_unofficial
+repykota \- manual page for repykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-repykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Generates print quota reports.
@@ -67,5 +67,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pt_BR/warnpykota.1
===================================================================
--- pykota/trunk/man/pt_BR/warnpykota.1 (revision 1894)
+++ pykota/trunk/man/pt_BR/warnpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH WARNPYKOTA "1" "novembro 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "fevereiro 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-warnpykota \- manual page for warnpykota 1.20_unofficial
+warnpykota \- manual page for warnpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-warnpykota v1.20_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Sends mail to users over print quota.
@@ -72,5 +72,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/autopykota.1
===================================================================
--- pykota/trunk/man/fr/autopykota.1 (revision 2086)
+++ pykota/trunk/man/fr/autopykota.1 (revision 2086)
@@ -0,0 +1,45 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Un outil pour automatiser la cr�ion des comptes et l'initialisation
+du solde.
+.PP
+CET OUTIL NE DOIT PAS �RE UTILIS�SI VOUS LIMITEZ VOS UTILISATEURS PAR
+QUOTA !
+.PP
+ligne de commande :
+.IP
+CET OUTIL NE DOIT PAS �RE UTILIS�DEPUIS LA LIGNE DE COMMANDE MAIS
+SEULEMENT DANS UNE external policy DANS pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR valeur }
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version d'autopykota et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Positionne le solde initial de l'utilisateur �.
+Si l'utilisateur existe d�, le solde actuel reste
+inchang�Si non indiqu�la valeur par d�ut est 0.
+.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
+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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/edpykota.1
===================================================================
--- pykota/trunk/man/fr/edpykota.1 (revision 2086)
+++ pykota/trunk/man/fr/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/pkbanner.1
===================================================================
--- pykota/trunk/man/fr/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/fr/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/pkprinters.1
===================================================================
--- pykota/trunk/man/fr/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/fr/pkprinters.1 (revision 2086)
@@ -0,0 +1,109 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Un gestionnaire d'imprimantes pour PyKota.
+.PP
+ligne de commande :
+.IP
+pkprinters [options] impr1 impr2 impr3 ... imprN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version de pkprinters et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Ajoute les imprimantes si elles n'existent pas d�
+dans la base de donn�. Si elles existent, alors
+elles sont modifi� sauf si l'option de ligne de
+commande \fB\-s\fR|\-\-skipexisting est aussi utilis�
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Supprime les imprimantes de la base de donn�.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Ajoute une description textuelle aux imprimantes.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Fixes les co�ar page et par travail.
+Le co�r travail d'impression est optionnel.
+Si les deux sont utilis� s�rez les nombres par
+une virgule.
+Les nombres n�tifs ou avec d�males sont autoris�
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Ajoute ou supprime les imprimantes des groupes
+pg1, pg2, etc... qui doivent d� exister.
+Un groupe d'imprimantes est comme une imprimante
+normale mais est inconnu du syst� d'impression.
+On cr�les groupes d'imprimantes de la m� mani�
+que l'on cr�des imprimantes, et ensuite on leur
+ajoute des imprimantes avec cette option.
+Le d�mpte et la v�fication sont effectu�sur
+une imprimante et sur tous les groupes auxquels elle
+appartient.
+Si l'option \fB\-\-remove\fR ci\-dessous n'est pas utilis�
+l'action par d�ut est d'ajouter les imprimantes aux
+groupes d'imprimantes sp�fi�
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+Liste les informations sur les imprimantes et les
+groupes dont elles sont membres.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+Combin�avec l'option \fB\-\-groups\fR ci\-dessus, supprime
+les imprimantes des groupes sp�fi�
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+Combin�avec l'option \fB\-\-add\fR ci\-dessus, indique
+�kprinters de ne pas modifier les imprimantes
+existantes.
+.IP
+Les noms d'imprimantes peuvent contenir des caract�s jokers si l'option
+\fB\-\-add\fR n'est pas utilis�
+.PP
+exemples :
+.IP
+\f(CW$ pkprinters --add -D "Imprimante HP" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Ceci va cr� les trois imprimantes hp2100, hp2200 and hp8000.
+Leur co�r page sera fix� 0.05 unit�et leur co�r travail sera
+fix� 0.1 unit�Les unit�sont dans votre propre monnaie,
+ou dans ce que vous voulez qu'elles signifient.
+Leurs descriptions seront positionn� �Imprimante HP".
+Si l'une de ces imprimantes existe d�, elle sera modifi��oins que
+l'option \fB\-s\fR|\-\-skipexisting ne soit aussi utilis�
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+Ceci va compl�ment effacer toutes les imprimantes, leurs informations
+de quota ainsi que leurs historiques des travaux. SOYEZ PRUDENTS !
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+Ceci ba mettre toutes les imprimantes dont le nom correspond �hp*"
+dans les groupes Laser et HP, qui DOIVENT d� exister.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+Ceci va enlever l'imprimante hp2200 du groupe LexMark.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/pykotme.1
===================================================================
--- pykota/trunk/man/fr/pykotme.1 (revision 2086)
+++ pykota/trunk/man/fr/pykotme.1 (revision 2086)
@@ -0,0 +1,65 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Fait des devis d'impression aux utilisateurs.
+.PP
+ligne de commande :
+.TP
+pykotme
+[options]  [fichiers]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version de pykotme et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Fait un devis sur cette imprimante seulement.
+En fait p peut contenir des caract�s jokers
+pour s�ctionner seulement certaines imprimantes.
+La valeur par d�ut est *, qui signifie toutes les
+imprimantes.
+Vous pouvez sp�fier plusieurs noms ou jokers,
+en les s�rant avec des virgules.
+.PP
+exemples :
+.IP
+\f(CW$ pykotme --printer apple fichier1.ps fichier2.ps\fR
+.IP
+Ceci va �blir un devis d'impression pour l'utilisateur courant.
+Ce devis indiquera la taille et le co�r l'imprimante apple d'un
+travail d'impression consitant en fichier1.ps et fichier2.ps
+.IP
+\f(CW$ pykotme --printer apple,hplaser <fichier1.ps\fR
+.IP
+Ceci va �blir un devis d'impression pour l'utilisateur courant.
+Ce devis indiquera la taille et le co�un travail provenant de l'entr�standard dans laquelle on redirigerait le fichier fichier1.ps et qui
+serait envoy�sur les imprimantes apple ou hplaser.
+.IP
+\f(CW$ pykotme\fR
+.IP
+Ceci va �blir un devis d'impression pour l'utilisateur courant.
+Ce devis indiquera la taille et le co�un travail provenant de l'entr�standard, et ce pour chaque imprimante.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/pykosd.1
===================================================================
--- pykota/trunk/man/fr/pykosd.1 (revision 2086)
+++ pykota/trunk/man/fr/pykosd.1 (revision 2086)
@@ -0,0 +1,67 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Un afficheur OSD de quota d'impression pour PyKota.
+.PP
+ligne de commande :
+.IP
+pykosd [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version de pykosd et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Fixe la couleur �tiliser pour l'affichage �n
+triplet hexadecimal, par exemple #FF0000 est 100%
+de rouge.
+La valeur par d�ut est 100% de vert (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Fixe la dur�de l'affichage en secondes.
+La valeur par d�ut est de 3 secondes.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Fixe la police de caract�s �tiliser pour
+l'affichage.
+La valeur par d�ut est celle de la librairie
+Python OSD.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Fixe le nombre de fois o�nformation sera affich�
+La valeur par d�ut est 0, qui indique un nombre
+d'affichages infini.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Fixe la dur�en secondes de sommeil entre deux
+affichages. La valeur par d�ut est 180 (3 minutes).
+.PP
+exemples :
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Lance pykosd. L'affichage sera rafra�it toutes les 60 secondes,
+et persistera pendant 3 secondes (la valeur par d�ut) �haque fois.
+Apr�5 it�tions, le programme se terminera.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/dumpykota.1
===================================================================
--- pykota/trunk/man/fr/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/fr/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/pkhint.1
===================================================================
--- pykota/trunk/man/fr/pkhint.1 (revision 2086)
+++ pykota/trunk/man/fr/pkhint.1 (revision 2086)
@@ -0,0 +1,47 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Un outil pour d�cter la meilleure m�ode de d�mpte pour chaque
+imprimante.
+.PP
+ligne de commande :
+.IP
+pkhint [options] [impr1 impr2 impr3 ... imprN] <fichier.conf
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version de pkhint et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.PP
+exemples :
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Va analyser votre syst� d'impression pour d�cter quelle est la
+meilleure m�ode de d�mpte pour chacune des imprimantes d�nies
+dont le nom correspond aux param�es.
+.IP
+Si vous ne passer aucune argument sur la ligne de commande, toutes les
+imprimantes seront analys�.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/pkmail.1
===================================================================
--- pykota/trunk/man/fr/pkmail.1 (revision 2086)
+++ pykota/trunk/man/fr/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/repykota.1
===================================================================
--- pykota/trunk/man/fr/repykota.1 (revision 2086)
+++ pykota/trunk/man/fr/repykota.1 (revision 2086)
@@ -0,0 +1,74 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+G�re des rapports de quotas d'impression.
+.PP
+ligne de commande :
+.IP
+repykota [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version de repykota et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+G�re un rapport sur les quotas des utilisateurs,
+c'est la valeur par d�ut.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+G�re un rapport sur les quotas de groupes plut�ue sur ceux des utilisateurs.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Renvoie les quotas pour cette imprimante seulement.
+En fait p peut contenir des caract�s jokers pour
+s�ctionner certaines imprimantes seulement.
+La valeur par d�ut est *, qui signifie de v�fier
+les quotas sur toutes les imprimantes.
+Vous pouvez pr�ser plusieurs noms ou jokers,
+en les s�rant avec des virgules.
+.PP
+exemples :
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+Ceci va afficher un rapport de quotas pour tous les utilisateurs de
+l'imprimante lp.
+.IP
+\f(CW$ repykota\fR
+.IP
+Ceci va afficher un rapport pour tous les utilisateurs sur toutes les
+imprimantes.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+Ceci va afficher un rapport pour l'utilisateur jerome et tous les
+utilisateurs dont le nom commence par "jo" sur toutes les imprimantes
+dont le nom commence par "laser" ou se termine par "pson".
+.IP
+Si cette commande est lanc�par un utilisateur qui n'est pas un
+administrateur PyKota, les arguments additionnels repr�ntant des noms
+d'utilisateurs ou de groupes sont ignor� et un rapport traitant seulement
+de l'utilisateur ou du groupe courant est g�r�.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/fr/warnpykota.1
===================================================================
--- pykota/trunk/man/fr/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/fr/warnpykota.1 (revision 2086)
@@ -0,0 +1,77 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Pr�ent les utilisateurs ayant atteint leurs limites.
+.PP
+ligne de commande :
+.TP
+warnpykota
+[options]  [noms]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version de warnpykota et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Pr�ent les utilisateur ayant atteint leurs limites,
+c'est la valeur par d�ult.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Pr�ent les utilisateurs dont les groupes auxquels
+ils appartiennent ont atteint leurs limites.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verifie les quotas sur cette imprimante seulement.
+En fait p peut contenir des caract�s jokers pour
+s�ctionner certaines imprimantes seulement.
+La valeur par d�ut est *, qui signifie de v�fier
+les quotas sur toutes les imprimantes.
+Vous pouvez pr�ser plusieurs noms ou jokers,
+en les s�rant avec des virgules.
+.PP
+exemples :
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+Ceci va pr�nir tous les utilisateurs ayant atteint leur limite sur
+l'imprimante lp.
+.IP
+\f(CW$ warnpykota\fR
+.IP
+Ceci va pr�nir tous les utilisateurs ayant atteint leurs limites quelle
+que soit l'imprimanter.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+Ceci va pr�nir tous les membres des groupes dont les noms commencent
+par "dev" et qui ont atteints leurs limites sur toutes les imprimantes
+dont le nom commence par "laserjet".
+.IP
+Si cette commande est lanc�par un utilisateur qui n'est pas un
+administrateur PyKota, les arguments additionnels repr�ntant des noms
+d'utilisateurs ou de groupes sont ignor� et seulement l'utilisateur ou
+le groupe courant est pr�nu.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Merci d'envoyer les rapports de bugs �Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/autopykota.1
===================================================================
--- pykota/trunk/man/es/autopykota.1 (revision 2086)
+++ pykota/trunk/man/es/autopykota.1 (revision 2086)
@@ -0,0 +1,49 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Herramienta que automatiza la creaci�e cuentas de usuario y el
+establecimiento inicial del saldo.
+.PP
+�NO DEBE USAR ESTA HERRAMIENTA SI QUIERE HACER USO DEL L�ITE POR CUOTA
+.IP
+DE P�INA!
+.PP
+uso desde la l�a de comandos:
+.IP
+NO HA DE UTILIZAR ESTA HERRAMIENTA DESDE LA L�EA DE COMANDOS, �ICAMENTE
+COMO PARTE DE UNA �pol�ca externa� EN EL ARCHIVO pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR valor }
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e atopykota y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Establece el saldo inicial para la cuenta del
+usuario al valor �b�. Si el usuario ya existe,
+se deja el saldo actual sin modificar. Si no se
+ha establecido, el valor por defecto es 0
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/edpykota.1
===================================================================
--- pykota/trunk/man/es/edpykota.1 (revision 2086)
+++ pykota/trunk/man/es/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/pkbanner.1
===================================================================
--- pykota/trunk/man/es/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/es/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/pkprinters.1
===================================================================
--- pykota/trunk/man/es/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/es/pkprinters.1 (revision 2086)
@@ -0,0 +1,111 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Un administrador de impresoras para PyKota.
+.PP
+uso desde la l�a de comandos:
+.IP
+pkprinters [opciones] impresora1 impresora2 impresora3 ... impresoraN
+.PP
+opciones
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e pkprinters y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+A� las impresoras si estas no existen en el
+servidor de almacenamiento de las cuotas. Si
+existen, se modifican a menos que se utilice
+\fB\-s\fR|\-\-skipexisting.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Borra las impresoras de la base de datos de
+almacenamiento de las cuotas.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d A� una descripci�extual a la impresora.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Establece el precio por p�na y por trabajo que
+se ha de cobrar. El precio por trabajo es opcional.
+Si se van a establecer ambos, sep�los con una coma.
+Se permiten valores en coma flotante y negativos.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] A� o elimina la(s) impresora(s) del grupo
+de impresoras �pg1�, �pg2�, etc. que han de existir.
+Un grupo de impresi�s similar a una impresora normal,
+con la salvedad de que, normalmente, es desconocido
+por el sistema de impresi�Cree los grupos de
+impresi�e la misma forma que crea las impresoras,
+luego a� otra impresora al grupo con esta opci�La contabilidad se realiza en la impresora y en todos
+los grupos de impresi� los que esta pertenece; la
+comprobaci�e la cuota se realiza en la impresora y
+en todos los grupos de impresi� los que pertenece.
+Si no se utiliza la opci�fB\-\-remove\fR listada abajo, la
+acci�or defecto es a�r las impresoras al grupo de
+impresoras especificado.
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+Lista informaci�obre la(s) impresora(s) y sobre los
+grupos de impresi� los que pertenece.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+En combinaci�on la opci�fB\-\-groups\fR citada arriba,
+elimina las impresoras de los grupos de impresi�specificados.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+En combinaci�on la opci�fB\-\-add\fR citada arriba,
+le dice a pkprinters que no modifique las impresoras
+existentes.
+.IP
+desde impresora1 hasta impresoraN pueden contener comodines, si la opci�fB\-\-add\fR no se ha utilizado.
+.PP
+ejemplos:
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Crear�res impresoras, denominadas hp2100, hp2200 y hp8000.
+Sus precios por p�na se establecer�a 0.05 unidades, y sus
+precios por trabajo se establecer�a 0.1 unidades. Las unidades
+est�en su propia moneda, o cualquier cosa que quiera que
+signifique.
+Todas sus descripciones se establecer�a la cadena �HP Printer�.
+Si alguna de estas impresoras ya existe, ser�odificada, a menos
+que la opci�fB\-s\fR|\-\-skipexisting se haya empleado.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+Esto borrar�ompletamente todas las impresoras y sus cuotas
+asociadas, as�omo su historial de trabajos. �UTIL�ELA CON
+CUIDADO!
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+Esto a�r�odas las impresoras cuyos nombres coincidan con
+�hp*� al grupo de impresoras �Laser� y �HP�, que DEBEN existir.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+Esto eliminar�a impresora �hp2200� del grupo de impresoras �LexMark�.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/pykotme.1
===================================================================
--- pykota/trunk/man/es/pykotme.1 (revision 2086)
+++ pykota/trunk/man/es/pykotme.1 (revision 2086)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Muestra las cuotas de impresi� los usuarios.
+.PP
+uso desde la l�a de comandos:
+.TP
+pykotme
+[opciones]  [archivos]
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�ykotme y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Muestra la cuota para esta impresora �mente.
+Actualmente �p� puede utilizar caracteres comod�para seleccionar s�algunas impresoras. El valor
+por defecto es *, que significa toas las impresoras.
+Puede especificar varios nombres o comodines,
+separ�olos por comas.
+.PP
+ejemplos
+.IP
+\f(CW$ pykotme --printer apple file1.ps file2.ps\fR
+.IP
+Esto mostrar�na cuota de impresi�ara el usuario actual. La cuota
+mostrar�l precio y el tama�el trabajo consistente en �file1.ps�
+y �file2.ps� que se enviar�a la impresora �apple�.
+.IP
+\f(CW$ pykotme --printer apple,hplaser <file1.ps\fR
+.IP
+Esto mostrar�na cuota de impresi�ara el usuario actual. La cuota
+mostrar�l precio y el tama�el trabajo consistente en �file1.ps�
+le� desde la entrada est�ar, que ser�nviado a la impresora
+�apple� o �hplaser�.
+.IP
+\f(CW$ pykotme\fR
+.IP
+Esto mostrar�na cuota para el trabajo consistente en los datos de
+la entrada est�ar. La cuota listar�l tama�el trabajo y el
+coste de impresi�el trabajo en cada impresora.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/pykosd.1
===================================================================
--- pykota/trunk/man/es/pykosd.1 (revision 2086)
+++ pykota/trunk/man/es/pykosd.1 (revision 2086)
@@ -0,0 +1,67 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Un monitor de cuotas OSD para PyKota.
+.PP
+uso desde la l�a de comandos:
+.IP
+pykosd [opciones]
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e pykosd y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Establece el color que se utilizar�n el
+visualizador como un triplete hexadecimal, por
+ejemplo #FF0000 es un rojo 100%.
+El valor por defecto es 100% verde (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Establece la duraci�el visualizador en segundos.
+Por defecto son 3 segundos.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Establece el tipo de letra que se utilizar�n
+el visualizador.
+Por defecto se utilizar�a opci�or defecto
+de la librer�Python OSD.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Establece el n� de veces que la informaci�e mostrar�El valor por defecto es 0, que significa un
+bucle sin fin.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Establece el tiempo de espera entre dos mensajes
+en segundos. El valor por defecto son 180 segundos
+(3 minutos).
+.PP
+ejemplos:
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Ejecutar�ykosd. El visualizador se actualizar�ada 60 segundos,
+y se mostrar� segundos (valor por defecto) cada vez. Despu�de
+cinco iteraciones, el programa finalizar�.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/dumpykota.1
===================================================================
--- pykota/trunk/man/es/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/es/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/pkhint.1
===================================================================
--- pykota/trunk/man/es/pkhint.1 (revision 2086)
+++ pykota/trunk/man/es/pkhint.1 (revision 2086)
@@ -0,0 +1,47 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+Herramienta que aconseja sobre qu��do de contabilidad es el mejor
+para cada impresora.
+.PP
+uso desde la l�a de comandos:
+.IP
+pkhint [opciones] [impresora1 impresora2 impresora3 ... impresoraN] <archivo.conf
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e pkhint y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.PP
+ejemplos:
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Analizar�u sistema de impresi�ara comprobar que sistema
+de contabilizaci�s el mejor para cada una de las impresoras
+definidas y cuyo nombre coincida con uno de los par�tros.
+.IP
+Si no pasa ning�r�tro en la l�a de comandos, se analizar�todas las impresoras.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/pkmail.1
===================================================================
--- pykota/trunk/man/es/pkmail.1 (revision 2086)
+++ pykota/trunk/man/es/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/repykota.1
===================================================================
--- pykota/trunk/man/es/repykota.1 (revision 2086)
+++ pykota/trunk/man/es/repykota.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Genera informes sobre las cuotas de impresi�.PP
+uso desde la l�a de comandos:
+.IP
+repykota [opciones]
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e repykota y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Genera un informe sobre las cuotas de los
+usuarios, este es el comportamiento por defecto.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Genera un informe sobre las cuotas de los grupos
+en lugar de los usuarios.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Informa de las cuotas en esta impresora �mente
+Actualmente �p� puede utilizar caracteres comod�para seleccionar s�algunas impresoras. El valor
+por defecto es *, que significa todas las impresoras.
+Puede especificar varios nombres o comodines,
+separ�olos por comas.
+.PP
+ejemplos:
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+Esto imprimir�l estado de la cuota para todos los usuarios que utilizan
+la impresora �lp�.
+.IP
+\f(CW$ repykota\fR
+.IP
+Esto imprimir�l estado de la cuota para todos los usuarios en todas
+las impresoras.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+Esto imprimir�l estado de la cuota para el usuario jerome y
+todos los usuarios cuyos nombres comiencen por �jo� en todas
+las impresoras cuyos nombres comiencen por �laser� o terminen   con �pson�.
+.IP
+Si se ejecuta por un usuario que no es un administrador de PyKota,
+los par�tros adicionales que representen nombres de usuarios o grupos
+son ignorados, inform�ose �mente del usuario/grupo actual.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/es/warnpykota.1
===================================================================
--- pykota/trunk/man/es/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/es/warnpykota.1 (revision 2086)
@@ -0,0 +1,75 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Env�correos electr�os a los usuarios que han sobrepasado su cuota
+.PP
+uso desde la l�a de comandos:
+.TP
+warnpykota
+[opciones]  [nombres]
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e warnpykota y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Advierte a los usuarios que han sobrepasado sus
+cuotas de impresi�este es el valor por defecto.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Advierte a los usuarios cuyas cuotas de grupo se
+hayan sobrepasado.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verifica las cuotas en esta impresora �mente.
+Actualmente �p� puede utilizar caracteres comod�para seleccionar solamente algunas impresoras.
+El valor por defecto es *, que significa todas
+las impresoras.
+Puede especificar varios nombres o comodines,
+separ�olos por comas.
+.PP
+ejemplos:
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+Esto avisar� todos los usuarios de la impresora �lp� que hayan
+sobrepasado sus cuotas de impresi�.IP
+\f(CW$ warnpykota\fR
+.IP
+Esto avisar� todos los usuarios que hayan sobrepasado su cuota
+de impresi�n cualquier impresora.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+Esto avisar� todos los grupos de usuarios cuyos nombres comiencen con
+�dev� y que hayan sobrepasado sus cuotas de impresi�n cualquier
+impresora cuyo nombre comience con �laserjet�
+.IP
+Si se ejecuta por un usuario que no es un administrador de PyKota,
+los par�tros adicionales que representen nombres de usuarios o grupos
+son ignorados, inform�ose �mente al usuario/grupo actual.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Por favor, env�los errores por correo electr�o a: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pykosd.1
===================================================================
--- pykota/trunk/man/pykosd.1 (revision 1942)
+++ pykota/trunk/man/pykosd.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PYKOSD "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykosd \- manual page for pykosd 1.21alpha6_unofficial
+pykosd \- manual page for pykosd 1.21alpha27_unofficial
 .SH DESCRIPTION
-pykosd v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 An OSD quota monitor for PyKota.
 .PP
@@ -59,5 +59,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/autopykota.1
===================================================================
--- pykota/trunk/man/th/autopykota.1 (revision 2086)
+++ pykota/trunk/man/th/autopykota.1 (revision 2086)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to automate user account creation and initial balance setting.
+.PP
+THIS TOOL MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY PAGE QUOTA !
+.PP
+command line usage :
+.IP
+THIS TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART
+OF AN external policy IN pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR value }
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints autopykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Sets the user's account initial balance value to b.
+If the user already exists, actual balance is left
+unmodified. If unset, the default value is 0.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/edpykota.1
===================================================================
--- pykota/trunk/man/th/edpykota.1 (revision 2086)
+++ pykota/trunk/man/th/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/pkbanner.1
===================================================================
--- pykota/trunk/man/th/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/th/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/pkprinters.1
===================================================================
--- pykota/trunk/man/th/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/th/pkprinters.1 (revision 2086)
@@ -0,0 +1,107 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Printers Manager for PyKota.
+.PP
+command line usage :
+.IP
+pkprinters [options] printer1 printer2 printer3 ... printerN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkprinters's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds printers if they don't exist on the Quota
+Storage Server. If they exist, they are modified
+unless \fB\-s\fR|\-\-skipexisting is also used.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes printers from the quota storage.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge.
+Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point and negative values are allowed.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
+groups pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+If the \fB\-\-remove\fR option below is not used, the
+default action is to add printers to the specified
+printer groups.
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+List informations about the printer(s) and the
+printers groups it is a member of.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In combination with the \fB\-\-groups\fR option above,
+remove printers from the specified printers groups.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In combination with the \fB\-\-add\fR option above, tells
+pkprinters to not modify existing printers.
+.IP
+printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
+is not set.
+.PP
+examples :
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Will create three printers named hp2100, hp2200 and hp8000.
+Their price per page will be set at 0.05 unit, and their price
+per job will be set at 0.1 unit. Units are in your own currency,
+or whatever you want them to mean.
+All of their descriptions will be set to the string "HP Printer".
+If any of these printers already exists, it will also be modified
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+This will completely delete all printers and associated quota information,
+as well as their job history. USE WITH CARE !
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+This will put all printers which name matches "hp*" into printers groups
+Laser and HP, which MUST already exist.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+This will remove the hp2200 printer from the LexMark printer group.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/pykotme.1
===================================================================
--- pykota/trunk/man/th/pykotme.1 (revision 2086)
+++ pykota/trunk/man/th/pykotme.1 (revision 2086)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Gives print quotes to users.
+.PP
+command line usage :
+.TP
+pykotme
+[options]  [files]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykotme's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Gives a quote for this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ pykotme --printer apple file1.ps file2.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps and file2.ps
+which would be sent to the apple printer.
+.IP
+\f(CW$ pykotme --printer apple,hplaser <file1.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps as read from
+standard input, which would be sent to the apple or hplaser
+printer.
+.IP
+\f(CW$ pykotme\fR
+.IP
+This will give a quote for a job consisting of what is on standard
+input. The quote will list the job size, and the price the job
+would cost on each printer.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/pykosd.1
===================================================================
--- pykota/trunk/man/th/pykosd.1 (revision 2086)
+++ pykota/trunk/man/th/pykosd.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+An OSD quota monitor for PyKota.
+.PP
+command line usage :
+.IP
+pykosd [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykosd's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Sets the color to use for display as an hexadecimal
+triplet, for example #FF0000 is 100% red.
+Defaults to 100% green (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Sets the duration of the display in seconds.
+Defaults to 3 seconds.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Sets the font to use for display.
+Defaults to the Python OSD library's default.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Sets the number of times the info will be displayed.
+Defaults to 0, which means loop forever.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Sets the sleeping duration between two displays
+in seconds. Defaults to 180 seconds (3 minutes).
+.PP
+examples :
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Will launch pykosd. Display will be refreshed every 60 seconds,
+and will last for 3 seconds (the default) each time. After five
+iterations, the program will exit.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/dumpykota.1
===================================================================
--- pykota/trunk/man/th/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/th/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/pkhint.1
===================================================================
--- pykota/trunk/man/th/pkhint.1 (revision 2086)
+++ pykota/trunk/man/th/pkhint.1 (revision 2086)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to give hints on what accounting method is best for each printer.
+.PP
+command line usage :
+.IP
+pkhint [options] [printer1 printer2 printer3 ... printerN] <file.conf
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkhint's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.PP
+examples :
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Will analyze your printing system to test which accounter
+is the best for each of the defined printer which
+name matches one of the parameters.
+.IP
+If you don't pass any argument on the command line, all
+printers will be analyzed.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/pkmail.1
===================================================================
--- pykota/trunk/man/th/pkmail.1 (revision 2086)
+++ pykota/trunk/man/th/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/repykota.1
===================================================================
--- pykota/trunk/man/th/repykota.1 (revision 2086)
+++ pykota/trunk/man/th/repykota.1 (revision 2086)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates print quota reports.
+.PP
+command line usage :
+.IP
+repykota [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints repykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Generates a report on users quota, this is
+the default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Generates a report on group quota instead of users.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Report quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+This will print the quota status for all users who use the lp printer.
+.IP
+\f(CW$ repykota\fR
+.IP
+This will print the quota status for all users on all printers.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+This will print the quota status for user jerome and all users
+whose name begins with "jo" on all printers which name begins
+with "laser" or ends with "pson".
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/th/warnpykota.1
===================================================================
--- pykota/trunk/man/th/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/th/warnpykota.1 (revision 2086)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Sends mail to users over print quota.
+.PP
+command line usage :
+.TP
+warnpykota
+[options]  [names]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints warnpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Warns users over their print quota, this is the
+default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Warns users whose groups quota are over limit.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verify quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+This will warn all users of the lp printer who have exceeded their
+print quota.
+.IP
+\f(CW$ warnpykota\fR
+.TP
+This will warn all users
+who have exceeded their print quota on
+.IP
+any printer.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+This will warn all users of groups which names begins with "dev" and
+who have exceeded their print quota on any printer which name begins
+with "laserjet"
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/pkmail.1
===================================================================
--- pykota/trunk/man/pkmail.1 (revision 1952)
+++ pykota/trunk/man/pkmail.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH PKMAIL "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkmail \- manual page for pkmail 1.21alpha7_unofficial
+pkmail \- manual page for pkmail 1.21alpha27_unofficial
 .SH DESCRIPTION
-pkmail v1.21alpha7_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Email gateway for PyKota.
@@ -59,5 +59,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/autopykota.1
===================================================================
--- pykota/trunk/man/it/autopykota.1 (revision 2086)
+++ pykota/trunk/man/it/autopykota.1 (revision 2086)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH AUTOPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+autopykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to automate user account creation and initial balance setting.
+.PP
+THIS TOOL MUST NOT BE USED IF YOU WANT TO LIMIT YOUR USERS BY PAGE QUOTA !
+.PP
+command line usage :
+.IP
+THIS TOOL MUST NOT BE USED FROM THE COMMAND LINE BUT ONLY AS PART
+OF AN external policy IN pykota.conf
+.IP
+autopykota { \fB\-i\fR | \fB\-\-initbalance\fR value }
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints autopykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-i\fR | \fB\-\-initbalance\fR b Sets the user's account initial balance value to b.
+If the user already exists, actual balance is left
+unmodified. If unset, the default value is 0.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/edpykota.1
===================================================================
--- pykota/trunk/man/it/edpykota.1 (revision 2086)
+++ pykota/trunk/man/it/edpykota.1 (revision 2086)
@@ -0,0 +1,231 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Print Quota editor for PyKota.
+.PP
+command line usage :
+.IP
+edpykota [options] user1 user2 ... userN
+.IP
+edpykota [options] group1 group2 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints edpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds users and/or printers if they don't
+exist on the Quota Storage Server.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users/groups from the quota storage.
+Printers are never deleted.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge
+for a particular printer. Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edit users print quotas, this is the default.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edit quotas on printer p only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Adds the printer(s) to the printer groups
+pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups print quotas instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to set
+print quotas
+.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+Doesn't set a quota but only does accounting.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Resets the actual page counter for the user
+or group to zero on the specified printers.
+The life time page counter is kept unchanged.
+.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Resets the actual and life time page counters
+for the user or group to zero on the specified
+printers. This is a shortcut for '\-\-used 0'.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Choose if the user/group is limited in printing
+by its account balance or by its page quota.
+The default value is 'quota'. Allowed values
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
+are not yet implemented.
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Sets the user's account balance to b.
+Account balance may be increase or decreased
+if b is prefixed with + or \-.
+WARNING : when decreasing account balance,
+the total paid so far by the user is decreased
+too.
+Groups don't have a real balance, but the
+sum of their users' account balance.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Sets the quota soft limit to sl pages.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
+.IP
+user1 through userN and group1 through groupN can use wildcards
+if the \fB\-\-add\fR option is not set.
+.PP
+examples :
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+This will add users john, paul, george and ringo to the quota
+database, and set their print quotas to the same values than user
+jerome. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+This will set jerome's print quota on the lp printer to a soft limit
+of 50 pages, and a hard limit of 60 pages. If either user jerome or
+printer lp doesn't exist on the Quota Storage Server then nothing is done.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Same as above, but if either user jerome or printer lp doesn't exist
+on the Quota Storage Server they are automatically added. Also
+user jerome is put into the groups "coders" and "it" which must
+already exist in the Quota Storage.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+This will set print quota soft limit to 500 pages and hard limit
+to 550 pages for groups financial and support on all printers.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+This will reset jerome's page counter to zero on all printers, as
+well as every user whose name begins with 'jo'.
+Their life time page counter on each printer will be kept unchanged.
+You can also reset the life time page counters by using the
+\fB\-\-hardreset\fR | \fB\-R\fR command line option.
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+This will tell PyKota to not limit jerome when printing on the
+hpcolor printer. All his jobs will be allowed on this printer, but
+accounting of the pages he prints will still be kept.
+Print Quotas for jerome on other printers are unchanged.
+.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+This will increase jerome's account balance by 10.0 (in your
+own currency). You can decrease the account balance with a
+dash prefix, and set it to a fixed amount with no prefix.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the Quota Storage
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+This will set the page price for printer lp to 0.1. Job price
+will not be changed.
+.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+This will put printers hplj1 and hplj2 in printers groups Laser and HP.
+When printing either on hplj1 or hplj2, print quota will also be
+checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/pkbanner.1
===================================================================
--- pykota/trunk/man/it/pkbanner.1 (revision 2086)
+++ pykota/trunk/man/it/pkbanner.1 (revision 2086)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKBANNER "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkbanner \- page de manuel de pkbanner 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkbanner v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates banners.
+.PP
+command line usage :
+.TP
+pkbanner
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkbanner'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 banner'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\-s\fR | \fB\-\-savetoner\fR s
+Sets the text luminosity factor to s%. This can be
+used to save toner. The default value is 0, which
+means that no toner saving will be done.
+.TP
+\fB\-u\fR | \fB\-\-url\fR u
+Uses u as an url to be written at the bottom of
+the banner page. The default url is :
+http://www.librelogiciel.com/software/
+.PP
+examples :
+.IP
+Using pkbanner directly from the command line is not recommended,
+excepted for testing purposes. You should use pkbanner in the
+\&'startingbanner' or 'endingbanner' directives in pykota.conf
+.IP
+startingbanner: /usr/bin/pkbanner \fB\-\-logo=\fR"" \fB\-\-savetoner\fR=\fI75\fR
+.IP
+With such a setting in pykota.conf, all print jobs will be
+prefixed with an A4 banner with no logo, and text luminosity will
+be increased by 75%. The PostScript output will be directly sent
+to your printer.
+.IP
+You'll find more examples in the sample configuration file included
+in PyKota.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/pkprinters.1
===================================================================
--- pykota/trunk/man/it/pkprinters.1 (revision 2086)
+++ pykota/trunk/man/it/pkprinters.1 (revision 2086)
@@ -0,0 +1,107 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKPRINTERS "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkprinters v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A Printers Manager for PyKota.
+.PP
+command line usage :
+.IP
+pkprinters [options] printer1 printer2 printer3 ... printerN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkprinters's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Adds printers if they don't exist on the Quota
+Storage Server. If they exist, they are modified
+unless \fB\-s\fR|\-\-skipexisting is also used.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes printers from the quota storage.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Sets the price per page and per job to charge.
+Job price is optional.
+If both are to be set, separate them with a comma.
+Floating point and negative values are allowed.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR pg1[,pg2...] Adds or Remove the printer(s) to the printer
+groups pg1, pg2, etc... which must already exist.
+A printer group is just like a normal printer,
+only that it is usually unknown from the printing
+system. Create printer groups exactly the same
+way that you create printers, then add other
+printers to them with this option.
+Accounting is done on a printer and on all
+the printer groups it belongs to, quota checking
+is done on a printer and on all the printer groups
+it belongs to.
+If the \fB\-\-remove\fR option below is not used, the
+default action is to add printers to the specified
+printer groups.
+.TP
+\fB\-l\fR | \fB\-\-list\fR
+List informations about the printer(s) and the
+printers groups it is a member of.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In combination with the \fB\-\-groups\fR option above,
+remove printers from the specified printers groups.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In combination with the \fB\-\-add\fR option above, tells
+pkprinters to not modify existing printers.
+.IP
+printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
+is not set.
+.PP
+examples :
+.IP
+\f(CW$ pkprinters --add -D "HP Printer" --charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+.IP
+Will create three printers named hp2100, hp2200 and hp8000.
+Their price per page will be set at 0.05 unit, and their price
+per job will be set at 0.1 unit. Units are in your own currency,
+or whatever you want them to mean.
+All of their descriptions will be set to the string "HP Printer".
+If any of these printers already exists, it will also be modified
+unless the \fB\-s\fR|\-\-skipexisting command line option is also used.
+.IP
+\f(CW$ pkprinters --delete "*"\fR
+.IP
+This will completely delete all printers and associated quota information,
+as well as their job history. USE WITH CARE !
+.IP
+\f(CW$ pkprinters --groups Laser,HP "hp*"\fR
+.IP
+This will put all printers which name matches "hp*" into printers groups
+Laser and HP, which MUST already exist.
+.IP
+\f(CW$ pkprinters --groups LexMark --remove hp2200\fR
+.IP
+This will remove the hp2200 printer from the LexMark printer group.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/pykotme.1
===================================================================
--- pykota/trunk/man/it/pykotme.1 (revision 2086)
+++ pykota/trunk/man/it/pykotme.1 (revision 2086)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOTME "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykotme v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Gives print quotes to users.
+.PP
+command line usage :
+.TP
+pykotme
+[options]  [files]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykotme's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Gives a quote for this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ pykotme --printer apple file1.ps file2.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps and file2.ps
+which would be sent to the apple printer.
+.IP
+\f(CW$ pykotme --printer apple,hplaser <file1.ps\fR
+.IP
+This will give a print quote to the current user. The quote will show
+the price and size of a job consisting in file1.ps as read from
+standard input, which would be sent to the apple or hplaser
+printer.
+.IP
+\f(CW$ pykotme\fR
+.IP
+This will give a quote for a job consisting of what is on standard
+input. The quote will list the job size, and the price the job
+would cost on each printer.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/pykosd.1
===================================================================
--- pykota/trunk/man/it/pykosd.1 (revision 2086)
+++ pykota/trunk/man/it/pykosd.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PYKOSD "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.21alpha27_unofficial
+.SH DESCRIPTION
+pykosd v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+An OSD quota monitor for PyKota.
+.PP
+command line usage :
+.IP
+pykosd [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pykosd's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-c\fR | \fB\-\-color\fR #rrggbb Sets the color to use for display as an hexadecimal
+triplet, for example #FF0000 is 100% red.
+Defaults to 100% green (#00FF00).
+.TP
+\fB\-d\fR | \fB\-\-duration\fR d
+Sets the duration of the display in seconds.
+Defaults to 3 seconds.
+.TP
+\fB\-f\fR | \fB\-\-font\fR f
+Sets the font to use for display.
+Defaults to the Python OSD library's default.
+.TP
+\fB\-l\fR | \fB\-\-loop\fR n
+Sets the number of times the info will be displayed.
+Defaults to 0, which means loop forever.
+.TP
+\fB\-s\fR | \fB\-\-sleep\fR s
+Sets the sleeping duration between two displays
+in seconds. Defaults to 180 seconds (3 minutes).
+.PP
+examples :
+.IP
+\f(CW$ pykosd -s 60 --loop 5\fR
+.IP
+Will launch pykosd. Display will be refreshed every 60 seconds,
+and will last for 3 seconds (the default) each time. After five
+iterations, the program will exit.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/dumpykota.1
===================================================================
--- pykota/trunk/man/it/dumpykota.1 (revision 2086)
+++ pykota/trunk/man/it/dumpykota.1 (revision 2086)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options] [filterexpr]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints dumpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Dumps 'type' datas. Allowed types are :
+.IP
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
+.IP
+NB : the \fB\-d\fR | \fB\-\-data\fR command line option
+is MANDATORY.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Dumps datas in the 'fmt' format. When not specified,
+the format is to dump datas in the csv format (comma
+separated values). All data dumped is between double
+quotes. Allowed formats are :
+.IP
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+All datas will be dumped to the file instead of
+to the standard output. The special '\-' filename
+is the default value and means stdout.
+WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
+.PP
+Examples :
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+This dumps the history in a comma separated values file, for possible
+use in a spreadsheet.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/pkhint.1
===================================================================
--- pykota/trunk/man/it/pkhint.1 (revision 2086)
+++ pykota/trunk/man/it/pkhint.1 (revision 2086)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKHINT "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkhint v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+A tool to give hints on what accounting method is best for each printer.
+.PP
+command line usage :
+.IP
+pkhint [options] [printer1 printer2 printer3 ... printerN] <file.conf
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkhint's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.PP
+examples :
+.IP
+\f(CW$ pkhint "hp*" printer103 </etc/cups/printers.conf\fR
+.IP
+Will analyze your printing system to test which accounter
+is the best for each of the defined printer which
+name matches one of the parameters.
+.IP
+If you don't pass any argument on the command line, all
+printers will be analyzed.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/pkmail.1
===================================================================
--- pykota/trunk/man/it/pkmail.1 (revision 2086)
+++ pykota/trunk/man/it/pkmail.1 (revision 2086)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKMAIL "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkmail \- page de manuel de pkmail 1.21alpha27_unofficial
+.SH DESCRIPTION
+pkmail v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Email gateway for PyKota.
+.PP
+command line usage :
+.TP
+pkmail
+[options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkmail's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.IP
+This command is meant to be used from your mail server's aliases file,
+as a pipe. It will then accept commands send to it in email messages,
+and will send the answer to the command's originator.
+.IP
+To use this command, create an email alias in /etc/aliases with
+the following format :
+.IP
+pykotacmd: "|/usr/bin/pkmail"
+.IP
+Then run the 'newaliases' command to regenerate the aliases database.
+.IP
+You can now send commands by email to 'pykotacmd@yourdomain.com', with
+the command in the subject.
+.IP
+List of supported commands :
+.IP
+report [username]
+.IP
+NB : For pkmail to work correctly, you may have to put the 'mail'
+system user in the 'lpadmin' system group to ensure this user can
+read the /etc/pykota/pykotadmin.conf file, and restart your
+mail server (e.g. /etc/init.d/exim restart). It is strongly advised
+that you think at least twice before doing this though.
+.IP
+Use at your own risk !
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/repykota.1
===================================================================
--- pykota/trunk/man/it/repykota.1 (revision 2086)
+++ pykota/trunk/man/it/repykota.1 (revision 2086)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH REPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+repykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Generates print quota reports.
+.PP
+command line usage :
+.IP
+repykota [options]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints repykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Generates a report on users quota, this is
+the default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Generates a report on group quota instead of users.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Report quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ repykota --printer lp\fR
+.IP
+This will print the quota status for all users who use the lp printer.
+.IP
+\f(CW$ repykota\fR
+.IP
+This will print the quota status for all users on all printers.
+.IP
+\f(CW$ repykota --printer "laser*,*pson" jerome "jo*"\fR
+.IP
+This will print the quota status for user jerome and all users
+whose name begins with "jo" on all printers which name begins
+with "laser" or ends with "pson".
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/it/warnpykota.1
===================================================================
--- pykota/trunk/man/it/warnpykota.1 (revision 2086)
+++ pykota/trunk/man/it/warnpykota.1 (revision 2086)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH WARNPYKOTA "1" "f�ier 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.21alpha27_unofficial
+.SH DESCRIPTION
+warnpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
+.PP
+Sends mail to users over print quota.
+.PP
+command line usage :
+.TP
+warnpykota
+[options]  [names]
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints warnpykota's version number then exits.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Prints this message then exits.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Warns users over their print quota, this is the
+default.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Warns users whose groups quota are over limit.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Verify quotas on this printer only. Actually p can
+use wildcards characters to select only
+some printers. The default value is *, meaning
+all printers.
+You can specify several names or wildcards,
+by separating them with commas.
+.PP
+examples :
+.IP
+\f(CW$ warnpykota --printer lp\fR
+.IP
+This will warn all users of the lp printer who have exceeded their
+print quota.
+.IP
+\f(CW$ warnpykota\fR
+.TP
+This will warn all users
+who have exceeded their print quota on
+.IP
+any printer.
+.IP
+\f(CW$ warnpykota --groups --printer "laserjet*" "dev*"\fR
+.IP
+This will warn all users of groups which names begins with "dev" and
+who have exceeded their print quota on any printer which name begins
+with "laserjet"
+.IP
+If launched by an user who is not a PyKota administrator, additionnal
+arguments representing users or groups names are ignored, and only the
+current user/group is reported.
+.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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/dumpykota.1
===================================================================
--- pykota/trunk/man/dumpykota.1 (revision 1942)
+++ pykota/trunk/man/dumpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH DUMPYKOTA "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH DUMPYKOTA "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-dumpykota \- manual page for dumpykota 1.21alpha6_unofficial
+dumpykota \- manual page for dumpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-dumpykota v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+dumpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 .PP
 Dumps PyKota database's content.
@@ -10,5 +10,5 @@
 command line usage :
 .IP
-dumpykota [options]
+dumpykota [options] [filterexpr]
 .PP
 options :
@@ -23,13 +23,13 @@
 Dumps 'type' datas. Allowed types are :
 .IP
-- history : dumps the jobs history.
-- users : dumps users.
-- groups : dumps user groups.
-- printers : dump printers.
-- upquotas : dump user quotas.
-- gpquotas : dump user groups quotas.
-- payments : dumps user payments.
-- pmembers : dumps printer groups members.
-- umembers : dumps user groups members.
+\- history : dumps the jobs history.
+\- users : dumps users.
+\- groups : dumps user groups.
+\- printers : dump printers.
+\- upquotas : dump user quotas.
+\- gpquotas : dump user groups quotas.
+\- payments : dumps user payments.
+\- pmembers : dumps printer groups members.
+\- umembers : dumps user groups members.
 .IP
 NB : the \fB\-d\fR | \fB\-\-data\fR command line option
@@ -42,14 +42,42 @@
 quotes. Allowed formats are :
 .IP
-- csv : separate datas with commas
-- ssv : separate datas with semicolons
-- tsv : separate datas with tabs
-- xml : dump data as XML
+\- csv : separate datas with commas
+\- ssv : separate datas with semicolons
+\- tsv : separate datas with tabs
+\- xml : dump data as XML
+\- cups : dump datas in CUPS' page_log format :
+.IP
+ONLY AVAILABLE WITH \fB\-\-data\fR history
 .TP
 \fB\-o\fR | \fB\-\-output\fR fname
 All datas will be dumped to the file instead of
-to the standard output. The special '-' filename
+to the standard output. The special '\-' filename
 is the default value and means stdout.
 WARNING : existing files are truncated !
+.IP
+Use the filter expressions to extract only parts of the
+datas. Allowed filters are of the form :
+.IP
+key=value
+.IP
+Allowed keys for now are :
+.TP
+username
+User's name
+.TP
+groupname
+Users group's name
+.TP
+printername
+Printer's name
+.TP
+pgroupname
+Printers group's name
+.IP
+Contrary to other PyKota management tools, wildcard characters are not
+expanded, so you can't use them.
+.IP
+NB : not all keys are allowed for each data type, so the result may be
+empty if you use a key not available for a particular data type.
 .PP
 Examples :
@@ -63,4 +91,8 @@
 .IP
 Dumps all users datas to the users.xml file.
+.IP
+\f(CW$ dumpykota --data history printername=HP2100 username=jerome\fR
+.IP
+Dumps the job history for user jerome on printer HP2100 only.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -76,5 +108,5 @@
 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
 .PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
Index: pykota/trunk/man/genman.sh
===================================================================
--- pykota/trunk/man/genman.sh (revision 2028)
+++ pykota/trunk/man/genman.sh (revision 2086)
@@ -17,10 +17,16 @@
     echo $prog ;
     help2man --no-info --section=1 --manual "User Commands" --source="C@LL - Conseil Internet & Logiciels Libres" --output=$prog.1 $prog ; 
-    for loc in *_* ; do
-        echo "  $loc" ;
-        cd $loc ;
-        help2man --no-info --locale=$loc --section=1 --manual "User Commands" --source="C@LL - Conseil Internet & Logiciels Libres" --output=$prog.1 $prog ; 
-        cd .. ;
-    done ;
+    cd ../po ;
+    for dir in * ; do 
+        if [ -d $dir ] ; then
+            if [ -e $dir/pykota.po ] ; then
+                echo "  $dir" ;
+                cd ../man/$dir ;
+                help2man --no-info --locale=$dir --section=1 --manual "User Commands" --source="C@LL - Conseil Internet & Logiciels Libres" --output=$prog.1 $prog ; 
+                cd .. ;
+            fi ;    
+        fi ;     
+    done
+    cd ../man ;
     echo ;
 done
