Imported Upstream version 5.2.1

1 files changed, 135 insertions, 136 deletions

diff --git a/README b/README
index 6dda7b8..174a80f 100644
--- a/README
+++ b/README
@@ -1,26 +1,25 @@
-Welcome to Gutenprint 5.2.0-beta2!  Please read these notes carefully.
+Welcome to Gutenprint 5.2.1!  Please read these notes carefully.
 
-*** NOTE TO PACKAGERS: This is a beta release of the forthcoming 5.2
-    stable release.  As of 5.2 and until further notice, Gutenprint
-    will no longer deliver separate "development" and "stable" release
-    series.
+*** NOTE TO PACKAGERS: Please read the file README.package for issues
+    that are of interest to distributors and packagers of Gutenprint.
+    It is not necessary for end users of Gutenprint to read this file.
 
 ================================================================
 
 I) INTRODUCTION
 
-    This is Gutenprint version 5.2.0-beta2, a beta release of
-    Gutenprint 5.2.  Gutenprint, formerly named Gimp-Print, is a suite
-    of printer drivers that may be used with most common UNIX print
-    spooling systems, including CUPS, lpr, LPRng, or others.  These
-    drivers provide high quality printing for UNIX (including
-    Macintosh OS X 10.2 and newer) and Linux systems in many cases
-    equal to or better than proprietary vendor-supplied drivers.
-    Gutenprint also includes an enhanced print plug-in for the GIMP
-    image editor, replacing the Gimp-Print 4.2-based plugin supplied
-    with GIMP 1.2, 2.0, and 2.2, and offering an alternative with
-    additional capabilities to the GtkPrint-based plugin supplied with
-    GIMP 2.4 and beyond.
+    This is Gutenprint version 5.2.1, the first release of Gutenprint
+    5.2.  Gutenprint, formerly named Gimp-Print, is a suite of printer
+    drivers that may be used with most common UNIX print spooling
+    systems, including CUPS, lpr, LPRng, or others.  These drivers
+    provide high quality printing for UNIX (including Macintosh OS X
+    10.3 and newer) and Linux systems in many cases equal to or better
+    than proprietary vendor-supplied drivers.  Gutenprint also
+    includes an enhanced print plug-in for the GIMP image editor,
+    replacing the Gimp-Print 4.2-based plugin supplied with GIMP 1.2,
+    2.0, and 2.2, and offering an alternative with additional
+    capabilities to the GtkPrint-based plugin supplied with GIMP 2.4
+    and beyond.
 
     Gutenprint has been renamed in order to clearly distinguish it
     from GIMP.  While this package started out as the Print plugin for
@@ -36,7 +35,7 @@ I) INTRODUCTION
     information than this README file.  The user's manual contains a
     complete list of supported printers.  In addition, please read the
     release notes (NEWS), as it has information on the latest changes.
-    This package has changed extensively since Gimp-Print 4.2.
+    This package has changed significantly since Gutenprint 5.0.
 
     Gutenprint supports only the printer part of multi-function
     devices (devices that typically include scanning, copying, and fax
@@ -69,8 +68,9 @@ II) INSTALLATION
     administration skills along with superuser privileges.  Superuser
     privilege allows you to perform actions that may be damaging to
     your system.  If you are not comfortable with the material
-    discussed here and in the release notes, we recommend that you not
-    attempt to install this package from source.
+    discussed here and in the release notes, or with performing simple
+    administrative actions, we recommend that you not attempt to
+    install this package from source.
 
     Before beginning, please read the release notes carefully for any
     updates.
@@ -120,7 +120,7 @@ A) OVERVIEW
 	gimp-print-devel@lists.sourceforge.net
 
 	================================================================
-	  Release: gutenprint 5.1.98.1 generated on 12 Apr 2008
+	  Release: gutenprint 5.2.1 generated on 18 Oct 2008
 
 	  Features:
 	    Build CUPS:                                 yes, installing in /usr
@@ -138,15 +138,15 @@ A) OVERVIEW
 	    Build test programs:                        yes
 	    Build testpattern generator:                yes
 
-	Installation summary:
+	  Installation summary:
 	    Installation prefix:                        /usr/local
 	    Data directory:                             /usr/local/share/gutenprint
 	    Library directory:                          /usr/local/lib/gutenprint
-	    XML data directory:                         /usr/local/share/gutenprint/5.1/xml
-	    Module directory:                           /usr/local/lib/gutenprint/5.1/modules
+	    XML data directory:                         /usr/local/share/gutenprint/5.2/xml
+	    Module directory:                           /usr/local/lib/gutenprint/5.2/modules
 	    Install sample images:                      yes
 
-	General configuration:
+	  General configuration:
 	    Compiler options:                           -Disfinite=finite  -O6  -Wall -Wcast-align -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -Wnested-externs -Wwrite-strings -Werror-implicit-function-declaration -Winline -Wformat=2 -finline-limit=131072 -pedantic -Waggregate-return -Wcast-qual -Wshadow -Wredundant-decls
 	    Build static libraries:                     yes
 	    Build shared libraries:                     no
@@ -156,6 +156,7 @@ A) OVERVIEW
 	    Generate debugging symbols:                 no
 	    Use modules:                                static
 	    Use readline libraries:                     yes, extra arguments: -lncurses
+	    uname -a output:                            Linux linuxhome 2.6.25.11-0.1-default #1 SMP 2008-07-13 20:48:28 +0200 x86_64 x86_64 x86_64 GNU/Linux
 	================================================================
 
     The CUPS, GIMP, Foomatic, and Ghostscript components require that
@@ -190,27 +191,10 @@ B) CORE DRIVER LIBRARY
     statically (with no use of shared libraries), you may use the
     option --disable-shared.
 
-    NOTES TO PACKAGERS: 
-
-    * You may wish to create a development package containing header
-      files and linkable libraries separate from the runtime package.
-      There are a few third party applications that link against
-      Gutenprint.
-
-    * Gutenprint permits installation of Gimp-Print 4.2 and Gutenprint
-      5.0 alongside Gutenprint 5.2, and in the future will permit
-      concurrent installation of different stable versions of
-      Gutenprint with different minor version numbers.  Therefore, you
-      should consider allowing Gutenprint 5.0, Gutenprint 5.2, and
-      Gimp-Print 4.2 to be installed concurrently.
-
-    * The core driver library component also includes locale files for
-      the libary and documentation.
-
 
 ----------------
 
-B) CUPS
+C) CUPS
 
     Gutenprint may be used as a driver under CUPS (Common UNIX
     Printing System), if your system uses that spooler.  Full
@@ -237,6 +221,13 @@ B) CUPS
     with your ability to continue using the Gutenprint 5.0 or
     Gimp-Print 4.2 CUPS driver.
 
+    WARNING: The "canon" and "epson" CUPS backends that previously
+    were distributed with Gutenprint are no longer distributed, so you
+    will need to ensure that none of your printer queues use these
+    backends.  Please read the Critical Upgrade Note in the release
+    notes for more information and the procedure for modifying your
+    printer queues.
+
     The Gutenprint CUPS driver consists of the following components:
 
     * The core Gutenprint CUPS driver, rastertogutenprint.5.2.  This
@@ -244,12 +235,9 @@ B) CUPS
       printer-specific data.  This is most commonly installed in
       /usr/lib/cups/filter.
 
-    * Back ends for driving Canon and Epson printers, named "canon"
-      and "epson".  These provide the ability to get information from
-      the printer for CUPS to use, and are normally installed in
-      /usr/lib/cups/backend.  Additional utilities to send certain
-      commands to these printers are installed as commandtocanon and
-      commandtoepson; they are installed in /usr/lib/cups/filter.
+    * Additional utilities to send certain commands to these printers
+      are installed as commandtocanon and commandtoepson; they are
+      installed in /usr/lib/cups/filter.
 
     * One or more sets of PPD files describing all of the printers
       supported by Gutenprint.  These are normally installed in
@@ -265,8 +253,9 @@ B) CUPS
     * A utility to update PPD files from an earlier release of
       Gutenprint, cups-genppdupdate.  This utility may be used to
       update PPD files generated by earlier versions of Gutenprint
-      starting from 4.3.21.  This is normally installed in /usr/sbin.
-      This utility cannot update PPD files from Gimp-Print 4.2.
+      starting from 4.3.21, including any 5.0, 5.1, or 5.2 release or
+      pre-release.  This is normally installed in /usr/sbin.  This
+      utility cannot update PPD files from Gimp-Print 4.2.
 
     * A utility to generate PPD files, cups-genppd.5.2.  Normally this
       is only required when the package is built, and only with CUPS
@@ -280,7 +269,7 @@ B) CUPS
       Gutenprint-supported printers, cups-calibrate.  This is normally
       installed in /usr/bin.
 
-    WARNING: With certain versions of CUPS and in certain non-default
+    WARNING: With certain versions of CUPS and in certain non-standard
 	configurations, if a new version of Gutenprint is installed
 	over an existing version genppd will create PPD files based on
 	the older version of Gutenprint rather than the newer version.
@@ -305,12 +294,17 @@ B) CUPS
 	   vendors typically install Gutenprint in /usr.
 
 	iii) Gutenprint is built dynamically only (--disable-static or
-	   --disable-static-genppd).  This is not a default, and
+	   --disable-static-genppd).  This is not standard, and
 	   requires the explicit --disable-static or
 	   --disable-static-genppd on the Gutenprint "configure"
 	   command line.  Therefore, if you build Gutenprint normally
 	   you should not be vulnerable to this problem.
 
+	iv) Gutenprint is configured to build the PPD files at compile
+	   time.  This is the case when using CUPS 1.1, but is not the
+	   case when using CUPS 1.2 unless you explicitly use
+	   --enable-cups-ppds.
+
 	Note that in general if you install CUPS into a non-standard
 	location, and install Gutenprint into the same location, this
 	problem can surface.  For example, if you choose to install
@@ -358,9 +352,10 @@ B) CUPS
     Following installation of the package with "make install", you
     must restart CUPS to permit CUPS to see the new PPD files.  The
     exact command to restart CUPS varies; it is typically something
-    like /etc/init.d/cups, /etc/software/init.d/cups, /etc/rc.d/cups,
-    /usr/sbin/rccups, or even /etc/rc.d/init.d/cups.  Your system may
-    have a different way to restart the CUPS server.  OS X, for
+    like /etc/init.d/cups restart, /etc/software/init.d/cups restart,
+    /etc/rc.d/cups restart, /usr/sbin/rccups, or even
+    /etc/rc.d/init.d/cups restart.  Your system may have a different
+    way to restart the CUPS server.  OS X (10.3, 10.4, and 10.5), for
     example, uses the following command:
 
     sudo /System/Library/StartupItems/PrintingServices/PrintingServices.sh restart
@@ -368,19 +363,36 @@ B) CUPS
     You may optionally choose to update your existing PPD files using
     the command cups-genppdupdate, after which you should restart CUPS
     as described above.  We strongly recommend use of this update
-    procedure.  This script will automatically update Gutenprint PPD
-    files from earlier versions.  This script will only update PPD
-    files from earlier versions of Gutenprint; it will not update
-    Gimp-Print 4.2 PPD files.  However, you may install Gutenprint 5.2
-    alongside Gimp-Print 4.2, and use both Gimp-Print 4.2 and
-    Gutenprint 5.2 drivers concurrently in separate printer queues.
-    Therefore, you need not convert a workflow based on Gimp-Print 4.2
-    right away, but can gradually convert or even permanently use both
-    drivers for different printer queues.
+    procedure, which is fast and simple.  This script will
+    automatically update Gutenprint PPD files from earlier versions
+    (5.0, 5.1, or 5.2 release or prerelease).  This script will only
+    update PPD files from earlier versions of Gutenprint; it will not
+    update Gimp-Print 4.2 PPD files or PPD files from other drivers.
+    However, you may install Gutenprint 5.2 alongside Gimp-Print 4.2,
+    and use both Gimp-Print 4.2 and Gutenprint 5.2 drivers
+    concurrently in separate printer queues.  Therefore, you need not
+    convert a workflow based on Gimp-Print 4.2 right away, but can
+    gradually convert or even permanently use both drivers for
+    different printer queues.
 
     The following options to configure are available for compiling the
     Gutenprint driver for CUPS:
 
+    --enable-cups-ppds
+
+	With CUPS 1.2, it is possible to arrange for PPD files to be
+	generated when a new printer queue is generated rather than
+	having all pre-generated PPD files in the filesystem.  This
+	saves considerable disk space and avoids the possible build
+	problem described above.  Normally, Gutenprint detects which
+	version of CUPS is in use and configures itself to create the
+	PPD files at build time only when CUPS 1.1 is in use.
+
+	If you wish to generate the PPD files at build time, you may
+	use this option.  If you are running CUPS 1.1, and for some
+	reason do not wish to generate the PPD files, you may use
+	--disable-cups-ppds.
+
     --disable-translated-cups-ppds
 
 	By default, PPD files for all languages available in
@@ -394,6 +406,19 @@ B) CUPS
 	--disable-translated-cups-ppds to avoid having many duplicate
 	PPD files.
 
+    --disable-globalized-cups-ppds
+
+	Starting with Gutenprint 5.2, Gutenprint builds PPD files
+	containing translations for all languages if CUPS 1.2 or above
+	is in use.  This greatly reduces the number of PPD files
+	created or PPD file choices offered.
+
+	If you have problems with the globalized PPD files, you may
+	use this option to generate standard translated PPD files (or
+	English-only, if --disable-translated-cups-ppds is also in
+	use).  This option only has effect if --enable-cups-ppds is
+	used.
+
     --enable-simplified-cups-ppds
 
 	Gutenprint 5.2 offers an option of creating simplified PPD
@@ -433,24 +458,10 @@ B) CUPS
 	this option unless you are certain that you understand the
 	problem and how to work around it.
 
-    NOTES TO PACKAGERS: 
-
-    * We recommend that your installation package run
-      cups-genppdupdate and restart CUPS as part of the installation
-      process.
-
-    * All files and directories with versioned names
-      (e. g. rastertogutenprint and the PPD files) may be installed
-      concurrently with other versions of Gimp-Print and Gutenprint as
-      described above.  Other executables (such as the Canon and Epson
-      back ends, and cups-calibrate) are not versioned, but are not
-      linked against libgutenprint and do not have any other
-      dependencies on Gutenprint.
-
 
 ----------------
 
-C) FOOMATIC
+D) FOOMATIC
 
     Foomatic is a printer meta-driver that can be used with any
     spooler (CUPS, lpd, LPRng, etc.) or even no spooler at all.  It
@@ -465,12 +476,15 @@ C) FOOMATIC
     repository for all printer information; the tools provided on
     those systems will not recognize the CUPS PPD files.  If your
     system uses Foomatic in this way, or does not use CUPS, you should
-    use Foomatic to manage your printers.
+    use Foomatic to manage your printers.  If you are using CUPS,
+    however, we strongly recommend using the CUPS driver described in
+    the previous section in preference to Foomatic.
 
     The Gutenprint driver for Foomatic requires Foomatic 2.0 or
     higher; Foomatic 3.0 or above is highly recommended.  It also
     requires GNU Ghostscript 6.53 or newer, AFPL Ghostscript 7.04 or
-    newer, or ESP Ghostscript 7.05 or newer for IJS support.
+    newer, or ESP Ghostscript 7.05 or newer for IJS support.  We
+    recommend Ghostscript 8 or above.
 
     The Foomatic support in Gutenprint consists of a data generator
     and an IJS-based Ghostscript driver.  It is possible to use the
@@ -484,21 +498,17 @@ C) FOOMATIC
     The Ghostscript driver in Gutenprint 5.2 is based on the IJS
     protocol.  IJS is a protocol originally developed by
     Hewlett-Packard to allow new drivers to be used with Ghostscript
-    without having to be compiled into Ghostscript.  As this driver
-    runs in a separate process, and IJS is licensed in a way
-    compatible with the GPL, this driver may be used with AFPL
-    Ghostscript if desired.  We no longer offer the legacy "stp"
-    driver provided in Gimp-Print 4.2.  This driver was difficult to
-    maintain and required a complex procedure to integrate with
-    Ghostscript.
+    without having to be compiled into Ghostscript.
 
     Gutenprint 5.2 offers two Foomatic drivers, one supporting the
     full range of options and the other supporting simplified options,
     as describe above under CUPS.  The full-featured driver is named
     "gutenprint-ijs.5.2"; the simplified driver is named
-    "gutenprint-ijs-simplified.5.2".  This allows Gutenprint 5.2 to
-    coexist with Gimp-Print 4.2; both drivers may be installed and
-    used (on separate printer queues, of course) on the same system.
+    "gutenprint-ijs-simplified.5.2".
+
+    Gutenprint 5.2 may coexist with Gimp-Print 4.2; both drivers may
+    be installed and used (on separate printer queues, of course) on
+    the same system.
 
     Normally, the Gutenprint configure script will automatically
     detect the presence of Foomatic and Ghostscript on your system.
@@ -530,14 +540,12 @@ C) FOOMATIC
 
 ----------------
 
-D) GIMP
+E) GIMP
 
-    Gutenprint may be used with an enhanced Print plug-in for GIMP
-    (2.0 and above), providing the ability to print images.  Please
-    read the release notes in addition to this README, as there have
-    been some changes in procedure since Gimp-Print 4.2 if you are
-    using certain versions of GIMP.  Gutenprint 5.2 no longer supports
-    GIMP 1.2.
+    Gutenprint may be used as an enhanced Print plug-in for GIMP (2.0
+    and above), providing the ability to print images.  Please read
+    the release notes in addition to this README.  Gutenprint 5.2 no
+    longer supports GIMP 1.2.
 
     The enhanced Print plugin for GIMP replaces the Gimp-Print
     4.2-based plugin provided with GIMP 2.0 and 2.2.  As of the GIMP
@@ -550,7 +558,7 @@ D) GIMP
 
     If your system separates development packages from runtime
     packages, you will typically have to install development packages
-    for GIMP itself, in addition to GTK and glib.  With GIMP 2.x and
+    for GIMP itself, in addition to Gtk and Glib.  With GIMP 2.x and
     GTK 2.x, additional packages may be required.
 
     Normally, the Gutenprint configure script detects which version,
@@ -565,24 +573,17 @@ D) GIMP
 
     ./configure --enable-user-install
 
-    It is not possible for Gimp-Print 4.2 and Gutenprint 5.2 (or any
-    future release) to coexist in the same installation of GIMP.  The
-    Gutenprint 5.2-based plugin can read settings from previous
-    versions of Gimp-Print, but the configuration file format in
-    Gutenprint 5.2 cannot be read by older versions of Gimp-Print.
-
-    NOTE TO PACKAGERS:
-
-    * The enhanced GIMP plugin, unlike the core library and the
-      Foomatic and CUPS drivers, may not be installed concurrently
-      with other versions.  For example, you may not install both the
-      Gimp-Print 4.2 and the Gutenprint 5.2 version of the Print
-      plugin, as they use different configuration file formats.
+    It is not possible for Gimp-Print 4.2, Gutenprint 5.0, and
+    Gutenprint 5.2 (or any future release) to coexist in the same
+    installation of GIMP.  The Gutenprint 5.2-based plugin can read
+    settings from previous versions of Gimp-Print, but the
+    configuration file format in Gutenprint 5.2 cannot be read by
+    older versions of Gimp-Print or Gutenprint.
 
 
 ----------------
 
-E) ESCPUTIL
+F) ESCPUTIL
 
     "escputil" is a command line utility for administering Epson
     inkjet printers.  It performs head alignment, retrieval of ink
@@ -598,12 +599,6 @@ E) ESCPUTIL
     notes.  If you do not wish to use readline, you may use
     --without-readline.
 
-    Unlike the case in Gimp-Print 4.2, this utility is not standalone;
-    it requires the installation of the core Gutenprint package to
-    function.  This allows it to support new printers without
-    modification.
-
-
 
 ================================================================
 
@@ -633,10 +628,10 @@ A) PRINTER INSTALLATION
     driver, so you may find more than one PPD file for your printer.
     Gutenprint PPD files are described as
 
-    Epson Stylus Photo R300 Foomatic/gutenprint-ijs.5.2
-    Epson Stylus Photo R300 Foomatic/gutenprint-ijs-simplified.5.2
     Epson Stylus Photo R300 - CUPS+Gutenprint v5.2.0
     Epson Stylus Photo R300 - CUPS+Gutenprint v5.2.0 Simplified
+    Epson Stylus Photo R300 Foomatic/gutenprint-ijs.5.2
+    Epson Stylus Photo R300 Foomatic/gutenprint-ijs-simplified.5.2
 
     The "simplified" PPD files offer a basic set of options only, for
     selecting printer options, standard paper sizes, and basic quality
@@ -648,7 +643,10 @@ A) PRINTER INSTALLATION
     CUPS+Gutenprint and Foomatic/gutenprint-ijs PPD files.  While
     either kind of PPD file will work, we recommend using the
     CUPS+Gutenprint PPD files.  These PPD files can be automatically
-    updated with cups-genppdupdate.
+    updated with cups-genppdupdate when you later upgrade your
+    Gutenprint installation.  Some systems mark the Foomatic PPD files
+    as "(recommended)"; we nevertheless recommend using the
+    CUPS+Gutenprint PPD files.
 
     Other PPD files are described differently, such as
 
@@ -660,18 +658,18 @@ A) PRINTER INSTALLATION
     NOTES FOR CUPS USERS:
 
     If you do not choose to automatically update existing PPD files,
-    you should reinstall any printers that you are using Gutenprint
-    PPD files with.  The Gutenprint driver and the PPD files must be
-    kept in sync, since the PPD files reflect the particular version
-    of the driver that they were built against.  If you attempt to use
-    a version of Gutenprint with PPD files not built for that precise
-    version, the driver will fail with a diagnostic error message.
-    For example, PPD files built for Gutenprint 5.0.0-beta4 will not
-    work with driver version 5.0.0.  You can identify printers using
-    Gutenprint PPD files by the name of the PPD file, which will be
-    something like:
-
-		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.2.0(en)
+    you should reinstall any printer queues that you are using
+    Gutenprint PPD files with.  The Gutenprint driver and the PPD
+    files must be kept in sync, since the PPD files reflect the
+    particular version of the driver that they were built against.  If
+    you attempt to use a version of Gutenprint with PPD files not
+    built for that precise version, the driver will fail with a
+    diagnostic error message.  For example, PPD files built for
+    Gutenprint 5.2.0-beta4 will not work with driver version 5.2.1.
+    You can identify printers using Gutenprint PPD files by the name
+    of the PPD file, which will be something like:
+
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.2.1(en)
 
     Linux users please note: If you are using CUPS 1.1.11 or higher,
     and you have a USB-connected printer, you must have a printer
@@ -726,7 +724,8 @@ IV) SOLVING PROBLEMS
        may be located elsewhere on some systems) for lines starting
        with 'E' (these lines indicate errors).  Also search for log
        information produced by Gutenprint; all such output lines will
-       have "Gutenprint".  These lines may help you solve the problem.
+       contain "Gutenprint".  These lines may help you solve the
+       problem and will help us investigate your problem if necessary.
 
     6) If you are using CUPS, enable debugging output.  This can be
        done by editing /etc/cups/cupsd.conf (which must be done as