Index: pykota/trunk/man/zh_TW/pkprinters.1
===================================================================
--- pykota/trunk/man/zh_TW/pkprinters.1 (revision 3279)
+++ pykota/trunk/man/zh_TW/pkprinters.1 (revision 3485)
@@ -1,124 +1,111 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
-.TH PKPRINTERS "1" "janvier 2008" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
+.TH PKPRINTERS "1" "janvier 2009" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
 .SH NOM
-pkprinters \- page de manuel de pkprinters 1.27alpha3_BROKEN_unofficial
+pkprinters \- page de manuel de pkprinters (PyKota) 1.27alpha7_unofficial
+.SH SYNOPSIS
+.B pkprinters
+[\fIoptions\fR] \fIprinter1 printer2 \fR... \fIprinterN\fR
 .SH DESCRIPTION
-pkprinters v1.27alpha3_BROKEN_unofficial (c) 2003, 2004, 2005, 2006, 2007, 2008 Jerome Alet \- alet@librelogiciel.com
-.PP
-A Printers Manager for PyKota.
-.PP
-command line usage :
+Manages PyKota printers.
+.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, printers.
+.TP
+\fB\-c\fR CHARGE, \fB\-\-charge\fR=\fICHARGE\fR
+Set the cost per page, and optionally per job, for
+printing to the specified printers. If both are to be
+set, separate them with a comma. Floating point and
+negative values are allowed.
+.TP
+\fB\-C\fR, \fB\-\-cups\fR
+Tell CUPS to either start or stop managing the
+specified printers with PyKota.
+.TP
+\fB\-d\fR, \fB\-\-delete\fR
+Delete the specified printers. Also purge the print
+quota entries and printing history matching the
+specified printers.
+.TP
+\fB\-D\fR DESCRIPTION, \fB\-\-description\fR=\fIDESCRIPTION\fR
+Set a textual description for the specified printers.
+.TP
+\fB\-g\fR GROUPS, \fB\-\-groups\fR=\fIGROUPS\fR
+If the \fB\-\-remove\fR option is not used, the default action
+is to add the specified printers to the specified
+printers groups. Otherwise they are removed from these
+groups. The specified printers groups must already
+exist, and should be created beforehand just like
+normal printers with this very command.
+.TP
+\fB\-l\fR, \fB\-\-list\fR
+Display detailed informations about the specified
+printers.
+.TP
+\fB\-m\fR MAXJOBSIZE, \fB\-\-maxjobsize\fR=\fIMAXJOBSIZE\fR
+Set the maximum job size in pages allowed on the
+specified printers.
+.TP
+\fB\-n\fR, \fB\-\-nopassthrough\fR
+Deactivate passthrough mode for the specified
+printers. This is the normal mode of operations, in
+which print jobs are accounted for, and are checked
+against printing quotas and available credits.
+.TP
+\fB\-p\fR, \fB\-\-passthrough\fR
+Activate passthrough mode for the specified printers.
+In this mode, jobs sent to these printers are not
+accounted for. This can be useful for exams during
+which no user should be charged for his printouts.
+.TP
+\fB\-r\fR, \fB\-\-remove\fR
+When combined with the \fB\-\-groups\fR option, remove
+printers from the specified printers groups.
+.TP
+\fB\-s\fR, \fB\-\-skipexisting\fR
+If \fB\-\-add\fR is used, ensure that existing printers won't
+be modified.
+.SS "examples:"
 .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.
-.HP
-\fB\-D\fR | \fB\-\-description\fR d Adds a textual description to printers.
-.TP
-\fB\-C\fR | \fB\-\-cups\fR
-Also modifies the DeviceURI in CUPS' printers.conf
-.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.
-.TP
-\fB\-m\fR | \fB\-\-maxjobsize\fR s
-Sets the maximum job size allowed on the printer
-to s pages.
-.TP
-\fB\-p\fR | \fB\-\-passthrough\fR
-Activate passthrough mode for the printer. In this
-mode, users are allowed to print without any impact
-on their quota or account balance.
-.TP
-\fB\-n\fR | \fB\-\-nopassthrough\fR Deactivate passthrough mode for the printer.
-Without \fB\-p\fR or \fB\-n\fR, printers are created in
-normal mode, i.e. no passthrough.
+pkprinters \fB\-\-add\fR \fB\-\-cups\fR \fB\-D\fR "HP Printer" \fB\-\-charge\fR 0.05,0.1 hp2100 hp2200
+Would create three printers named 'hp2100', and 'hp2200' in PyKota's
+database, while telling CUPS to route all print jobs through PyKota for
+these printers. Each of them would have 'HP Printer' as its description.
+Printing to any of them would cost 0.05 credit per page, plus 0.1 credit
+for each job.
 .IP
-printer1 through printerN can contain wildcards if the \fB\-\-add\fR option
-is not set.
-.PP
-examples :
+pkprinters \fB\-\-delete\fR "*"
+Would delete all existing printers and matching print quota entries and
+printing history from PyKota's database. USE WITH CARE.
 .IP
-\f(CW$ pkprinters \-\-add -D "HP Printer" \-\-charge 0.05,0.1 hp2100 hp2200 hp8000\fR
+pkprinters \fB\-\-groups\fR Laser,HP "hp*"
+Would add all printers which name begins with 'hp' to the 'Laser' and 'HP'
+printers groups, which must already exist.
 .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.
+pkprinters \fB\-\-groups\fR Lexmark \fB\-\-remove\fR hp2200
+Would remove printer 'hp2200' from the 'Lexmark' printers group.
+.SS "licensing terms:"
 .IP
-\f(CW$ pkprinters \-\-delete "*"\fR
+(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
-This will completely delete all printers and associated quota information,
-as well as their job history. USE WITH CARE !
+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
-\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
-(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/>.
