! Help topics for DVItoVDU.  Keep lines < 77 characters long and
! watch for !, / and numbers in column 1.
! Details peculiar to our site are indicated by the string "! SYSDEP".
! Feel free to make modifications applicable to your site.
!
1 DVItoVDU

 USAGE:  DVItoVDU filename[.DVI] [qualifiers]

 DVItoVDU is an interactive previewer that allows you to look at
 TeX-generated DVI pages on a variety of commonly available VDUs.
 The "DVItoVDU User Guide" has more details on how to use the program.
! SYSDEP
 To print your own copy just type:

    $ lntex Tex_disk:[TEX.DVITOVDU]USERGUIDE
!
! Now keep lines < 75 chars long.
!
2 Commands_in_brief

 MISCELLANEOUS
 -------------
 ?          Display brief help on all the commands.
 S          Show various qualifier values and current page statistics.
 Q          Quit from DVItoVDU.

 SELECTING A PAGE
 ----------------
 i          Select the ith DVI page; i must be a positive integer from
            1 to n where n is the total number of pages in the DVI file.
 [i0...i9]  Select the DVI page whose TeX page counters match the given
            integers, i0 to i9, separated by periods.  Any number of
            integers may be absent; an absent integer matches any value
            in the corresponding counter. Trailing periods may be omitted.
            If more than one DVI page matches, the lowest will be chosen.
 N          Select the Next DVI page, depending on current direction.
 >          The N command will move forwards through the DVI file.
 <          The N command will move backwards through the DVI file.

 CHANGING THE WAY A PAGE IS DISPLAYED
 ------------------------------------
 T          Terse display of characters; fast but inaccurate.
 B          Box display showing rectangular outlines of characters.
 F          Full display of all pixels in characters; accurate but slow.

 CHANGING THE UNITS OF DIMENSIONS
 --------------------------------
 IN         Get/show dimensions in terms of inches
            (/RESOLUTION value = pixels per inch).
 CM         Get/show dimensions in terms of centimetres (2.54cm = 1in).
 MM         Get/show dimensions in terms of millimetres (10mm = 1cm).
 PC         Get/show dimensions in terms of picas (1pc = 12pt).
 PT         Get/show dimensions in terms of points (72.27pt = 1in).
 PX         Get/show dimensions in terms of pixels.

 CHANGING THE SIZE OF THE WINDOW
 -------------------------------
 H wd       Set the Horizontal size of the window to the given width.
            If wd absent, set width to initial, unscaled value.
 V ht       Set the Vertical size of the window to the given height.
            If ht absent, set height to initial, unscaled value.
 ZI         Zoom In by halving the current window dimensions.
 ZO         Zoom Out by doubling the current window dimensions.

 MOVING THE WINDOW OVER A PAGE
 -----------------------------
 W h,v      Move the Window's top left corner to given paper position.
            h is the horizontal coordinate, v is the vertical coordinate.
            If h,v is absent then the window is moved to (Minh,Minv),
            the top left corner of the page rectangle.
 U v        Move window Up v units. If v absent, move up an amount
            equal to the window's current height.
 D v        Move window Down v units. If v absent, move down an amount
            equal to the window's current height.
 L h        Move window Left h units. If h absent, move left an amount
            equal to the window's current width.
 R h        Move window Right h units. If h absent, move right an amount
            equal to the window's current width.

2 Qualifiers

/VDU=string   (default=VT100)

 This qualifier is used to tell DVItoVDU what type of VDU you are using.
 For example, typing `dvitovdu/vdu=vis550 foo' will tell DVItoVDU you're
 using a VISUAL 550.

 The current version of DVItoVDU will accept the following /VDU values:

 AED483    (AED 512 with 512 by 483 screen)
 AED512    (AED 512 with 512 by 512 screen)
 ANSI      (any ANSI compatible VDU; synonym = VT100)
 REGIS     (any ReGIS compatible VDU; synonyms = GIGI, VK100, VT125, VT240)
 VIS240    (VISUAL 240; synonym = VIS241)
 VIS500    (VISUAL 500)
 VIS550    (VISUAL 550)
 VT100132  (any VT100 compatible VDU in 132 column mode)
 VT220     (VT220 using down-loaded chunky graphics; synonym = VT200)
 VT640     (VT100 with Retro-Graphics)

/XSIZE=dimen   (default=210mm=8.3in)
/YSIZE=dimen   (default=297mm=11.7in)

 These two qualifiers define the dimensions of the paper upon which your
 document will be printed.  Both values are specified as dimensions
 similar to those used in TeX but units are restricted to IN, CM, MM, PC,
 PT or PX (these two-letter sequences are the same as the commands used
 to change the units of dimensions).
 Every time you select a page, DVItoVDU will use these paper dimensions
 to check that the page edges fall within the paper edges.
! SYSDEP
 Note that their default values specify A4 paper.

/MAGNIFICATION=i   (default=DVI magnification)

 This option allows you to replace the DVI magnification with some other
 value; i is a positive integer 1000 times the desired magnification.

! SYSDEP
 If you plan to use LNTEX's /MAGNIFICATION qualifier, you should supply
 the same override to DVItoVDU; that way you'll see exactly what the
 document will look like when printed.
 Unless you know what you are doing you should avoid using /MAGNIFICATION,
 especially if your TeX source uses \magnification AND true dimensions.
 The complete story on magnification can be found in chapters 4 and 10
 of "The TeXbook".

/TFM_DIRECTORY=directory   (default=TEX_FONTS:)
 DVItoVDU needs to read TFM files if your document uses resident PostScript
 fonts (for which bitmapped information does not exist).
 DVItoVDU assumes that all such fonts have names beginning with "PS-".

/FONT_DIRECTORY=directory   (default=TEX_DISK:[TEX.PK])

 DVItoVDU gets all its bitmapped font information from files
 located in the given directory.

/DUMMY_FONT=file   (default=CMR10.300PK)

 If a requested font does not exist, DVItoVDU will first warn you, then
 load the given font file (located in /FONT_DIRECTORY) and continue as best
 it can so you can look for more errors.  Paragraphs using this dummy
 information are likely to have ragged right margins.
!
! SYSDEP: The above two qualifiers are used to tell DVItoVDU what type
! of bitmapped fonts you're using, and their location and naming convention.
! See DVITOVDU.CLD for more details.

/RESOLUTION=i   (default=300)

 DVItoVDU treats the imaginary sheet of paper on which a DVI page will
 appear as a two dimensional array of tiny dots known as pixels
 (short for "picture elements").
 i is a positive integer that defines the number of pixels per inch,
 horizontally and vertically.  Its value should match the resolution
 of the device that will be used to print your document.
 Most laser printers currently have a resolution of 300 dots per inch.

/HELP_FILE=file   (default=TEX_DISK:[TEX.DVITOVDU]HELP)

 The ? command reads the text file specified by this qualifier.
 The default help file contains a brief summary of all the commands.
