Index: pykota/trunk/man/el_GR/edpykota.1
===================================================================
--- pykota/trunk/man/el_GR/edpykota.1 (revision 3279)
+++ pykota/trunk/man/el_GR/edpykota.1 (revision 3485)
@@ -1,152 +1,137 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH EDPYKOTA "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH EDPYKOTA "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-edpykota \- page de manuel de edpykota 1.27alpha3_BROKEN_unofficial
+edpykota \- page de manuel de edpykota (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B edpykota
+[\fIoptions\fR] [\fIusernames|groupnames\fR]
 .SH DESCRIPTION
-edpykota v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-A Print Quota editor for PyKota.
-.PP
-command line usage :
+Manages PyKota print quota entries for users or users groups. A print quota
+entry is related to both an user and a printer, or to both a group and a
+printer, meaning that for example different users can have different page
+count limits on the same printer. If an user doesn't have a print quota entry
+on a particular printer, he won't be allowed to print to it.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit.
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+show the version number and exit.
+.TP
+\fB\-A\fR ARGUMENTSFILE, \fB\-\-arguments\fR=\fIARGUMENTSFILE\fR
+loads additional options and arguments from a file,
+one per line.
+.TP
+\fB\-a\fR, \fB\-\-add\fR
+Add new, or modify existing, users or groups print
+quota entries.
+.TP
+\fB\-d\fR, \fB\-\-delete\fR
+Delete the specified users or groups print quota
+entries. When deleting users print quota entries, the
+matching jobs are also deleted from the printing
+history.
+.TP
+\fB\-S\fR SOFTLIMIT, \fB\-\-softlimit\fR=\fISOFTLIMIT\fR
+Set the soft page count limit for the specified print
+quota entries. Users can print over this limit for a
+number of days specified in the 'gracedelay' directive
+in pykota.conf
+.TP
+\fB\-H\fR HARDLIMIT, \fB\-\-hardlimit\fR=\fIHARDLIMIT\fR
+Set the hard page count limit for the specified print
+quota entries. Users are never allowed to print over
+this limit.
+.TP
+\fB\-g\fR, \fB\-\-groups\fR
+Manage groups print quota entries instead of users
+print quota entries.
+.TP
+\fB\-I\fR INCREASE, \fB\-\-increase\fR=\fIINCREASE\fR
+Increase the existing soft and hard page count limits
+for the specified print quota entries. You can
+decrease the values instead by prefixing this
+parameter with a negative sign.
+.TP
+\fB\-L\fR, \fB\-\-list\fR
+Display detailed informations about the specified
+users or groups print quota entries.
+.TP
+\fB\-n\fR, \fB\-\-noquota\fR
+Set no limit for both soft and hard page counts for
+the specified users or groups print quota entries.
+.TP
+\fB\-P\fR PRINTER, \fB\-\-printer\fR=\fIPRINTER\fR
+Specify a comma separated list of printers you want to
+manage print quota entries on. The default is '*',
+meaning all printers.
+.TP
+\fB\-r\fR, \fB\-\-reset\fR
+Reset the actual page counter for the specified users
+print quota entries (doesn't work for groups print
+quota entries). The life time page counter is left
+unchanged.
+.TP
+\fB\-R\fR, \fB\-\-hardreset\fR
+Reset the actual and life time page counters for the
+specified users print quota entries (doesn't work for
+groups print quota entries). This is a shortcut for
+\fB\-\-used\fR 0.
+.TP
+\fB\-s\fR, \fB\-\-skipexisting\fR
+If \fB\-\-add\fR is used, ensure that existing users or groups
+print quota entries won't be modified.
+.TP
+\fB\-U\fR USED, \fB\-\-used\fR=\fIUSED\fR
+Set the values of both the actual and life time page
+counters for the specified users print quota entries
+(doesn't work for groups print quota entries). This
+can be useful when migrating from a different print
+quota software. The values can also be increased or
+decreased by prefixing this parameter with either a
+positive or negative sign.
+.SS "examples:"
 .IP
-edpykota [options] user1 user2 ... userN
+edpykota \fB\-\-add\fR john paul george ringo
+Would create print quota entries with no page count limits for these four
+users on all existing printers.
 .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 or groups print quota entries if
-they don't exist in database.
-.TP
-\fB\-d\fR | \fB\-\-delete\fR
-Deletes users or groups print quota entries.
-Users or groups are never deleted, you have
-to use the pkusers command to delete them.
-The history will be purge from all matching
-jobs, unless \fB\-g\fR | \fB\-\-groups\fR is used.
-.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\-\-groups\fR
-Edit groups print quota entries instead of
-users print quota entries.
-.TP
-\fB\-L\fR | \fB\-\-list\fR
-Lists users or groups print quota entries.
-.TP
-\fB\-n\fR | \fB\-\-noquota\fR
-Sets both soft and hard limits to None for users
-or groups print quota entries.
-.TP
-\fB\-r\fR | \fB\-\-reset\fR
-Resets the actual page counter for the user
-or group to zero on the specified printers.
-The life time page counter is kept unchanged.
-.TP
-\fB\-R\fR | \fB\-\-hardreset\fR
-Resets the actual and life time page counters
-for the user or group to zero on the specified
-printers. This is a shortcut for '\-\-used 0'.
-.TP
-\fB\-s\fR | \fB\-\-skipexisting\fR
-In combination with the \fB\-\-add\fR option above, tells
-edpykota to not modify existing print quota entries.
-.TP
-\fB\-S\fR | \fB\-\-softlimit\fR sl
-Sets the quota soft limit to sl pages.
-.TP
-\fB\-H\fR | \fB\-\-hardlimit\fR hl
-Sets the quota hard limit to hl pages.
-.TP
-\fB\-I\fR | \fB\-\-increase\fR v
-Increase existing Soft and Hard limits by the value
-of v. You can prefix v with + or \-, if no sign is
-used, + is assumed.
-.TP
-\fB\-U\fR | \fB\-\-used\fR u
-Sets the page counters for the user u pages on
-the selected printers. Doesn't work for groups, since
-their page counters are the sum of all their members'
-page counters.
-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 u is prefixed with + or \-.
-WARNING : BOTH page counters are modified in all cases,
-so be careful.
-NB : if u equals '0', then the action taken is
-the same as if \fB\-\-hardreset\fR was used.
+edpykota \fB\-\-printer\fR HP \fB\-\-softlimit\fR 50 \fB\-\-hardlimit\fR 60 jerome
+Would allow user 'jerome' to print up to 60 pages on printer 'HP'. This
+user would be warned when he would have reached 50 pages on this printer.
+Both the user and printer must have been created previously using the
+pkusers and pkprinters commands, respectively.
 .IP
-user1 through userN and group1 through groupN can use wildcards
-if the \fB\-\-add\fR option is not set.
-.PP
-examples :
+edpykota \fB\-\-groups\fR \fB\-\-softlimit\fR 500 \fB\-\-hardlimit\fR 600 support financial
+Would set soft and hard page count limits on any printer for groups
+\&'support' and 'financial'.
 .IP
-\f(CW$ edpykota \-\-add john paul george ringo\fR
+edpykota \fB\-\-reset\fR \fB\-\-printer\fR HP jerome "jo*"
+Would reset the actual page counter for users 'jerome' and all users whose
+name begins with 'jo' on printer 'HP'.
 .IP
-This will create print quota entries for users john, paul, george
-and ringo on all printers. These print quota entries will have no
-limit set.
+edpykota \fB\-\-printer\fR HPCOLOR \fB\-\-noquota\fR jerome
+Would allow this user to print without any page limit on printer
+\&'HPCOLOR'. Depending on how this user is limited, he may still be subject
+to being limited by the number of available credits in his account.
 .IP
-\f(CW$ edpykota \-\-printer lp -S 50 -H 60 jerome\fR
+edpykota \fB\-\-add\fR \fB\-\-skipexisting\fR
+Would create a print quota entry for each user on each printer for which
+none already existed. You'll most likely want to use this command at least
+once after initial setup.
+.SS "licensing terms:"
 .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. Both user jerome and
-printer lp have been previously created with the pkusers and pkprinters
-commands, respectively.
+(c) 2003\-2009 Jerome Alet \- alet@librelogiciel.com
+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 3 of the License, or (at your option)
+any later version.
 .IP
-\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
+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.
 .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 \-\-delete \-\-printer "HP*,XER*" jerome rachel\fR
-.IP
-This will delete users jerome and rachel's print quota
-entries on all printers which name begin with 'HP' or
-\&'XER'. The jobs printed by these users on these printers
-will be deleted from the history.
-.PP
-(c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet <alet@librelogiciel.com>
-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 3 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, see <http://www.gnu.org/licenses/>.
-.PP
-Please report bugs to : Jerome Alet \- alet@librelogiciel.com
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.
