1 DVIOUT
  Converts a Device Independent (DVI) file generated by TeX to a form
  usable by a specific output device, such as a laser printer or high
  resolution graphics device.

  Format:

    DVIOUT input-file-spec[,...]
2 Parameters
 input-file-spec[,...]

  Specifies the names of one or more input files to be output to a device.
  If you specify more than one input file, you must separate the names with
  commas. The default file extension is DVI.

  Wildcard characters are not permitted in the file specification(s).
2 Command_Qualifiers

/CONCATENATE

 /CONCATENATE
 /NOCONCATENATE

  Determines whether the magnification value replaces or is concaten-
  ated to the magnification specified within the input DVI file. If
  /CONCATENATE is used, the magnification specified in the DVIOUT
  command is multiplied by the magnification specified within the DVI
  file. This can be used to increase or decrease the overall magnifica-
  tion. If /NOCONCATENATE is used (the default), the magnification
  specified in the DVIOUT command (if any) overrides the magnification
  specified within the DVI file.

/COPIES

 /COPIES=number_of_copies

  Specifies the number of copies of the DVI file that are to be generated.
  The default, if not specified, is 1.

  The result of specifying zero as the number of copies is undefined.

/DELETE

 /DELETE
 /NODELETE

  Specifies that the input DVI file is to be deleted at the completion
  of processing. If an error occurs during the file processing, or the
  processing was interrupted by Control-C, the file is not deleted even
  if this option is specified.

/DEVICE

 /DEVICE=device_name

  Selects the output device to be used. Multiple output devices are
  supported by DVIOUT. Currently, the devices supported are:

  TEK4014           The Tektronix 4014 graphics terminal.
  APPLE_LASERWRITER The Apple LaserWriter laser printer (PostScript file).
  PS300             Generic 300 dpi PostScript.
  PS400             Generic 400 dpi PostScript.
  PS600             Generic 600 dpi PostScript.
  PS1200            Generic 1200 dpi PostScript.
  NULL              The null device. No output is generated.

  If not specified, output goes to the null device. The null device is
  configured at a resolution of 300 pixels per inch.

/EVEN_PAGES

 /EVEN_PAGES
 /NOEVEN_PAGES

  Specifies that only even-numbered pages are to be printed. This is
  useful when generating output to be fed into a copier to generate
  two-sided copies (see also ODD_PAGES). When used as a local qualifier
  and /ODD_PAGES has been specified as a global qualifier, then 
  /NOODD_PAGES must also be specified as a local qualifier to obtain the
  desired results. A page is considered even-numbered if TeX's \count0
  register is even.

/EXCLUDE

 /EXCLUDE
 /NOEXCLUDE

  Reverses the meaning of the combination of /PAGES, /ODD_PAGES and
  /EVEN_PAGES. That is, all pages that normally would have been selected
  are excluded. All other pages are printed. /EXCLUDE/ODD_PAGES is
  equivalent to /EVEN_PAGES and vice-versa. Specifying /EXCLUDE without
  any other page selection being specified results in no output.

/FORM

 /FORM=form_name

  Specifies a form type that the output device is currently using. Examples
  of possible types are LETTER, LEGAL, A3, A4, B4, 11X17, etc. The form name
  is used to determine the proper positioning of output on the page, and is
  device specific (that is, it may or may not have an effect, depending on
  which device is used).

  Note that this does not necessarily set the form to the proper type; it
  is used to inform DVIOUT of the form currently in use. Other mechanisms
  must be used to ensure that the proper form is set prior to the output
  actually being generated at the device.

/HOFFSET

 /HOFFSET=dimension

  Specifies the horizontal position of (0,0) on the output page. This
  can be used to adjust the position of the final output on the output
  device. The dimension specified is any dimension acceptable to TeX.
  The default is 1 inch. Acceptable dimension units are:

  pt: point         pc: pica          in: inch          bp: big point
  cm: centimeter    mm: millimeter    dd: didot         cc: cicero
  sp: scaled point

/INTERACTIVE

 /INTERACTIVE
 /NOINTERACTIVE

  Specifies that the program will pause before each page and request
  confirming input from the user in order to continue. Individual pages
  can be excluded from the output on a case-by-case basis. The default
  is to generate the output without user interaction. When /INTERACTIVE
  is in effect, the prompt:

     Next page is page number nnn. Enter option [Y/N/G/Q]:

  appears prior to each page being printed. The four possible options
  are:

     Y    Yes, print the next page
     N    No, do not print the next page
     G    Go, print all remaining pages
     Q    Quit, do not print all remaining pages; terminate.

  Invalid responses are equivalent to No. End of file (Control-Z) is
  equivalent to Quit.

/LANDSCAPE

 /LANDSCAPE
 /NOLANDSCAPE

  Specifies that output is to be rotated 90 degrees clockwise from the
  normal letter-type output. This is useful for generating slides
  or sideways pages, sometimes needed for special applications. The
  default is /NOLANDSCAPE.

/MAGNIFICATION

 /MAGNIFICATION=magnification_value

  Specifies the magnification to be applied to the output. The
  magnification value is the desired magnification multiplied by 1000.
  Additional values that can be specified are:

  MAG0: no magnification             MAGH: magnification by 1.095
  MAG1: magnification by 1.200       MAG2: magnification by 1.440
  MAG3: magnification by 1.728       MAG4: magnification by 2.074
  MAG5: magnification by 2.488       MAG6: magnification by 2.986

  Pixel files may not be available for every magnification. Sizes
  available are site dependent. The default is MAG0 (no magnification).
  This replaces the \magnification value, if any, present in the input
  DVI file, unless /CONCATENATE is specified.

/MARK

 /MARK=string
 /NOMARK

  Specifies a mark that will appear at the top and bottom of each page.
  The string specified is set so that the baseline of the characters
  in the string are 1/2 inch from the top edge of the page and 1/4 inch
  from the bottom edge of the page, where the page size is determined
  from the /FORM specification. The string is centered horizontally on
  the page. The font used can be specified using the /MKFONT and
  /MKSCALE qualifiers. /NOMARK is the default.

  This feature is intended for use in classified environments, where
  top and bottom security banners are generally required. This feature
  is NOT a proper substitute for 'final copy' page classifications, but
  is instead intended for use with draft and working versions of a
  document.

/MEMORY

 /MEMORY=size

  Specifies a memory size for the output device. This is primarily used
  to allow a complex document to be printed, albeit slowly, if the
  output device has insufficient memory to store all required fonts, etc.
  Since the memory calculations done by DVIOUT for each device is only
  approximate, some print jobs may fail with memory exceeded errors,
  requiring a reduction in the amount DVIOUT believes is available.
  Conversely, if a particular installation has upgraded an output device
  with a more-than-usual amount of memory, this option will allow more
  of that memory to be utilized. The unit of memory is device specific
  (usually in thousands of bytes).

/MKFONT

 /MKFONT=font_name

  Specifies the font to be used for the top and bottom page marks
  specified with the /MARK qualifier. The font_name value is the name
  of any font which is accessible using the TeX \font command. The
  /MKSCALE qualifier further qualifies the font used by specifying
  the scale of the font. Thus, the font that will be used is defined
  as if the TeX command '\font\markfont=\mkfont scaled \mkscale' was
  used (sort of -- no kerning or ligature replacement takes place
  when setting the page mark characters).

  If not specified, font cmss17 is used for the page marks.

/MKSCALE

 /MKSCALE=scale

  Specifies the scale of the font used to produce top and bottom page
  marks. The value specified is the desired scale multiplied by 1000.
  Additional values that can be specified are:

  MAG0: scaled by unity              MAGH: scaled by 1.095
  MAG1: scaled by 1.200              MAG2: scaled by 1.440
  MAG3: scaled by 1.728              MAG4: scaled by 2.074
  MAG5: scaled by 2.488              MAG6: scaled by 2.986

  If not specified, a scale of 1440 (magstep 2) is used.

/ODD_PAGES

 /ODD_PAGES
 /NOODD_PAGES

  Specifies that only odd-numbered pages are to be printed. This is
  useful when generating output to be fed into a copier to generate
  two-sided copies (see also EVEN_PAGES). When used as a local qualifier
  and /EVEN_PAGES has been specified as a global qualifier, then 
  /NOEVEN_PAGES must also be specified as a local qualifier to obtain the
  desired results. A page is considered odd-numbered if TeX's \count0
  register is odd.

/OPTIONS

 /OPTIONS=name

  Specifies the name of a file containing run option information for
  DVIOUT to use instead of the default options file. The default file
  extension is OPT. If the file is not in the DVI_INPUTS: area, the
  full device and directory string must be included in the file name.

  If not specified, DVIOUT uses the option file DVI_INPUTS:<name>.OPT,
  where "name" is the device name specified with the /DEVICE qualifier.

/OUTPUT

 /OUTPUT=device or file_specification

  Specifies a particular device or output file to which the DVIOUT output
  is to go. The meaning and interpretation of the output value is device
  specific. For on-line devices such as a graphics terminal, the output
  value will specify a device name. For spooled devices, the output value
  will specify a file specification.

/PAGES

 /PAGES=(pages_spec,...)

  Selects a subset of pages to be printed. A page specification can be
  a single page number, a range of page numbers or a page number search
  string. Each page number can consist of up to ten individual
  components, corresponding to TeX's \count0 through \count9 registers.
  Individual components are separated from each other with a period.
  A valid page number component is either a positive whole number, a
  roman numeral, or an asterisk. Examples of page specifications are:

      1:5                 Pages 1 through 5
      5.2:12.2            Pages 5.2 through 12.2
      5.*.1               All pages with \count0 = 5 and \count2 = 1
      xiii:xxi            Pages -21 through -13 (roman numerals
                            translate to negative page numbers)

  In the case of a page range, page numbers are compared using the
  first number (corresponding to \count0) as the least significant
  'digit'. Therefore, for example, page 5.2 is less than page 2.3.
  This is done this way because \count0 almost always is used as the
  fastest-changing page number.

  Lists of page specifications should be enclosed in parentheses and
  separated by commas. The total page specification is ANDed with
  /ODD_PAGES or /EVEN_PAGES to select those pages printed. If /EXCLUDE
  is specified, the page specification designates the pages that are
  NOT to be printed. Pages that are specified but are undefined in the
  DVI file are ignored. This qualifier may only appear as a local
  qualifier.

/PIXEL_SOURCE

 /PIXEL_SOURCE=source

  Specifies where the pixel (or raster) information for the characters
  in each font are to be obtained. The possible options for this
  qualifier are:

      PK       Raster information is obtained from packed files
      PXL      Raster information is obtained from pixel files
      GF       Raster information is obtained from generic font files.

  The source of the pixel information varies from site to site.
  Probably only one of these three forms is available on your system.
  The default is PK, use packed files for raster information.

/PRESERVE

 /PRESERVE
 /NOPRESERVE (D)

  Specifies whether DVIOUT attempts to ensure that the state of the
  output device is preserved. On output devices that support this
  capability, use of this qualifier will save the the output device
  configuration prior to the job being output and restore the initial
  state at the completion of the job. The default is not to preserve
  the device state, instead relying on the spooler software to perform
  this function.

/REVERSE

 /REVERSE
 /NOREVERSE

  Specifies that the pages of the document are to be printed in
  reverse order. This feature is useful for output devices that stack
  paper in reverse order. The default is to print pages in their
  normal order. Note that this only applies to the order of the pages
  within the DVI file, which may not be in their 'natural' order to
  begin with. You can use the /SORTED qualifier to ensure that pages
  are printed in their correct order.

/SORTED

 /SORTED
 /NOSORTED

  Specifies that the pages will be output in sorted order. If /REVERSE
  is used in conjuction with this qualifier, the pages will appear in
  reverse sorted order. Page number comparisons are made first based on
  \count9 (most significant), then \count8, and so on to \count0 (least
  significant).

/TWO_SIDED

 /TWO_SIDED
 /NOTWO_SIDED

  Specifies that two-sided copies are to be produced, if possible. This
  command will have no effect if the output device specified with the
  /DEVICE qualifier cannot support two-sided copies. Use the /ODD_PAGES
  and /EVEN_PAGES qualifiers (on separate runs) to produce two files
  that can be used to produce two-sided copies if the output device
  cannot support them directly.

  Use of this qualifier may produce peculiar results when used in
  conjunction with a /PAGES specification, or if /INTERACTIVE is used.
  When you use /TWO_SIDED, and the device supports its use, the first
  page printed goes on the obverse of the first sheet, the second page
  goes on the reverse of the first sheet, etc., which may not
  necessarily correspond to odd and even page numbers.

/USETFM

 /USETFM
 /NOUSETFM

  Specifies whether TeX Font Metric (TFM) files are to be used to supply
  character dimension information when pixel files are absent. This is
  used to continue processing a DVI file even though all files required
  for needed fonts may not be present. This will result in one or more
  missing characters in the final output. The default is to use the TFM
  files when pixel files are absent.

/VOFFSET

 /VOFFSET=dimension

  Specifies the vertical position of (0,0) on the output page. This
  can be used to adjust the position of the final output on the output
  device. The dimension specified is any dimension acceptable to TeX.
  The default is 1 inch. Acceptable dimension units are:

  pt: point         pc: pica          in: inch          bp: big point
  cm: centimeter    mm: millimeter    dd: didot         cc: cicero
  sp: scaled point
2 Options_file

  The options file contains site modifiable defaults for various
  things that may be dependent on particular configurations of
  TeX, DVIOUT and/or output devices.
3 File_syntax

  Each line in the options file contains an expression denoting an
  option identifier and an option value, separated by an equals sign.
  For example,

      special.paste.options.tek4014 = noegm, margin=one

  which tells DVIOUT what Tektronix 4014 options list to pass to
  the \special PASTE routine, in the absence of an explicitly
  specified options list.

  An exclamation ("!") point can be used anywhere in the file to
  include a comment string. Lines may be continued by specifying a
  hyphen ("-") as the last character in a line. All blanks are removed,
  and all alpha characters are converted to upper case, except for values
  delineated by single or double quote characters. A quote character
  can be included in the string by specifying two adjacent quote
  characters.

  A secondary file can be included into the options file by specifying
  an ".include" line, such as:

      .include common_options

  The included file text is read in and is represented exactly as if
  it had appeared in the main-level file. File inclusion can occur to
  an arbitrary level. File name defaults for the .included file are
  the same as for the top level options files. An .include line must
  not appear in the middle of an option expression.
3 Option_types

  The option types currently defined are:

      a. special.paste.options.<protocol_name> = list

         Specifies a default value for the /OPTIONS qualifier used
         in the execution of the \special PASTE command. The
         <protocol_name> is the name of any protocol currently
         supported by the PASTE operation.

      b. native_font.<tfmname>[.<magnification>] = list

         Specifies the characteristics of a native font for the
         current device type. The <tfmname> is the name of the font
         tfm file used by TeX, and should be enclosed in double
         quotes to preserve case. The optional <magnification> value
         is used when a font at a specific magnification is being
         described (if absent, the characteristics are applied to
         all magnifications of the font). The magnification is in
         the normal TeX nomenclature, i.e. 1000 means no magnifica-
         tion, 1200 is \magstep1, etc. The characteristics list can
         consist of one or more of the following:

            name = "Font-Name"		Specifies the name of the
					font in the device's own
					language
            encoding = <encoding-type>  Specifies the encoding to
                                        use for the font. The
                                        <encoding-type> can be either
                                        native (default) or TeX. TeX
                                        encoding is used for a pre-
                                        downloaded TeX font.

      c. font_characteristics = list

         Specifies the general characteristics of native fonts.
         The list can consist of any of the following:

	    orientation = up		Specifies that font characters
					can be oriented with the top up
					(normal portrait orientation)
	    orientation = left		Specifies that font characters
					can be oriented with the top to
					the left (landscape orientation)
	    orientation = down		Specifies that font characters
					can be oriented upside-down
	    orientation = right		Specifies that font characters
					can be oriented with the top to
					the right
	    orientation = any		Specifies that fonts can have
					an arbitrary orientation
	    reflect = no		Specifies that fonts cannot
					be reflected
	    reflect = yes		Specifies that fonts can be
					reflected

         Where multiple options are supported, enclose the list in
         parentheses. For example, orientation=(up,left).
2 Native_fonts

  The DVIOUT program supports, where feasible, the use of native fonts
  on some types of output devices. Native fonts are identified by
  font names that are enumerated in the options file for the device.
  The options files supplied with DVIOUT support the following native
  fonts (may be changed by local system manager):

    Device(s)                Fonts                   Orientations
    ----------------------   ---------------------   -----------------
    APPLE_LASERWRITER        Courier, Helvetica,     No limit
                             Times, Symbol
    PS300, PS400, PS600,     Courier, Helvetica,     No limit
    PS1200                   Times, Palatino, Zapf,
                             New Century Schoolbook,
                             Bookman, Avant Garde,
                             Helvetica Narrow,
                             Symbol

  Of course, Font Metric files must be available for these fonts in
  order for TeX and DVIOUT to use them. Although some problems exist
  when using native fonts (for example, mixing native fonts and TeX
  fonts in math output), a substantial savings in speed can be
  realized by using native and pre-downloaded fonts.

  Native fonts that cannot be scaled must have an "at" size equal to
  their design size. If the "at" size is different than the design
  size, it is assumed the font can be automatically scaled by the
  output device.

  DVIOUT supports the pre-downloaded TeX fonts produced by the PSFONT
  program supplied with DVIOUT. However, the use of pre-downloaded
  TeX fonts is not set up as the default configuration, as there are
  many (and some very large) fonts. Your system manager can set up
  the pre-downloaded fonts to be used at your site by customizing the
  options file for the PostScript printer, and causing these fonts to
  be loaded whenever the queue is established for the printer. For
  example, if the options file contains the line

      native_font."cmr10".1000 = name="CM-Roman10", encoding=TeX

  then DVIOUT will treat the cmr10 font at magstep 0 to be already
  resident and will not try to download it. Of course, if the font
  has not been loaded, an error will occur when the file is processed
  by the printer. It is not recommended that resident TeX fonts be
  scaled; these are bit-map fonts designed to be used only at a
  specific magnification.
2 TeX-XeT_support

  The DVIOUT program supports the extension to TeX that allows mixing
  of right-to-left text within left-to-right text as described in the
  article by Donald Knuth and Pierre MacKay in the April, 1987 issue
  of TUGboat magazine, pages 14-25. It assumes the implementation that
  is described in the Appendix of that article. Native fonts on some
  types of output devices may not be able to support mirror-imaging.
2 Examples
  1. DVIOUT /DEVICE=TEK4014 /HOFFSET=.5in /VOFFSET=.6in /MAG=MAG2 TEXPUT

  Specifies that the file TEXPUT.DVI be output to the Tektronix 4014
  graphics terminal using a magnification of 1.44 and the position of the
  upper left corner of the page is (.5,.6) inches.

  2. DVIOUT /DEVICE=APPLE_LASERWRITER /ODD_PAGES /MEMORY=1024 -
            /OUTPUT=TEMP.PS MYFILE1.TMP,MYFILE2.TMP,MYFILE3.TMP /COPIES=3

  Specifies that the odd pages of files MYFILE1.TMP, MYFILE2.TMP and
  MYFILE3.TMP be output to a PostScript file named TEMP.PS, and that the
  LaserWriter has 1 megabyte of available memory. Further, three copies
  of the last file are to be generated. Note that three versions of the
  output file TEMP.PS will be created.

  3. DVIOUT /DEVICE=TEK4014 /COPIES=2 /INTERACTIVE /LANDSCAPE SLIDES

  Specifies that 2 copies of file SLIDES.DVI be output to the Tektronix
  4014 terminal using landscape mode, and that the user is to be prompted
  for input to continue between each page.

  4. DVIOUT /DEVICE=APPLE_LASERWRITER MANUAL /PAGES=(1,5,35:40)

  Specifies that pages 1 and 5 and pages 35 through 40 of file
  MANUAL.DVI be output to the PostScript file MANUAL.PS.
2 LaserWriter_problems
  The Apple LaserWriter is a rather cantankerous device. The resident
  software has a few "features" that make processing of large documents
  very difficult, if not impossible. To get around the memory (and
  intelligence) limitations of the LaserWriter, the following steps can
  be taken:

  a) Specify a smaller amount of memory (/MEMORY=nnn) if you run out
     of memory after all fonts have been loaded (some output is present)
     and before the job is completed. This may also be of some limited
     benefit if memory is exceeded while loading fonts. The LaserWriter
     software does no garbage collection, so memory is consumed as each
     page is built up. If individual pages are not too complicated,
     things should work satisfactorily (a page full of "cminch"
     characters could cause problems, for example, because they are so
     large).

  b) Specify a subset of pages and print the document in smaller sec-
     tions. Or do just odd pages (/ODD) or even (/EVEN) pages.

  c) Provide for setup files to be printed before the PostScript file
     is printed that allow more memory to be available for the print
     job. This will consist primarily of setting up a smaller frame
     buffer in the LaserWriter (if your output is margined by TeX's
     standard 6.5 by 9 inch size, this works nicely, more than doubling
     available memory). The LaserWriter procedure "note" frees up about
     100K bytes. This should be available using the /SETUP option with
     the VMS "PRINT" command (check with your system manager).
2 Special_Commands
  TeX provides the capability to communicate special requirements to
  the DVIOUT program through use of the \special control sequence.
  The argument to \special specifies a command to be executed by
  DVIOUT. The command consists of a command verb, one or more arguments,
  and optional qualifiers; the syntax is very similar to the VMS DCL
  language syntax. Currently, the following commands are supported:

    PASTE       Provides the capability to imbed graphics in the output
    LINE        Generates a line segment
    POINT       Generates a solid point
    ARC         Generates an arc segment
    FILL        Generates a filled polygon
    XYDEF       Saves the current (h,v) position for later use
    BBAR        Saves the current v position for use with LBAR and RBAR
    LBAR        Draws a black bar in the left margin
    RBAR        Draws a black bar in the right margin
    LWIDTH      Changes the line width of line and arc segments
    LSTYLE      Changes the line style of line and arc segments
    COLOR       Changes the color of all subsequent output
    SAVE        Saves the current graphics attributes
    RESTORE     Restores graphics attributes from saved state
3 PASTE
  Format:  PASTE input_file protocol width depth

  Execution of this command causes the specified graphics data file to be
  read in and interpreted. Output is generated in a box defined with the
  upper left corner at the current page position having the indicated
  width, depth and optional orientation. Additionally, the relative
  picture number can be specified if the graphics file contains multiple
  pages of data.
4 Parameters
 input_file

  Specifies the name of the file containing the graphics data. The file
  can be a standard VMS file name specification, or it can be of the
  form:

    libfile(module)

  where 'libfile' is the name of a VMS text library and 'module' is the
  name of a module within the library.

  The default file extension for PostScript files is "PS", for Tektronix
  4014 files it is "TEK" and for MacPaint files the default file
  extension is "MCP".

 protocol

  Specifies the protocol used within the input graphics file. Currently,
  the protocols supported by DVIOUT are:

    TEK4014     Tektronix 4010/4014. The device space of 4096X by 3120Y
                is mapped to the output box.
    MACPAINT    MacPaint file. The 576 by 720 pixel bitmap image is
                scaled and mapped to the output box (see MacPaint_Tips).
    PAINT       Same as MACPAINT.
    POSTSCRIPT  A picture defined using PostScript. The 8.5 by 11 inch
                page is mapped to the box (page size can be changed using
                /OPTIONS). This is only supported for PostScript output
                devices.

 width

  Specifies the width of the box to contain the graphics output. The
  dimension specified is any dimension acceptable to TeX, except for
  font dependent dimensions. Acceptable dimension units are:

  pt: point         pc: pica          in: inch          bp: big point
  cm: centimeter    mm: millimeter    dd: didot         cc: cicero
  sp: scaled point

 depth

  Specifies the depth of the box to contain the graphics output. The
  dimension specified is any dimension acceptable to TeX, except for
  font dependent dimensions. Acceptable dimension units are:

  pt: point         pc: pica          in: inch          bp: big point
  cm: centimeter    mm: millimeter    dd: didot         cc: cicero
  sp: scaled point
4 Qualifiers
/ORIENTATION

 /ORIENTATION=direction

  Specifies the direction "up" has in the output box. The four possible
  values are:

    UP          The picture is in its normal orientation (default)
    DOWN        The picture is upside-down
    LEFT        The top of the picture is on the left
    RIGHT       The top of the picture is on the right

  Note that there is an interaction between the box's size and the
  orientation, unless the box is square. The user must ensure that the
  box's size and orientation match the normally expected aspect ratio
  of the device (if any) characterized by the protocol being used (not
  applicable for MacPaint images, which are always 1-to-1).

/PICTURE

 /PICTURE=picture_number

  Specifies the relative picture number within the input graphics file
  that is to be used, presuming the input graphics file contains
  multiple images. The default value is 1.

/OPTIONS

 /OPTIONS=list

  Specifies device-dependent options to be applied during the PASTE
  operation. If more than one option is specified, the list should
  be enclosed in parentheses.

  Default options lists can be provided in the DVIOUT options file,
  specified with the /OPTIONS qualifier on the main command line.
  Alternately, a set of default options files can be provided by
  your site manager.
4 TEK4014_Options

  The options that can be specified for the Tektronix 4010/4014
  PASTE operation are as follows:

    [NO]EGM               Enhanced Graphic Module emulation -
                            this allows dashed lines and 12 bit
                            addressing (4096 X 4096)
    [NO]CRLF              Carriage Return implies Line Feed
    [NO]LFCR              Line Feed implies Carriage Return
    [NO]ALTDEL            ESC ? can be used instead of DEL
    SELECT=select_option  Select character set
    MARGIN=margin_option  Specify margin option

  The default options are /OPTIONS=(EGM,ALTDEL,SELECT=ASCII,
                                    MARGIN=OFF,NOCRLF,NOLFCR)
5 Select_Options

  The values that can be specified for the SELECT option are:

    ASCII                 ASCII character set used
    ALT                   Alternate (APL) character set used
    PROGRAM               Character set selection under program
                            control

  Currently, the APL character set is not available within the
  Tektronix emulator, so the SELECT option will not have any
  effect. The default is SELECT=ASCII.
5 Margin_Options

  The values that can be specified for the MARGIN option are:

    ONE or 1              Page full indication when margin 1
                            overflows
    TWO or 2              Page full indication when margin 2
                            overflows
    OFF                   No page full indication

  The default is MARGIN=OFF.
4 PostScript_Options

  The options that can be specified for the PostScript PASTE
  operation are as follows:

    WIDTH=dimension       Page width of the PostScript image
    HEIGHT=dimension      Page Height of the PostScript image

  Acceptable dimension units are pt, pc, in, bp, cm, mm, dd,
  cc and sp. If specified, the portion of the page from (0,0)
  to (width,height) is mapped to the PASTE box. The default
  is WIDTH=8.5in and HEIGHT=11in.
4 MacPaint_Tips

  The pasting of MacPaint images into the output is limited to
  integer scaling of the bitmap contained in the input file. The
  scale factor is chosen so that the image will fit, without
  truncation, into the output area. If the area is too small to hold
  the image at a scale factor of one, the image is truncated at the
  boundaries. In all cases, the image is truncated, if necessary, at
  the bottom of the output area, permitting just the upper part of
  the MacPaint picture to be generated.

  With this in mind, the dimensions of the output area should be
  chosen to be multiples of a 576 by 720 pixel area. On a 300 dpi
  device, the width should be a multiple of 1.92 inches, and, if
  full-height pictures are to be generated, the height should be
  the same multiple times 2.4 inches. These dimensions are reversed
  for left and right (i.e. landscape) orientations.
4 Notes_on_PostScript

  The processing of PostScript files is only supported on PostScript
  output devices. Attempts to PASTE a PostScript file for other types
  of devices will result in an error and no output being produced.

  Every effort has been made to make sure the PostScript commands
  within the included file do not interfere with the processing of
  normal output. However, it is quite possible that PostScript
  commands in the included file can foul up DVIOUT's PostScript
  output. The following guidelines and restrictions should be followed:

    The included PostScript file should not contain any errors. If an
    error does occur, DVIOUT will attempt to recover and continue
    processing the job. The box containing the picture is cleared and
    an error summary is generated to help the user locate the problem.

    The "setmatrix" operator must not be used, and the operation
    of standard PostScript operators must not be changed. If either
    of these things occur, the results are undefined.

    PostScript names beginning with "DVI@" are reserved to DVIOUT.
    Other names may be in use by the print spooler as well. Also,
    several definitions in userdict exist, whose operation must
    not be interfered with (your included file must share resources
    with DVIOUT and the print spooler).

    The file should not contain multiple pages (this may be allowed
    sometime in the future). It can, however, contain one "showpage"
    (or copypage) command.

    DVIOUT changes the operation of the operators "erasepage",
    "showpage", "copypage", "defaultmatrix", "initmatrix",
    "initgraphics", and "initclip". They have been re-defined to
    do things consistent with the mini-page PASTE environment.
    The default behavior of these operators should not be expected,
    although they can be used as if in a full-page environment.

    A fair amount of space in userdict is used by DVIOUT. It is
    suggested that your PostScript program define as few new operators
    as possible; or, create and use your own dictionary for new
    definitions.
3 LINE
  Format:  LINE (x1,y1) (x2,y2)

  Draws a line segment from (x1,y1) to (x2,y2) using the current
  line width and line style. The endpoints of the line segment are
  specified relative to the current (h,v) position.

  If the current line style is not solid, the gaps between the solid
  line segments of the dashed line are transparent, rather than opaque
  (that is, they do not 'white-out' anything underneath).
4 Parameters
 (x1,y1)

  Specifies the (x,y) coordinates of the first endpoint of the line
  segment. These coordinates are relative to the current (h,v) position.
  The coordinates are dimensions of the form acceptable to TeX, except
  for font dependent dimensions. Acceptable dimension units are pt, pc,
  in, bp, cm, mm, dd, cc and sp. If "*" is specified, the next defined
  (x,y) coordinate pair is used.

 (x2,y2)

  Specifies the (x,y) coordinates of the second endpoint of the line
  segment. These coordinates are relative to the current (h,v) position.
  The coordinates are dimensions of the form acceptable to TeX, except
  for font dependent dimensions. Acceptable dimension units are pt, pc,
  in, bp, cm, mm, dd, cc and sp. If "*" is specified, the next defined
  (x,y) coordinate pair is used.
3 POINT
  Format:  POINT (x,y) diameter

  Outputs a solid point with the specified diameter at (x,y). The
  position of the point is specified relative to the current (h,v)
  position.
4 Parameters
 (x,y)

  Specifies the (x,y) coordinates of the point. These coordinates are
  relative to the current (h,v) position. The coordinates are dimensions
  of the form acceptable to TeX, except for font dependent dimensions.
  Acceptable dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp.
  If "*" is specified, the next defined (x,y) coordinate pair is used.

 diameter

  Specifies the diameter of the point. The diameter can be any dimension
  acceptable to TeX, except for font dependent dimensions. Acceptable
  dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp.
3 ARC
  Format:  ARC (x,y) radius start_ang stop_ang

  Outputs an arc segment with (x,y) and radius defining the center and
  radius, respectively, of the circle containing the arc segment. An
  arc is subtended from start_ang to stop_ang. If the stop angle is
  greater than the start angle, a clockwise arc segment is drawn,
  otherwise a counter-clockwise segment is drawn. Angles are measured
  positive clockwise from the 3 o'clock position. The current 
  linestyle is used to generate the arc segment. The center of the
  circle is specified relative to the current (h,v) position.

  If the current line style is not solid, the gaps between the solid
  line segments of the dashed line are transparent, rather than opaque.
  The result of making the radius less than the current line width is
  undefined.
4 Parameters
 (x,y)

  Specifies the (x,y) coordinates of the center of the circle
  containing the arc segment. These coordinates are relative to the
  current (h,v) position. The coordinates are dimensions of the form
  acceptable to TeX, except for font dependent dimensions. Acceptable
  dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp. If "*" is
  specified, the next defined (x,y) coordinate pair is used.

 radius

  Specifies the radius of the circle containing the arc segment.
  The radius can be any dimension acceptable to TeX, except for font
  dependent dimensions. Acceptable dimension units are pt, pc, in, bp,
  cm, mm, dd, cc and sp.

 start_ang

  Specifies the starting angle that defines the arc. The angle is
  measured positive clockwise from the 3 o'clock position.

 stop_ang

  Specifies the ending angle that defines the arc. The angle is
  measured positive clockwise from the 3 o'clock position. If
  start_ang is less than stop_ang, a clockwise arc segment is drawn;
  otherwise a counter-clockwise arc segment is drawn.
3 XYDEF
  Format:  XYDEF

  Saves the current (h,v) position for later use. The values are
  accessed in a last-in, first-out fashion (i.e., a stack). A given
  (h,v) pair can be used in any of the graphics commands that require
  one or more (x,y) coordinate pairs (line endpoints, center of arc,
  polygon vertices, etc.) by specifying "*" instead of the usual (x,y)
  pair.

  The defined entries persist over page boundaries and are not
  affected by SAVE/RESTORE operations. All defined entries must be
  used by the completion of the document.
3 BBAR
  Format:  BBAR y

  Saves the current vertical position, adjusted by the specified y
  offset value. The saved value can then be used with subsequent
  LBAR or RBAR commands. The BBAR command cannot be nested; if it is
  nested, all but the first BBAR and last LBAR or RBAR are ignored.
4 Parameters
 y

  Specifies the y coordinate of one endpoint of the bar. The coordinate
  is relative to the current vertical position. The coordinate is a
  dimension of the form acceptable to TeX, except for font dependent
  dimensions. Acceptable dimension units are pt, pc, in, bp, cm, mm, dd,
  cc and sp. If "*" is specified, the y component of the last defined
  (x,y) coordinate pair is used.
3 LBAR
  Format:  LBAR y width offset

  Draws a black bar in the left margin from the point defined by a
  previous BBAR command and the point specified in this command. The
  bar is drawn using the specified width and is positioned the specified
  offset from the left edge of the paper. This capability can partially
  implement change bars which indicate the portion(s) of a page that have
  undergone revision. The endpoint of the bar is specified relative to
  the current vertical position.

  Bars cannot span pages. Because of this, additional layering of change
  bar capability must be done within TeX or LaTeX. In particular, if a
  change is active and a new page is output, the output routine must
  insert \specials at the appropriate spots in the vertical lists for the
  current page and the next page. This \special simply provides a basic
  capability that is difficult, maybe impossible, to do in TeX (i.e.,
  putting something at a specific vertical position on the page without
  regard for the horizontal position).

  A very simple way of using this feature, where the changes do not span
  pages, would be to define the following control sequences:

    \newdimen\lineheight
    \def\bchange{\lineheight=-.8\baselineskip
                 \leavevmode\special{BBAR \the\lineheight}}
    \def\echange{\special{LBAR 0pt 0.05in 0.75in}}

  and bracket the changed sections of text by \bchange and \echange pairs.
  You must keep in mind where the current (h,v) position is when using
  \specials; the location is affected by the current TeX mode (horizontal
  or vertical), the effects of surrounding glue, and other arcane things.
  The problems are particularly sticky (literally) around paragraph and
  page breaks. In the above example, it was necessary to offset the BBAR
  point to the top of the line to make sure the bar covers the entire
  line (otherwise the location would be at the baseline of the current
  line, and would not produce the desired result). The \leavevmode control
  sequence is one that seems always to have to precede a box (\specials
  are treated like tiny boxes) in order to get the box properly inserted
  in the intended horizontal list.
4 Parameters
 y

  Specifies the y coordinate of the endpoint of the bar. The coordinate
  is relative to the current vertical position. The coordinate is a
  dimension of the form acceptable to TeX, except for font dependent
  dimensions. Acceptable dimension units are pt, pc, in, bp, cm, mm, dd,
  cc and sp. If "*" is specified, the y component of the last defined
  (x,y) coordinate pair is used.

 width

  Specifies the width of the bar. The width can be any positive non-zero
  dimension acceptable to TeX, except for font dependent dimensions.
  Acceptable dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp.

 offset

  Specifies the offset from the left edge of the paper to the center of
  the bar. The offset value can be any positive non-zero dimension
  acceptable to TeX, except for font dependent dimensions. Acceptable
  dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp.
3 RBAR
  Format:  RBAR y width offset

  Draws a black bar in the right margin from the point defined by a
  previous BBAR command and the point specified in this command. The
  bar is drawn using the specified width and is positioned the specified
  offset from the right edge of the paper. This capability can partially
  implement change bars which indicate the portion(s) of a page that have
  undergone revision. The endpoint of the bar is specified relative to
  the current vertical position.

  For more information on this \special, see the discussion for LBAR.
4 Parameters
 y

  Specifies the y coordinate of the endpoint of the bar. The coordinate
  is relative to the current vertical position. The coordinate is a
  dimension of the form acceptable to TeX, except for font dependent
  dimensions. Acceptable dimension units are pt, pc, in, bp, cm, mm, dd,
  cc and sp. If "*" is specified, the y component of the last defined
  (x,y) coordinate pair is used.

 width

  Specifies the width of the bar. The width can be any positive non-zero
  dimension acceptable to TeX, except for font dependent dimensions.
  Acceptable dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp.

 offset

  Specifies the offset from the right edge of the paper to the center of
  the bar. The offset value can be any positive non-zero dimension
  acceptable to TeX, except for font dependent dimensions. Acceptable
  dimension units are pt, pc, in, bp, cm, mm, dd, cc and sp.
3 FILL
  Format:  FILL (x1,y1),(x2,y2),...,(xn,yn) columns bitsize pattern

  Outputs a filled polygon with n vertices (x1,y1),(x2,y2),...,(xn,yn)
  using the specified fill pattern. No edge of the polygon can cross
  another edge of the polygon. If the polygon has edges that cross,
  the outcome of the operation is undefined. The polygon must have at
  least three vertices specified. Optionally, the perimeter of the
  polygon will be drawn with the current line width and style.

  The resulting filled polygon will be opaque; that is, it will cover
  anything drawn before which overlaps it. It is possible, however,
  that opaque filling is not possible on some types of output devices
  (the resulting filled polygon is transparent), so it is recommended
  that nothing be output that will overlap the filled polygon.
4 Parameters
 (x1,y1),(x2,y2),...,(xn,yn)

  Specify the (x,y) coordinates of the polygon vertices. These are
  dimensions expressed relative to the current (h,v) position.
  Acceptable dimension units are pt, pc, in, bp, cm, mm, dd, cc and
  sp. The number of supplied coordinates must be at least three.
  If "*" is specified for one or more (x,y) coordinates, the next
  defined (x,y) coordinate pair is used.

 columns

  Specifies the number of columns in the pattern specification (that
  is, the width of the pattern). If this number is zero, a solid
  pattern of the current color is used to fill the polygon. The next
  two parameters are not used if this value is zero.

 bitsize

  Specifies the width and height of each 'bit' in the pattern bitmap.
  It may be any valid dimension, except zero or negative values,
  specified in units of pt, pc, in, bp, cm, mm, dd, cc or sp.

 pattern

  Specifies the fill pattern to use in the interior of the polygon.
  The pattern specification consists of a list of hexadecimal values
  that describe the fill pattern for each successive row of the
  pattern. Each hexadecimal digit represents four 'bits', where the
  width and height of a 'bit' are specified by the bitsize parameter.
  A bit with a 1 value indicates an 'on' (black) condition; 0 repre-
  sents 'off' (white).

  The maximum length of each row cannot exceed the width given by the
  columns parameter. If the row pattern specification length is less
  than the number of columns, that row is padded with zeros to make up
  the difference. Therefore, each row pattern consists of
  [(columns + 3) div 4] hexadecimal digits. The last 1-3 bits of the
  last hex digit should be zeros if the number of columns in the
  pattern is not an exact multiple of four. The maximum number of
  hexadecimal digits that can be processed is 255, limiting the number
  of columns in the pattern to 1020.

  The number of rows in the pattern is determined by the number of
  values in the list. The pattern thus specified will be repeated as
  necessary to fill the entire polygon. Adjacent or overlapping
  polygons using the same fill pattern will merge in such a way that
  the fill patterns of the two polygons are properly 'synchronized'.
4 Qualifiers
 /PERIMETER

  /PERIMETER
  /NOPERIMETER

  Specifies whether the lines around the perimeter of the polygon
  are to be drawn. If /PERIMETER is specified, the perimeter of the
  polygon is drawn using the current line width and line style.

3 LWIDTH
  Format:  LWIDTH width

  Specifies the width of subsequent line and arc segments.
4 Parameters
 width

  The width can be any dimension acceptable to TeX, except for font
  dependent dimensions such as em and ex. Acceptable dimension units
  are pt, pc, in, bp, cm, mm, dd, cc and sp.
3 LSTYLE
  Format:  LSTYLE style

  Specifies the line style to use for subsequent line segments and
  arc segments.
4 Parameters
 style

  The line style may be expressed in two forms. The first form may
  give one of the following names:

      SOLID		Specifies a solid line
      DOTTED            Specifies a dotted line
      DASHED            Specifies a dashed line
      DOTDASH           Specifies a dot-dash line.

  The second form allows the individual visible and invisible
  segments of the line to be specified. This is done by specifying
  a comma-separated list of lengths that alternately give the length
  of visible and invisible segments of the line. These lengths are
  in units of line width -- the actual length of the resulting line
  segments are a function of the line's width. An example that
  produces a dot-dot-dot-dash style would be:

      LSTYLE 1,1,1,1,1,1,6,1

  Segment indices 1,3,5,... specify visible segments and segment
  indices 2,4,6,... specify invisible segments. There should always
  be an even number of segments. The maximum number of segments that
  can be specified is 20.
3 COLOR
  Format:  COLOR hue

  Execution of this command sets the color for subsequent output to the
  device. It only has an effect if the output device supports color. On
  some devices, this may cause the gray level of subsequent output to
  change. On devices with a limited number of output colors, the color
  most closely matching the color specification will be used.

  Care must be taken to ensure that \special commands containing color
  changes are implemented in a way which allows the scope of the color
  change to be controlled. For example, TeX has no way of knowing what
  effects \special commands have on the device; therefore it is unable to
  restore the color rendition when a color change has occurred within a
  group, unlike changes to fonts and TeX internal registers.
4 Parameters
 hue

  Specifies the hue of the color. Any of the following colors can be
  specified:

    RED   GREEN   BLUE   CYAN   MAGENTA   YELLOW   BLACK   WHITE

  Additionally, a color mix can be specified using two different color
  models. These are:

    RGB=red:green:blue

      Assigns a color according to the RGB (red-green-blue) color model.
      The parameters specify the amount, in percent, of each of the
      three primary colors used to produce the resulting color.

    HLS=hue:lightness:saturation

      Assigns a color according to the HLS (hue-lightness-saturation)
      color model. The hue parameter is a number from 0 to 360, with
      0=blue, 60=magenta, 120=red, 180=yellow, 240=green and 300=cyan,
      with numbers between these representing other intermediate colors.

      The lightness parameter ranges from 0 (black) to 100 (white), and
      is a measure of the brightness of the resulting color. A value of
      50 describes a normally bright color; a value above 50 represents
      a lighter color, such as pink; and a value below 50 represents
      a dark color, such as indigo or maroon. When the lightness is
      either 0 or 100, the hue parameter has no effect.

      The saturation parameter is a value from 0 (minimum saturation)
      to 100 (maximum saturation), and represents the amount of
      additional white added to the pure color defined by the hue. A
      saturation of 0 results in a shade of gray, with the gray level
      then determined by the lightness parameter (hue has no effect
      when the saturation is zero). A 'pure' color is one with a
      saturation of 100, that is, a color that contains no white.
3 SAVE

  Saves the current line style, line width, and color. Use the RESTORE
  command to restore the attributes in effect at the time the SAVE is
  performed. It is recommended that SAVE/RESTORE operations always be
  performed around a set of graphics operations. In particular, if the
  color is changed, it is usually necessary to make sure that the
  change is not persistent, since the color setting also affects non-
  graphical output.
3 RESTORE

  Restores the line style, line width, and color from a previous
  saved state.
