Index: pykota/trunk/man/edpykota.1
===================================================================
--- pykota/trunk/man/edpykota.1 (revision 1942)
+++ pykota/trunk/man/edpykota.1 (revision 2086)
@@ -1,8 +1,8 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
-.TH EDPYKOTA "1" "November 2004" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
+.TH EDPYKOTA "1" "February 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NAME
-edpykota \- manual page for edpykota 1.21alpha6_unofficial
+edpykota \- manual page for edpykota 1.21alpha27_unofficial
 .SH DESCRIPTION
-edpykota v1.21alpha6_unofficial (c) 2003-2004 C@LL - Conseil Internet & Logiciels Libres
+edpykota v1.21alpha27_unofficial (c) 2003, 2004, 2005 C@LL \- Conseil Internet & Logiciels Libres
 A Print Quota editor for PyKota.
 .PP
@@ -34,4 +34,15 @@
 If both are to be set, separate them with a comma.
 Floating point values are allowed.
+.TP
+\fB\-o\fR | \fB\-\-overcharge\fR f
+Sets the overcharging factor applied to the user
+when computing the cost of a print job. Positive or
+negative floating point values are allowed,
+this allows you to do some really creative
+things like giving money to an user whenever
+he prints. The number of pages in a print job
+is not modified by this coefficient, only the
+cost of the job for a particular user.
+Only users have a coefficient.
 .TP
 \fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
@@ -80,5 +91,5 @@
 Resets the actual and life time page counters
 for the user or group to zero on the specified
-printers.
+printers. This is a shortcut for '\-\-used 0'.
 .TP
 \fB\-l\fR | \fB\-\-limitby\fR l
@@ -86,7 +97,7 @@
 by its account balance or by its page quota.
 The default value is 'quota'. Allowed values
-are 'quota' 'balance' 'quota-then-balance' and
-\&'balance-then-quota'.
-WARNING : quota-then-balance and balance-then-quota
+are 'quota' 'balance' 'quota\-then\-balance' and
+\&'balance\-then\-quota'.
+WARNING : quota\-then\-balance and balance\-then\-quota
 are not yet implemented.
 .TP
@@ -94,5 +105,5 @@
 Sets the user's account balance to b.
 Account balance may be increase or decreased
-if b is prefixed with + or -.
+if b is prefixed with + or \-.
 WARNING : when decreasing account balance,
 the total paid so far by the user is decreased
@@ -106,4 +117,15 @@
 \fB\-H\fR | \fB\-\-hardlimit\fR hl
 Sets the quota hard limit to hl pages.
+.TP
+\fB\-U\fR | \fB\-\-used\fR usage
+Sets the pagecounters for the user to usage pages;
+useful for migrating users from a different system
+where they have already used some pages. Actual
+and Life Time page counters may be increased or decreased
+if usage is prefixed with + or \-.
+WARNING : BOTH page counters are modified in all cases,
+so be careful.
+NB : if 'usage' equals '0', then the action taken is
+the same as if \fB\-\-hardreset\fR was used.
 .IP
 user1 through userN and group1 through groupN can use wildcards
@@ -178,4 +200,18 @@
 When printing either on hplj1 or hplj2, print quota will also be
 checked and accounted for on virtual printers Laser and HP.
+.IP
+\f(CW$ edpykota --overcharge 2.5 poorstudent\fR
+.IP
+This will overcharge the poorstudent user by a factor of 2.5.
+.IP
+\f(CW$ edpykota --overcharge -1 jerome\fR
+.IP
+User jerome will actually earn money whenever he prints.
+.IP
+\f(CW$ edpykota --overcharge 0 boss\fR
+.IP
+User boss can print at will, it won't cost him anything because the
+cost of each print job will be multiplied by zero before charging
+his account.
 .PP
 This program is free software; you can redistribute it and/or modify
@@ -191,5 +227,5 @@
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
-.PP
-Please e-mail bugs to: Jerome Alet - alet@librelogiciel.com
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA.
+.PP
+Please e\-mail bugs to: Jerome Alet \- alet@librelogiciel.com
