Index: pykota/trunk/man/pl/pkturnkey.1
===================================================================
--- pykota/trunk/man/pl/pkturnkey.1 (revision 3279)
+++ pykota/trunk/man/pl/pkturnkey.1 (revision 3485)
@@ -1,99 +1,95 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKTURNKEY "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKTURNKEY "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkturnkey \- page de manuel de pkturnkey 1.27alpha3_BROKEN_unofficial
+pkturnkey \- page de manuel de pkturnkey (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkturnkey
+[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR
 .SH DESCRIPTION
-pkturnkey v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
 A turn key tool for PyKota. When launched, this command will initialize
-PyKota's database with all existing print queues and some or all users.
-For now, no prices or limits are set, so printing is fully accounted
-for, but not limited. That's why you'll probably want to also use
-edpykota once the database has been initialized.
-.PP
-command line usage :
+PyKota's database with all existing print queues and some or all users. For
+now, no prices or limits are set, so printing is fully accounted for, but not
+limited. That's why you'll probably want to also use edpykota once the
+database has been initialized.
+.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\-c\fR, \fB\-\-doconf\fR
+Try to autodetect the best print accounting settings
+for existing CUPS printers. All printers must be
+switched ON beforehand.
+.TP
+\fB\-d\fR, \fB\-\-dousers\fR
+Create accounts for users, and allocate print quota
+entries for them.
+.TP
+\fB\-D\fR, \fB\-\-dogroups\fR
+Create accounts for users groups, and allocate print
+quota entries for them.
+.TP
+\fB\-e\fR, \fB\-\-emptygroups\fR
+Also include groups which don't have any member.
+.TP
+\fB\-f\fR, \fB\-\-force\fR
+Modifies PyKota's database content for real, instead
+of faking it (for safety reasons).
+.TP
+\fB\-u\fR UIDMIN, \fB\-\-uidmin\fR=\fIUIDMIN\fR
+Only include users whose uid is greater than or equal
+to this parameter. If you pass an username instead,
+his uid will be used automatically.
+.TP
+\fB\-U\fR UIDMAX, \fB\-\-uidmax\fR=\fIUIDMAX\fR
+Only include users whose uid is lesser than or equal
+to this parameter. If you pass an username instead,
+his uid will be used automatically.
+.TP
+\fB\-g\fR GIDMIN, \fB\-\-gidmin\fR=\fIGIDMIN\fR
+Only include users groups whose gid is greater than or
+equal to this parameter. If you pass a groupname
+instead, its gid will be used automatically.
+.TP
+\fB\-G\fR GIDMAX, \fB\-\-gidmax\fR=\fIGIDMAX\fR
+Only include users groups whose gid is lesser than or
+equal to this parameter. If you pass a groupname
+instead, its gid will be used automatically.
+.SS "examples:"
 .IP
-pkturnkey [options] [printqueues names]
-.PP
-options :
-.TP
-\fB\-v\fR | \fB\-\-version\fR
-Prints pkturnkey version number then exits.
-.TP
-\fB\-h\fR | \fB\-\-help\fR
-Prints this message then exits.
-.TP
-\fB\-c\fR | \fB\-\-doconf\fR
-Give hints about what to put into pykota.conf
-.TP
-\fB\-d\fR | \fB\-\-dousers\fR
-Manages users accounts as well.
-.TP
-\fB\-D\fR | \fB\-\-dogroups\fR
-Manages users groups as well.
-Implies \fB\-d\fR | \fB\-\-dousers\fR.
-.TP
-\fB\-e\fR | \fB\-\-emptygroups\fR
-Includes empty groups.
-.TP
-\fB\-f\fR | \fB\-\-force\fR
-Modifies the database instead of printing what
-it would do.
-.TP
-\fB\-u\fR | \fB\-\-uidmin\fR uid
-Only adds users whose uid is greater than or equal to
-uid. You can pass an username there as well, and its
-uid will be used automatically.
-If not set, 0 will be used automatically.
-Implies \fB\-d\fR | \fB\-\-dousers\fR.
-.TP
-\fB\-U\fR | \fB\-\-uidmax\fR uid
-Only adds users whose uid is lesser than or equal to
-uid. You can pass an username there as well, and its
-uid will be used automatically.
-If not set, a large value will be used automatically.
-Implies \fB\-d\fR | \fB\-\-dousers\fR.
-.TP
-\fB\-g\fR | \fB\-\-gidmin\fR gid
-Only adds groups whose gid is greater than or equal to
-gid. You can pass a groupname there as well, and its
-gid will be used automatically.
-If not set, 0 will be used automatically.
-Implies \fB\-D\fR | \fB\-\-dogroups\fR.
-.TP
-\fB\-G\fR | \fB\-\-gidmax\fR gid
-Only adds groups whose gid is lesser than or equal to
-gid. You can pass a groupname there as well, and its
-gid will be used automatically.
-If not set, a large value will be used automatically.
-Implies \fB\-D\fR | \fB\-\-dogroups\fR.
-.PP
-examples :
+pkturnkey \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2
+Would simulate the creation in PyKota's database of the printing accounts
+for all users whose uid is greater than or equal to 'jerome''s. Each of
+them would be given a print quota entry on printers 'HPLASER1' and
+\&'HPLASER2'.
 .IP
-\f(CW$ pkturnkey \-\-dousers \-\-uidmin jerome\fR
+pkturnkey \fB\-\-force\fR \fB\-\-dousers\fR \fB\-\-uidmin\fR jerome HPLASER1 HPLASER2
+Would do the same as the example above, but for real. Please take great
+care when using the \fB\-\-force\fR command line option.
 .IP
-Will simulate the initialization of PyKota's database will all existing
-printers and print accounts for all users whose uid is greater than
-or equal to jerome's one. Won't manage any users group.
+pkturnkey \fB\-\-doconf\fR
+Would try to automatically detect the best print accounting settings for
+all active printers, and generate some lines for you to add into your
+pykota.conf
+.SS "licensing terms:"
 .IP
-To REALLY initialize the database instead of simulating it, please
-use the \fB\-f\fR | \fB\-\-force\fR command line switch.
+(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
-You can limit the initialization to only a subset of the existing
-printers, by passing their names at the end of the command line.
-.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
+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
+You should have received a copy of the GNU General Public License along
+with this program.  If not, see <http://www.gnu.org/licenses/>.
