Index: /pykota/trunk/man/edpykota.1
===================================================================
--- /pykota/trunk/man/edpykota.1 (revision 1784)
+++ /pykota/trunk/man/edpykota.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH EDPYKOTA "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.20alpha21_unofficial
+edpykota \- manual page for edpykota 1.20alpha25_unofficial
 .SH DESCRIPTION
-edpykota v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+edpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 A Print Quota editor for PyKota.
 .PP
Index: /pykota/trunk/man/pt/autopykota.1
===================================================================
--- /pykota/trunk/man/pt/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/pt/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/pt/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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 1827)
+++ /pykota/trunk/man/pt/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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 1827)
+++ /pykota/trunk/man/pt/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/pt/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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 1827)
+++ /pykota/trunk/man/pt/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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 1827)
+++ /pykota/trunk/man/pt/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/repykota.1
===================================================================
--- /pykota/trunk/man/pt/repykota.1 (revision 1827)
+++ /pykota/trunk/man/pt/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/pt/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/be/autopykota.1
===================================================================
--- /pykota/trunk/man/be/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/be/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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/be/edpykota.1
===================================================================
--- /pykota/trunk/man/be/edpykota.1 (revision 1827)
+++ /pykota/trunk/man/be/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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/be/pkprinters.1
===================================================================
--- /pykota/trunk/man/be/pkprinters.1 (revision 1827)
+++ /pykota/trunk/man/be/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/be/pykotme.1
===================================================================
--- /pykota/trunk/man/be/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/be/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/be/pykosd.1
===================================================================
--- /pykota/trunk/man/be/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/be/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/be/dumpykota.1
===================================================================
--- /pykota/trunk/man/be/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/be/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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/be/pkhint.1
===================================================================
--- /pykota/trunk/man/be/pkhint.1 (revision 1827)
+++ /pykota/trunk/man/be/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/be/repykota.1
===================================================================
--- /pykota/trunk/man/be/repykota.1 (revision 1827)
+++ /pykota/trunk/man/be/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/be/warnpykota.1
===================================================================
--- /pykota/trunk/man/be/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/be/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/pykotme.1
===================================================================
--- /pykota/trunk/man/pykotme.1 (revision 1784)
+++ /pykota/trunk/man/pykotme.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH PYKOTME "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykotme \- manual page for pykotme 1.20alpha21_unofficial
+pykotme \- manual page for pykotme 1.20alpha25_unofficial
 .SH DESCRIPTION
-pykotme v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykotme v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 .PP
 Gives print quotes to users.
Index: /pykota/trunk/man/de/autopykota.1
===================================================================
--- /pykota/trunk/man/de/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/de/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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/de/edpykota.1
===================================================================
--- /pykota/trunk/man/de/edpykota.1 (revision 1827)
+++ /pykota/trunk/man/de/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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 1827)
+++ /pykota/trunk/man/de/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/de/pykotme.1
===================================================================
--- /pykota/trunk/man/de/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/de/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/de/pykosd.1
===================================================================
--- /pykota/trunk/man/de/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/de/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/de/dumpykota.1
===================================================================
--- /pykota/trunk/man/de/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/de/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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 1827)
+++ /pykota/trunk/man/de/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/de/repykota.1
===================================================================
--- /pykota/trunk/man/de/repykota.1 (revision 1827)
+++ /pykota/trunk/man/de/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/de/warnpykota.1
===================================================================
--- /pykota/trunk/man/de/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/de/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/sv/autopykota.1
===================================================================
--- /pykota/trunk/man/sv/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/sv/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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/sv/edpykota.1
===================================================================
--- /pykota/trunk/man/sv/edpykota.1 (revision 1827)
+++ /pykota/trunk/man/sv/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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/sv/pkprinters.1
===================================================================
--- /pykota/trunk/man/sv/pkprinters.1 (revision 1827)
+++ /pykota/trunk/man/sv/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/sv/pykotme.1
===================================================================
--- /pykota/trunk/man/sv/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/sv/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/sv/pykosd.1
===================================================================
--- /pykota/trunk/man/sv/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/sv/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/sv/dumpykota.1
===================================================================
--- /pykota/trunk/man/sv/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/sv/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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/sv/pkhint.1
===================================================================
--- /pykota/trunk/man/sv/pkhint.1 (revision 1827)
+++ /pykota/trunk/man/sv/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/sv/repykota.1
===================================================================
--- /pykota/trunk/man/sv/repykota.1 (revision 1827)
+++ /pykota/trunk/man/sv/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/sv/warnpykota.1
===================================================================
--- /pykota/trunk/man/sv/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/sv/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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 1784)
+++ /pykota/trunk/man/pkhint.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH PKHINT "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkhint \- manual page for pkhint 1.20alpha21_unofficial
+pkhint \- manual page for pkhint 1.20alpha25_unofficial
 .SH DESCRIPTION
-pkhint v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkhint v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 A tool to give hints on what accounting method is best for each printer.
 .PP
Index: /pykota/trunk/man/repykota.1
===================================================================
--- /pykota/trunk/man/repykota.1 (revision 1784)
+++ /pykota/trunk/man/repykota.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH REPYKOTA "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-repykota \- manual page for repykota 1.20alpha21_unofficial
+repykota \- manual page for repykota 1.20alpha25_unofficial
 .SH DESCRIPTION
-repykota v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+repykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 .PP
 Generates print quota reports.
Index: /pykota/trunk/man/warnpykota.1
===================================================================
--- /pykota/trunk/man/warnpykota.1 (revision 1784)
+++ /pykota/trunk/man/warnpykota.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH WARNPYKOTA "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-warnpykota \- manual page for warnpykota 1.20alpha21_unofficial
+warnpykota \- manual page for warnpykota 1.20alpha25_unofficial
 .SH DESCRIPTION
-warnpykota v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 .PP
 Sends mail to users over print quota.
Index: /pykota/trunk/man/autopykota.1
===================================================================
--- /pykota/trunk/man/autopykota.1 (revision 1801)
+++ /pykota/trunk/man/autopykota.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH AUTOPYKOTA "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-autopykota \- manual page for autopykota 1.20alpha23_unofficial
+autopykota \- manual page for autopykota 1.20alpha25_unofficial
 .SH DESCRIPTION
-autopykota v1.20alpha23_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+autopykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 A tool to automate user account creation and initial balance setting.
 .PP
Index: /pykota/trunk/man/el/autopykota.1
===================================================================
--- /pykota/trunk/man/el/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/el/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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/el/edpykota.1
===================================================================
--- /pykota/trunk/man/el/edpykota.1 (revision 1827)
+++ /pykota/trunk/man/el/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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/el/pkprinters.1
===================================================================
--- /pykota/trunk/man/el/pkprinters.1 (revision 1827)
+++ /pykota/trunk/man/el/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/el/pykotme.1
===================================================================
--- /pykota/trunk/man/el/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/el/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/el/pykosd.1
===================================================================
--- /pykota/trunk/man/el/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/el/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/el/dumpykota.1
===================================================================
--- /pykota/trunk/man/el/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/el/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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/el/pkhint.1
===================================================================
--- /pykota/trunk/man/el/pkhint.1 (revision 1827)
+++ /pykota/trunk/man/el/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/el/repykota.1
===================================================================
--- /pykota/trunk/man/el/repykota.1 (revision 1827)
+++ /pykota/trunk/man/el/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/el/warnpykota.1
===================================================================
--- /pykota/trunk/man/el/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/el/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/pkprinters.1
===================================================================
--- /pykota/trunk/man/pkprinters.1 (revision 1784)
+++ /pykota/trunk/man/pkprinters.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH PKPRINTERS "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pkprinters \- manual page for pkprinters 1.20alpha21_unofficial
+pkprinters \- manual page for pkprinters 1.20alpha25_unofficial
 .SH DESCRIPTION
-pkprinters v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 A Printers Manager for PyKota.
 .PP
Index: /pykota/trunk/man/en/autopykota.1
===================================================================
--- /pykota/trunk/man/en/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/en/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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/en/edpykota.1
===================================================================
--- /pykota/trunk/man/en/edpykota.1 (revision 1827)
+++ /pykota/trunk/man/en/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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/en/pkprinters.1
===================================================================
--- /pykota/trunk/man/en/pkprinters.1 (revision 1827)
+++ /pykota/trunk/man/en/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/en/pykotme.1
===================================================================
--- /pykota/trunk/man/en/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/en/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/en/pykosd.1
===================================================================
--- /pykota/trunk/man/en/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/en/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/en/dumpykota.1
===================================================================
--- /pykota/trunk/man/en/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/en/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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/en/pkhint.1
===================================================================
--- /pykota/trunk/man/en/pkhint.1 (revision 1827)
+++ /pykota/trunk/man/en/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/en/repykota.1
===================================================================
--- /pykota/trunk/man/en/repykota.1 (revision 1827)
+++ /pykota/trunk/man/en/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/en/warnpykota.1
===================================================================
--- /pykota/trunk/man/en/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/en/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/br/autopykota.1
===================================================================
--- /pykota/trunk/man/br/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/br/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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/br/edpykota.1
===================================================================
--- /pykota/trunk/man/br/edpykota.1 (revision 1827)
+++ /pykota/trunk/man/br/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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/br/pkprinters.1
===================================================================
--- /pykota/trunk/man/br/pkprinters.1 (revision 1827)
+++ /pykota/trunk/man/br/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/br/pykotme.1
===================================================================
--- /pykota/trunk/man/br/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/br/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/br/pykosd.1
===================================================================
--- /pykota/trunk/man/br/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/br/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/br/dumpykota.1
===================================================================
--- /pykota/trunk/man/br/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/br/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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/br/pkhint.1
===================================================================
--- /pykota/trunk/man/br/pkhint.1 (revision 1827)
+++ /pykota/trunk/man/br/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/br/repykota.1
===================================================================
--- /pykota/trunk/man/br/repykota.1 (revision 1827)
+++ /pykota/trunk/man/br/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/br/warnpykota.1
===================================================================
--- /pykota/trunk/man/br/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/br/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/fr/autopykota.1
===================================================================
--- /pykota/trunk/man/fr/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/fr/autopykota.1 (revision 1827)
@@ -0,0 +1,45 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/fr/edpykota.1 (revision 1827)
@@ -0,0 +1,196 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+Un �teur de quotas pour PyKota.
+.PP
+ligne de commande :
+.IP
+edpykota [options] utilisateur1 utilisateur2 ... utilisateurN
+.IP
+edpykota [options] groupe1 groupe2 ... groupeN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Affiche la version d'edpykota et quitte.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Affiche ce message et quitte.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+Ajoute des utilisateurs et/ou des imprimantes
+s'ils n'existent pas d� dans la base de donn�.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Efface des utilisateurs ou des groupes depuis
+la base de donn�.                       Les imprimantes ne sont jamais effac�.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Positionne le co�r page et par travail
+sur l'imprimante. Le prix par travail est optionel.
+Si les deux sont positionn� il faut les s�rer
+par une virgule. Les nombres r�s sont autoris�
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...] Place les utilisateurs dans chacun des groupes
+list� separ�par des virgules. Les groupes
+doivent d� exister dans la base de donn�.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Modifie les quotas utilisateur, c'est la valeur
+par d�ut.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Modifie les quotas sur l'imprimante p 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.
+.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.
+.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.
+.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.
+.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 1827)
+++ /pykota/trunk/man/fr/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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/fr/pykotme.1
===================================================================
--- /pykota/trunk/man/fr/pykotme.1 (revision 1827)
+++ /pykota/trunk/man/fr/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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/fr/pykosd.1
===================================================================
--- /pykota/trunk/man/fr/pykosd.1 (revision 1827)
+++ /pykota/trunk/man/fr/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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/fr/dumpykota.1
===================================================================
--- /pykota/trunk/man/fr/dumpykota.1 (revision 1827)
+++ /pykota/trunk/man/fr/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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 1827)
+++ /pykota/trunk/man/fr/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/fr/repykota.1
===================================================================
--- /pykota/trunk/man/fr/repykota.1 (revision 1827)
+++ /pykota/trunk/man/fr/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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/fr/warnpykota.1
===================================================================
--- /pykota/trunk/man/fr/warnpykota.1 (revision 1827)
+++ /pykota/trunk/man/fr/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/es/autopykota.1
===================================================================
--- /pykota/trunk/man/es/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/es/autopykota.1 (revision 1827)
@@ -0,0 +1,49 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/es/edpykota.1 (revision 1827)
@@ -0,0 +1,210 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+Un editor de Cuotas de Impresi�ara PyKota.
+.PP
+uso desde la l�a de comandos:
+.IP
+edpykota [opciones] usuario1 usuario2 ... usuarioN
+.IP
+edpykota [opciones] grupo1 grupo2 ... grupoN
+.PP
+opciones :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e edpykota y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-a\fR | \fB\-\-add\fR
+A� usuarios y/o grupos si no existen en el
+Servidor de Almacenamiento de las Cuotas.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Borra usuarios/grupos de la base de datos de
+almacenamiento de las cuotas. Las impresoras no
+se borran.
+.TP
+\fB\-c\fR | \fB\-\-charge\fR p[,j]
+Establece el precio que se ha de cargar, por
+p�na y por trabajo, a una determinada
+impresora. El precio por trabajo es opcional.
+Si se han de establecer los dos, sep�los
+con una coma. Se permiten valores en coma
+flotante.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Coloca a los usuarios en cada uno de los
+grupos listados, separados por comas. Los
+grupos han de existir en la base de datos                               donde se almacenan las cuotas.
+.TP
+\fB\-u\fR | \fB\-\-users\fR
+Edita las cuotas de impresi�e los usuarios,
+este es el comportamiento por defecto.
+.TP
+\fB\-P\fR | \fB\-\-printer\fR p
+Edita las cuotas �mente en la impresora �p�.
+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.
+.TP
+\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] A� la(s) impresora(s) a los grupos
+de impresi�pg1�, �pg2�, etc., estos 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.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edita las cuotas de impresi�e los grupos
+de usuarios en lugar de los usuarios.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Utiliza el usuario �u� o el grupo �g� como
+prototipo para establecer las cuotas de
+impresi�.TP
+\fB\-n\fR | \fB\-\-noquota\fR
+No se establece una cuota, s�se realiza
+contabilidad.
+.TP
+\fB\-r\fR | \fB\-\-reset\fR
+Reinicio a cero del contador de p�nas actual
+para el usuario o grupo en las impresoras
+especificadas. El historial del contador
+de p�nas no se modificar�.TP
+\fB\-R\fR | \fB\-\-hardreset\fR
+Reinicio a cero del contador de p�nas actual
+y del historial, para el usuario o grupo
+en las impresoras especificadas.
+.TP
+\fB\-l\fR | \fB\-\-limitby\fR l
+Elija si el usuario/grupo est�imitado por
+saldo o por cuota de p�nas. El valor por
+defecto es �quota�. Los valores permitidos
+son �quota�, �balance�, �quota-then-balance� y
+�balance-then-quota�.
+AVISO: �quota-then-balance� y �balance-then-quota�
+no se han implementado todav�
+.TP
+\fB\-b\fR | \fB\-\-balance\fR b
+Establece el saldo a �b� para la cuenta de usuario.
+El saldo se puede incrementar o reducir si a �b�
+le anteceden los signos + o -.
+AVISO: cuando se reduce el saldo, el total pagado
+por el usuario tambi�se reduce.
+Los grupos no tienen un saldo real, es la suma
+de los saldos de sus usuarios.
+.TP
+\fB\-S\fR | \fB\-\-softlimit\fR sl
+Establece el l�te blando para la cuota a �sl�
+p�nas.
+.TP
+\fB\-H\fR | \fB\-\-hardlimit\fR hl
+Establece el l�te duro para la cuota a �hl�
+p�nas.
+.IP
+desde usuario1 hasta usuarioN y desde grupo1 hasta grupoN puede utilizar
+comodines, si no se ha empleado la opci�fB\-\-add\fR.
+.PP
+ejemplos:
+.IP
+\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
+.IP
+Esto a�r� los usuarios john, paul, george y ringo a la base
+de datos de cuotas, y establecer�us cuotas de impresi�l mismo
+valor que la del usuario jerome. El usuario jerome ha de existir.
+La direcci�e correo electr�o del usuario ringo se establecer�omo �ringo@example.com�
+.IP
+\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
+.IP
+Esto establecer�a cuota de impresi�e jerome en la impresora lp
+a un l�te blando de 50 p�nas, y a un l�te duro de 60 p�nas.
+Si el usuario jerome o la impresora lp no existen en el Servidor de
+Almacenamiento de Cuotas, la acci�o se tendr�n cuenta.
+.IP
+\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
+.IP
+Igual que el ejemplo anterior, pero en este caso, si el usuario
+jerome o la impresora lp no existen en el Servidor de Almacenamiento
+de Cuotas, ser�autom�camente a�dos. El usuario jerome
+se a�r� los grupos �coders� e �it�, que han de existir en la
+base de datos donde se almacenan las cuotas.
+.IP
+\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+.IP
+Esto establecer�na cuota de impresi�con un l�te blando de
+500 p�nas y un l�te duro de 550 p�nas, para los grupos
+�financial� y �support� en todas las impresoras.
+.IP
+\f(CW$ edpykota --reset jerome "jo*"\fR
+.IP
+Esto reiniciar�l contador de p�nas de jerome a cero en todas
+las impresoras, as�omo a todos los usuarios cuyos nombres comiencen
+por �jo�.
+El historial del contador de p�nas de cada impresora no se
+modificar�Puede reiniciar el historial del contador de
+p�nas utilizando la opci�fB\-\-hardreset\fR | \fB\-R\fR
+.IP
+\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
+.IP
+Esto informar� PyKota para que no limite a jerome cuando
+imprima en la impresora hpcolor. Se permitir�todos sus trabajos
+en esta impresora, pero la contabilidad de las p�nas que �imprima se seguir�uardando.
+Las cuotas de impresi�e jerome en las otras impresoras no
+se cambiar�.IP
+\f(CW$ edpykota --limitby balance jerome\fR
+.IP
+Esto le dir� PyKota que limite a jerome por su saldo cuando
+imprima.
+.IP
+\f(CW$ edpykota --balance +10.0 jerome\fR
+.IP
+Esto incrementar�l saldo de jerome en 10.0 (en su propia
+moneda). Puede reducir el saldo anteponiendo un gui�y
+establecer un saldo fijo sin anteponer nada.
+.IP
+\f(CW$ edpykota --delete jerome rachel\fR
+.IP
+Esto borrar�ompletamente a jerome y a rachel de la base de datos
+de almacenamiento de las cuotas. Tambi�se borrar�todas sus cuotas
+.IP
+y trabajos de impresi�.IP
+\f(CW$ edpykota --printer lp --charge 0.1\fR
+.IP
+Esto establecer�l precio por p�na para la impresora lp a 0.1.
+El precio por trabajo no se cambiar�.IP
+\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
+.IP
+Esto a�r�as impresoras �hplj1� y �hplj2� al grupo de impresoras
+�Laser� y �HP�. Cuando se imprima en las impresoras �hplj1� o �hplj2�,
+la cuota de impresi�ambi�se comprobar� se cargar�n las
+impresoras virtuales �Laser� y �HP�.
+.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/pkprinters.1
===================================================================
--- /pykota/trunk/man/es/pkprinters.1 (revision 1827)
+++ /pykota/trunk/man/es/pkprinters.1 (revision 1827)
@@ -0,0 +1,112 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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 1827)
+++ /pykota/trunk/man/es/pykotme.1 (revision 1827)
@@ -0,0 +1,65 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/es/pykosd.1 (revision 1827)
@@ -0,0 +1,67 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/es/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Vuelca el contenido de la base de datos de PyKota.
+.PP
+uso desde la l�a de comandos:
+.IP
+dumpykota [opciones]
+.PP
+opciones:
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Muestra el n� de versi�e dumpykota y
+luego sale.
+.TP
+\fB\-h\fR | \fB\-\-help\fR
+Muestra este mensaje y luego sale.
+.TP
+\fB\-d\fR | \fB\-\-data\fR type
+Vuelca los datos �type�. Los tipos permitidos son:
+.IP
+- history : vuelca el historial de trabajos.
+- users : vuelca los usuarios.
+- groups : vuelca los grupos de usuarios.
+- printers : vuelca las impresoras.
+- upquotas : vuelca las cuotas de los usuarios.
+- gpquotas : vuelca las cuotas de los grupos de usuarios.
+- payments : vuelca los pagos del usuario.
+- pmembers : vuelca los miembros de los grupos de impresi�- umembers : vuelca los miembros de los grupos de usuarios.
+.IP
+NB : la opci�fB\-d\fR | \fB\-\-data\fR es OBLIGATORIA.
+.TP
+\fB\-f\fR | \fB\-\-format\fR fmt
+Vuelca los datos en el formato �fmt�. Cuando no se
+especifica, el formato de volcado de datos es csv
+(valores separados por comas). Todos los datos
+volcados est�entre comillas dobles. Los formatos
+permitidos son:
+.IP
+- csv : datos separados por comas
+- ssv : datos separados por puntos y comas
+- tsv : datos separados por tabuladores
+- xml : vuelca los datos como XML
+.TP
+\fB\-o\fR | \fB\-\-output\fR fname
+Todos los datos ser�volcados al archivo en lugar de
+a la salida est�ar. El nombre de archivo especial
+�-� es el valor por defecto y significa stdout.
+AVISO: �los archivos existentes ser�truncados!
+.PP
+Ejemplos:
+.IP
+\f(CW$ dumpykota --data history --format csv >myfile.csv\fR
+.IP
+Esto volcar�l historial en un archivo con valores separados por comas,
+para un posible uso en una hoja de c�ulo.
+.IP
+\f(CW$ dumpykota --data users --format xml -o users.xml\fR
+.IP
+Vuelca todos los datos de los usuarios al archivo users.xml.
+.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/pkhint.1
===================================================================
--- /pykota/trunk/man/es/pkhint.1 (revision 1827)
+++ /pykota/trunk/man/es/pkhint.1 (revision 1827)
@@ -0,0 +1,47 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/repykota.1
===================================================================
--- /pykota/trunk/man/es/repykota.1 (revision 1827)
+++ /pykota/trunk/man/es/repykota.1 (revision 1827)
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/es/warnpykota.1 (revision 1827)
@@ -0,0 +1,75 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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 1784)
+++ /pykota/trunk/man/pykosd.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH PYKOSD "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-pykosd \- manual page for pykosd 1.20alpha21_unofficial
+pykosd \- manual page for pykosd 1.20alpha25_unofficial
 .SH DESCRIPTION
-pykosd v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+pykosd v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 An OSD quota monitor for PyKota.
 .PP
Index: /pykota/trunk/man/th/autopykota.1
===================================================================
--- /pykota/trunk/man/th/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/th/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/th/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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 1827)
+++ /pykota/trunk/man/th/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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 1827)
+++ /pykota/trunk/man/th/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/th/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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 1827)
+++ /pykota/trunk/man/th/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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 1827)
+++ /pykota/trunk/man/th/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/repykota.1
===================================================================
--- /pykota/trunk/man/th/repykota.1 (revision 1827)
+++ /pykota/trunk/man/th/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/th/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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/it/autopykota.1
===================================================================
--- /pykota/trunk/man/it/autopykota.1 (revision 1827)
+++ /pykota/trunk/man/it/autopykota.1 (revision 1827)
@@ -0,0 +1,44 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH AUTOPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+autopykota \- page de manuel de autopykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+autopykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/it/edpykota.1 (revision 1827)
@@ -0,0 +1,195 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH EDPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+edpykota \- page de manuel de edpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+edpykota v1.20alpha25_unofficial (c) 2003-2004 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\-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.
+.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.
+.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.
+.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 1827)
+++ /pykota/trunk/man/it/pkprinters.1 (revision 1827)
@@ -0,0 +1,108 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKPRINTERS "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkprinters \- page de manuel de pkprinters 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkprinters v1.20alpha25_unofficial (c) 2003-2004 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.
+.TP
+\fB\-D\fR | \fB\-\-description\fR
+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 1827)
+++ /pykota/trunk/man/it/pykotme.1 (revision 1827)
@@ -0,0 +1,66 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOTME "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykotme \- page de manuel de pykotme 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykotme v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/it/pykosd.1 (revision 1827)
@@ -0,0 +1,63 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PYKOSD "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pykosd \- page de manuel de pykosd 1.20alpha25_unofficial
+.SH DESCRIPTION
+pykosd v1.20alpha25_unofficial (c) 2003-2004 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 pkprinters'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 1827)
+++ /pykota/trunk/man/it/dumpykota.1 (revision 1827)
@@ -0,0 +1,80 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH DUMPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+dumpykota \- page de manuel de dumpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+.PP
+Dumps PyKota database's content.
+.PP
+command line usage :
+.IP
+dumpykota [options]
+.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
+.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 !
+.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.
+.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 1827)
+++ /pykota/trunk/man/it/pkhint.1 (revision 1827)
@@ -0,0 +1,46 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH PKHINT "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkhint \- page de manuel de pkhint 1.20alpha25_unofficial
+.SH DESCRIPTION
+pkhint v1.20alpha25_unofficial (c) 2003-2004 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/repykota.1
===================================================================
--- /pykota/trunk/man/it/repykota.1 (revision 1827)
+++ /pykota/trunk/man/it/repykota.1 (revision 1827)
@@ -0,0 +1,71 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH REPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+repykota \- page de manuel de repykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+repykota v1.20alpha25_unofficial (c) 2003-2004 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 1827)
+++ /pykota/trunk/man/it/warnpykota.1 (revision 1827)
@@ -0,0 +1,76 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
+.TH WARNPYKOTA "1" "octobre 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+warnpykota \- page de manuel de warnpykota 1.20alpha25_unofficial
+.SH DESCRIPTION
+warnpykota v1.20alpha25_unofficial (c) 2003-2004 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 1784)
+++ /pykota/trunk/man/dumpykota.1 (revision 1827)
@@ -2,7 +2,7 @@
 .TH DUMPYKOTA "1" "October 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-dumpykota \- manual page for dumpykota 1.20alpha21_unofficial
+dumpykota \- manual page for dumpykota 1.20alpha25_unofficial
 .SH DESCRIPTION
-dumpykota v1.20alpha21_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+dumpykota v1.20alpha25_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
 .PP
 Dumps PyKota database's content.
Index: /pykota/trunk/man/genman.sh
===================================================================
--- /pykota/trunk/man/genman.sh (revision 1758)
+++ /pykota/trunk/man/genman.sh (revision 1827)
@@ -15,4 +15,12 @@
 #
 for prog in autopykota dumpykota edpykota pykotme repykota warnpykota pkprinters pkhint pykosd ; do 
+    echo $prog ;
     help2man --section=1 --manual "User Commands" --source="C@LL - Conseil Internet & Logiciels Libres" --output=$prog.1 --no-info $prog ; 
+    for loc in be br de el en es fr it pt sv th ; do
+        echo "  $loc" ;
+        cd $loc ;
+        help2man --locale=$loc --section=1 --manual "User Commands" --source="C@LL - Conseil Internet & Logiciels Libres" --output=$prog.1 --no-info $prog ; 
+        cd .. ;
+    done ;
+    echo ;
 done
Index: /pykota/trunk/po/fr/pykota.po
===================================================================
--- /pykota/trunk/po/fr/pykota.po (revision 1824)
+++ /pykota/trunk/po/fr/pykota.po (revision 1827)
@@ -335,66 +335,66 @@
 "                       en les s�rant avec des virgules.\n"
 "  \n"
-"  -G | --pgroups pg1[,pg2...] Adds the printer(s) to the printer groups\n"
-"                       pg1, pg2, etc... which must already exist.\n"
-"                       A printer group is just like a normal printer,\n"
-"                       only that it is usually unknown from the printing\n"
-"                       system. Create printer groups exactly the same\n"
-"                       way that you create printers, then add other \n"
-"                       printers to them with this option.\n"
-"                       Accounting is done on a printer and on all\n"
-"                       the printer groups it belongs to, quota checking\n"
-"                       is done on a printer and on all the printer groups\n"
-"                       it belongs to.\n"
-"  \n"
-"  -g | --groups        Edit users groups print quotas instead of users.\n"
-"                          \n"
-"  -p | --prototype u|g Uses user u or group g as a prototype to set\n"
-"                       print quotas\n"
-"                       \n"
-"  -n | --noquota       Doesn't set a quota but only does accounting.\n"
-"  \n"
-"  -r | --reset         Resets the actual page counter for the user\n"
-"                       or group to zero on the specified printers. \n"
-"                       The life time page counter is kept unchanged.\n"
-"                       \n"
-"  -R | --hardreset     Resets the actual and life time page counters\n"
-"                       for the user or group to zero on the specified \n"
-"                       printers. \n"
-"                       \n"
-"  -l | --limitby l     Choose if the user/group is limited in "
-"printing                     \n"
-"                       by its account balance or by its page quota.\n"
-"                       The default value is 'quota'. Allowed values\n"
-"                       are 'quota' 'balance' 'quota-then-balance' and\n"
+"  -G | --pgroups pg1[,pg2...] Ajoute l'imprimante aux groupes d'imprimantes\n"
+"                       pg1, pg2, etc... qui doivent d� exister.\n"
+"                       Un groupe d'imprimantes est comme une imprimante\n"
+"                       normale, sauf que celle-ci est inconnue du syst�\n"
+"                       d'impression. On cr�des groupes d'imprimantes de la\n"
+"                       m� mani� que des imprimantes normale, et ensuite\n"
+"                       on y ajoute d'autres imprimantes avec cette option.\n"
+"                       Le d�mpte est fait sur une imprimante et sur tous\n"
+"                       les groupes d'imprimantes auxquels elle appartient,\n"
+"                       la v�fication de quota est faite sur une imprimante\n"
+"                       et sur tous les groupes d'imprimantes auxquels elle\n"
+"                       appartient.\n"
+"  \n"
+"  -g | --groups        Modifie les quotas de groupes plut�ue ceux des\n"
+"                       utilisateurs.\n"
+"                       \n"
+"  -p | --prototype u|g Prend l'utilisateur u ou le groupe g comme mod�\n"
+"                       pour positionner le quota d'impression.\n"
+"                       \n"
+"  -n | --noquota       Ne d�nit aucun quota, mais laisse le d�mpte actif.\n"
+"  \n"
+"  -r | --reset         Remet �� le compteur de pages courant pour\n"
+"                       l'utilisateur ou le groupe sur les imprimantes\n"
+"                       sp�fi�.\n"
+"                       Le compteur de pages '�rnel' est inchang�n"
+"                       \n"
+"  -R | --hardreset     Remet �� les compteurs de pages courant et\n"
+"                       '�rnel' pour l'utilisateur ou le groupe sur les\n"
+"                       imprimantes sp�fi�.\n"
+"                       \n"
+"  -l | --limitby l     D�nit le facteur de limitation pour l'utilisateur\n"
+"                       ou le groupe : soit par le solde du compte (balance),\n"
+"                       soit par le quota par pages.\n"
+"                       La valeur par d�ut est 'quota'. Les valeurs\n"
+"                       autoris� sont 'quota' 'balance' 'quota-then-balance'\n"
 "                       'balance-then-quota'.\n"
-"                       WARNING : quota-then-balance and balance-then-quota\n"
-"                       are not yet implemented.\n"
-"                       \n"
-"  -b | --balance b     Sets the user's account balance to "
-"b.                     \n"
-"                       Account balance may be increase or decreased\n"
-"                       if b is prefixed with + or -.\n"
-"                       WARNING : when decreasing account balance,\n"
-"                       the total paid so far by the user is decreased\n"
-"                       too.\n"
-"                       Groups don't have a real balance, but the\n"
-"                       sum of their users' account balance.\n"
-"                       \n"
-"  -S | --softlimit sl  Sets the quota soft limit to sl "
-"pages.                       \n"
-"  \n"
-"  -H | --hardlimit hl  Sets the quota hard limit to hl pages.\n"
-"  \n"
-"  user1 through userN and group1 through groupN can use wildcards\n"
-"  if the --add option is not set.\n"
-"  \n"
-"examples :                              \n"
+"                       ATTENTION : quota-then-balance et balance-then-quota\n"
+"                       ne sont pas encore impl�nt�.\n"
+"                       \n"
+"  -b | --balance b     Fixe le solde de l'utiliateur �a valeur b.\n"
+"                       Le solde peut aussi �e incr�nt�u d��nt�"
+"                       si b est pr�d�'un signe + ou -.\n"
+"                       ATTENTION : si on d��nte le solde, le total\n"
+"                       r��ar l'utilisateur est d��nt�ussi.\n"
+"                       Les groupes n'ont pas de solde, leur solde est la\n"
+"                       somme des soldes des utilisateurs membres.\n"
+"                       \n"
+"  -S | --softlimit sl  Fixe la limite souple �l pages.\n"
+"  \n"
+"  -H | --hardlimit hl  Fixe la limite dure �l pages.\n"
+"  \n"
+"  les noms d'utilisateurs ou de groupes peuvent contenir des caract�s\n"
+"  joker si l'option --add n'est pas utilis�\n"
+"  \n"
+"exemples :                              \n"
 "\n"
 "  $ edpykota --add -p jerome john paul george ringo/ringo@example.com\n"
 "  \n"
-"  This will add users john, paul, george and ringo to the quota\n"
-"  database, and set their print quotas to the same values than user \n"
-"  jerome. User jerome must already exist.\n"
-"  User ringo's email address will also be set to 'ringo@example.com'\n"
+"  Ceci va ajouter les utilisateurs john, paul, george and ringo �a base\n"
+"  de donn�, et fixer leur quota par pages �a m� valeur que\n"
+"  l'utilisateur jerome. L'utilisateur jerome doit exister.\n"
+"  L'adresse email de ringo sera fix��ringo@example.com'\n"
 "  \n"
 "  $ edpykota --printer lp -S 50 -H 60 jerome\n"
@@ -473,5 +473,5 @@
 "Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.\n"
 "\n"
-"Please e-mail bugs to: %s"
+"Merci d'envoyer les rapports de bugs �%s"
 
 msgid "You're not allowed to use this command."
