Changeset 3413 for pykota/trunk/docs/pkprinters.sgml
- Timestamp:
- 09/27/08 22:02:37 (16 years ago)
- Files:
-
- 1 modified
Legend:
- Unmodified
- Added
- Removed
-
pykota/trunk/docs/pkprinters.sgml
r2551 r3413 4 4 <title>Manage printers with pkprinters</title> 5 5 <para>Last modified on $Date$</para> 6 6 7 7 <para> 8 <command>pkprinters</command> is the preferred tool to manage printers in <application>PyKota</application>. 8 <command>pkprinters</command> is the preferred tool to manage printers in <application>PyKota</application>. 9 9 It only manages printers, and do it well. With it you can add or delete printers or printer groups, or modify 10 10 existing printers or printers groups. This is also the tool to use to put printers into one or more printers groups. 11 </para> 12 11 </para> 12 13 13 <para> 14 The very first thing you have to do once <application>PyKota</application> is installed but before it can work, 14 The very first thing you have to do once <application>PyKota</application> is installed but before it can work, 15 15 is to add into <application>PyKota</application>'s database an entry for each of the print queues on 16 16 which you want to have print quota or accounting. … … 19 19 like full management of printers. 20 20 </para> 21 21 22 22 <para> 23 23 Let's say your printing system has several print queues defined : <literal>HP2100</literal>, <literal>TekTro</literal>, 24 24 and <literal>StylusColor1</literal> and <literal>StylusColor2</literal>. You want to charge 5 cents per page on each of this print queues. 25 25 You just have to type : 26 <screen> 26 <screen> 27 27 $ pkprinters --add --charge 0.05 HP2100 TekTro StylusColor1 StylusColor2 28 28 </screen> … … 33 33 </warning> 34 34 </para> 35 35 36 36 <para> 37 After some minutes, you think that you should charge more on the <literal>StylusColor1</literal> 38 and <literal>StylusColor2</literal> because they can do color. 37 After some minutes, you think that you should charge more on the <literal>StylusColor1</literal> 38 and <literal>StylusColor2</literal> because they can do color. 39 39 You also want to enter a description for these printers, because you have several 40 40 of them : 41 <screen> 41 <screen> 42 42 $ pkprinters --charge 0.25 "StylusColor*" 43 43 $ pkprinters --description "Stylus Color 900 First floor" StylusColor1 … … 45 45 </screen> 46 46 </para> 47 47 48 48 <para> 49 49 You can now verify what you did : 50 <screen> 50 <screen> 51 51 $ pkprinters --list 52 52 HP2100 [] (0.0 + #*0.05) … … 56 56 </screen> 57 57 </para> 58 58 59 59 <para> 60 60 The command above has listed all print queues present in <application>PyKota</application>'s database, 61 along with their optional description and their base cost formula. 61 along with their optional description and their base cost formula. 62 62 The cost formula includes the price per job, <literal>0.0</literal> in our examples, 63 63 and the price per page (<literal>#</literal> representing the number of pages). 64 64 </para> 65 65 66 66 <para> 67 67 If you defined printers groups, then the total cost is computed as the recursive … … 71 71 cost of printing on a particular printer for a particular user. 72 72 </para> 73 73 74 74 <sect1> 75 75 <title>Reference</title> … … 89 89 <arg>-c <replaceable>p</replaceable>,<replaceable>j</replaceable></arg> 90 90 <arg>--charge <replaceable>p</replaceable>,<replaceable>j</replaceable></arg> 91 </group> 91 </group> 92 92 <group choice="opt"> 93 93 <arg>-g <replaceable>pgroup1</replaceable>,<replaceable>pgroup2</replaceable>,<replaceable>...</replaceable></arg> 94 94 <arg>--groups <replaceable>pgroup1</replaceable>,<replaceable>pgroup2</replaceable>,<replaceable>...</replaceable></arg> 95 </group> 95 </group> 96 96 <group choice="opt"><arg>-l</arg><arg>--list</arg></group> 97 97 <group choice="opt"><arg>-r</arg><arg>--remove</arg></group> … … 100 100 <arg>-m <replaceable>s</replaceable></arg> 101 101 <arg>--maxjobsize <replaceable>s</replaceable></arg> 102 </group> 102 </group> 103 103 <group choice="opt"><arg>-p</arg><arg>--passthrough</arg></group> 104 104 <group choice="opt"><arg>-n</arg><arg>--nopassthrough</arg></group>