| 1 | <!-- $Id$ --> |
|---|
| 2 | |
|---|
| 3 | <chapter> |
|---|
| 4 | <title>Manage billing codes with pkbcodes</title> |
|---|
| 5 | <para>Last modified on $Date$</para> |
|---|
| 6 | |
|---|
| 7 | <para> |
|---|
| 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. |
|---|
| 12 | </para> |
|---|
| 13 | |
|---|
| 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 | |
|---|
| 35 | <sect1> |
|---|
| 36 | <title>Reference</title> |
|---|
| 37 | <para> |
|---|
| 38 | <cmdsynopsis> |
|---|
| 39 | <command>pkbcodes</command> |
|---|
| 40 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
|---|
| 41 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
|---|
| 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> |
|---|
| 51 | </cmdsynopsis> |
|---|
| 52 | </para> |
|---|
| 53 | </sect1> |
|---|
| 54 | </chapter> |
|---|
| 55 | |
|---|
