		 This is for version 2.43. April 12, 1989.

The use of this program may not be readily apparent.  If you are using
TranScript, and your printer's name is "ps", you would use a command
sequence that looked something like this:

	% tex myfile
	% dvi2ps myfile > myfile.ps
	% lpr -Pps myfile.ps

The first few pages will print in a very very slow fashion while the fonts
are being defined.  Printing speeds up a little as you get further down the
document.


Installation comments:
======================

First you will have to make some customizations. This mainly has to do with
the directories where your files have to be stored, the choice of either
pxl or pk bitmaps, the default paper size, the use of builtin Postscript
fonts and the amount of virtual memory in your laserprinter.If you don't
want Builtin fonts, delete the -DBUILTIN from CFLAGS.  Next there are some
things in dvi2ps.ps. These concern the MacIntosh stuff (This code may be
terribly out of date!!), and some special code that make the Laserwriter
work properly. Please search these keywords with you editor and check if
you want them in.

All of these choices must be indicated in the Makefile!!

Then type ``make'' to compile everything and ``make install'' to install the
software. ``Make install'' will ``squeeze'' the files dvi2ps.ps and Builtin.ps,
i.e remove comments and unnecessary blanks, so that downloading will be a
little bit faster. Squeeze will also enable/disable the Macintosh and
Laserwrite specific code.

This version obeys the TEXFONTS environment variable. If your pxl(pk) files
are in a different directory thanm your tfm files, then specify both.  The
font area is arranged in a new fashion that will probably be showing up in
other device drivers as well.  All the tfm files are contained in
/usr/lib/tex/fonts.  If a file named SUBDIR is present in
/usr/lib/tex/fonts (or whatever directory name you select), then the name
of the font is taken as the name of a subdirectory in searching for the pxl
file associated with the font.  In other words, amr10.1500pxl will be found
in /usr/lib/tex/fonts/amr10/amr10.1500pxl.  When the file named SUBDIR is
not present, all pxl files are looked for in the directory itself, in other
words, /usr/lib/tex/fonts/amr10.1500pxl in the above example.  The same
applies if you have chosen for pk files.

printcap information
====================

MIT uses another program called dvipsf when the LaserWriter is used with the
/etc/printcap file.  dvipsf invokes dvi2ps and applef.  Both dvipsf.c and
applef.c are included here.  MIT's printcap entry for the laserwriter reads:
7th Floor LaserWriter|lw7|7lw|laserwriter|apple|LE-MONDE|LE-MONDE-LGP|LE-MONDE-ASCII|LE-MONDE-DVI:\
	:cP=LE-MONDE-LGP:cT:dP=LE-MONDE-DVI:dT:vP=LE-MONDE:\
	:br#9600:rw:fc#0000374:fs#0000003:xc#0:xs#0040040:mx#0:\
	:lp=/dev/ttyh5:sd=/usr/spool/lw7:pl#66:pw#89:\
	:lf=/usr/spool/lw7/log:of=/usr/lib/applef:\
	:md=/usr/spool/lw7/motd:vf=/usr/lib/applef:\
	:df=/usr/lib/dvipsf:cf=/usr/lib/applebitf:


History and acknowledgements
============================

The driver was converted by Neal Holtz of Carleton University from a Sun
previewer originally written by Mark Senn and later modified by others (see
dvi2ps for specifics).  Additional modifications and enhancements have been
done by Scott Jones and Chris Lindblad at MIT.

(These notes added by Richard Furuta)

Notes by Piet van Oostrum:

Some of the code that I included came from Leslie Carr and Sebastian Raht
(University of Southampton, UK), James Clark (??) and Van Jacobson (LBL).

I added support for BSD4.1 and changed the dvi2ps program to read PK files
rather than PXL files (the files are generated by the Metafont Utilities),
use of builtin fonts an some other improvements.

This version of dvi2ps tries to estimate how much virtual memory the
LaserWriter has left. If that estimate is low it does not preload font
characters, but it prints the bitmap and then forgets about is. The BUDGET
is just the estimate of the initial amount of virtual memory you have. If
you set this too low, no problem, only your jobs may take more time. If you
set it too high, it may cause a VMError in the Laserwriter for large
documents. In that case your printer driver should give you the
errormessage.
There is some postscript code in the ``dvi2ps.ps'' file (in the definition of
the ``@end'' operator to print out the amount of VM that is left after your
job.
To use the VM limiting feature compile with -DBUDGET=estimated VM value in
bytes.
I also restructured the DVI.PS file to improve the VM usage.

To use builtin fonts compile with -DBUILTIN.
You can then define the fonts e.g. with \font\times=t-rom at 12pt
See the file times.sty for equivalent latex style options.
Other ones are palatino.sty, ncs.sty (for New Century Schoolbook) and
bookman.sty. The latter ones don't have the tfm files for the small caps
font.
These style files don't use builtin Postscript fonts for math mode. The
files times+m.sty and palatino+m.sty do attempt to map math mode. It is
still in its infancy. So plesae report any bugs or improvements.

Builtin fonts are defined by the file TeXPSfonts.map.
You may define additional builtin fonts (or derivatives thereof) by editing
this file or supplying additional files of the same name in the TEXFONTS
path or the directories given with the -a option. All the TeXPSfonts.map
files are concatenated to yield the collection of builtin fonts.

The format of the TeXPSfonts.map files is: for each builtin font an entry
is given: The first field in the entry is the TeX font name (e.g. t-rom for
times). The second (optional) field is a '#' followed by an include file
name. This file may contain additional postscript code for the font. The
file will be included (once) in the generated postscript if this font is
used.
The rest of the entry is a postscript definition of the font. This
postscript will be copied to the output file every time a font is used
derived from this font (i.e. for every \font definition). The definition in
the output will be preceded by two parameters: first a unique fontname
composed by the TeX fontname and a number (e.g. t-rom.360 for a 12 pt
times) and second the fontsize in pixel units (e.g. 49.813 for a 12 pt
font). The postscript field may be continued on the following lines if they
start with blank space (space or tab).
Other lines are comment (starting with %) and default include file names
(starting with #). The latter ones specify which include file to use for
all following entries that don't have their own include file.

There is one additonal file that is included once a builtin font is used:
this is the file Builtin.ps. It should be in the TEXFONTS path. This one is
included in addition to the #files mentioned above.

Future enhancements.
===================

I plan to do the following things:

Add support for gf files (the code for this is on the Unix tape), and
moreover choice of which format to use at runtime (i.e. you may have a
mixture of font files).

Scaling of nonexisting font sizes, by use of the postscript operators. This
will give a slightly better approximation than dumb font substitution.

Integration with other versions of dvi2ps.

make the postscript more ``conforming'' to Adobe standards.
------------------------------------------------------------------------
Please report bugs and suggestions for improvement to:

Piet van Oostrum, Dept of Computer Science, University of Utrecht
Padualaan 14, P.O. Box 80.089, 3508 TB Utrecht, The Netherlands
Telephone: +31-30-531806. piet@cs.ruu.nl (mcvax!hp4nl!ruuinf!piet)
