1 DVI2PS
This program converts a TeX DVI file to PostScript.  The  result
requires  a  small  amount of PostScript source to precede it to
the  printer,  before  it  can  be  successfully  printed.   (By
default, that PostScript code is prepended to the output.)

DVI2PS [-a pxldir] [-c] [-d] [-f n] [-h] [-i file] [-m n] [-n n]
       [-o str] [-p] [-q] [-r] [-s] [-t n] [-w] dvifile[.dvi]
2 Usage
In order to use DVI2PS, first create a DCL symbol for DVI2PS
           $ DVI2PS :== $DVI2PS

Users who execute SYS$SYSTEM:LOCALCMDS.COM will have  this  done
automatically.  To process a file, issue the command:
           $ DVI2PS [flags] infile
2 Flags
-a pxldir
           specify different  area  for  PXL  files.   Directory
           pxldir  is searched for all PXL files, instead of the
           default directory.
-c
           create an output file in the spool  directory.   This
           is  fairly  Apollo-specific,  and  may be disabled at
           other sites.  When given, the output is directed to a
           file   with   a  unique  name,  created  in  a  spool
           directory.
-d
           select debugging output (you probably don't want to).
-f n
           specify a starting page number (this is  a  TeX  page
           number - \count0).
-h
           do not copy the standard header  file.   This  option
           prevents  the  standard  PostScript header file being
           prepended to the output.
-i file
           copy the named file to the output.  The  contents  of
           the file named will be copied to the output after the
           standard header file has been copied.

-m0 | -mh | -m1 | -m2 | -m3 | -m4
           specify a magstep to use to print the document.  This
           overrides whatever might be in the DVI file.
-m n
           specify a magnification to use to print the document.
           This  should  probably  be  one  of the magic numbers
           1000,  1095,  1200,  1440,  1728,  or  2074,  but  no
           checking  is done.  Note:  if your site does not have
           the complete set of 300 dpi fonts, this option  might
           be disabled.
-n n
           specify the number of copies to print.
-o str
           specify a printing option.  Valid options are letter,
           note,  legal,  landscape,  envelope,  and manualfeed.
           This  argument  may  be   repeated   several   times.
           envelope  is  a  variant  of  landscape  that selects
           manual feed and does proper positioning  for  regular
           envelopes.
-p
           do not preload font information.  Occasionally  there
           may  be  insufficent  memory  to hold the information
           about all of the fonts in the  system.   Portions  of
           the  document  may  be  converted by including the -p
           option on the command line.  This  will  prevent  the
           preloading  of  all fonts into the system and instead
           use demand loading of the font tables.
-q
           be quiet.  Don't chatter about pages converted, etc.
-r
           stack pages in  reverse  order.   Normally,  the  DVI
           pages are processed in reverse order, with the result
           that they are stacked in the  correct  order  in  the
           output tray.  This option reverses that.
-s
           turn on printing of  statistics.   Some  versions  of
           DVI2PS  will  optionally  print statistics about font
           usage and some other information  that  is  generally
           only interesting to developers.  On these systems, -s
           turns on the statistics printing.
-t n
           specify an ending page number.
-w
           don't print out warnings.
2 Notes
This is a `bare bones' DVI-to-PostScript program.  Minimal error
checking is done.

Not all fonts are available in the resolution needed to  display
on the laser printer; when a missing font is encountered, DVI2PS
will continue to process your DVI file, and will log  a  warning
message.   Gaps  will  appear  in the document where the missing
characters should have been.

It can take up to 60 seconds for the first page  to  be  output.
After  a  head  of steam has been built up, it can roll along at
5-10 seconds per page.

PostScript Illustrations

This program supports use of the  \special  command  in  TeX  to
include  special  PostScript code for graphics, etc.  Specifying
\special{psfile=foo.ps} in the TeX source  will  result  in  the
contents  of  file  foo.ps  (assumed to contain PostScript code)
being copied into the output at that point.  For  most  included
graphics, the user's (0,0) point will be set to the point of the
\special command with x and y coordinates increasing up  and  to
the right and in units of PostScript points (72/inch) - thus you
must explicitly leave space above the \special command for  most
graphics.   For  graphics  produced  by Apple Macintoshes (i.e.,
MacDraw, MacPaint, etc.), the top left  corner  of  the  drawing
will  be  at the point of the \special command; in this case you
must leave the required space below the \special.

The \special string can contain  any  number  of  the  following
keyword=value pairs, separated by blanks:

Keyword   Value Type (dimensions in points:  72 pt = 1 in)

psfile    string    - PostScript file to include
hsize     dimension - maximum horizontal size (for clipping)
vsize     dimension - maximum vertical size (for clipping)
                      Use negative values to specify a  clipping
                      region below the current position.
hoffset   dimension - amount to shift right
voffset   dimension - amount to shift up
hscale    number    - scale factor in x-dimension
vscale    number    - scale factor in y-dimension
rotation  number    - counter-clockwise rotation angle

Thus:
\special{psfile=foo.ps hoffset=72  hscale=0.9  vscale=0.9}  will
shift the graphics produced by file foo.ps right by 1", and will
draw it at 0.9 normal size.

hsize and vsize are given relative to the  (0,0)  point  of  the
drawing and are unaffected by offsets and scales.

Offsets are given relative to the point of the \special command,
and are unaffected by scales.

If Macintosh drawings are to be included, the proper  Laser-Prep
file must be downloaded to the printer, either permanently or as
another header file in addition to the standard DVI2PS.PS header
file.
2 Files
TeX_fonts:             default area for font files
TeX_inputs:DVI2PS.PS   PostScript support code
2 Bugs
There is likely a limit to the size of  documents  that  can  be
printed  (at  least,  on  the  Apple  LaserWriter).   If you get
VMerrors reported when printing, use the -f and -t  options,  to
select  a  range  of  pages.  The exact limit is unknown, but is
probably well in excess of  50  pages  for  `normal'  documents,
decreasing  with  number of different fonts used, size of fonts,
etc.
2 Authors
Mark Senn wrote the early versions of this program for  the  BBN
BitGraph.   Stephan  Bechtolsheim,  Bob  Brown,  Richard Furuta,
James Schaad and Robert  Wells  improved  it.   Norm  Hutchinson
ported  the  program  to  the  Sun.  Neal Holtz ported it to the
Apollo, and then  to  produce  PostScript.   Scott  Jones  added
intelligent  font  substitution.   Jean-Francois  Lamy fixed the
interface for PostScript illustrations.

(PostScript is a trademark of Adobe Systems, Inc.)
