This directory contains the postscript code needed to run dvi2ps.

Therer are four main pieces.
The basic prologue material is called ``basic.pro''.
The code needed to use the builtin PostScript fonts is called ``builtin.pro''.
The code needed to use psfig is called ``psfig.pro''.
The code needed to use Macintosh graphics is called ``mac.pro''.

As distributed, only the first two of these pieces are stored in the current
directory. The file ``psfig.pro'' is in the directory ../psfig. The file
``mac.pro'' is in the directory ../psfig/usrguide/figs. This arrangement
is to comply with the copyright restrictions as fully as possible, and also
to make it easy to produce the manual page that comes with psfig.

When dvi2ps is run, it includes a standard prologue file by default.
The name of this file is set at compile time (see the Installation file
in ../src). It can be overridden at runtime by using the environment variable
PSHEADER. It can also be overridden by using the command line options
	-h		don't include the default header
	-i file		include the named file.
These opptions are also available in the startup file ``.dvi2ps''. This means
that a user can specify a collection of standard or nonstandard header files
to include with every job.

The installer must decide which of the standard pieces shall compose the 
standard header, and must make certain that the LocalGuide clearly
explains what choices were made. Because of the size of the ``mac.pro''
file, it should never be included in the standard file. The ``basic.pro''
should always be included. So the possible options are:

(i) basic. Only the basic material is included.

(ii) builtin. Both the basic material and the builtin material are included.

(iii) psfig. Both the basic material and the psfig material are included.

(iv) large. All of basic, builtin, and psfig are included.

You should choose one of these options and then ``make'' the appropriate
header file. Note that this will produce a file called ``dvi2ps.pro'',
which contains the specified header material. All prologue material
must later be installed in some standard location (specified by the
name of the POSTSCRIPT directory in the overall Makefile).

NOTE: The naming convention that has been adopted in this distribution
is that all PostScript code which is intended to produce output has the
extension ``.ps''; all PostScript code which is intended only as prologue
(and should not produce output by itself) has the extension ``.pro''.
