   Copyright (C) 1989, 1996 Aladdin Enterprises.  All rights reserved.
  
  This file is part of GNU Ghostscript.
  
  GNU Ghostscript is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility to
  anyone for the consequences of using it or for whether it serves any
  particular purpose or works at all, unless he says so in writing.  Refer to
  the GNU General Public License for full details.
  
  Everyone is granted permission to copy, modify and redistribute GNU
  Ghostscript, but only under the conditions described in the GNU General
  Public License.  A copy of this license is supposed to have been given to
  you along with GNU Ghostscript so you can know your rights and
  responsibilities.  It should be in a file named COPYING.  Among other
  things, the copyright notice and this notice must be preserved on all
  copies.
  
  Aladdin Enterprises is not affiliated with the Free Software Foundation or
  the GNU Project.  GNU Ghostscript, as distributed by Aladdin Enterprises,
  does not depend on any other GNU software.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

****************************************************
* This file describes version 5.10 of Ghostscript. *
****************************************************

If this is your first contact with Ghostscript, we suggest you read the file
new-user.txt before continuing with this README file.  new-user.txt gives an
overview of:

	- what Ghostscript does (PostScript and PDF previewing, conversion,
	and printing);

	- what its licensing terms are (free for ordinary use);

	- what platforms it runs on (every platform you're likely to be
	interested in);

	- where to find some useful programs that enhance Ghostscript (like
	user-friendly previewers for Unix, VMS, MS Windows, MS-DOS, and
	Macintosh).

	- what to do if you have problems (the "If you need help" section).

The rest of this README file is a road map to the documentation files that
are part of the fileset.  If you are a new user, we suggest you look through
it now.  After that, we recommend you read install.txt, which tells you how
to install Ghostscript, and make.txt, which tells you how to compile
Ghostscript from source code (which is required before installation on Unix
and VMS systems).

********
******** Documentation overview ********
********

There is a Ghostscript World Wide Web home page at 
	http://www.cs.wisc.edu/~ghost/index.html

All the file names mentioned in the documentation, except for README and
NEWS, are in lower case, which is the usual convention for Unix systems.  On
MS-DOS systems, all file names are actually upper-case.

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

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

> new-user.txt - information specifically for new users.

Then read as many of the following as seem relevant:

> install.txt - information about how install Ghostscript.

> use.txt - information about to use Ghostscript.  Some of 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.txt - more detailed information about some specific devices that
Ghostscript knows about.

> ps2epsi.txt, unix-lpr.txt - more detailed information about some of
the shell scripts and batch files distributed with Ghostscript.

> bug-form.txt - a form to use for reporting problems (but remember that
Ghostscript comes with NO WARRANTY and NO SUPPORT).

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.txt - 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.txt - how to compile and link Ghostscript.  (You should also read
install.txt in this case.)

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.txt - information about the fonts distributed with
Ghostscript, including how to add or replace fonts.

> language.txt - A description of the Ghostscript language, and its
differences from the documented PostScript language.

> psfiles.txt - information about the .ps files distributed with
Ghostscript (other than fonts).

There is also a FAQ (Frequently Asked Questions) file available on the
Internet.  See "If you need help" in new-user.txt for the location.

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 - this file.

> current.txt - 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.txt - the interface between Ghostscript and device drivers.

> xfonts.txt - the interface between Ghostscript and platform-supplied
fonts.  (Read drivers.txt 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.txt - 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.txt - 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 either (if you will be using Ghostscript as a
callable PostScript language interpreter):

> imain.h - the documented API for Ghostscript not as a DLL.

or (if you are going to use just the Ghostscript graphics library):

> lib.txt - information about the structure of and APIs for the
Ghostscript library.

Other files
-----------

> ps2epsi.txt - documentation for the PostScript to EPSI conversion
utility.

> helpers.txt - a note of thanks to all the people who have helped with
Ghostscript development.

> hershey.txt - information about the Hershey fonts, which are the
basis of some of the Ghostscript fonts.

> history*.txt - a history of changes in older Ghostscript releases.

> humor.txt - a humorous comment on Ghostscript contributed by a user.

> unix-lpr.txt - information about how to integrate Ghostscript with
Unix printer spooling.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

PostScript is a trademark of Adobe Systems, Incorporated.
