!
! DO NOT EDIT THIS FILE.  It was produced by passing a .RNH file through
! RUNOFF.  Edit the .RNH file instead.
!
1 XDVI
 XDVI is a program which runs under the DECWindows system.  It is used
 to preview DVI files, such as those produced by TeX and LaTeX.

 XDVI has the capability of displaying the  file  reduced  by  various
 (integer) factors, and also has a "magnifying glass" which allows one
 to see a small part of the unshrunk image momentarily.

 Before displaying any page or part thereof, XDVI checks to see if the
 DVI  file  has changed since the last time it was displayed.  If this
 is the case, XDVI will reinitialize itself for the new DVI file.  For
 this  reason,  exposing parts of the XDVI window while TeX is running
 should be avoided.  This feature allows you to preview many  versions
 of the same file while running XDVI only once.

 Format:

    XDVI [Options] dvi_file
2 Options
 In addition to specifying the .DVI file (with or without  the  .DVI),
 XDVI  supports  the  following  command  line options.  If the option
 begins with a "+" instead of a "-", the option  is  restored  to  its
 default value.  By default, these options can be set via the resource
 names given in the description of each option.
3 +
 +<page>

 Specifies the first page to show.  If + is given  without  a  number,
 the last page is assumed; the first page is the default.
3 -altfont
 -altfont <font>

 Declares a default font to use when the font in the DVI  file  cannot
 be found.  This is useful, for example, with PostScript fonts.

 The resource name is ".altFont".
3 -background
 -background <color>

 Same as -bg.
3 -bd
 -bd <color>

 Determines the color of the window border.

 The resource name is ".borderColor".
3 -bg
 -bg <color>

 Determines the color of the background.

 The resource name is ".background".
3 -bordercolor
 -bordercolor <color>

 Same as -bd.
3 -borderwidth
 -borderwidth <width>

 Same as -bw.
3 -bw
 -bw <width>

 Specifies the width of the border of the window.

 The resource name is ".borderWidth".
3 -copy
 Always use the copy operation when writing characters to the display.
 This  option  may  be  necessary  for  correct  operation  on a color
 display, but overstrike characters will be incorrect.

 The resource name is ".copy".
3 -cr
 -cr <color>

 Determines the color of the cursor.  The default is the color of  the
 page border.

 The resource name is ".cursorColor".
3 -density
 -density <density>

 Determines the density used when  shrinking  bitmaps  for  fonts.   A
 higher value produces a lighter font.  The default value is 40.

 The resource name is ".densityPercent".
3 -display
 -display <display>

 Specifies the host, display, and screen to be used for displaying the
 DVI   file.    The   display   must   be   specified   in   the  form
 node::display.screen.  The default is obtained from the logical  name
 "DECW$DISPLAY", which may be defined using the SET DISPLAY command.
3 -fg
 -fg <color>

 Determines the color of the text (foreground).

 The resource name is ".foreground".
3 -foreground
 -foreground <color>

 Same as -fg.
3 -geometry
 -geometry <geometry>

 Specifies the initial geometry of the window.

 The resource name is "*geometry".
3 -hl
 -hl <color>

 Determines the  color  of  the  page  border.   The  default  is  the
 foreground color.

 The resource name is ".highlight".
3 -icongeometry
 -icongeometry <geometry>

 Specifies the initial position for the icon.

 The resource name is ".iconGeometry".
3 -iconic
 -iconic

 Causes the XDVI window to start in the iconic state.  The default  is
 to start with the window open.

 The resource name is ".iconic".
3 -l
 Causes the names of the fonts used to be listed.

 The resource name is ".listFonts".
3 -p
 -p <pixels>

 Defines the size of the fonts  to  use,  in  pixels  per  inch.   The
 default value is 300.

 The resource name is ".pixelsPerInch".
3 -paper
 -paper <papertype>

 Specifies the size of the printed page.  This may be of the form  WxH
 (or  WxHcm),  where  W  is  the  width in inches (or cm) and H is the
 height in inches (or cm),  respectively.   There  are  also  synonyms
 which  may  be  used:   us  (8.5x11),  usr  (11x8.5), legal (8.5x14),
 foolscap (13.5x17), as well as the ISO  sizes  a1-a7,  b1-b7,  c1-c7,
 a1r-a7r (a1-a7 rotated), etc.  The default size is 8.5 x 11 inches.

 The resource name is ".paper".
3 -margins
 -margins <inches>

 Specifies the size of both the top and side margins.  This can  be  a
 decimal  number,  e.g.,  1.5.  XDVI determines the "home" position of
 the page within the window as follows.  If the entire  page  fits  in
 the  window,  then  the  margin settings are ignored.  If, even after
 removing the margins from the left, right, top, and bottom, the  page
 still  cannot  fit  in the window, then the page is put in the window
 such that the top and left margins are  hidden,  and  presumably  the
 upper  left-hand  corner of the text on the page will be in the upper
 left-hand corner of the window.  Otherwise, the text is  centered  in
 the window.  See also `M' under the Keystrokes help entry.

 The resource name is ".margins".
3 -mgs[n]
 -mgs[n] <size>

 Specifies the size of the window  to  be  used  for  the  "magnifying
 glass"  for  Button  n.  See the MOUSE ACTIONS section.  Defaults are
 200, 350, 600, 900, and 1200.

 The resource name is ".magnifierSize[n]".
3 -mgs
 -mgs <size>

 Same as -mgs1.
3 -rv
 Causes the page to be displayed with  white  characters  on  a  black
 background, instead of vice versa.

 The resource name is ".reverseVideo".
3 -s
 -s <shrink>

 Defines the initial shrink factor.  The default value is 3.

 The resource name is ".shrinkFactor".
3 -sidemargin
 -sidemargin <inches>

 Specifies the side margin (see -margins).

 The resource name is ".sideMargin".
3 -thorough
 XDVI will usually try to ensure  that  overstrike  characters  (e.g.,
 \notin)  are  printed  correctly.   On  monochrome  displays, this is
 always possible with one logical operation, either  AND  or  OR.   On
 color displays, however, this may take two operations, one to set the
 appropriate bits and one to clear other bits.  If this is  the  case,
 then  by default XDVI will instead use the copy operation, which does
 not handle overstriking correctly.  The "thorough" option chooses the
 slower but more correct choice.  See also -copy.

 The resource name is ".thorough".
3 -topmargin
 -topmargin <inches>

 Specifies the top and bottom margins (see -margins).

 The resource name is ".topMargin".
2 Keystrokes
 Xdvi recognizes the following keystrokes when typed  in  its  window.
 Each  may  optionally be preceded by a (positive or negative) number,
 whose interpretation will depend on the particular  keystroke.   Note
 that the keystrokes are case sensitive.
3 q
 Quits the program.  Control-C and control-D will do this, too.
3 n
 Moves to the next page (or to the  nth  next  page  if  a  number  is
 given).  Synonyms are `f', Space, Return, and Line Feed.
3 p
 Moves to the previous page (or back  n  pages).   Synonyms  are  `b',
 control-H, and Delete.
3 g
 Moves to the page with the given number.  Initially, the  first  page
 is  assumed to be page number 1, but this can be changed with the `P'
 keystroke.  If no page number is given, then  it  goes  to  the  last
 page.
3 P
 "This is page number n." This can be used to make the  `g'  keystroke
 refer to actual page numbers instead of absolute page numbers.
3 Control-L
 Redisplays the current page.
3 ^
 Move to the "home" position of the page.  This is normally the  upper
 left-hand  corner  of the page, depending on the margins as described
 in the -margins option.
3 u
 Moves up two thirds of a window-full.
3 d
 Moves down two thirds of a window-full.
3 l
 Moves left two thirds of a window-full.
3 r
 Moves right two thirds of a window-full.
3 c
 Moves the page so that the point  currently  beneath  the  cursor  is
 moved  to the middle of the window.  It also (gasp!) warps the cursor
 to the same place.
3 M
 Sets the margins so that the point currently under the cursor is  the
 upper  left-hand  corner  of  the  text  in the page.  Note that this
 command itself does not move the image at all.  For  details  on  how
 the margins are used, see the -margins option.
3 s
 Changes the shrink factor to the  given  number.   If  no  number  is
 given,  the  smallest  factor  that  makes the entire page fit in the
 window will be used.  (Margins are ignored in this computation.)
3 S
 Sets the density factor to be  used  when  shrinking  bitmaps.   This
 should  be a number between 0 and 100; higher numbers produce lighter
 characters.
3 R
 Forces the dvi file to be reread.  This allows you  to  preview  many
 versions of the same file while running XDVI only once.
3 k
 Normally when XDVI switches pages it moves to the  home  position  as
 well.   The  `k' keystroke toggles a `keep-position' flag which, when
 set, will keep the same position when  moving  between  pages.   Also
 `0k' and `1k' clear and set this flag, respectively.
2 Mouse_Actions
 If the shrink factor is set  to  any  number  other  than  one,  then
 clicking  any  mouse  button  will  pop up a "magnifying glass" which
 shows the unshrunk image in the vicinity of the  mouse  click.   This
 subwindow  disappears  when  the mouse button is released.  Different
 mouse buttons produce different sized windows, as  indicated  by  the
 -mgs  option.   Moving  the cursor while holding the button down will
 move the magnifying glass.

 Also, the scrollbars (if present) behave in  the  standard  X  Window
 way:   pushing  Button 2 in a scrollbar moves the top or left edge of
 the scrollbar to that point and optionally drags it; pushing Button 1
 moves  the  image up or right by an amount equal to the distance from
 the button press to the upper left-hand corner of the window; pushing
 Button  3 moves the image down or left by the same amount.  Note that
 this is different  than  the  way  DECWindows  normally  defines  the
 actions of the mouse buttons in scrollbars.
2 Logical_Names
 Some logical names can be defined to override the values defined when
 XDVI was compiled.
3 DECW$DISPLAY
 Unless the -display option is used on the command line, XDVI uses the
 logical name "DECW$DISPLAY" to specify which bit map display terminal
 to use.  This logical name  may  be  defined  with  the  SET  DISPLAY
 command.
3 XDVIFONTS
 The  logical  name  "XDVIFONTS"  determines  the  directory   path(s)
 searched  for  fonts in the following manner.  The string consists of
 one or more strings separated by slashes.  In each such  string,  the
 substring  "%f"  is  changed to the font name; "%d" is changed to the
 magnification; and "%p" is changed to the font family ("gf", "pk", or
 "pxl").  If no "%f" appears in the string, then the string ":%f.%d%p"
 is added on the end.

 For example, if the string is "TEX$DISK:[TEX.FONTS.%d]%f.%p" and  the
 font     is    cmr10    at    300dpi,    then    XDVI    looks    for
 TEX$DISK:[TEX.FONTS.300]CMR10.GF,   TEX$DISK:[TEX.FONTS.300]CMR10.PK,
 and TEX$DISK:[TEX.FONTS.1500]CMR10.PXL, in that order.

 If the first character of the "XDVIFONTS" logical name  is  a  slash,
 then  the system default directories are tried first.  If the font is
 not found in the desired size, then XDVI will try to find the nearest
 size.  If the font cannot be found at all, then XDVI will try to vary
 the point size of the font (within a  certain  range),  and  if  this
 fails, then it will use the font specified as the alternate font (cf.
 -altfont).
3 XDVISIZES
 The logical name "XDVISIZES" must be set to indicate which  sizes  of
 fonts  are  available.   It  should  consists  of  a  list of numbers
 separated by slashes.  If the list begins with a  slash,  the  system
 default  sizes  are  used,  as well.  Sizes are expressed in dots per
 inch; decimals may be used for "pxl" files:  for example, a 300  dots
 per  inch  file  magnified  by half a step comes out to 1643 dots per
 five inches, which should be encoded as 328.6.  The  current  default
 set of sizes is 300/328.6/360/432/518.4/622/746.4.
2 Resource_Names
 All of the command line options may be set  via  the  resource  names
 given in the descriptions of the options.  This may be used to define
 a specific set of options as the default each time you run XDVI.   To
 make  use  of this feature, create a file named DECW$XDEFAULTS.DAT in
 the same directory as the rest of your DECW*.DAT files.   Include  in
 this file the resource names and arguments of each of the options you
 wish to specify.  For example:

    XDvi.copy: off
    XDvi.thorough: on
    XDvi.shrinkFactor: 2
    XDvi.margins: 0.95
    XDvi*geometry: 1015x750+3+25

 When XDVI is invoked, it would behave as if it had been invoked  with
 the following command:

    XDVI +copy -thorough -s 2 -margins 0.95 -geometry 1015x750+3+25 dvifile

 Specifying options on the command  line  will  override  any  options
 specified via resource names in the DECW$XDEFAULTS.DAT file.
2 Authors
 Eric Cooper, CMU, did a version for direct output to a QVSS.
 Modified for X by Bob Scheifler, MIT Laboratory for Computer Science.
 Modified for X11 by Mark Eichin, MIT SIPB.
 Modified for VMS and DECWindows by Scott Allendorf, University of Iowa.
 Additional enhancements by many others.
