diff options
Diffstat (limited to 'Build/source/texk/windvi/XDVI.RNH')
-rw-r--r-- | Build/source/texk/windvi/XDVI.RNH | 692 |
1 files changed, 0 insertions, 692 deletions
diff --git a/Build/source/texk/windvi/XDVI.RNH b/Build/source/texk/windvi/XDVI.RNH deleted file mode 100644 index 29deb734622..00000000000 --- a/Build/source/texk/windvi/XDVI.RNH +++ /dev/null @@ -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 |