INSTALL - CUPS DDK v1.2.3 - 2007-10-05
--------------------------------------

This file describes how to compile and install the CUPS Driver
Development Kit ("DDK") from source code. For more information
on the CUPS DDK see the file called "README.txt".  A complete
change log can be found in "CHANGES.txt".


BEFORE YOU BEGIN

You'll need ANSI-compliant C and C++ compilers, plus a make
program and Bourne (POSIX) shell.  The GNU compiler tools work
well - we've tested the current DDK code against GCC 3.x with
excellent results.

The makefiles used by the DDK should work with most versions of
make.  We use them successfully with GNU make as well as the
make programs shipped by SGI and Sun.  *BSD, HP-UX, and Tru64
users should use GNU make (gmake).

Finally, you MUST have the CUPS 1.2 or higher software installed
including all header files.  If you are using MacOS X, Apple does
not include the header files with the standard OS install or
developer tools - you will need to download the Darwin CUPS
sources and use the "installhdr" target to install the header
files manually.  Note that MacOS X 10.4.x and earlier come with
an older version of CUPS - you cannot build the DDK on a standard
10.2.x-10.4.x CUPS installation.


CONFIGURATION

The CUPS DDK uses GNU autoconf, so you will find the usual
"configure" script in the main CUPS DDK source directory.  Type
the following command to configure the CUPS DDK for your system
using the default options:

    ./configure ENTER

The default options will put the CUPS DDK software under the
"/usr" directory on your system.  Use the "--prefix" option to
install the CUPS DDK software in another location:

    ./configure --prefix=/some/directory ENTER

Once you have configured things, just type:

    make ENTER

or:

    gmake ENTER

to build the software.


INSTALLING THE SOFTWARE

Once you have built the software you need to install it before
using it.  The "install" target provides a quick way to install
the software on your local system:

    make install ENTER

or:

    gmake install ENTER

You can also build binary packages that can be installed on
other machines using the EPM list file "cupsddk.list".  The EPM
software can be found at:

    http://www.easysw.com/epm/


CREATING BINARY DISTRIBUTIONS WITH EPM

The top level makefile supports generation of many types of binary
distributions using EPM.  To build a binary distribution type:

    make <format> ENTER

or

    gmake <format> ENTER

The <format> target is one of the following:

    epm      - Builds a portable shell script and tar file based
	       distribution.
    deb      - Builds a Debian binary distribution.
    rpm      - Builds a RPM binary distribution.
    native   - Builds a "native" distribution (typically RPM on
	       Linux, otherwise whatever is found on the system)


REPORTING PROBLEMS

If you have problems, READ THE DOCUMENTATION FIRST!  If the
documentation does not solve your problems please post a message
to the "cups.ddk" forum at:

    http://www.cups.org/newsgroups.php

Include your operating system and version, compiler and version,
and any errors or problems you've run into.  If you are running
a version of Linux, be sure to provide the Linux distribution
you have, too.

Please note that the "cups.ddk" newsgroup is monitored by
volunteers, so your message may go unanswered for days or
weeks.  Commercial support for the DDK is available for a fee;
for more information, please visit the Easy Software Products
web site at:

    http://www.easysw.com/cups/

