[thirdparty/cups.git] / pstoraster / README.pstoraster

README.pstoraster - 11/14/2003
------------------------------

INTRODUCTION

    This directory contains the CUPS "driver" for Ghostscript
    7.x and 8.x, the pstoraster script that is used to run
    Ghostscript as a CUPS filter, the pstoraster.convs file that
    defines the PostScript to raster filter for CUPS drivers, a
    makefile fragment that adds the CUPS driver, and the wrapper
    script (pstopxl) and PPD files (pxl*.ppd) to support PCL
    XL/PCL 6 printers.

    This software is included with both the CUPS and ESP
    Ghostscript 7.07.1 distributions.  While the files will also
    compile with earlier versions of Ghostscript, there are bugs
    in older versions of Ghostscript which may cause problems.

    Also, this driver may not be used in any commercial
    Ghostscript distributions without prior written
    permission/licensing from Easy Software Products.  See the
    contact information in the file "gdevcups.c" for more
    information.


COMPILING ESP GHOSTSCRIPT WITH THE CUPS DRIVER

    Normally the CUPS driver will be automatically included when
    you use the configure script supplied with ESP Ghostscript.

    Once you have compiled and installed Ghostscript, restart
    the cupsd process, either by sending the HUP signal to the
    process or using the init script supplied with CUPS.

    To use the PCL XL/PCL 6 drivers, make sure that you also
    configure Ghostscript with the pxlmono and pxlcolor drivers.


COMPILING AFPL/GNU GHOSTSCRIPT WITH THE CUPS DRIVER

    Before configuring AFPL or GNU Ghostscript, first copy this
    directory to the Ghostscript source directory, e.g.:

        cp -r pstoraster /some/path/to/ghostscript-7.07

    Then apply the appropriate patch:

        cd /some/path/to/ghostscript-7.07
        patch -p1 pstoraster/gs707-lib.patch

    or:

        cd /some/path/to/ghostscript-8.11
        patch -p1 pstoraster/gs811-lib.patch

    Next, run the configure script to configure the Ghostscript
    software:

        ./configure [any configure options you want]

    Finally, add the following include line to the end of the
    makefile:

        include pstoraster/cups.mak

    and add "$(DD)cups.dev" to any of the DEVICE_DEVS lines.

    Once you have compiled and installed Ghostscript, restart
    the cupsd process, either by sending the HUP signal to the
    process or using the init script supplied with CUPS.

    To use the PCL XL/PCL 6 drivers, make sure that you also
    configure Ghostscript with the pxlmono and pxlcolor drivers.
Commit	Line	Data
ef416fc2	1	README.pstoraster - 11/14/2003
	2	------------------------------
	3
	4	INTRODUCTION
	5
	6	This directory contains the CUPS "driver" for Ghostscript
	7	7.x and 8.x, the pstoraster script that is used to run
	8	Ghostscript as a CUPS filter, the pstoraster.convs file that
	9	defines the PostScript to raster filter for CUPS drivers, a
	10	makefile fragment that adds the CUPS driver, and the wrapper
	11	script (pstopxl) and PPD files (pxl*.ppd) to support PCL
	12	XL/PCL 6 printers.
	13
	14	This software is included with both the CUPS and ESP
	15	Ghostscript 7.07.1 distributions. While the files will also
	16	compile with earlier versions of Ghostscript, there are bugs
	17	in older versions of Ghostscript which may cause problems.
	18
	19	Also, this driver may not be used in any commercial
	20	Ghostscript distributions without prior written
	21	permission/licensing from Easy Software Products. See the
	22	contact information in the file "gdevcups.c" for more
	23	information.
	24
	25
	26	COMPILING ESP GHOSTSCRIPT WITH THE CUPS DRIVER
	27
	28	Normally the CUPS driver will be automatically included when
	29	you use the configure script supplied with ESP Ghostscript.
	30
	31	Once you have compiled and installed Ghostscript, restart
	32	the cupsd process, either by sending the HUP signal to the
	33	process or using the init script supplied with CUPS.
	34
	35	To use the PCL XL/PCL 6 drivers, make sure that you also
	36	configure Ghostscript with the pxlmono and pxlcolor drivers.
	37
	38
	39	COMPILING AFPL/GNU GHOSTSCRIPT WITH THE CUPS DRIVER
	40
	41	Before configuring AFPL or GNU Ghostscript, first copy this
	42	directory to the Ghostscript source directory, e.g.:
	43
	44	cp -r pstoraster /some/path/to/ghostscript-7.07
	45
	46	Then apply the appropriate patch:
	47
	48	cd /some/path/to/ghostscript-7.07
	49	patch -p1 pstoraster/gs707-lib.patch
	50
	51	or:
	52
	53	cd /some/path/to/ghostscript-8.11
	54	patch -p1 pstoraster/gs811-lib.patch
	55
	56	Next, run the configure script to configure the Ghostscript
	57	software:
	58
	59	./configure [any configure options you want]
	60
	61	Finally, add the following include line to the end of the
	62	makefile:
	63
	64	include pstoraster/cups.mak
65
66	and add "$(DD)cups.dev" to any of the DEVICE_DEVS lines.
67
68	Once you have compiled and installed Ghostscript, restart
69	the cupsd process, either by sending the HUP signal to the
70	process or using the init script supplied with CUPS.
71
72	To use the PCL XL/PCL 6 drivers, make sure that you also
73	configure Ghostscript with the pxlmono and pxlcolor drivers.