commit a0c57f549d2798f9ee4357c12dd3d86ab7f546e8
parent 94f3e71b9af968887b99c1a1ddf6a353f702c18d
Author: Kyle Milz <krwmilz@gmail.com>
Date: Thu, 19 Aug 2021 00:53:45 +0000
delete vms files
Diffstat:
D | MAKE-VMS.COM | | | 217 | ------------------------------------------------------------------------------- |
D | README.VMS | | | 483 | ------------------------------------------------------------------------------- |
D | VMS-C.OPT | | | 2 | -- |
D | XDVI.RNH | | | 692 | ------------------------------------------------------------------------------- |
4 files changed, 0 insertions(+), 1394 deletions(-)
diff --git a/MAKE-VMS.COM b/MAKE-VMS.COM
@@ -1,217 +0,0 @@
-$! MAKE-VMS.COM
-$! A DCL `Make' procedure for compiling and linking XDVI.
-$!
-$! If you do want only the plain vanilla Xdvi just type @make_vms
-$!
-$!
-$! At the moment only support for DPS is really working to display inline
-$! postscript. To compile with DPS invoke the com as @make_vms dps
-$! You'll need a post-June 95 version of the xvmsutils installed at your
-$! site (This package is available at
-$! http://axp616.gsi.de:8080/www/vms/xvmsutils.html)
-$!
-$! If you want to compile using the Xaw lib to get buttons and scrollbars on
-$! Xdvi you will have to invoke the build as @make_vms "" tool
-$! (or @make_vms dps tool). In this case you need the Xaw3d lib installed,
-$! which you might get from http://axp616.gsi.de:8080/www/vms/xaw.html.
-$! Please edit the option file created during installation of the package
-$! to remove all references to shareable image and copy it to the dire where
-$! Xdvi resides with a name of xaw3dalpha.opt or xaw3dvax.opt.
-$!
-$! In case of problems with the install you might contact me at
-$! m.zinser@gsi.de (preferred) or eurmpz@eur.sas.com
-$!
-$!
-$ ON ERROR THEN GOTO EXIT
-$ ON CONTROL_Y THEN GOTO EXIT
-$ OLD_VERIFY = f$verify (0)
-$!
-$ MAY_USE_DECC = 1
-$!
-$ IF F$GETSYI("HW_MODEL") .GE. 1024
-$ THEN
-$ ARCH_NAME="Alpha"
-$ ARCH_PREF="AXP_"
-$ HAVE_DECC_VAX = 0
-$ USE_DECC_VAX = 0
-$ CC="CC/stand=VAX/ansi/ext=comm/obj=.''ARCH_PREF'obj"
-$ WRITE SYS$OUTPUT "Compiling on Alpha AXP using DECC"
-$ ELSE
-$ ARCH_NAME="VAX"
-$ ARCH_PREF="VAX_"
-$ IF F$search("sys$system:DECC$compiler.exe") .NES. ""
-$ THEN
-$! DECC for VAX available (and maybe VAXC, too!)
-$ HAVE_DECC_VAX = 1
-$ IF HAVE_DECC_VAX .AND. MAY_USE_DECC
-$ THEN
-$! We use DECC:
-$ USE_DECC_VAX = 1
-$ CC="CC/DECC/stand=VAX/ext=comm/obj=.''ARCH_PREF'obj"
-$ ELSE
-$! We use VAXC:
-$ USE_DECC_VAX = 0
-$ CC="CC/VAXC/obj=.''ARCH_PREF'obj"
-$ ENDIF
-$ ELSE
-$! only VAXC available
-$ HAVE_DECC_VAX = 0
-$ USE_DECC_VAX = 0
-$ CC="CC/obj=.''ARCH_PREF'obj"
-$ ENDIF
-$ IF USE_DECC_VAX
-$ THEN
-$ WRITE SYS$OUTPUT "Compiling on VAX using DECC"
-$ ELSE
-$ WRITE SYS$OUTPUT "Compiling on VAX using VAXC"
-$ ENDIF
-$ ENDIF
-$ LDFLAGS = ""
-$ if f$trnlnm("X11").eqs. "" then DEFINE X11 DECW$INCLUDE
-$ if f$trnlnm("SYS").eqs ""
-$ then
-$ IF USE_DECC_VAX .AND. (F$TRNLNM("DECC$LIBRARY_INCLUDE") .NES. "")
-$ THEN
-$ DEFINE SYS DECC$LIBRARY_INCLUDE
-$ ELSE
-$ DEFINE SYS SYS$LIBRARY
-$ ENDIF
-$ endif
-$ if f$trnlnm("DPS").eqs. "" then define dps xdps$include
-$!
-$ ps_dps = ""
-$ ps_gs = ""
-$ tool = "NOTOOL"
-$ IF f$edit(p1,"UPCASE") .eqs. "DPS" THEN ps_dps = "PSDPS"
-$ IF f$edit(p1,"UPCASE") .eqs. "GS" THEN ps_gs = "PSGS"
-$ if f$edit(p2,"UPCASE") .eqs. "TOOL" then tool = "TOOL"
-$!
-$ ps_options = ""
-$ ps_head = ""
-$ varobjs = ""
-$ IF ps_dps .EQS. "PSDPS"
-$ THEN
-$ ps_head = "PSHEADER"
-$ ps_options = ps_options + ", VFORK, PS_DPS"
-$ varobjs = varobjs + "PSDPS.''ARCH_PREF'OBJ, "
-$ ENDIF
-$ IF ps_gs .EQS. "PSGS"
-$ THEN
-$ ps_head = "PSHEADER"
-$ ps_options = ps_options + ", PS_GS"
-$ varobjs = varobjs + "PSGS.''ARCH_PREF'OBJ, "
-$ ENDIF
-$!
-$ OPEN/WRITE optfile VMS_XDVI.'ARCH_PREF'OPT
-$ if (tool.eqs."TOOL") .or. (ps_dps.EQS."PSDPS")
-$ then
-$!
-$! Find out which X-Version we're running. This will fail for older
-$! VMS versions (i.e., v5.5-1). Therefore, choose DECWindows XUI for
-$! default.
-$!
-$ On Error Then GoTo XUI
-$ @sys$update:decw$get_image_version sys$share:decw$xlibshr.exe decw$version
-$ if f$extract(4,3,decw$version).eqs."1.0"
-$ then
-$ write optfile "Sys$share:DECW$DWTLIBSHR.EXE/Share"
-$ endif
-$ if f$extract(4,3,decw$version).eqs."1.1"
-$ then
-$ write optfile "sys$share:decw$xtshr.exe/share"
-$ endif
-$ if f$extract(4,3,decw$version).eqs."1.2"
-$ then
-$ write optfile "sys$share:decw$xtlibshrr5.exe/share"
-$ endif
-$ GoTo MAIN
-$!
-$ XUI:
-$!
-$ write optfile "Sys$share:DECW$DWTLIBSHR.EXE/Share"
-$ MAIN:
-$ endif
-$ IF ps_dps .EQS. "PSDPS"
-$ THEN
-$ write optfile "x11vms:xvmsutils.olb/lib"
-$!
-$ WRITE optfile "sys$share:xdps$dpsclientshr/share"
-$ WRITE optfile "sys$share:xdps$dpsbindingsshr/share"
-$ WRITE optfile "sys$share:xdps$dpslibshr/share"
-$ ENDIF
-$ WRITE optfile "sys$share:decw$xlibshr/share"
-$ if tool .eqs. "TOOL"
-$ then
-$ write optfile "XMULIBSHR/SHARE"
-$ write optfile "XAW3DLIBSHR/SHARE"
-$ endif
-$ IF (ARCH_NAME .EQS. "VAX") .AND. (.NOT. USE_DECC_VAX)
-$ THEN
-$ WRITE optfile "sys$share:vaxcrtl/share"
-$ option_file = "VMS_XDVI.''ARCH_PREF'OPT" ! for linking SQUEEZE
-$ ELSE
-$ option_file = "nl:" ! for linking SQUEEZE
-$ ENDIF
-$ CLOSE optfile
-$ if (tool.eqs."TOOL")
-$ then
-$ copy/nolog xaw3d'arch_name'.opt,VMS_XDVI.'ARCH_PREF'OPT;-1 -
- VMS_XDVI.'ARCH_PREF'OPT
-$ tool = "TOOL, BUTTONS"
-$ endif
-$!
-$ DEFS = "VMS, 'tool', USE_PK, USE_GF, TEXXET, GREY, MAKEPK'ps_options'"
-$ CC /DEFINE = ('DEFS') DVI_INIT.C
-$ CC /DEFINE = ('DEFS') DVI_DRAW.C
-$ CC /DEFINE = ('DEFS') GF.C
-$ CC /DEFINE = ('DEFS') PK.C
-$ CC /DEFINE = ('DEFS') VF.C
-$ CC /DEFINE = ('DEFS') UTIL.C
-$ If ps_dps .EQS. "PSDPS"
-$ then
-$!
-$! This definition of FIG_PATH and HEADER_PATH is site specific. You may
-$! want to change it!!!
-$!
-$ CC /DEFINE = ('DEFS', "DEFAULT_FONT_PATH=""TEX_FONTS""", -
- "DEFAULT_VF_PATH=""TEX_VFDIR""", -
- "DEFAULT_FONT_SIZES=""300/329/360/432/518/622/746""",-
- "DEFAULT_FIG_PATH=""TEX_INPUTS:,SYS$DISK:""",-
- "DEFAULT_HEADER_PATH=""DVI_INPUTS:,TEX_INPUTS:,SYS$LOGIN:,SYS$DISK:[]""")-
- FONT_OPEN.C
-$ else
-$ CC /DEFINE = ('DEFS', "DEFAULT_FONT_PATH=""TEX_FONTS""", -
- "DEFAULT_VF_PATH=""TEX_VFDIR""", -
- "DEFAULT_FONT_SIZES=""300/329/360/432/518/622/746""") FONT_OPEN.C
-$ endif
-$ CC /DEFINE = ('DEFS') SPECIAL.C
-$ CC /DEFINE = ('DEFS') EVENTS.C
-$ IF ps_dps .NES. ""
-$ THEN
-$ CC /DEFINE = ('DEFS') PSDPS.C
-$ ENDIF
-$ IF ps_gs .NES. ""
-$ THEN
-$ CC /DEFINE = ('DEFS') PSGS.C
-$ ENDIF
-$ IF ps_head .NES. ""
-$ THEN
-$ CC /DEFINE = ('DEFS') SQUEEZE.C
-$ LINK /EXE=.'ARCH_PREF'EXE SQUEEZE.'ARCH_PREF'OBJ, 'option_file' /OPTION
-$ SQUEEZE := $SYS$DISK:[]SQUEEZE.'ARCH_PREF'EXE
-$ SQUEEZE PSHEADER.TXT PSHEADER.C
-$ CC /DEFINE = ('DEFS') PSHEADER.C
-$ varobjs = varobjs + "PSHEADER.''ARCH_PREF'OBJ,"
-$ ENDIF
-$ CC /DEFINE = ('DEFS') XDVI.C
-$!
-$ LINK 'LDFLAGS'/EXE=.'ARCH_PREF'EXE XDVI.'ARCH_PREF'OBJ, -
- DVI_INIT.'ARCH_PREF'OBJ, DVI_DRAW.'ARCH_PREF'OBJ, -
- GF.'ARCH_PREF'OBJ, PK.'ARCH_PREF'OBJ, VF.'ARCH_PREF'OBJ, -
- UTIL.'ARCH_PREF'OBJ, FONT_OPEN.'ARCH_PREF'OBJ, SPECIAL.'ARCH_PREF'OBJ, -
- EVENTS.'ARCH_PREF'OBJ, 'varobjs' VMS_XDVI.'ARCH_PREF'OPT/OPTION
-$ DELETE/NOLOG VMS_XDVI.'ARCH_PREF'OPT;*
-$!
-$EXIT:
-$ dummy=f$verify ('old_verify')
-$ EXIT
diff --git a/README.VMS b/README.VMS
@@ -1,483 +0,0 @@
-NAME
-----
-
-XDVI - DVI Previewer for VAX VMS systems running the DECWindows software.
-
-SYNOPSIS
---------
-
- XDVI [+[<page>]] [-s <shrink>] [-density <density>] [-nogrey]
- [-gamma <g>] [-p <pixels>] [-margins <dimen>] [-sidemargin <dimen>]
- [-topmargin <dimen>] [-offsets <dimen>] [-xoffset <dimen>]
- [-yoffset <dimen>] [-paper <papertype>] [-altfont <font>] [-l] [-rv]
- [-mgs[n] <size>] [-hush] [-hushspecials] [-hushchars] [-hushchecksums]
- [-fg <color>] [-bg <color>] [-hl <color>] [-bd <color>] [-cr <color>]
- [-bw <width>] [-display <host::display>] [-geometry <geometry>]
- [-icongeometry <geometry>] [-iconic] [-keep] [-copy] [-thorough]
- [-version] dvi_file
-
-DESCRIPTION
------------
-
- 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.
-
-OPTIONS
--------
-
- In addition to specifying the DVI file (with or without the .DVI extension),
- 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 parentheses
- in the description of each option.
-
- +<page> Specifies the first page to show. If + is given
- without a number, the last page is assumed; the first
- page is the default.
-
- -altfont <font> (.altFont) Declares a default font to use when the
- font in the DVI file cannot be found. This is useful,
- for example, with PostScript fonts.
-
- -background <color> (.background) Determines the color of the background.
- Same as -bg.
-
- -bd <color> (.borderColor) Determines the color of the window
- border.
-
- -bg <color> (.background) Determines the color of the background.
-
- -bordercolor <color> Same as -bd.
-
- -borderwidth <width> (.borderWidth) Specifies the width of the border of
- the window. Same as -bw.
-
- -bw <width> (.borderWidth) Specifies the width of the border of
- the window.
-
- -copy (.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. If greyscale
- anti-aliasing is in use, the -copy operation will
- disable the use of colorplanes and make overstrikes
- come out incorrectly. See also -thorough.
-
- -cr <color> (.cursorColor) Determines the color of the cursor.
- The default is the color of the page border.
-
- -density <density> (.densityPercent) Determines the density used when
- shrinking bitmaps for fonts. A higher value produces a
- lighter font. The default value is 40.
-
- -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.
-
- -fg <color> (.foreground) Determines the color of the text
- (foreground).
-
- -foreground <color> Same as -fg.
-
- -gamma <gamma> (.gamma) Controls the interpolation of colors in the
- greyscale anti-aliasing color palette. The default
- value is 1.0. For 0 < gamma < 1, the fonts will be
- lighter (more like the background), and for gamma > 1,
- the fonts will be darker (more like the foreground).
- Negative values behave the same way, but use a slightly
- different algorithm.
-
- -geometry <geometry> (*geometry) Specifies the initial geometry of the
- window.
-
- -hl <color> (.highlight) Determines the color of the page border.
- The default is the foreground color.
-
- -hush (.Hush) Causes XDVI to suppress all suppressible
- warnings.
-
- -hushchars (.hushLostChars) Causes XDVI to suppress warnings
- about references to characters which are not defined in
- the font.
-
- -hushchecksums (.hushChecksums) Causes XDVI to suppress warnings
- about checksum mismatches between the DVI file and the
- font file.
-
- -hushspecials (.hushSpecials) Causes XDVI to suppress warnings about
- \special strings which it cannot process.
-
- -icongeometry <geometry> (.iconGeometry) Specifies the initial position for
- the icon.
-
- -iconic (.iconic) Causes the XDVI window to start in the
- iconic state. The default is to start with the window
- open.
-
- -keep (.keepPosition) Sets a flag to indicate that XDVI
- should not move to the home position when moving to a
- new page. See also the `k' keystroke.
-
- -l (.listFonts) Causes the names of the fonts used to be
- listed.
-
- -margins <dimen> (.Margin) Specifies the size of both the top and side
- margins. This should be a decimal number optionally
- followed by "cm", e.g., 1.5 or 3cm, giving a
- measurement in inches or centimeters. 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 -sidemargin,
- -topmargin, and the keystroke `M'.
-
- -mgs <size> Same as -mgs1.
-
- -mgs[n] <size> (.magnifierSize[n]) Specifies the size of the window
- to be used for the "magnifying glass" for Button n.
- The size may be given as an integer (indicating that
- the magnifying glass is to be square), or it may be
- given in the form WxH. See the MOUSE ACTIONS section.
- Defaults are 200x150, 400x250, 700x500, 1000x800, and
- 1200x1200.
-
- -nogrey (.grey) Turns off the use of greyscale anti-aliasing
- when printing shrunken bitmaps. In this case, the
- logic of the corresponding resource is the reverse:
- -nogrey corresponds to grey:off; +nogrey to grey:on.
- See also the 'G' keystroke.
-
- -offsets <dimen> (.Offset) Specifies the size of both the horizontal
- and vertical offsets of the output on the page. This
- should be a decimal number optionally followed by "cm",
- e.g., 1.5 or 3cm, giving a measurement in inches or
- centimeters. By decree of the Stanford TeX Project,
- the default TeX page origin is always 1 inch over and
- down from the top-left page corner, even when
- non-American paper sizes are used. Therefore, the
- default offsets are 1.0 inch. See also -xoffset and
- -yoffset.
-
- -p <pixels> (.pixelsPerInch) Defines the size of the fonts to use,
- in pixels per inch. The default value is 300.
-
- -paper <papertype> (.paper) 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.
-
- -rv (.reverseVideo) Causes the page to be displayed with
- white characters on a black background, instead of vice
- versa.
-
- -s <shrink> (.shrinkFactor) Defines the initial shrink factor.
- The default value is 3.
-
- -sidemargin <dimen> (.sideMargin) Specifies the side margin (see
- -margins).
-
- -thorough (.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.
-
- -topmargin <dimen> (.topMargin) Specifies the top and bottom margins (see
- -margins).
-
- -version Print information on the version of XDVI.
-
- -xoffset <dimen> (.xOffset) Specifies the size of the horizontal
- offset of the output on the page. See -offsets.
-
- -yoffset <dimen> (.yOffset) Specifies the size of the vertical offset
- of the output on the page. See -offsets.
-
-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.
-
- q Quits the program. Control-C, control-D, and control-Z will do this,
- too.
-
- n Moves to the next page (or to the nth next page if a number is given).
- Synonyms are `f', Space, Return, Line Feed, and <Next Screen>.
-
- p Moves to the previous page (or back n pages). Synonyms are `b',
- control-H, Delete, and <Prev Screen>.
-
- 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, below. If no page number is given, then it goes to the last
- page.
-
- 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.
-
- Control-L Redisplays the current page.
-
- ^ 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, above.
-
- u Moves up two thirds of a window-full. The <Up Arrow> key is a synonym
- for this keystroke.
-
- d Moves down two thirds of a window-full. The <Down Arrow> key is a
- synonym for this keystroke.
-
- l Moves left two thirds of a window-full. The <Left Arrow> key is a
- synonym for this keystroke.
-
- r Moves right two thirds of a window-full. The <Right Arrow> key is a
- synonym for this keystroke.
-
- 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.
-
- 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.
-
- 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.)
-
- 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.
-
- R Forces the DVI file to be reread. This allows you to preview many
- versions of the same file while running XDVI only once.
-
- 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. See also the -keep option.
-
- G This key toggles the use of greyscale anti-aliasing for displaying
- shrunken bitmaps. In addition, the key sequences `0G' and `1G' clear and
- set this flag, respectively. See also the -nogrey option.
-
-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.
-
-LOGICAL NAMES
--------------
-
- 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.
-
- 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 file format ("pk" or "gf"). 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_FONTS" and the font is cmr10 at 300 dots per inch, then XDVI searches
- for TEX_FONTS:CMR10.300PK and TEX_FONTS:CMR10.300GF, in that order. An extra
- slash anywhere in the "XDVIFONTS" logical name causes the system default
- directories to be tried at that point. 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).
-
- In addition, a "%F" specifier is available; it is a synonym for "%f", but it
- does not inhibit putting the string ":%f.%d%p" at the end. Finally, a "%b"
- specifier is available; it is converted to the current resolution being used
- (i.e., the value of the -p parameter or the .pixelsperinch resource).
-
- For compatibility with some versions of TeX, you may also use the logical
- name "TEXFONTS" in place of "XDVIFONTS", although in that case the string
- should not include any "%" specifiers. The reason for recognizing "TEXFONTS"
- is that certain versions of TeX also support the convention regarding an
- extra slash in the font path; therefore, users who create their own fonts can
- put both their .TFM and raster files in the same directory and do
-
- $ DEFINE TEXFONTS "/MFDIR"
-
- or
-
- $ DEFINE TEXFONTS "MFDIR/"
-
- in order to get both TeX and XDVI to search their directory in addition to
- the system standard directories. The "XDVIFONTS" logical name overrides the
- "TEXFONTS" logical name, so that on those sites where "TEXFONTS" must be set
- explicitly, and therefore this feature is not useful, the "XDVIFONTS" logical
- name may be set to an empty string to cause XDVI to ignore "TEXFONTS".
-
- XDVI also recognizes the "PKFONTS" and "TEXPKS" logical names, which are
- checked after "XDVIFONTS" but before "TEXFONTS".
-
- The logical name "XDVISIZES" may be set to indicate which sizes of fonts are
- available. It should consist 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 and must be integers. The current
- default set of sizes is 300/329/360/432/518/622/746. XDVI will also try the
- actual size of the font before trying any of the given sizes.
-
- Virtual fonts are also supported, although XDVI does not have any built-in
- fonts to which they can refer. The search path for .VF files can be
- specified with the "XDVIVFS" logical name in a similar manner to that for the
- "XDVIFONTS" logical name. XDVI will also check the "VFFONTS" logical name if
- the "XDVIFONTS" logical name is not defined. Virtual fonts are searched for
- immediately after looking for the font as a normal font in the exact size
- specified.
-
-FILES
------
-
- TEX_FONTS System default directory for font pixel files.
-
-RESOURCE NAMES
---------------
-
- All of the command line options may be set via the resource names given in
- parentheses 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.Margin: 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.
-
-INSTALLATION
-------------
-
- The installation of XDVI on a VMS system is relatively easy. If you have a
- source-only distribution, you will need to have access to the VAX C compiler
- to build an executable image. The following steps should get you started:
-
- 1) Gather all of the distribution files into one directory, and then create
- the executable image by executing the MAKE-VMS.COM file:
-
- $ @MAKE-VMS
-
- 2) Create a help file for XDVI using the supplied XDVI.RNH file:
-
- $ RUNOFF XDVI.RNH
-
- 3) Insert the resulting XDVI.HLP file into one of your local help libraries:
-
- $ LIBRARY /INSERT HELPLIB.HLB XDVI.HLP
-
- 4) Modify the command file you use to set up the TEX commands so that it
- defines the foreign symbol XDVI, and the logical names "XDVIFONTS",
- "XDVIVFS", and "XDVISIZES". For more information on the expected contents
- of the logical names, see the LOGICAL NAMES section of this document. The
- following lines are what I use locally:
-
- $ PROC = F$ENVIRONMENT ("PROCEDURE")
- $ TEXDIR = F$PARSE (PROC, , , "DEVICE", "NO_CONCEAL") + -
- F$PARSE (PROC, , , "DIRECTORY", "NO_CONCEAL")
- $ TEXDIR = TEXDIR - "][" - "][" - "][" - "]"
- $ TEXDISK = TEXDIR + ".]"
- $ PIXELS = TEXDIR + ".GF.CANON300.]"
- $ LPIXELS = TEXDIR + ".LOCAL.PIXELS.CANON300.]"
- $!
- $! Define the virtual disk devices.
- $!
- $ DEFINE /PROCESS /TRANSLATE = (CONCEAL, TERMINAL) TEX_DISK 'TEXDISK'
- $ DEFINE /PROCESS /TRANSLATE = (CONCEAL, TERMINAL) PIXELS$ 'PIXELS'
- $ DEFINE /PROCESS /TRANSLATE = (CONCEAL, TERMINAL) LPIXELS$ 'LPIXELS'
- $!
- $! Define the directories for TeX and its related TeXware.
- $!
- $ DEFINE TEX_EXE TEX_DISK:[LOCAL.PROGRAMS]
- $ DEFINE TEX_PIXELS PIXELS$, LPIXELS$
- $!
- $! Define the information necessary to run XDVI.
- $!
- $ XDVI :== "$TEX_EXE:XDVI"
- $ DEFINE XDVIFONTS "TEX_PIXELS:[DPI%d]%f.%p"
- $ DEFINE XDVIVFS XDVIFONTS
- $ DEFINE XDVISIZES -
- "300/329/360/432/518/600/622/746/896/1075/1200/1290/1548"
- $ EXIT
-
- 5) If you wish, you may create a DECW$XDEFAULTS.DAT file that specifies a
- default set of command line options. See the RESOURCE NAMES section for
- more information and an example of what I use locally.
-
- If you have any comments about XDVI, or find any bugs in the program, please
- contact me at the address below. Enjoy!
-
- Scott Allendorf
- Department of Physics and Astronomy
- The University of Iowa
- Iowa City, IA 52242
-
- Email: scott-allendorf@uiowa.edu
-
-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.
diff --git a/VMS-C.OPT b/VMS-C.OPT
@@ -1,2 +0,0 @@
-sys$share:decw$xlibshr/share
-sys$share:vaxcrtl/share
diff --git a/XDVI.RNH b/XDVI.RNH
@@ -1,692 +0,0 @@
-.!
-.! This is a RUNOFF source file that produces a VMS-style HELP library
-.! for the XDVI program.
-.!
-.! This file was created by hand-converting XDVI.MAN. The internal date
-.! in the XDVI.MAN file was "27 March 1990". If you improve this file,
-.! please let me know. Pete Siemsen, siemsen@usc.edu
-.!
-.! Merged with patchlevel 8.001 help file for VMS by Scott Allendorf.
-.! Added new switches for patchlevel 10. Scott Allendorf.
-.! Added new switches for patchlevel 11. Scott Allendorf.
-.! Added new switches for patchlevel 14. Scott Allendorf.
-.! Added new switches for patchlevel 16. Scott Allendorf.
-.! Updated for patchlevel 17. Scott Allendorf.
-.! Updated for patchlevel 18. Scott Allendorf.
-.!
-.NO PAGING
-.NO FLAGS ALL
-.RIGHT MARGIN 71
-.LITERAL
-!
-! DO NOT EDIT THIS FILE. It was produced by passing a .RNH file through
-! RUNOFF. Edit the .RNH file instead.
-!
-.END LITERAL
-.LEFT MARGIN 1
-
-.INDENT -1
-1 XDVI
-.BREAK
-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.
-.SKIP
-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.
-.SKIP
-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.
-
-.SKIP
-Format:
-.SKIP
-.INDENT +3
-XDVI [Options] dvi_file
-
-.INDENT -1
-2 Options
-.BREAK
-In addition to specifying the DVI file (with or without the .DVI extension),
-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.
-.INDENT -1
-3 +
-.BREAK
-+<page>
-.SKIP
-Specifies the first page to show. If + is given without a number, the
-last page is assumed; the first page is the default.
-.INDENT -1
-3 -altfont
-.BREAK
--altfont <font>
-.SKIP
-Declares a default font to use when the font in the DVI file cannot be
-found. This is useful, for example, with PostScript fonts.
-.SKIP
-The resource name is ".altFont".
-.INDENT -1
-3 -background
-.BREAK
--background <color>
-.SKIP
-Determines the color of the background. Same as -bg.
-.SKIP
-The resource name is ".background".
-.INDENT -1
-3 -bd
-.BREAK
--bd <color>
-.SKIP
-Determines the color of the window border.
-.SKIP
-The resource name is ".borderColor".
-.INDENT -1
-3 -bg
-.BREAK
--bg <color>
-.SKIP
-Determines the color of the background.
-.SKIP
-The resource name is ".background".
-.INDENT -1
-3 -bordercolor
-.BREAK
--bordercolor <color>
-.SKIP
-Same as -bd.
-.INDENT -1
-3 -borderwidth
-.BREAK
--borderwidth <width>
-.SKIP
-Specifies the width of the border of the window. Same as -bw.
-.SKIP
-The resource name is ".borderWidth".
-.INDENT -1
-3 -bw
-.BREAK
--bw <width>
-.SKIP
-Specifies the width of the border of the window.
-.SKIP
-The resource name is ".borderWidth".
-.INDENT -1
-3 -copy
-.BREAK
-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. If greyscale anti-aliasing
-is in use, the -copy operation will disable the use of colorplanes and make
-overstrikes come out incorrectly. See also -thorough.
-.SKIP
-The resource name is ".copy".
-.INDENT -1
-3 -cr
-.BREAK
--cr <color>
-.SKIP
-Determines the color of the cursor. The default is the
-color of the page border.
-.SKIP
-The resource name is ".cursorColor".
-.INDENT -1
-3 -debug
-.BREAK
--debug <bitmask>
-.SKIP
-If nonzero, prints additional debugging information on standard output.
-The bitmask should be given as a decimal number. The values of the bits
-are defined in the source file xdvi.h .
-.SKIP
-The resource name is ".debugLevel".
-.INDENT -1
-3 -density
-.BREAK
--density <density>
-.SKIP
-Determines the density used when shrinking bitmaps for fonts. A
-higher value produces a lighter font. The default value is 40.
-.SKIP
-The resource name is ".densityPercent".
-.INDENT -1
-3 -display
-.BREAK
--display <display>
-.SKIP
-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.
-.INDENT -1
-3 -fg
-.BREAK
--fg <color>
-.SKIP
-Determines the color of the text (foreground).
-.SKIP
-The resource name is ".foreground".
-.INDENT -1
-3 -foreground
-.BREAK
--foreground <color>
-.SKIP
-Same as -fg.
-.INDENT -1
-3 -gamma
-.BREAK
--gamma <gamma>
-.SKIP
-Controls the interpolation of colors in the greyscale anti-aliasing color
-palette. The default value is 1.0. For 0 < gamma < 1, the fonts will be
-lighter (more like the background), and for gamma > 1, the fonts will be darker
-(more like the foreground). Negative values behave the same way, but use a
-slightly different algorithm.
-.SKIP
-The resource name is ".gamma".
-.INDENT -1
-3 -geometry
-.BREAK
--geometry <geometry>
-.SKIP
-Specifies the initial geometry of the window.
-.SKIP
-The resource name is "*geometry".
-.INDENT -1
-3 -hl
-.BREAK
--hl <color>
-.SKIP
-Determines the color of the page border. The default is the foreground color.
-.SKIP
-The resource name is ".highlight".
-.INDENT -1
-3 -hush
-.BREAK
-Causes XDVI to suppress all suppressible warnings.
-.SKIP
-The resource name is ".Hush".
-.INDENT -1
-3 -hushchars
-.BREAK
-Causes XDVI to suppress warnings about references to characters which
-are not defined in the font.
-.SKIP
-The resource name is ".hushLostChars".
-.INDENT -1
-3 -hushchecksums
-.BREAK
--hushchecksums
-.SKIP
-Causes XDVI to supress warnings about checksum mismatches between the DVI file
-and the font file.
-.SKIP
-The resource name is ".hushChecksums".
-.INDENT -1
-3 -hushspecials
-.BREAK
-Causes XDVI to suppress warnings about \special strings which it cannot process.
-.SKIP
-The resource name is ".hushSpecials".
-.INDENT -1
-3 -icongeometry
-.BREAK
--icongeometry <geometry>
-.SKIP
-Specifies the initial position for the icon.
-.SKIP
-The resource name is ".iconGeometry".
-.INDENT -1
-3 -iconic
-.BREAK
--iconic
-.SKIP
-Causes the XDVI window to start in the iconic state. The default is to start
-with the window open.
-.SKIP
-The resource name is ".iconic".
-.INDENT -1
-3 -keep
-.BREAK
--keep
-.SKIP
-Sets a flag to indicate that XDVI should not move to the home position when
-moving to a new page. See also `k' under the Keystrokes help entry.
-.SKIP
-The resource name is ".keepPosition".
-.INDENT -1
-3 -l
-.BREAK
-Causes the names of the fonts used to be listed.
-.SKIP
-The resource name is ".listFonts".
-.INDENT -1
-3 -margins
-.BREAK
--margins <dimen>
-.SKIP
-Specifies the size of both the top and side margins. This should be a
-decimal number optionally followed by "cm", e.g., 1.5 or 3cm, giving a
-measurement in inches or centimeters.
-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 -sidemargin, -topmargin under the Options help entry,
-and `M' under the Keystrokes help entry.
-.SKIP
-The resource name is ".Margin".
-.INDENT -1
-3 -mfmode
-.BREAK
--mfmode <mode-def>
-.SKIP
-Specifies a `mode-def' string, which can be used in searching for fonts
-(see also the 'Logical_Names' entry).
-It is also passed to METAFONT during automatic creation of fonts.
-.SKIP
-The resource name is ".mfMode"
-.INDENT -1
-3 -mgs[n]
-.BREAK
--mgs[n] <size>
-.SKIP
-Specifies the size of the window to be used for the "magnifying glass"
-for Button n. The size may be given as an integer (indicating that the
-magnifying glass is to be square), or it may be given in the form WxH. See
-the Mouse_Actions section.
-Defaults are 200x150, 400x250, 700x500, 1000x800, and 1200x1200.
-.SKIP
-The resource name is ".magnifierSize[n]".
-.INDENT -1
-3 -mgs
-.BREAK
--mgs <size>
-.SKIP
-Same as -mgs1.
-.INDENT -1
-3 -nogrey
-.BREAK
--nogrey
-.SKIP
-Turns off the use of greyscale anti-aliasing when printing shrunken bitmaps.
-In this case, the logic of the corresponding resource is the reverse:
--nogrey corresponds to grey:off; +nogrey to grey:on.
-See also 'G' under the Keystrokes help entry.
-.SKIP
-The resource name is ".grey".
-.INDENT -1
-3 -nomakepk
-.BREAK
--nomakepk
-.SKIP
-Turns off the automatic generation of missing font files that cannot be
-found by other means.
-For this option, the logic of the corresponding resource is reversed:
--nogrey corresponds to makePK:off; +nogrey to makePK:on.
-.SKIP
-The resource name is ".makePK".
-.INDENT -1
-3 -offsets
-.BREAK
--offsets <dimen>
-.SKIP
-Specifies the size of both the horizontal and vertical offsets of the
-output on the page. This should be a decimal number optionally followed by
-"cm", e.g., 1.5 or 3cm, giving a measurement in inches or centimeters.
-By decree
-of the Stanford TeX Project, the default TeX page origin is always 1 inch
-over and down from the top-left page corner, even when non-American paper
-sizes are used. Therefore, the default offsets are 1.0 inch. See also -xoffset
-and -yoffset.
-.SKIP
-The resource name is ".Offset".
-.INDENT -1
-3 -p
-.BREAK
--p <pixels>
-.SKIP
-Defines the size of the fonts to use, in pixels per inch. The
-default value is 300.
-.SKIP
-The resource name is ".pixelsPerInch".
-.INDENT -1
-3 -paper
-.BREAK
--paper <papertype>
-.SKIP
-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.
-.SKIP
-The resource name is ".paper".
-.INDENT -1
-3 -rv
-.BREAK
-Causes the page to be displayed with white characters on a black
-background, instead of vice versa.
-.SKIP
-The resource name is ".reverseVideo".
-.INDENT -1
-3 -s
-.BREAK
--s <shrink>
-.SKIP
-Defines the initial shrink factor. The default value is 3.
-.SKIP
-The resource name is ".shrinkFactor".
-.INDENT -1
-3 -sidemargin
-.BREAK
--sidemargin <dimen>
-.SKIP
-Specifies the side margin (see -margins).
-.SKIP
-The resource name is ".sideMargin".
-.INDENT -1
-3 -thorough
-.BREAK
-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.
-.SKIP
-The resource name is ".thorough".
-.INDENT -1
-3 -topmargin
-.BREAK
--topmargin <dimen>
-.SKIP
-Specifies the top and bottom margins (see -margins).
-.SKIP
-The resource name is ".topMargin".
-.INDENT -1
-3 -version
-.BREAK
--version
-.SKIP
-Print information on the version of XDVI.
-.INDENT -1
-3 -xoffset
-.BREAK
--xoffset <dimen>
-.SKIP
-Specifies the size of the horizontal offset of the output on the page. See
--offsets.
-.SKIP
-The resource name is ".xOffset".
-.INDENT -1
-3 -yoffset
-.BREAK
--yoffset <dimen>
-.SKIP
-Specifies the size of the vertical offset of the output on the page. See
--offsets.
-.SKIP
-The resource name is ".yOffset".
-
-.INDENT -1
-2 Keystrokes
-.BREAK
-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.
-.INDENT -1
-3 q
-.BREAK
-Quits the program. Control-C, control-D, and control-Z will do this, too.
-.INDENT -1
-3 n
-.BREAK
-Moves to the next page (or to the nth next page if a number is given).
-Synonyms are `f', Space, Return, Line Feed, and <Next Screen>.
-.INDENT -1
-3 p
-.BREAK
-Moves to the previous page (or back n pages). Synonyms are
-`b', control-H, Delete, and <Prev Screen>.
-.INDENT -1
-3 g
-.BREAK
-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.
-.INDENT -1
-3 P
-.BREAK
-"This is page number n." This can be used to make the `g'
-keystroke refer to actual page numbers instead of absolute page numbers.
-.INDENT -1
-3 Control-L
-.BREAK
-Redisplays the current page.
-.INDENT -1
-3 ^
-.BREAK
-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.
-.INDENT -1
-3 u
-.BREAK
-Moves up two thirds of a window-full. The <Up Arrow> key is a synonym for this
-keystroke.
-.INDENT -1
-3 d
-.BREAK
-Moves down two thirds of a window-full. The <Down Arrow> key is a synonym for
-this keystroke.
-.INDENT -1
-3 l
-.BREAK
-Moves left two thirds of a window-full. The <Left Arrow> key is a synonym for
-this keystroke.
-.INDENT -1
-3 r
-.BREAK
-Moves right two thirds of a window-full. The <Right Arrow> key is a synonym for
-this keystroke.
-.INDENT -1
-3 c
-.BREAK
-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.
-.INDENT -1
-3 M
-.BREAK
-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.
-.INDENT -1
-3 s
-.BREAK
-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.)
-.INDENT -1
-3 S
-.BREAK
-Sets the density factor to be used when shrinking bitmaps. This should
-be a number between 0 and 100; higher numbers produce lighter characters.
-If greyscaling mode is in effect, this changes the value of gamma instead.
-The new value of gamma is the given number divided by 100; negative values
-are allowed.
-.INDENT -1
-3 R
-.BREAK
-Forces the DVI file to be reread. This allows you to preview many
-versions of the same file while running XDVI only once.
-.INDENT -1
-3 k
-.BREAK
-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. See also the -keep option.
-.INDENT -1
-3 G
-.BREAK
-The key toggles the use of greyscale anti-aliasing for displaying shrunken
-bitmaps. In addition, the key sequences `0G' and `1G' clear and set this flag,
-respectively. See also the -nogrey option.
-
-.INDENT -1
-2 Mouse_Actions
-.BREAK
-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.
-.SKIP
-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.
-
-.INDENT -1
-2 Logical_Names
-.BREAK
-Some logical names can be defined to override the values defined when
-XDVI was compiled.
-.INDENT -1
-3 DECW$DISPLAY
-.BREAK
-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.
-.INDENT -1
-3 XDVIFONTS
-.BREAK
-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 file format ("pk" or "gf"). 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_FONTS" and the font is
-cmr10 at 300 dots per inch, then XDVI searches for TEX_FONTS:CMR10.300PK
-and TEX_FONTS:CMR10.300GF,
-in that order.
-An extra slash anywhere in the the "XDVIFONTS" logical name causes the
-system default directories to be tried at that point. 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).
-.SKIP
-In addition, a "%F" specifier is available; it is a synonym for "%f", but it
-does not inhibit putting the string ":%f.%d%p" at the end. Finally, a "%b"
-specifier is available; it is converted to the current resolution being used
-(i.e., the value of the -p parameter or the .pixelsperinch resource).
-.SKIP
-For compatibility with some versions of TeX, you may also use the logical name
-"TEXFONTS" in place of "XDVIFONTS", although in that case the string should
-not include any "%" specifiers. The reason for recognizing "TEXFONTS" is
-that certain versions of TeX also support the convention regarding an extra
-slash in the font path; therefore, users who create their own fonts can put
-both their .TFM and raster file in the same directory and do
-.SKIP
-.LITERAL
- $ DEFINE TEXFONTS "/MFDIR"
-
-or
-
- $ DEFINE TEXFONTS "MFDIR/"
-.END LITERAL
-.SKIP
-in order to get TeX and XDVI to search their directory in addition to the
-system standard directories. The "XDVIFONTS" logical name overrides the
-"TEXFONTS" logical name, so that on those sites where "TEXFONTS" must be set
-explicitly, and therefore this feature is not useful, the "XDVIFONTS" logical
-name may be set to an empty string to cause XDVI to ignore "TEXFONTS".
-.SKIP
-XDVI also recognizes the "PKFONTS" and "TEXPKS" logical names, which are
-checked after "XDVIFONTS" but before "TEXFONTS".
-
-.INDENT -1
-3 XDVISIZES
-.BREAK
-The logical name "XDVISIZES" may 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 and must be integers. The current default set of
-sizes is 300/329/360/432/518/622/746. XDVI will also try the actual
-size of the font before trying any of the given sizes.
-
-.INDENT -1
-3 XDVIVFS
-.BREAK
-Virtual fonts are supported, although XDVI does not have any built-in fonts to
-which they can refer. The search path for .VF files can be specified with the
-"XDVIVFS" logical name in a similar manner to that for the "XDVIFONTS" logical
-name. XDVI will also check the "VFFONTS" logical name if the "XDVIFONTS"
-logical name is not defined. Virtual fonts are searched for immediately after
-looking for the font as a normal font in the exact size specified.
-
-.INDENT -1
-2 Resource_Names
-.BREAK
- 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:
-.SKIP
-.LITERAL
- XDvi.copy: off
- XDvi.thorough: on
- XDvi.shrinkFactor: 2
- XDvi.Margin: 0.95
- XDvi*geometry: 1015x750+3+25
-.END LITERAL
-.SKIP
- When XDVI is invoked, it would behave as if it had been invoked with the
- following command:
-.SKIP
-.LITERAL
- XDVI +copy -thorough -s 2 -margins 0.95 -geometry 1015x750+3+25 dvifile
-.END LITERAL
-.SKIP
- Specifying options on the command line will override any options specified
- via resource names in the DECW$XDEFAULTS.DAT file.
-
-.INDENT -1
-2 Authors
-.BREAK
-.LITERAL
-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.
-.END LITERAL