README.RT
---------

Ghostscript is a PostScript interpreter, which can send output to a variety
of different printers, to an X-windows display, or to several graphics file
formats. Several other utilities are included, including ps2asci and ps2epsi.

Patch details
-------------

These patches enable Ghostscript V2.6.1 with the 4 mandatory patches to
be used on the IBM RT 6150/6150, running AIX V2.2.1.

This has been (briefly) tested with the following software levels:

AIX LPP	Level		Title				Updates applied
-------	-----		-----				---------------
opsys	02.06.0760	Base System Program		1773 + 1779
X11	02.01.0400	IBM AIX/RT X-Windows 2.1	1738 + 1739

All routines compile and link successfully (except for the two mentioned in
make.rt6150, which require additional header files from hardware vendors).
I haven't tested all the printer drivers, as I don't have those printers.
The X11 drivers work to a local RT display (Megapel/5081 and Enhanced
Monochrome adaptor/6155 tested), though I did get a core dump when running
to a remote RS/6000 X display.

I've put ... #ifdef AIX ... around all RT-specific code, so the patched
source files can be used unchanged on other platforms. A couple of
changes apply to all platforms.

Most of the changes were minor, due to different header files or C compiler
limitations. The exception is the X11 support; I've been somewhat cavalier
to allow Ghostscript to run under the RT X11.3 release - several routines
are just ifdef-ed out! In retrospect, I should have provided dummy routines
instead. Maybe next time!

What to do
----------

If you just want to plug and play, unpack the binary file into /usr/local.
This puts binaries into /usr/local/bin, other support and example files
into /usr/local/lib/ghostscript, and a manual page in /usr/local/man/man1. 
You should also obtain the full set of ghostscript fonts (see below) into 
/usr/local/lib/ghostscript/fonts.

If you want to compile Ghostscript yourself, first obtain:-
    - Ghostscript V2.6.1 source code
    - Ghostscript fonts
    - 4 mandatory patches for Ghostscript V2.6.1

I got these from the CD-ROM "Prime Time Freeware for UNIX" Issue 3-2, edited
by Rich Morin, ISBN 1-881957-05-5. Costs around $50, with discounts for
regular purchasers. Contact ptf@cfcl.com for more information. (This 2-CD set
holds 5 Gb of source code and documentation - highly recommended!)

Ghostscript is also available from anonymous ftp from:-
	ftp.cs.wisc.edu in /pub/ghost/gnu
	prep.ai.mit.edu in /pub/gnu
and from other GNU mirror archive sites. If you have real problems in getting
GhostScript, I can mail you a copy.
Exercise for the reader: Ghostscript 3.12 is in /pub/ghost/aladdin on
ftp.cs.wisc.edu. You might like to port this to the RT.

As of 18 Nov 1994, the files you want are:-
	ghostscript-2.6.1.tar.gz		Ghostscript source code
	ghostscript-fonts-2.6.1.tar.gz		Ghostscript fonts
	ghostscript-2.6.1.fix-0[1234].gz	4 mandatory patches
Of course, you will need to abbreviate these names to 14 characters for AIX.

To compile, first unpack ghostscript-2.6.1.tar.gz. 
Then apply the patches by 'patch -s < ghostscript-2.6.1.fix-0[1234].gz'
Then apply the RT 6150 patches by 'patch -s < 2_6_1_rt.dif'. 
Then run 'make.rt6150' to do the compilation, or 'make.rt6150 install'
to compile and install in /usr/local/bin and /usr/local/lib/ghostscript. 
This builds a full set of printer drivers.  You can cut this down to the set 
you actually require, by editing make.rt6150.

I've also included 'make.rs6000', which works under RS/6000 AIX 3.2.5.

The fonts should be unpacked into /usr/local/lib/ghostscript/fonts.

To use as a printer filter, add to /etc/qconfig something like:
 backend = /usr/local/bin/gs -q -dNOPAUSE -sDEVICE=bj10e -sOutputFile=/dev/lp0
See unix-lpr.sh for a more comprehensive filter, with banner pages.
See also /usr/local/bin/gslp, gsbj, etc.

Copyright
---------

Ghostscript is copyrighted under the GNU Public License. 
For these patches (only), I grant you permission to do what you want with
them, provided you take full responsibility and liability.


					Andrew Yeomans (AYeomans@vnet.ibm.com)
					21st November 1994
