[2552] | 1 | <!-- $Id$ --> |
---|
[2541] | 2 | |
---|
| 3 | <chapter> |
---|
| 4 | <title>Manage billing codes with pkbcodes</title> |
---|
| 5 | <para>Last modified on $Date$</para> |
---|
| 6 | |
---|
| 7 | <para> |
---|
[2551] | 8 | Some people like lawyers for example need to be able to invoice their own clients |
---|
| 9 | for printouts. To address such needs, <application>CUPS</application> features |
---|
| 10 | the possibility to attach a particular billing code to each print job, and of course, |
---|
| 11 | <application>PyKota</application> can make use of it. |
---|
[2541] | 12 | </para> |
---|
| 13 | |
---|
[2551] | 14 | <para> |
---|
| 15 | To use a billing code when printing, you have to pass an additionnal argument to the |
---|
| 16 | <command>lp</command> command, for example for a client named <literal>smith</literal> |
---|
| 17 | this could be something like : |
---|
| 18 | <screen> |
---|
| 19 | $ lp -o job-billing=smith the_file_to_print.ps |
---|
| 20 | </screen> |
---|
| 21 | </para> |
---|
| 22 | |
---|
| 23 | <para> |
---|
| 24 | For <application>PyKota</application> to be able to maintain statistics |
---|
| 25 | per billing code, you first have to add these billing codes to <application>PyKota</application>'s |
---|
| 26 | database. This is the main goal of the <command>pkbcodes</command> command line tool. |
---|
| 27 | </para> |
---|
| 28 | |
---|
| 29 | <para> |
---|
| 30 | But <command>pkbcodes</command> also allows you to add a textual description to each billing |
---|
| 31 | code, to delete them, to reset billing code specific counters, and finally to list |
---|
| 32 | existing billing codes. |
---|
| 33 | </para> |
---|
| 34 | |
---|
[2541] | 35 | <sect1> |
---|
| 36 | <title>Reference</title> |
---|
| 37 | <para> |
---|
| 38 | <cmdsynopsis> |
---|
[2551] | 39 | <command>pkbcodes</command> |
---|
[2541] | 40 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
---|
| 41 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
---|
[2553] | 42 | <group choice="opt"><arg>-a</arg><arg>--add</arg></group> |
---|
| 43 | <group choice="opt"><arg>-d</arg><arg>--delete</arg></group> |
---|
| 44 | <group choice="opt"> |
---|
| 45 | <arg>-D <replaceable>desc</replaceable></arg> |
---|
| 46 | <arg>--description <replaceable>desc</replaceable></arg> |
---|
| 47 | </group> |
---|
| 48 | <group choice="opt"><arg>-l</arg><arg>--list</arg></group> |
---|
| 49 | <group choice="opt"><arg>-r</arg><arg>--reset</arg></group> |
---|
| 50 | <group choice="opt"><arg>-s</arg><arg>--skipexisting</arg></group> |
---|
[2541] | 51 | </cmdsynopsis> |
---|
| 52 | </para> |
---|
| 53 | </sect1> |
---|
| 54 | </chapter> |
---|
| 55 | |
---|