GNU Ghostscript Documentation


The documents below are from GNU Ghostscript 3.33. If you have a copy of Ghostscript 3.33, you will have these documents. The latest version of these files can be obtained with GNU Ghostscript from ftp://ftp.cs.wisc.edu/ghost/gnu/.

What if I'm a new user?

If you are a new user of Ghostscript, you should start by reading:

README
information specifically for new users.
Then read as many of the following as seem relevant:
use.doc
information about how to install and use Ghostscript. This information is also contained in gs.1 - a `man' page for Ghostscript.
The catalog at the beginning of devs.mak, which lists all the devices for which Ghostscript is able to produce output (although if you got Ghostscript in binary form, it will only include a subset of these devices).
devices.doc
more detailed information about specific devices that Ghostscript knows about.
ps2epsi.doc, unix-lpr.doc
more detailed information about some of the shell scripts and batch files distributed with Ghostscript. If you have Aladdin Ghostscript, as opposed to the GNU Ghostscript releases distributed by the Free Software Foundation, you should read (or at least skim through):
public.doc
additional information about Aladdin Ghostscript releases that is not relevant to GNU Ghostscript releases.
If you are going to compile Ghostscript, rather than just use an executable you got from somewhere, you should read:
make.doc
how to install, compile and link Ghostscript.
If you run into any questions, or if you are going to be using Ghostscript extensively, you should at least skim, and probably eventually read:
fonts.doc
information about the fonts distributed with Ghostscript, including how to add or replace fonts.
language.doc
A description of the Ghostscript language, and its differences from the documented PostScript language.
psfiles.doc
information about the .ps files distributed with Ghostscript (other than fonts).
There is also a FAQ (Frequently Asked Questions) file available on the Internet from http://www.cs.wisc.edu/~ghost/gsfaq.html.

What should I read if I'm not a new user?

When you receive a new release of Ghostscript, you should start by reading:
README
The first file to read
COPYING
The GNU General Public License, under which GNU Ghostscript is distributed.
current.doc
information about problems, and major changes and new features in the current release. If you have used a previous release of Ghostscript, you probably should also read any more recent sections of:
NEWS
a complete, detailed history of changes in the most recent Ghostscript releases.

What if I'm a developer?

If you are going to be writing a new driver for Ghostscript, you should read:
drivers.doc
the interface between Ghostscript and device drivers.
xfonts.doc
the interface between Ghostscript and platform-supplied fonts. (Read drivers.doc first.)
If you are considering distributing Ghostscript (either Aladdin or GNU versions) in conjunction with a commercial product, you should read the PUBLIC license carefully, and you should also read:
commprod.doc
additional clarification of the circumstances under which Ghostscript can be distributed with a commercial product.
If you intend to use Ghostscript in the form of a DLL under OS/2 or Microsoft Windows, you should read:
dll.doc
documentation on Ghostscript as a DLL.
If you intend to use Ghostscript as part of another program and not as a DLL, rather than as a self-contained executable application, you should start by reading:
imain.h
the documented API for Ghostscript not as a DLL.

Other files

devarch.doc
notes on the architecture of device handling in Ghostscript 3.0.
ps2epsi.doc
documentation for the PostScript to EPSI conversion utility.
helpers.doc
a note of thanks to all the people who have helped with Ghostscript development.
hershey.doc
information about the Hershey fonts, which are the basis of some of the Ghostscript fonts.
history1.doc, history2.doc
a history of changes in older Ghostscript releases.
humor.doc
a humorous comment on Ghostscript contributed by a user.
lib.doc
information about the Ghostscript library.
unix-lpr.doc
information about how to integrate Ghostscript with Unix printer spooling.

Home Back
Updated 18 December 1997 Russell Lang