CUPS-PDF
--------

This software is designed to produce PDF files in a heterogeneous network by
providing a PDF printer on the central fileserver.

WARNING: Though this is a final release no warranty of any kind is granted!

Installation (on a SuSE 8.1 or 8.2 Linux system - paths may differ on other
platforms):

 * Modify the file cups-pdf.h to fit your needs. The file contains comments
   how to set options.

 * Compile cups-pdf.c in the same directory as cups-pdf.h is located and
   move the binary to CUPS' backend directory (/usr/lib/cups/backend/cups-pdf)
   [ e.g. by calling "gcc -O9 -o /usr/lib/cups/backend/cups-pdf cups-pdf.c" ]

 * Copy PostscriptColor.ppd.gz to /usr/share/cups/model/PostscriptColor.ppd.gz 

Now after restarting CUPS you will be able to choose "Virtual Printer (PDF
Printer)" when setting up a new printer in CUPS.

To set up a queue for other UNIX clients you should select Postscript as
vendor and the Color Printer as model for your new printer; queues that get
their input from samba or netatalk (i.e. Windows, OS/2 or MacOS) can be set up
as raw queues. On the Windows, OS/2 or MacOS system choose a color postscript
driver for that network printer (the drivers for Minolta Page Works or HP
DesignJet printers do a good job).

Once you print to the new device the output directory selected in cups-pdf.h
(defaults to /var/spool/cups-pdf) will be created and all converted PDF files
will be placed in subdirectories named after the owner of the print job. In
case the owner cannot be identified (i.e. does not exist on the server) the
output is placed in the subdirectory for anonymous operation (if not disabled
in cups-pdf.h - defaults to ANONYMOUS/). Furthermore if logging is enabled the
logfile will be placed by default in /var/log/cups.

The file "PostscriptColor.ppd.gz" is a modified version of "Postscript.ppd.gz"
that comes with CUPS 1.1.15 that is able to handle color output. 

License statement:

This code may be freely distributed as long as this header is preserved.

This code is distributed under the GPL. (http://www.gnu.org/copyleft/gpl.html)

Copyright (C) 2003  Volker C. Behr 

   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 2
   of the License, or (at your option) any later version.

   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.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

If you want to redistribute modified sources/binaries this header has to be
preserved and all modifications should be clearly indicated.

In case you want to include this code into your own programs I would
appreaciate some feedback via email.

I welcome any questions, hints, comments or suggestions.
Volker C. Behr <vrbehr@cip.physik.uni-wuerzburg.de>
