Index: pykota/trunk/man/th/pkusers.1
===================================================================
--- pykota/trunk/man/th/pkusers.1 (revision 2703)
+++ pykota/trunk/man/th/pkusers.1 (revision 2703)
@@ -0,0 +1,157 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH PKUSERS "1" "f�ier 2006" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.SH NOM
+pkusers \- page de manuel de pkusers 1.24alpha12_unofficial
+.SH DESCRIPTION
+pkusers v1.24alpha12_unofficial (c) 2003, 2004, 2005, 2006 Jerome Alet \- alet@librelogiciel.com
+.PP
+An Users and Groups Manager for PyKota.
+.PP
+command line usage :
+.IP
+pkusers [options] user1 user2 user3 ... userN
+.PP
+or :
+.IP
+pkusers \fB\-\-groups\fR [options] group1 group2 group3 ... groupN
+.PP
+options :
+.TP
+\fB\-v\fR | \fB\-\-version\fR
+Prints pkusers'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 if they don't exist on the database.
+If they exist, they are modified unless
+\fB\-s\fR|\-\-skipexisting is also used.
+.TP
+\fB\-d\fR | \fB\-\-delete\fR
+Deletes users from the quota storage.
+.HP
+\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to users or groups.
+.TP
+\fB\-g\fR | \fB\-\-groups\fR
+Edit users groups instead of users.
+.TP
+\fB\-p\fR | \fB\-\-prototype\fR u|g Uses user u or group g as a prototype to create
+or modify datas.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have such a coefficient.
+.TP
+\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
+Puts the users into each of the groups
+listed, separated by commas. The groups
+must already exist in the Quota Storage.
+.TP
+\fB\-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' 'noquota' 'noprint'
+and 'nochange' :
+.IP
+\- quota : limit by number of pages per printer.
+\- balance : limit by number of credits in account.
+\- noquota : no limit, accounting still done.
+\- nochange : no limit, accounting not done.
+\- noprint : printing is denied.
+.IP
+NB : nochange and noprint are not supported for groups.
+.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\-C\fR | \fB\-\-comment\fR txt
+Defines some informational text to be associated
+with a change to an user's account balance.
+Only meaningful if \fB\-b\fR | \fB\-\-balance\fR is also used.
+.TP
+\fB\-r\fR | \fB\-\-remove\fR
+In combination with the \fB\-\-groups\fR option above,
+remove users from the specified users groups.
+.TP
+\fB\-s\fR | \fB\-\-skipexisting\fR
+In combination with the \fB\-\-add\fR option above, tells
+pkusers to not modify existing users.
+.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$ pkusers --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 account information based on user
+jerome's own account. User jerome must already exist.
+User ringo's email address will also be set to 'ringo@example.com'
+.IP
+\f(CW$ pkusers --ingroups coders,it jerome\fR
+.IP
+User jerome is put into the groups "coders" and "it" which must
+already exist in the quota database.
+.IP
+\f(CW$ pkusers --limitby balance jerome\fR
+.IP
+This will tell PyKota to limit jerome by his account's balance
+when printing.
+.IP
+\f(CW$ pkusers --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$ pkusers --delete jerome rachel\fR
+.IP
+This will completely delete jerome and rachel from the quota
+database. All their quotas and jobs will be deleted too.
+.IP
+\f(CW$ pkusers --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ pkusers --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ pkusers --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
+.PP
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+.PP
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+.PP
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
+.PP
+Please report bugs to : Jerome Alet \- alet@librelogiciel.com
