root / tea4cups / trunk / README @ 576

Revision 576, 2.7 kB (checked in by jerome, 14 years ago)

Finalized transition to the new name for the project

  • Property svn:keywords set to Author Date Id Rev
Line 
1# $Id$
2
3Tea4CUPS : Tee for CUPS
4
5This program is free software; you can redistribute it and/or modify
6it under the terms of the GNU General Public License as published by
7the Free Software Foundation; either version 2 of the License, or
8(at your option) any later version.
9
10This program is distributed in the hope that it will be useful,
11but WITHOUT ANY WARRANTY; without even the implied warranty of
12MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13GNU General Public License for more details.
14
15You should have received a copy of the GNU General Public License
16along with this program; if not, write to the Free Software
17Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
18
19=============================================================================
20
21Tea4CUPS is the equivalent of the *nix command 'tee', but as a CUPS
22backend.
23
24Tea4CUPS behaves just like any other CUPS backend, but allows you to
25transparently send print jobs' datas to any number of outputs : other
26CUPS backends, files or pipes.
27
28This for example allows you to output the same print job on several
29printers at the same time, which is not possible with CUPS.
30
31Another possibility would be for example to send the same document to
32a printer, a PDF generator, a Fax, and as an attachment to an email
33message, all of this by printing it a single time.
34
35=============================================================================
36
37Installation :
38--------------
39
40  1 - Copy the 'tea4cups' command into CUPS' backend directory,
41      for example :
42     
43        $ cp tea4cups /usr/lib/cups/backend
44       
45  2 - Restart CUPS in order for this new backend to be detected.       
46 
47  3 - Either from CUPS' web interface, add new printers with
48      'Tea4CUPS managed' in front of the device's name.
49         
50      Or by directly modifying CUPS' printers.conf file, prepend   
51      each DeviceURI value with 'tea4cups://', and restart CUPS.
52     
53  4 - Copy tea4cups.conf into CUPS' configuration directory (where   
54      cupsd.conf resides) :
55     
56        $ cp tea4cups.conf /etc/cups/
57       
58  5 - Modify tea4cups.conf to suit your needs. Several examples     
59      are included.
60     
61  6 - There's no 6 !   
62 
63=============================================================================
64
65Troubleshooting :
66-----------------
67
68  1 - Set "LogLevel debug2" in CUPS' cupsd.conf
69 
70  2 - Restart CUPS.
71 
72  3 - Set "debug: yes" in the [global] section of tea4cups.conf
73 
74  4 - Print something on a print queue managed
75      by Tea4CUPS.
76     
77  5 - Look at CUPS' error_log file for diagnostic and error messages.
78 
79=============================================================================
80   
81Please e-mail bugs to : alet@librelogiciel.com (Jerome Alet)
Note: See TracBrowser for help on using the browser.