Merge changes from CUPS 1.4svn-r7696.

[thirdparty/cups.git] / INSTALL.txt

diff --git a/INSTALL.txt b/INSTALL.txt
index 92416a1828b4b34ce84daafc6e932a07fc443f31..46104948d883b8200f3c9893554e197ba1bfe526 100644 (file)
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -1,5 +1,5 @@
-INSTALL - CUPS v1.3.0 - 2007-08-03
-----------------------------------
+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
@@ -19,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. 
-    BSD 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
@@ -31,9 +32,8 @@ BEFORE YOU BEGIN
     compile and run without these, however you'll miss out on
     many of the features provided by CUPS.
 
-    Kerberos support requires a very recent version of the MIT
-    implementation with the krb5_cc_new_unique() function or the
-    Heimdal implementation, along with the corresponding GSSAPI
+    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
@@ -47,7 +47,7 @@ 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
@@ -96,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
@@ -164,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