Provided by: dvi2ps_5.1j-1.5_amd64 bug

NAME

       dvi2ps - convert a DVI file to PostScript

SYNOPSIS

       dvi2ps [-D var=val] [-F fontdesc] [-K] [-R n] [-S]
            [-c output-file] [-d] [-f n] [-i file] [-m n] [-n n]
            [-o str] [-q] [-r] [-s file] [-t n] [-w]
            [dvifile[.dvi]]

DESCRIPTION

       This  program converts a DVI file to PostScript, and writes the result to standard output.
       If no dvifile is given, it reads from standard input.  The  setting  for  the  printer  is
       given by the fontdesc file.

OPTIONS

       -D var=val
              specify a value of a variable var as val.

       -F fontdesc
              specify a fontdesc file.

       -K     remove comments from included PS files.

       -R n   specify the resolution of the printer (n dpi).

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

       -c output-file
              write the output to output-file instead of the standard output.

       -d     select debugging output (you probably don't want to).

       -f n   specify a starting page number (this is a TeX page number - \count0).

       -i file
              copy  the  named file to the output.  The contents of the file named will be copied
              to the Prolog-part (cf. PostScript Document Structuring Convention) of the output.

       -m0 | -mh | -m1 | -m2 | -m3 | -m4 | -m5
              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.  Magic numbers 1000, 1095,
              1200, 1440, 1728, 2074 or 2488 correspond to above magsteps.

       -n n   specify the number of copies to print.

       -o str specify a printing option.  Valid options are letter, note, legal, tabloid, a3, a4,
              a5,    b4,    b5,   landscape,   letterlandscape,   notelandscape,   legalenvelope,
              tabloidlandscape, a3landscape, a4landscape, a5landscape, b4landscape,  b5landscape,
              envelope,  large,  small,  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.

       -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 file
              copy  the  named file to the output.  The contents of the file named will be copied
              to the Setup-part (cf. PostScript Document Structuring Convention) of the output.

       -t n   specify an ending page number.

       -w     Don't print out warnings.

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
       epsfile   string        - Encapsulated 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 LaserPrep file must be downloaded to
       the printer, either permanently or as another header file  in  addition  to  the  standard
       tex.ps header file.

FILES

       *.dvi                 TeX DeVice Independent output file
       /usr/local/share/texmf/fonts/.../
                             default font file directories
       /usr/local/lib/dvi2ps/fontdesc
                             default fontdesc file

SEE ALSO

       tex(1)

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.

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.  Jean-Francois Lamy fixed the interface for PostScript illustrations.

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

                                         4 September 2000                               DVI2PS(1)