Remove old files.

[thirdparty/cups.git] / INSTALL.txt

diff --git a/INSTALL.txt b/INSTALL.txt
index df6022b46d195ad7c83cf0c127c15bfa4ec08f16..46104948d883b8200f3c9893554e197ba1bfe526 100644 (file)
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -1,13 +1,15 @@
-INSTALL - CUPS v1.2.0 - 2006-05-08
-----------------------------------
+INSTALL - CUPS v1.4svn - 2008-04-23
+-----------------------------------
 
 This file describes how to compile and install CUPS from source
 code. For more information on CUPS see the file called
 "README.txt".  A complete change log can be found in
 "CHANGES.txt".
 
-**** IF YOU HAVE A NON-POSTSCRIPT PRINTER, YOU WILL ALSO    ****
-**** NEED TO INSTALL ESP GHOSTSCRIPT AFTER YOU INSTALL CUPS ****
+**** IF YOU HAVE A NON-POSTSCRIPT PRINTER AND ARE NOT       ****
+**** RUNNING MAC OS X, YOU WILL ALSO NEED TO INSTALL GPL    ****
+**** GHOSTSCRIPT WITH THE "cups" DRIVER AFTER YOU INSTALL   ****
+**** CUPS.                                                  ****
 
 
 BEFORE YOU BEGIN
@@ -17,10 +19,11 @@ BEFORE YOU BEGIN
     we've tested the current CUPS code against several versions
     of GCC with excellent results.
 
-    The makefiles used by the project should work with all
+    The makefiles used by the project should work with most
     versions of make.  We've tested them with GNU make as well as
     the make programs shipped by Compaq, HP, SGI, and Sun. 
-    FreeBSD users should use GNU make (gmake).
+    BSD users should use GNU make (gmake) since BSD make does
+    not support "include".
 
     Besides these tools you'll want the JPEG, PNG, TIFF, and ZLIB
     libraries for image support, the CDSA, GNU TLS, or OpenSSL
@@ -29,17 +32,22 @@ BEFORE YOU BEGIN
     compile and run without these, however you'll miss out on
     many of the features provided by CUPS.
 
+    Kerberos support requires MIT Kerberos 1.6.3 or later or
+    Heimdal Kerberos, along with the corresponding GSSAPI
+    pieces.
+
     Also, please note that CUPS no longer includes the
     Ghostscript- based pstoraster filter.  You *must* download
-    ESP Ghostscript separately from the CUPS web site if you want
-    to print PostScript files to non-PostScript printers.
+    GPL Ghostscript separately from the CUPS web site if you want
+    to print PostScript files to non-PostScript printers on
+    operating systems other than Mac OS X.
 
 
 COMPILING FROM SUBVERSION
 
     The CUPS Subversion repository doesn't hold a copy of the
     pre-built configure script.  You'll need to run the GNU
-    autoconf software (2.52 or higher) before compiling the
+    autoconf software (2.60 or higher) before compiling the
     software from Subversion:
 
        autoconf -f
@@ -88,6 +96,10 @@ CONFIGURATION
        LDFLAGS="-L/some/directory" \
        ./configure ...
 
+    The "--enable-debug" option compiles CUPS with debugging enabled,
+    as well as support for debug logging via the CUPS_DEBUG_LOG
+    environment variable at run-time.
+
     Once you have configured things, just type:
 
        make ENTER
@@ -156,6 +168,15 @@ CREATING BINARY DISTRIBUTIONS WITH EPM
        tardist   - Builds an IRIX package (also inst)
 
 
+GETTING DEBUG LOGGING FROM CUPS
+
+    When configured with the "--enable-debug" option, CUPS compiles
+    in additional debug logging support in the scheduler, CUPS API,
+    and CUPS Imaging API.  Set the CUPS_DEBUG_LOG environment
+    variable to a filename to append logging information at run-time.
+    Use the name "-" to send the messages to stderr.
+
+
 REPORTING PROBLEMS
 
     If you have problems, READ THE DOCUMENTATION FIRST!  If the