[This document was originally writte by Jim Yang, who made this port of
GhostScript for OS/2 with Borland C++, and modified by Kai Uwe Rommel
while modifying the program a little bit for emx 0.8h, GNU gcc.]

Program Description:

  This is an OS/2 2.x port of the GNU Ghostscript 2.6.1 with an OS/2
Presentation Manager driver. Ghostscript is a PostScript interpreter and
viewer. This version is compiled with emx 0.8h (GNU gcc) for OS/2. The
makefile for OS/2 requires GNU make or IBM nmake.

The PM driver has the following capabilities:

	1.  Two drawing modes.  The first mode is similar to the X11 driver
	    for UNIX, where there are no scroll bars in the drawing
	    window, and you can see GS constructing the image.
	    The second drawing mode uses scroll bars in the drawing
	    window, so it is possible to preview documents larger than
	    the size of the screen; however, in this mode the image does
	    not appear in the window until it is finished (the showpage
	    command is issued).

        2.  Four color modes: 256 color mode, 16 gray scale mode, 
	    4 gray scale mode, and monochrome mode.  If you are using the
	    VGA display driver you can only use the 4 gray scale mode.
	    You can use the 16 gray scale mode if you are using a 256 color
	    display driver.  To use the 256 color mode, your display driver
	    must support palette management.  The monochrome mode was added
	    in this version of PM driver to reduce the memory requirement
	    so that you can preview using a large bitmap (i.e. 300 dpi x 300 
	    dpi).

The program is compiled with the following drivers:

		os2pm epson eps9high necp6 bj10e bj200
		laserjet ljetplus ljet2p ljet3 lbp8
		deskjet djet500 cdeskjet cdjcolor cdjmono
		paintjet pjetxl pjxl pjxl300
		ibmpro dfaxhigh dfaxlow bit
		pbm pbmraw pgm pgmraw ppm ppmraw
		gifmono gif8 pcxmono pcx16 pcx256
		bmpmono bmp16 bmp256 bmp16m tiffg3

   (Note that I have not tested any driver other than os2pm, bj10e,
    gifmono, and gif8. - JY)

   (I have also tested os2pm, ljet3p and the bitmap drivers
    tiffg3, bmp16, bmp256, gif8. - KUR)


By the way, you can obtain fonts and source codes for Ghostscript from ftp
sites such as ftp.cs.wisc.edu:/pub/X/ghostscript* and labrea.stanford.edu.
To learn how to use the various features of the PM driver, read gspm26.doc.


Jim Yang
jyang@daedalus.caltech.edu


With the emx compiled version, two versions of gs are included. One
traditionally linked one with the PM driver disabled for use in batch
mode, and for stdin operation (gs.exe, for pipes, for example) and one
linked like Jim Yang designed it, for use as a PM previewing program
(this version consists of two executables, gspm.exe and gsos2pm.exe,
where gspm.exe is the program to be started by the user). Both versions
have also more other drivers included than Jim's executables. 

Note that the gs.exe standalone version has the PM driver linked in but
disabled. This is due to the make procedure to avoid compiling all of
the code twice. But you need to explicitly specify the device to be used
on the command line or in GS_OPTS (see below) for it to start up
properly, because it will abort otherwise with an error from the PM
driver.

Note that there is no longer a gs DLL included like in Jim's variant, so
you don't have to put it into LIBPATH. However, the two emx runtime
DLL's, emx.dll and emxlibc.dll are required. That means, you need to
download emxrt.zip from the same place where you got this archive from.

This variant of gs for OS/2 supports two additional environment
variables:

GS_OPTS     It can contain options for gs to be interpreted as if they 
            were specified on the command line.

GS_LOAD     The number of minutes the gs executable is kept in memory,
            this is useful if using it with my printer device monitor
            (see monitor.doc) if many jobs are to be processed in short
            intervals. This requires the emxload.exe program from the
            emxrt (emx runtime) package to be available via PATH.


A printer device monitor is also included, that allows GhostScript to be
used as the back end of a PostScript PM printer queue. See README in
the printmon subdirectory (packed in printmon.zip) for a description.
A sample batch file demonstrating it's use is gsmon.cmd.

Kai Uwe Rommel
rommel@ars.muc.de
