Imported Upstream version 4.3.99+cvs20050702

1 files changed, 283 insertions, 258 deletions

diff --git a/README b/README
index 2635ec8..9f3f63c 100644
--- a/README
+++ b/README
@@ -1,31 +1,39 @@
 INTRODUCTION
 
-    This is Gimp-Print version 4.2.7, a stable release in the 4.2
-    series.  This is expected to be the final release in the 4.2
-    series unless a critical bug is identified or there are further
-    delays in 5.0.  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, and can be used for many of the most
-    demanding printing tasks.  A complete list of supported printers
-    may be found in the NEWS file.
-
-    This release is backward compatible with other releases of
-    Gimp-Print 4.2 (4.2.0, 4.2.1, 4.2.2, 4.2.3, 4.2.4, 4.2.5, and
-    4.2.6).
-
-    Gimp-Print also includes a plug-in for the GIMP image editor.
+    This is Gutenprint version 5.0.0 beta 4, the fourth beta
+    prerelease of Gutenprint 5.0.  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, and can be used for many of the most demanding printing
+    tasks.  A complete list of supported printers may be found in the
+    NEWS file.
+
+    The package has been renamed in order to clearly distinguish it
+    from the GIMP.  While this package started out as the Print plugin
+    for the GIMP, it has expanded into a collection of general purpose
+    printer drivers, and the Print plugin for the GIMP is now only a
+    small (but important) piece of the package.  Furthermore, the name
+    Gutenprint recognizes Johannes Gutenberg, the inventor of the
+    movable type printing press.  Finally, the word "guten" means
+    "good" in German.
+
+    Gutenprint also includes a plug-in for the GIMP image editor.
     This plug-in is also distributed with the GIMP.
 
+    Gutenprint was previously known as Gimp-Print.  The name was
+    changed prior to the 5.0.0 release.
+
     Please read this README, and the NEWS file carefully!  Many things
     have changed from previous releases.  The package is quite
-    different in many ways from Gimp-Print 4.0, and you should read
-    these instructions carefully.
+    different in many ways from Gimp-Print 4.2, and you should read
+    these instructions carefully.  In addition, the NEWS file contains
+    specific software requirements.
 
     A user's manual exists in doc/users_guide; it is normally
-    installed in PDF and HTML form in /usr/local/share/gimp-print/doc.
+    installed in PDF and HTML form in /usr/local/share/gutenprint/doc.
     This manual covers setup and use of the GIMP Print plug-in and the
     CUPS driver.
 
@@ -33,64 +41,30 @@ INTRODUCTION
     KNOWN BUILD ISSUES section below.
 
 
-MACINTOSH OS X NOTE
-
-    As of Gimp-Print 4.2.2, this package fully supports Macintosh OS X
-    10.2.  OS X uses CUPS (Common UNIX Printing System) to provide
-    printing services; Gimp-Print works with CUPS to permit high
-    quality, full-featured printing to a wide variety of printers.
-
-    This package requires Macintosh OS X 10.2 or later; it will not
-    work with any 10.0 or 10.1 release (including 10.1.5), or any
-    Macintosh OS prior to OS X.
-
-    We strongly recommend that Macintosh users download the
-    precompiled installer package from
-    http://gimp-print.sourceforge.net/MacOSX.php3 rather than attempt
-    to build this package from source, as using the installer is much
-    simpler.
-
-    We further recommend that Macintosh OS X users install ESP
-    GhostScript, to permit printing from applications (such as most
-    Adobe applications) that generate PostScript rather than PDF
-    output.  NOTE THAT WITHOUT THIS PACKAGE, YOU WILL NOT BE ABLE TO
-    PRINT FROM ANY CARBON APPLICATIONS (in particular, many Adobe
-    applications)!  Directions for that are also available at
-    http://gimp-print.sourceforge.net/MacOSX.php3.
-
-    Users installing these packages do not need any additional
-    software packages.
-
-    Please read the release notes (the NEWS file) for information on
-    bugs fixed, new features, supported printers, and any specific
-    information related to your printer.
-
-
 BASIC INSTALLATION
 
-    Gimp-Print includes the following primary components:
+    Gutenprint includes the following primary components:
 
-      - The core driver, libgimpprint.so
+      - The core driver, libgutenprint.so
       - A user's manual
       - A Print plug-in for the GIMP
       - A CUPS (Common UNIX Printing System) driver
-      - A standard Ghostscript driver, `stp'
       - An IJS-based Ghostscript driver
       - Support for the Foomatic spooler configuration system
       - A utility to administer Epson printers, escputil
 
-    By default, Gimp-Print builds the Print plugin for the GIMP, the
+    By default, Gutenprint builds the Print plugin for the GIMP, the
     user's manual, and a utility to perform head cleaning, nozzle
     alignment, and other tasks on EPSON Stylus inkjet printers, named
     "escputil".  Directions for building other components are listed
     below.
 
-    Please check our web site at http://gimp-print.sourceforge.net for
-    details about what is and is not supported.
+    Please check our web site at http://gutenprint.org for details
+    about what is and is not supported.
 
     Please report any problems to gimp-print-devel@sourceforge.net.
 
-    In general, to build Gimp-Print, you run the following commands:
+    In general, to build Gutenprint, you run the following commands:
 
     ./configure [options]
     make
@@ -99,10 +73,17 @@ BASIC INSTALLATION
     If you do not have the GIMP installed (or if you have only the
     user package installed, and not the development package that most
     distributions include separately), the attempt to run configure
-    will fail.  To build other components (such as the IJS or CUPS
-    drivers) without the GIMP being present, you must use the
+    will fail.  To build other components (such as the Ghostscript or
+    CUPS drivers) without the GIMP being present, you must use the
     --without-gimp option to configure.
 
+    By default dynamically loadable modules (plug-ins) will be built,
+    and loaded at run-time if your operating system supports it.  If
+    you experience problems, --with-modules=dlopen or
+    --with-modules=ltdl may be used to select the module loading
+    method (dlopen is the default, but GNU libltdl is more portable),
+    or --with-modules=static or --without-modules disables them.
+
     Note: This package requires the use of GNU Make to compile.  On
     systems with both GNU make and another make installed, GNU make
     may be named `gmake' or `gnumake'.  BSD users in particular will
@@ -111,23 +92,26 @@ BASIC INSTALLATION
 
 THE GIMP
 
-    Gimp-Print may be used as a plug-in for the GIMP, providing the
+    Gutenprint may be used as a plug-in for the GIMP, providing the
     ability to print images.  If you wish to do so, you must use the
-    GIMP 1.2; it is not compatible with the GIMP 1.3 or 2.0.  Please
-    read the release notes in addition to this README, as there have
-    been some changes in procedure since Gimp-Print 4.2.6 if you are
-    using certain versions of the GIMP.
+    GIMP 1.2.3 or above on the 1.2 line, or the GIMP 2.0 or 2.1.
+    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 the GIMP.
 
-    To build and install the Gimp Print plug-in:
+    To build and install the GIMP Print plug-in for the GIMP 1.2:
 
     ./configure [--with-gimp]
     make
     make install
 
-    You may optionally specify --with-gimp if you wish to be explicit
-    about building the Gimp Print plugin; --with-gimp is implied if
-    `configure' detects that the GIMP is installed, so you do not
-    actually need to specify it.
+    For the GIMP 2.0 or 2.1, the option "--with-gimp2" rather than
+    "--with-gimp" should be used.
+
+    You may optionally specify --with-gimp or --with-gimp2 if you wish
+    to be explicit about building the GIMP Print plugin; --with-gimp
+    is implied if `configure' detects that the GIMP is installed, so
+    you do not actually need to specify it.
 
     This installs the GIMP Print plugin in your system plug-in
     directory.  If you wish to install it in your personal plugin
@@ -135,29 +119,37 @@ THE GIMP
 
     ./configure --enable-user-install
 
-    If you have installed the Gimp as a precompiled package
+    If you have installed the GIMP as a precompiled package
     (e. g. from an RPM), you will need to install the gimp-devel
     (sometimes called gimp-developer, or something similar) package as
-    well as the gimp package.  The gimp package as supplied in most
-    distributions only contains what's needed to run the Gimp, not the
+    well as the gimp package.  The GIMP package as supplied in most
+    distributions only contains what's needed to run the GIMP, not the
     additional files needed to build GIMP-based applications and
     plugins such as the Print plugin.  On some systems, you will also
     need to install gtk-devel and glib-devel packages as well.
 
-    If you have installed the Gimp from source on Linux: after running
+    If you have installed the GIMP from source on Linux: after running
     make install, you must run ldconfig as root before attempting to
     build this plugin.
 
+    The GIMP 1.2 will not be supported in Gutenprint 5.1 and beyond.
+    However, all Gutenprint 5.0 releases will support The GIMP 1.2.
+
+    The GIMP 2.0 plugin will eventually be migrated to The GIMP
+    project for The GIMP 2.2 release.  It may be removed from the
+    Gutenprint distribution following Gutenprint 5.0, and it may not
+    support releases of The GIMP other than 2.0 in the Gutenprint 5.0
+    release.
+
 
 CUPS
 
-    Gimp-print may be used as a driver under CUPS (Common UNIX
+    Gutenprint may be used as a driver under CUPS (Common UNIX
     Printing System), if your system uses that spooler.  Full
     description of CUPS is beyond the scope of this README file; full
-    information may be found at http://www.cups.org.  Gimp-print 4.2
-    requires CUPS 1.1.9 or higher.  We recommend use of 1.1.14 or
-    above; that release of CUPS features better internationalization
-    and fixes some important bugs.
+    information may be found at http://www.cups.org.  Gutenprint 5.0
+    requires CUPS 1.1.9 or higher.  We recommend use of 1.1.15 or
+    above; that release of CUPS fixes some important bugs.
 
     This package includes a CUPS driver that may be built, allowing
     use of this software for general printing purposes.  To build and
@@ -185,14 +177,14 @@ CUPS
     printer), as described below.
 
     Following this, you must reinstall any printers that you are using
-    Gimp-Print PPD's with.  Such printers may be identified in any
+    Gutenprint PPD's with.  Such printers may be identified in any
     CUPS front end (e. g. KUPS, or via the web interface) because they
     look something like this:
 
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(en)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(en)
 
-    If the version number (in this case, 4.2.7) does not match
-    the version of Gimp-Print that you are installing, you must use
+    If the version number (in this case, 5.0.0-beta4) does not match
+    the version of Gutenprint that you are installing, you must use
     Modify Printer to force the new PPD file to get installed.
     Failure to do so may lead to incorrect output and/or other errors!
 
@@ -222,15 +214,15 @@ E [21/Nov/2001:17:59:07 +0500] add_printer: bad device-uri attribute 'usb:/dev/u
     apparent when you use a CUPS front end to select a PPD file and
     you see something like this:
 
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(en)
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(en)
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(en)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(en)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(en)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(en)
 
     rather than this:
 
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(en)
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(sv)
-		    EPSON Stylus Photo EX, CUPS+GIMP-print v4.2.7(fr)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(en)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(sv)
+		    EPSON Stylus Photo EX - CUPS+Gutenprint v5.0.0-beta4(fr)
 
     you may wish to turn off the translation of PPD files:
 
@@ -268,28 +260,37 @@ E [21/Nov/2001:17:59:07 +0500] add_printer: bad device-uri attribute 'usb:/dev/u
 
     We recommend that all users who wish to use this package for
     general purpose printing install either CUPS or use Foomatic with
-    the IJS driver (both described below) and use that as their
-    printing system, rather than the traditional lpd or lp systems.
-    It is much simpler to manage than lpd, and provides an excellent
-    web-based interface for both administration and use.  Please visit
-    http://www.cups.org for information on downloading and installing
-    CUPS.
+    the Ghostscript driver (both described below) and use that as
+    their printing system, rather than the traditional lpd or lp
+    systems.  It is much simpler to manage than lpd, and provides an
+    excellent web-based interface for both administration and use.
+    Please visit http://www.cups.org for information on downloading
+    and installing CUPS.
 
 
 FOOMATIC
 
-    Gimp-Print includes support for the Foomatic meta-driver package.
+    Gutenprint includes support for the Foomatic meta-driver package.
     This requires the foomatic-xml distribution.  Foomatic is
     available from http://www.linuxprinting.org/foomatic.html.  It is
     also available in Debian unstable.  For best results, use the
     version in cvs.  The first version of Foomatic (the one used with
-    Gimp-Print 4.0) is not compatible with Gimp-Print 4.2.  Note that
-    the Foomatic driver is named `stp' in Gimp-Print 4.0; in
-    Gimp-Print 4.2 it is named `gimp-print' for the Ghostscript
-    ("stp") driver and "gimp-print-ijs" for the IJS driver. The data
-    for the Gimp-Print 4.0 driver is not compatible with the 4.2
+    Gimp-Print 4.0) is not compatible with Gutenprint 5.0.  Note that
+    the Foomatic driver was named `stp' in Gimp-Print 4.0; in
+    Gimp-Print 4.2 (and early 4.3) it was named `gimp-print' for the
+    Ghostscript ("stp") driver and "gimp-print-ijs" for the IJS
+    driver.  In 5.0 only the "gutenprint-ijs" data is present.  The
+    data for the Gimp-Print 4.2 driver is not compatible with the 5.0
     driver.
 
+    Furthermore, as of Gutenprint 5.0 the Foomatic driver will include
+    the release version of Gutenprint in its name.  Therefore, the
+    Foomatic name for this driver is "gutenprint-ijs.5.0".
+
+    Foomatic data generation has been fixed as of Gutenprint
+    5.0.0-beta4, and is now an appropriate solution for queue
+    configuration.
+
     To verify that you have an appropriate version of Foomatic, please
     run
 
@@ -299,56 +300,44 @@ FOOMATIC
 
     /usr/local/sbin/foomatic-kitload (if /usr/local/sbin is not on your PATH).
 
-    Both Foomatic 2.0.x (stable branch) and 2.9.x (development branch,
-    approaching Foomatic 3.0.x) are supported. With Foomatic 2.9.x there
-    are the extra features of heaving an additional "PrintoutMode" option
-    with pre-configurations for common printing tasks and the options
-    being put into different groups ("General", "PrintoutMode",
+    Both Foomatic 2.0.x (old stable branch) and 3.0 (current stable
+    branch) are supported.  With Foomatic 3.0 there are the extra
+    features of heaving an additional "PrintoutMode" option with
+    pre-configurations for common printing tasks and the options being
+    put into different groups ("General", "PrintoutMode",
     "Adjustment").
 
     If you don't have Foomatic installed, or the version that is
-    installed is too old, please download the current Foomatic 2.0.x 
+    installed is too old, please download the current Foomatic 3.0x
     package from
 
     http://www.linuxprinting.org/download/foomatic/foomatic-current.tar.gz
 
     and follow the instructions in that package. See
 
-    http://www.linuxprinting.org/foomatic2.9/foomatic.html
-
-    on how to download and install Foomatic 2.9.x.
-
     After Foomatic is installed, build the Foomatic data as follows:
 
     ./configure --with-foomatic
     make
     make install
 
-    for obtaining the Foomatic data only for the Ghostscript ("stp")
-    driver or
-
-    ./configure --with-ijs --with-foomatic
-    make
-    make install
-
-    for obtaining the Foomatic data for both the Ghostscript ("stp")
-    driver and the IJS driver (note that this also build the IJS
-    interface itself, so you have to follow the instructions in
-    src/ghost/README, too).
-
     The "make install" step will add the necessary data to your
     Foomatic installation.  It must be run as root.  It will fail if
     Foomatic is not installed or your Foomatic is too old.  Now you
     can either set up a queue for your printer with
     "foomatic-configure" (see USAGE file in the Foomatic package) or
-    generate the printer description file for your spooler (with 
+    generate the printer description file for your spooler (with
     "foomatic-datafile") and configure your printer as described on
     the spooler-specific web pages of linuxprinting.org.
 
+    IMPORTANT: Whenever you install a new version of Gutenprint you
+    must re-create the printer queues using Gutenprint with Foomatic
+    (these queues have a driver name of "gutenprint-ijs.5.0").
+
     Note that it almost never makes sense to build the Foomatic driver
-    without also building the Ghostscript driver or the IJS driver, 
-    even if Foomatic is to be used with CUPS (CUPS-O-Matic).  Please 
-    read the instructions below in the GHOSTSCRIPT section.
+    without also building the Ghostscript driver, even if Foomatic is
+    to be used with CUPS (CUPS-O-Matic).  Please read the instructions
+    below in the GHOSTSCRIPT section.
 
     If you do not wish to build the Gimp Print plugin, you must run
 
@@ -356,7 +345,7 @@ FOOMATIC
 
     or
 
-    ./configure --with-ijs --with-foomatic --without-gimp
+    ./configure --with-ghostscript --with-foomatic --without-gimp
 
     Please visit http://www.linuxprinting.org/foomatic.html for more
     information on Foomatic.
@@ -368,45 +357,7 @@ FOOMATIC
 
 GHOSTSCRIPT
 
-    Gimp-Print 4.2 includes a Ghostscript driver that may be built,
-    allowing use of this software for general printing purposes.  This
-    package requires GNU Ghostscript 5.10, 5.50, 6.51, or 6.52.  There
-    is a simpler build procedure for GNU Ghostscript 6.53 and 7.05,
-    and for ESP Ghostscript 7.05.  In particular, versions of
-    Ghostscript that are not licensed under the GNU General Public
-    License (GPL) are not supported, and this driver may not be
-    distributed with such a version.  If you wish to use Gimp-Print
-    with AFPL Ghostscript, you may do so via the IJS-based driver,
-    described below.
-
-    Please read src/ghost/README for more information, including how
-    to build and install it, and available options; the build
-    procedure here merely creates the necessary source files that you
-    must add to your Ghostscript source.  The directions vary for
-    different versions of Ghostscript.
-
-    We *strongly* recommend that end users not attempt to use this
-    driver directly.  The available options are very complex, and the
-    standard printer configuration tools (such as apsfilter and
-    magicfilter) are not designed for drivers such as Gimp-print, and
-    do not provide a convenient interface to the driver's
-    capabilities.  We recommend that end users either install CUPS, as
-    described above, or use Foomatic to configure printer queues.
-    CUPS is very easy to install, configure, and use, and is the
-    recommended solution.
-
-    Note that many of the options to the Ghostscript driver are
-    incompatible with the options used prior to release 4.2.0.
-    Please read src/ghost/README for information on the current
-    options.
-
-    This driver will not be developed beyond the 4.2 release series.
-    It will be replaced by the IJS driver, described below.
-
-
-IJS
-
-    Gimp-Print includes an IJS-based Ghostscript driver.  As
+    Gutenprint includes an IJS-based Ghostscript driver.  As
     paraphrased from the Ghostscript documentation, IJS is a
     relatively new initiative to improve the quality and ease of use
     of inkjet printing with Ghostscript.  Using IJS, one can add new
@@ -417,18 +368,32 @@ IJS
     driver runs in a separate process from Ghostscript itself, the IJS
     driver may be used with AFPL Ghostscript (7.04 and above).
 
-    The basic way to build the IJS driver is
+    The basic way to build the Ghostscript driver is
 
-    ./configure --with-ijs [--without-gimp]
+    ./configure --with-ghostscript [--without-gimp]
     make
     make install
 
     You must have the IJS libraries installed for this to work.
     Instructions for that are included with GNU Ghostscript 6.53 and
-    beyond, and AFPL Ghostscript 7.04 and beyond.
-
-    Detailed instructions for building and using the IJS driver is
-    described in src/ghost/README.
+    beyond, AFPL Ghostscript 7.04 and beyond, and ESP Ghostscript 7.05
+    and beyond.
+
+    We strongly recommend that end users not use this driver directly.
+    The available options are very complex, and the standard printer
+    configuration tools (such as apsfilter and magicfilter) do not
+    provide a convenient interface to the driver's capabilities.  We
+    recommend that end users either install CUPS, as described above,
+    or use Foomatic to configure printer queues.  We recommend using
+    CUPS with the native CUPS drivers described above.  We recommend
+    using Foomatic to configure printer queues if you do not use CUPS
+    (e. g. you use LPRng, System V print spooling, or Berkeley print
+    spooling).
+
+    Gutenprint 5.0 no longer provides the monolithic "stp" driver
+    present in 4.2.  This driver, which was linked directly into
+    Ghostscript, was very difficult to maintain and required a complex
+    integration procedure.
 
 
 RECOMMENDED SETTINGS
@@ -446,7 +411,9 @@ RECOMMENDED SETTINGS
 
     On most inkjet printers, 600 or 720 dpi will produce very high
     quality; 1200x1200 or 1440x720 dpi will produce extremely high
-    quality.
+    quality.  On newer printers with very small drops, higher
+    resolutions such as 2880x1440 DPI may be required to achieve the
+    highest quality.
 
 
 SUPPORT
@@ -472,7 +439,22 @@ SUPPORT
        mailing list.  This is recommended as a last resort only.
 
 
-KNOWN BUILD ISSUES
+KNOWN BUILD/INSTALLATION ISSUES
+
+    This section describes a number of issues that have been
+    encountered while building or installing Gutenprint.  If any of
+    these apply to you, please read the notes carefully.  The issues
+    are:
+
+    1) Building escputil may fail, or escputil may fail to run.
+
+    2) CUPS PPD files may not be translated (there may be multiple
+       versions of the PPD files, all in English).
+
+    3) Build/installation of Foomatic data may happen correctly, but
+       the generated PPD files do not work correctly.
+
+    Detailed descriptions of these issues follow.
 
     * There is a known complication building "escputil" that causes
       problems on some systems.  "escputil" uses the "readline"
@@ -620,12 +602,12 @@ KNOWN BUILD ISSUES
       variable, LANGUAGE, which unconditionally looks up translations
       according to the language, ignoring LANG and the LC_*
       environment variables that are normally used for translation.
-      This library is included with the Gimp-Print tarball, but it is
-      not used unless --with-included-gettext is specified on the
-      configure command line.  This is because many systems provide
-      translation machinery in their standard libraries, and it may
-      not always be best to use foreign libraries to replace standard
-      system functionality.
+      This library is no longer included with Gutenprint
+      (--with-included-gettext will not work).  Install the GNU
+      gettext package first if you need libintl.a.  Many systems
+      provide translation machinery in their standard libraries, and
+      it may not always be best to use foreign libraries to replace
+      standard system functionality.
 
       We have chosen to use LANGUAGE for this purpose, as the GNU
       gettext library appears to offer the most reliable translation,
@@ -651,11 +633,10 @@ KNOWN BUILD ISSUES
       than translated into the appropriate languages, we suggest the
       following:
 
-      1) Use --with-included-gettext to use the GNU gettext.  If your
-         system is not based on GNU libc (Linux usually is based on
-         GNU libc; BSD, Solaris, IRIX, etc. are not), you will need
-         this option to have any possibility of creating the
-         translated PPD files.
+      1) Install GNU gettext (libintl).  If your system is not based
+         on GNU libc (Linux usually is based on GNU libc; BSD,
+         Solaris, IRIX, etc. are not), you will need this to have any
+         possibility of creating the translated PPD files.
 
       2) Run 'make install' to install the package (including the
          message catalogs) onto the system first, and then do the
@@ -681,56 +662,118 @@ KNOWN BUILD ISSUES
 
       Please feel free to contact us about this issue.
 
+    * There are multiple issues that one must be aware of when using
+      Foomatic with Gutenprint.
+
+      1) Before installing Gutenprint 5.0.0-beta4, you must manually
+	 remove any existing Foomatic option files.  This is because the
+	 Foomatic utility to load data kits (foomatic-kitload) does not
+	 remove obsolete data files from the Foomatic database.  If you
+	 do not do this, any PPD files you generate will be incorrect
+	 and printing may work incorrectly or not at all.
+
+	 Foomatic option files are usually located in 
+
+	 /usr/local/share/foomatic/db/source/opt
+
+	 or
+
+	 /usr/share/foomatic/db/source/opt
+
+	 Assuming they're in the former location, you must remove data
+	 files associated with the Gutenprint driver.  The command to do
+	 this, which must be run as the superuser (root) is
+
+	 cd /usr/local/share/foomatic/db/source/opt
+	 ls -l gutenprint-ijs*.xml
+
+	 If there are existing files present, you must remove them:
+
+	 rm -f gutenprint-ijs*.xml
+
+	 Now check to make sure that they are gone:
+
+	 ls -l gutenprint-ijs*.xml
+
+	 CAUTION: Be very careful when typing this command!  Minor
+	 errors in typing these commands may result in severe damage to
+	 your system.
+
+	 After this, you may run 'make install' in your Gutenprint
+	 source directory to install the package.  You will then need to
+	 re-create any printer queues using Foomatic.
+
+	 In general, you will have to perform this procedure any time
+	 you install a new version of Gutenprint.
+
+	 Please check the Foomatic site
+	 (http://www.linuxprinting.org/foomatic.html) and the Gutenprint
+	 site (http://gimp-print.sourceforge.net) for updated
+	 instructions about this.
+
+      2) Unlike with the CUPS native driver, there is no simple way to
+	 update all PPD files when you install a new version of
+	 Gutenprint.  You must either use the foomatic-ppdfile command
+	 to upgrade PPD files individually, or foomatic-compiledb to
+	 build all PPD files.
+
+         From this point forward, the Foomatic data will be version
+	 locked to the Gutenprint release installed on the system.  For
+	 example, PPD files generated with the Foomatic data for this
+	 release will not work with the ijsgutenprint in the next
+	 release.  This is to prevent accidentally using incorrect
+	 data, which could cause incorrect function to take place.
+
 
 PACKAGING
 
-    We recommend that packagers and distributors of Gimp-print use the
+    We recommend that packagers and distributors of Gutenprint use the
     following settings to build the package:
 
     --with-foomatic
-    --with-ijs  (distros with GhostScript 6.53 or newer)
+    --with-ghostscript
     --with-user-guide
     --with-samples
     --with-escputil
 
     We suggest the following packaging:
 
-    * A gimp-print core package should contain the following.  You may
+    * A Gutenprint core package should contain the following.  You may
       wish to install the user's guide only in certain formats.
 
-      /usr/lib/libgimpprint.so.1.0 (the core shared library)
+      /usr/lib/libgutenprint.so.2.x.y (the core shared library)
       /usr/bin/escputil (Epson Stylus utility)
-      /usr/bin/ijsgimpprint (GIMP-Print IJS plug-in driver)
-      /usr/share/gimp-print/doc/html (HTML documentation)
-      /usr/share/gimp-print/doc/users-guide.pdf
-      /usr/share/gimp-print/doc/users-guide.ps
-      /usr/share/locale/*/LC_MESSAGES/gimp-print.mo
+      /usr/bin/ijsgutenprint.5.0 (Gutenprint Ghostscript IJS plug-in driver)
+      /usr/share/gutenprint/doc/html (HTML documentation)
+      /usr/share/gutenprint/doc/users-guide.pdf
+      /usr/share/gutenprint/doc/users-guide.ps
+      /usr/share/locale/*/LC_MESSAGES/gutenprint.mo
 
-    * A gimp-print-devel package (for developers) should contain the
+    * A gutenprint-devel package (for developers) should contain the
       following.  Again, you may wish to install the programmer's
       manual only in certain formats.
 
-      /usr/include/gimp-print
-      /usr/bin/gimpprint-config
-      /usr/share/gimp-print/doc/manual-html
-      /usr/share/gimp-print/doc/gimpprint.ps
-      /usr/share/aclocal/gimpprint.m4
-      /usr/lib/libgimpprint.a
-      /usr/lib/libgimpprint.so
+      /usr/include/gutenprint
+      /usr/bin/gutenprint-config
+      /usr/share/gutenprint/doc/manual-html
+      /usr/share/gutenprint/doc/gutenprint.ps
+      /usr/share/aclocal/gutenprint.m4
+      /usr/lib/libgutenprint.a
+      /usr/lib/libgutenprint.so
 
       You may wish to include the test pattern generator source and
       the sample test pattern in this package, and you may wish to
       include test patterns of your own.  You may also wish to include
       the various unprint programs and the parse-* scripts from the
       test directory, although these are typically of more use to
-      developers of the Gimp-Print package per se than developers of
-      applications layered on Gimp-Print.  However, the test programs
+      developers of the Gutenprint package per se than developers of
+      applications layered on Gutenprint.  However, the test programs
       have received less testing than the others, and are known to
       have some limitations that are not documented.
 
-    * A gimp-print-extras package should contain
+    * A gutenprint-extras package should contain
 
-      /usr/share/gimp-print/samples
+      /usr/share/gutenprint/samples
 
       You may wish to include the test pattern generator and the
       sample test pattern from src/testpattern if you don't include it
@@ -738,20 +781,16 @@ PACKAGING
       test/bjc-unprint; test/parse-escp2; and test/parse-bjc in this
       package.
 
-    * Ghostscript should be built with the stp driver using either the
-      "new" instructions (requiring only gdevstp.c, and linking
-      dynamically against libgimpprint) for Ghostscript 6.52 or
-      earlier, or the IJS driver for Ghostscript 6.53 or newer.  This
-      will allow Ghostscript to operate with future 4.2 upgrade
-      releases without requiring recompilation.
+    * Ghostscript requires GNU Ghostscript 6.53 or above, or ESP
+      Ghostscript 7.05 or above.
 
-    * CUPS packages should include the Gimp-print PPD's in
+    * CUPS packages should include the gutenprint PPD's in
       /usr/share/cups/model, and the following utilities:
 
       + "epson" and "canon" belong in /usr/lib/cups/backend.
 
-      + "rastertoprinter", "commandtoepson", and "commandtocanon" belong
-	in /usr/lib/cups/filter.
+      + "rastertogutenprint-5.0", "commandtoepson", and
+	"commandtocanon" belong in /usr/lib/cups/filter.
 
       + "cups-calibrate" belongs in /usr/bin.
 
@@ -759,7 +798,7 @@ PACKAGING
 
       + "calibrate.ppm" belongs in /usr/share/cups.
 
-      The PPD's packaged with Gimp-print are rather bulky, about 1 MB
+      The PPD's packaged with gutenprint are rather bulky, about 1 MB
       for each language installed.  At present, twelve language
       translations are installed, in addition to the US English
       defaults: GB English, Swedish, Danish, Norwegian, French,
@@ -769,29 +808,15 @@ PACKAGING
       Please see KNOWN BUILD ISSUES above for more discussion about
       build issues related to the PPD files.
 
-    * A gimp-print-foomatic package, containing the
-      src/foomatic/foomatic-db/gimp-print*/ directories, should be 
+    * A gutenprint-foomatic package, containing the
+      src/foomatic/foomatic-db/gutenprint*/ directories, should be 
       provided to allow people who wish to use foomatic to install the
       corresponding data files. The packaging should arrange to call
       "foomatic-kitload" (or the equivalent) on this tree when it is
       installed.
 
-    * We recommend that you replace the Print plugin bundled with the
-      Gimp (any 1.2 version) with the Gimp Print plugin in this
-      distribution.  There are various ways to do this; you can run
-      'make gimp-dist' from top level and untar the resulting tarball
-      into the Gimp source directory prior to building the Gimp, or
-      you can install the plugin (src/gimp/print) over an existing
-      Gimp Print plugin.  The plugin in the Gimp 1.2 tree is based on
-      the older Gimp-Print 4.0 source base; 4.2 supports more printers
-      with better quality, and has more features than 4.0.
-
-      We are working with the GIMP development team to replace the
-      current Print plugin (which contains the entire source required
-      to build the driver) with a smaller base containing just the
-      plugin itself.  This will allow compatibility with at least all
-      4.2-based releases of Gimp-Print, allowing upgrading the plugin
-      by simply upgrading the libgimpprint library.
+      An alternative option is to install pregenerated PPD files,
+      which may be created with foomatic-compiledb.
 
     * Please read the release notes carefully!
 
@@ -799,7 +824,7 @@ PACKAGING
       subscribe to the gimp-print-devel@sourceforge.net mailing list
       to monitor development activities.  When reporting a problem
       related to building the package for distribution, please
-      identify yourself as such.  The Gimp-Print package is primarily
+      identify yourself as such.  The Gutenprint package is primarily
       an infrastructure package, rather than an end-user application,
       and as such we particularly want to fix any problems that
       interfere with building and distribution of this package on any
@@ -813,32 +838,32 @@ DEBIAN
     It should build from source on woody and sid, but will not build
     on potato.  There are seven separate packages:
 
-    gimp1.2-print	    The GIMP Print plugin. Also contains HTML
-			    and SGML documentation that is registered
-			    with doc-base.
-    cupsys-driver-gimpprint The CUPS driver and PPD files.
-    foomatic-db-gimpprint   Foomatic data files for gimp-print drivers.
-    ijsgimpprint	    Ghostscript IJS server.
-    libgimpprint1	    The libgimpprint library (GIMP-Print core).
-    libgimpprint-dev	    Headers, symlinks, m4 macro
-			    (AM_PATH_GIMPPRINT) and gimpprint-config
-			    needed to develop programs that link with
-			    libgimpprint.
-    gimpprint-doc	    User's Guide in HTML and PDF format
-    libgimpprint-doc	    Programmer's Guide in Info, DVI and HTML
-			    format.
-    gimpprint-locales	    Message catalogues for internationalisation.
-    escputil		    The escputil printer tool for Epson printers.
+    gimp1.2-print	     The GIMP Print plugin. Also contains HTML
+			     and SGML documentation that is registered
+			     with doc-base.
+    cupsys-driver-gutenprint The CUPS driver and PPD files.
+    ijsgutenprint	     Ghostscript IJS server.
+    foomatic-db-gutenprint   Foomatic data files for gutenprint drivers.
+    libgutenprint1	     The libgutenprint library (Gutenprint core).
+    libgutenprint1-dev	     Headers, symlinks, m4 macro
+			     (AM_PATH_GUTENPRINT) and gutenprint-config
+			     needed to develop programs that link with
+			     libgutenprint.
+    gutenprint-doc	     User's Guide in HTML and PDF format
+    libgutenprint1-doc	     Programmer's Guide in Info, DVI and HTML
+			     format.
+    gutenprint-locales	     Message catalogues for internationalisation.
+    escputil		     The escputil printer tool for Epson printers.
 
     The library symlinks will get packaged without any modification needed
     to the debian packaging whatever library versioning scheme is
-    used.  Most packages depend on libgimpprint as this will provide
+    used.  Most packages depend on libgutenprint as this will provide
     translations for i18n in the future that they will use, or they
-    require libgimpprint anyway.
+    require libgutenprint anyway.
 
-    The newer Debian gs packages (>= 5.50) are linked with libgimpprint, so
+    The newer Debian gs packages (>= 5.50) are linked with libgutenprint, so
     you need not do any patching!  However, if you compile a newer version
-    of libgimpprint, the newer version will be used by ghostscript.
+    of libgutenprint, the newer version will be used by ghostscript.
 
 
 USE OF THE CVS REPOSITORY