summaryrefslogtreecommitdiff
path: root/Build/source/texk/windvi/xdvi.man
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/windvi/xdvi.man')
-rw-r--r--Build/source/texk/windvi/xdvi.man1569
1 files changed, 0 insertions, 1569 deletions
diff --git a/Build/source/texk/windvi/xdvi.man b/Build/source/texk/windvi/xdvi.man
deleted file mode 100644
index 4dcf7f8c2b4..00000000000
--- a/Build/source/texk/windvi/xdvi.man
+++ /dev/null
@@ -1,1569 +0,0 @@
-.\" Copyright (c) 1990-1999 Paul Vojta
-.\"
-.\" Permission is hereby granted, free of charge, to any person obtaining a copy
-.\" of this software and associated documentation files (the "Software"), to
-.\" deal in the Software without restriction, including without limitation the
-.\" rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-.\" sell copies of the Software, and to permit persons to whom the Software is
-.\" furnished to do so, subject to the following conditions:
-.\"
-.\" The above copyright notice and this permission notice shall be included in
-.\" all copies or substantial portions of the Software.
-.\"
-.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
-.\" PAUL VOJTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-.\" IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-.\" CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-.\"
-.if t .ds Te T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X
-.if n .ds Te TeX
-' # small and boldface (not all -man's provide it)
-.de SB
-\&\fB\s-1\&\\$1 \\$2\s0\fR
-..
-.TH XDVI 1 "15 February 1999" "X Version 11"
-.SH NAME
-xdvi \- DVI Previewer for the X Window System
-.SH SYNOPSIS
-.B xdvi
-.nh
-[\fB+\fP[\fIpage\fP]] [\fB\-s\fP \fIshrink\fP] [\fB\-S\fP \fIdensity\fP]
-#ifgrey
-[\fB\-nogrey\fP] [\fB\-gamma\fP \fIg\fP] [\fB\-install\fP] [\fB\-noinstall\fP]
-#endif
-[\fB\-p\fP \fIpixels\fP]
-[\fB\-margins\fP \fIdimen\fP]
-[\fB\-sidemargin\fP \fIdimen\fP] [\fB\-topmargin\fP \fIdimen\fP]
-[\fB\-offsets\fP \fIdimen\fP]
-[\fB\-xoffset\fP \fIdimen\fP] [\fB\-yoffset\fP \fIdimen\fP]
-[\fB\-paper\fP \fIpapertype\fP] [\fB\-altfont\fP \fIfont\fP]
-#ifmakepk
-[\fB\-nomakepk\fP]
-#endif
-#ifkpathsea
-.BI \-mfmode " mode-def\fR[\fP\fB:\fPdpi\fR]\fP"
-#endif
-#ifnokpathsea
-[\fB\-mfmode\fP \fImode-def\fP]
-#endif
-[\fB\-l\fP]
-[\fB\-rv\fP]
-#ifbuttons
-[\fB\-expert\fP]
-[\fB\-shrinkbutton\fP\fIn\fP \fIshrink\fP]
-#endif
-[\fB\-mgs\fP[\fIn\fP] \fIsize\fP] [\fB\-warnspecials\fP]
-[\fB\-hush\fP]
-[\fB\-hushchars\fP] [\fB\-hushchecksums\fP]
-#ifkpathsea
-[\fB\-hushspecials\fP]
-#endif
-[\fB\-safer\fP]
-[\fB\-fg\fP \fIcolor\fP] [\fB\-bg\fP \fIcolor\fP] [\fB\-hl\fP \fIcolor\fP]
-[\fB\-bd\fP \fIcolor\fP] [\fB\-cr\fP \fIcolor\fP]
-[\fB\-bw\fP \fIwidth\fP]
-#ifgrid
-[\fB\-grid1\fP \fIcolor\fP]
-[\fB\-grid2\fP \fIcolor\fP]
-[\fB\-grid3\fP \fIcolor\fP]
-#endif
-[\fB\-bw\fP \fIwidth\fP]
-[\fB\-display\fP \fIhost:display\fP] [\fB\-geometry\fP \fIgeometry\fP]
-[\fB\-icongeometry\fP \fIgeometry\fP] [\fB\-iconic\fP]
-#ifbuttons
-[\fB\-font\fP \fIfont\fP]
-#endif
-[\fB\-keep\fP] [\fB\-copy\fP] [\fB\-thorough\fP]
-#ifps
-[\fB\-nopostscript\fP]
-[\fB\-noscan\fP]
-[\fB\-allowshell\fP]
-#endif
-#ifdps
-[\fB\-nodps\fP]
-#endif
-#ifnews
-[\fB\-nonews\fP]
-#endif
-#ifghost
-[\fB\-noghostscript\fP]
-[\fB\-nogssafer\fP]
-[\fB\-gsalpha\fP]
-[\fB\-interpreter\fP \fIpath\fP]
-[\fB\-gspalette\fP \fIpalette\fP]
-#endif
-#ifhyper
-[\fB\-underlink\fP]
-[\fB\-browser\fP \fIWWWbrowser\fP]
-[\fB\-base\fP \fIbase URL\fP]
-#endif
-#ifsrcspecials
-[\fB\-srcMode\fP]
-[\fB\-srcVisibility\fP]
-[\fB\-srcTickShape\fP \fIn\fP]
-[\fB\-srcTickSize\fP \fIgeometry\fP]
-[\fB\-srcCursor\fP \fIn\fP]
-[\fB\-srcJumpButton\fP \fIbutton\fP]
-[\fB\-srcEditorCommand\fP \fIcommand string\fP]
-[\fB\-srcSpecialFormat\fP \fIn\fP]
-#endif
-[\fB\-debug\fP \fIbitmask\fP] [\fB\-version\fP]
-#ifselfile
-[\fIdvi_file\fP]
-#endif
-#ifnoselfile
-.I dvi_file
-#endif
-.hy
-.SH DESCRIPTION
-.B xdvi
-is a program which runs under the X window system. It is used to preview
-.I dvi
-files, such as are produced by
-.BR tex (1).
-.PP
-This program has the capability of showing the file shrunken by various
-(integer) factors, and also has a ``magnifying glass'' which allows one
-to see a small part of the unshrunk image momentarily.
-.PP
-Before displaying any page or part thereof, it checks to see if the
-.I dvi
-file has changed since the last time it was displayed. If this is the case,
-then
-.B xdvi
-will reinitialize itself for the new
-.I dvi
-file. For this reason, exposing parts of the
-.B xdvi
-window while \*(Te\& is running should be avoided. This feature allows you
-to preview many versions of the same file while running
-.B xdvi
-only once.
-#ifbuttons
-.PP
-In addition to using keystrokes to move within the file,
-.B xdvi
-provides buttons on the right side of the window, which are synonymous
-with various sequences of keystrokes.
-#endif
-#ifps
-.PP
-.B xdvi
-can show PostScript<tm> specials by any of three methods.
-It will try first to use Display PostScript<tm>, then NeWS, then it
-will try to use Ghostscript to render the images. All of these options
-depend on additional software to work properly; moreover, some of them
-may not be compiled into this copy of
-.BR xdvi .
-.PP
-For performance reasons,
-.B xdvi
-does not render PostScript specials in the magnifying glass.
-#endif
-#ifselfile
-.PP
-If
-.I dvi_file
-is not specified, a file-selection widget is popped up for you to choose the
-.I dvi
-file.
-#endif
-.SH OPTIONS
-In addition to specifying the
-.I dvi
-file (with or without the
-.B .dvi
-extension),
-.B xdvi
-supports the following command line options. If the option begins with a
-.RB ` + '
-instead of a
-.RB ` \- ',
-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.
-.TP
-.BI + page
-Specifies the first page to show. If
-.B +
-is given without a number, the last page is assumed; the first page is
-the default.
-#ifps
-.TP
-.B \-allowshell
-.RB ( .allowShell )
-This option enables the shell escape in PostScript specials.
-(For security reasons, shell escapes are disabled by default.)
-This option should be rarely used; in particular it should not be used just
-to uncompress files: that function is done automatically if the file name
-ends in
-.BR .Z ,
-.BR .gz ,
-or
-.BR .bz2
-Shell escapes are always turned off if the
-.B \-safer
-option is used.
-#endif
-.TP
-.BI \-altfont " font"
-.RB ( .altFont )
-Declares a default font to use when the font in the
-.I dvi
-file cannot be found. This is useful, for example, with PostScript <tm> fonts.
-.TP
-.BI \-background " color"
-.RB ( .background )
-Determines the color of the background. Same as
-.BR -bg .
-#ifhyper
-.TP
-.BI \-base " base URL"
-.RB ( .urlBase )
-Sets the base URL value that external links given in the
-.I dvi
-file are assumed relative to - normally this should be the URL
-of the document itself (?).
-#endif
-.TP
-.BI \-bd " color"
-.RB ( .borderColor )
-Determines the color of the window border.
-.TP
-.BI \-bg " color"
-.RB ( .background )
-Determines the color of the background.
-.TP
-.BI \-bordercolor " color"
-Same as
-.BR -bd .
-.TP
-.BI \-borderwidth " width"
-.RB ( .borderWidth )
-Specifies the width of the border of the window. Same as
-.BR -bw .
-#ifhyper
-.TP
-.BI \-browser " WWWbrowser"
-.RB ( .wwwBrowser )
-Defines the World Wide Web browser to be used to handle external URL's,
-for example mosaic. If neither the command-line option nor the X
-resource are set, uses the environment variable WWWBROWSER.
-#endif
-.TP
-.BI \-bw " width"
-.RB ( .borderWidth )
-Specifies the width of the border of the window.
-.TP
-.B \-copy
-.RB ( .copy )
-Always use the
-.I 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.
-#ifgrey
-If greyscale anti-aliasing is in use, the
-.B \-copy
-operation will disable the use of colorplanes and make overstrikes come
-out incorrectly.
-#endif
-See also
-.BR \-thorough .
-.TP
-.BI \-cr " color"
-.RB ( .cursorColor )
-Determines the color of the cursor. The default is the color of the page
-border.
-.TP
-.BI \-debug " bitmask"
-.RB ( .debugLevel )
-#ifnokpathsea
-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
-.BR xdvi.h .
-#endif
-#ifkpathsea
-If nonzero, prints additional information on standard output. The
-number is taken as a set of independent bits. The meaning of each bit
-follows. 1=bitmaps; 2=dvi translation; 4=pk reading; 8=batch
-operation; 16=events; 32=file opening; 64=PostScript communication;
-128=Kpathsea stat(2) calls; 256=Kpathsea hash table lookups; 512=Kpathsea
-path definitions; 1024=Kpathsea path expansion; 2048=Kpathsea searches.
-To trace everything having to do with file searching and opening, use 4000.
-Some of these debugging options are actually provided by Kpathsea.
-See the Debugging section in the Kpathsea manual.
-#endif
-.TP
-.BI \-density " density"
-.RB ( .densityPercent )
-Determines the density used when shrinking bitmaps for fonts.
-A higher value produces a lighter font. The default value is 40.
-#ifgrey
-If greyscaling is in use this argument does not apply; use
-.B \-gamma
-instead.
-#endif
-See also the
-.RB ` S '.
-keystroke.
-Same as
-.BR \-S
-.TP
-.BI \-display " host" : display
-Specifies the host and screen to be used for displaying the
-.I dvi
-file. By default this is obtained from the environment variable
-.SB DISPLAY.
-#ifbuttons
-.TP
-.B \-expert
-.RB ( .expert )
-Prevent the buttons from appearing. See also the
-.RB ` x '
-keystroke.
-#endif
-.TP
-.BI \-fg " color"
-.RB ( .foreground )
-Determines the color of the text (foreground).
-.TP
-.BI \-foreground " color"
-Same as
-.BR -fg .
-#ifbuttons
-.TP
-.BI \-font " font"
-.RB ( *font )
-Sets the font for use in the buttons.
-#endif
-#ifgrey
-.TP
-.BI \-gamma " gamma"
-.RB ( .gamma )
-Controls the interpolation of colors in the greyscale anti-aliasing color
-palette. Default value is 1.0. For 0 <
-.I gamma
-< 1, the fonts will be lighter (more like the background), and for
-.I gamma
-> 1, the fonts will be darker (more like the foreground). Negative
-values behave the same way, but use a slightly different algorithm.
-For color and greyscale displays; for monochrome, see
-.BR \-density .
-See also the
-.RB ` S '
-keystroke
-#endif
-#ifgrid
-.TP
-.BI \-grid1 " color"
-.RB ( .grid1Color )
-Determines the color of level 1 grid (default as foreground)
-.TP
-.BI \-grid2 " color"
-.RB ( .grid2Color )
-Determines the color of level 2 grid (default as foreground)
-.TP
-.BI \-grid3 " color"
-.RB ( .grid3Color )
-Determines the color of level 3 grid (default as foreground)
-#endif
-.TP
-.BI \-geometry " geometry"
-.RB ( *geometry )
-Specifies the initial geometry of the window.
-#ifghost
-.TP
-.BI \-gspalette " palette"
-.RB ( .palette )
-Specifies the palette to be used when using Ghostscript for rendering
-PostScript specials. Possible values are
-.BR Color ,
-.BR Greyscale ,
-and
-.BR Monochrome .
-The default is
-.BR Color .
-.TP
-.B \-gsalpha
-.RB ( .gsAlpha )
-Causes
-.B Ghostscript
-to be called with the
-.B x11alpha
-driver instead of the
-.B x11
-driver. The
-.B x11alpha
-driver enables anti-aliasing in PostScript figures, for a nicer appearance.
-It is available on newer versions of
-.BR Ghostscript .
-This option can also be toggled with the
-.RB ` V '
-keystroke.
-#endif
-.TP
-.BI \-hl " color"
-.RB ( .highlight )
-Determines the color of the page border. The default is the foreground color.
-.TP
-.B \-hush
-.RB ( .Hush )
-Causes
-.B xdvi
-to suppress all suppressible warnings.
-.TP
-.B \-hushchars
-.RB ( .hushLostChars )
-Causes
-.B xdvi
-to suppress warnings about references to characters which are not defined
-in the font.
-.TP
-.B \-hushchecksums
-.RB ( .hushChecksums )
-Causes
-.B xdvi
-to suppress warnings about checksum mismatches between the
-.I dvi
-file and the font file.
-.TP
-#ifkpathsea
-.B \-hushspecials
-.RB ( .hushSpecials )
-Causes
-.B xdvi
-to suppress warnings about
-.B \especial
-strings that it cannot process.
-#endif
-.TP
-.BI \-icongeometry " geometry"
-.RB ( .iconGeometry )
-Specifies the initial position for the icon.
-.TP
-.B \-iconic
-.RB ( .iconic )
-Causes the
-.B xdvi
-window to start in the iconic state. The default is to start with the
-window open.
-#ifgrey
-.TP
-.B \-install
-.RB ( .install )
-If
-.B xdvi
-is running under a
-.B PseudoColor
-visual, then (by default) it will check for
-.B TrueColor
-visuals with more bits per pixel, and switch to such a visual if one exists.
-If no such visual exists, it will use the current visual and colormap. If
-.B \-install
-is selected, however, it will still use a
-.B TrueColor
-visual with a greater depth, if one is available; otherwise, it will
-install its own colormap on the current visual. If the current visual is not
-.BR PseudoColor ,
-then
-.B xdvi
-will not switch the visual or colormap, regardless of its options.
-The default value of the
-.B install
-resource is the special value,
-.BR maybe .
-There is no
-.B +install
-option. See also
-.BR \-noinstall ,
-and the GREYSCALING AND COLORMAPS section.
-#endif
-#ifghost
-.TP
-.BI \-interpreter " filename"
-.RB ( .interpreter )
-Use
-.I filename
-as the Ghostscript interpreter. By default it uses
-.BR @GS_PATH@ .
-#endif
-.TP
-.B \-keep
-.RB ( .keepPosition )
-Sets a flag to indicate that
-.B xdvi
-should not move to the home position when moving to a new page. See also the
-.RB ` k '
-keystroke.
-.TP
-.B \-l
-.RB ( .listFonts )
-Causes the names of the fonts used to be listed.
-.TP
-.BI \-margins " dimen"
-.RB ( .Margin )
-Specifies the size of both the top margin and side margin.
-This 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.
-The dimension should be a decimal number optionally followed by
-any of the two-letter abbreviations for units accepted by \*(Te\&
-.RB ( pt ,
-.BR pc ,
-.BR in ,
-.BR bp ,
-.BR cm ,
-.BR mm ,
-.BR dd ,
-.BR cc ,
-or
-.BR sp ).
-By default, the unit will be
-.BR @DEFAULT_UNIT@.
-See also
-.BR \-sidemargin ", " \-topmargin ,
-and the keystroke
-.RB ` M .'
-.TP
-#ifkpathsea
-.BI \-mfmode " mode-def"
-#endif
-#ifnokpathsea
-.BI \-mfmode " mode-def\fR[\fP\fB:\fPdpi\fR]\fP"
-#endif
-.RB ( .mfMode )
-Specifies a
-.I mode-def
-string, which can be used in searching for fonts (see ENVIRONMENT, below).
-Generally, when changing the
-.IR mode-def ,
-it is also necessary to change the font size to the appropriate value
-for that mode. This is done by adding a colon and the value in dots per inch;
-for example,
-.BR "\-mfmode ljfour:600" .
-This method overrides any value given by the
-.B pixelsPerInch
-resource or the
-.B \-p
-command-line argument.
-#ifmakepk
-The metafont mode is also passed to
-.B metafont
-during automatic creation of fonts.
-#endif
-By default, it is
-.BR "@MFMODE@" .
-.TP
-.BI \-mgs " size"
-Same as
-.BR \-mgs1 .
-.TP
-.BI "\-mgs\fR[\fIn\fR]" " size"
-.RB ( .magnifierSize\fR[\fIn\fR] )
-Specifies the size of the window to be used for the ``magnifying glass''
-for Button
-.IR 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
-.IR width x height .
-See the MOUSE ACTIONS section. Defaults are 200x150, 400x250, 700x500,
-1000x800, and 1200x1200.
-#ifdps
-.TP
-.B \-nodps
-.RB ( .dps )
-Inhibits the use of Display PostScript<tm> for displaying PostScript<tm>
-specials. Other forms of PostScript emulation, if installed, will be used
-instead.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nodps
-corresponds to
-.BR dps:off ;
-.B +nodps
-to
-.BR dps:on .)
-#endif
-#ifghost
-.TP
-.B \-noghostscript
-.RB ( .ghostscript )
-Inhibits the use of Ghostscript for displaying PostScript<tm> specials.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-noghostscript
-corresponds to
-.BR ghostscript:off ;
-.B +noghostscript
-to
-.BR ghostscript:on .)
-#endif
-#ifgrey
-.TP
-.B \-nogrey
-.RB ( .grey )
-Turns off the use of greyscale anti-aliasing when printing shrunken bitmaps.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nogrey
-corresponds to
-.BR grey:off ;
-.B +nogrey
-to
-.BR grey:on .)
-See also the
-.RB ` G '
-keystroke.
-#endif
-#ifghost
-.TP
-.B \-nogssafer
-.RB ( .gsSafer )
-Normally, if Ghostscript is used to render PostScript specials, the Ghostscript
-interpreter is run with the option
-.BR \-dSAFER .
-The
-.B \-nogssafer
-option runs Ghostscript without
-.BR \-dSAFER .
-The
-.B \-dSAFER
-option in Ghostscript disables PostScript operators such as
-.BR deletefile ,
-to prevent possibly malicious PostScript programs from having any effect.
-If the
-.B \-safer
-option is specified, then this option has no effect; in that case Ghostscript
-is always run with
-.BR \-dSAFER .
-(For the
-.B \-nogssafer
-option, the logic of the corresponding resource is reversed:
-.B \-nogssafer
-corresponds to
-.BR gsSafer:off ;
-.B +nogssafer
-to
-.BR gsSafer:on .)
-#endif
-#ifgrey
-.TP
-.B \-noinstall
-.RB ( .install )
-Inhibit the default behavior of switching to a
-.B TrueColor
-visual if one is available with more bits per pixel than the current visual.
-This option corresponds to a resource of
-.BR install:off .
-There is no
-.B +noinstall
-option. See also
-.BR \-install ,
-and the GREYSCALING AND COLORMAPS section.
-#endif
-#ifmakepk
-.TP
-.B \-nomakepk
-.RB ( .makePk )
-Turns off automatic generation of font files that cannot be found by other
-means.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nomakepk
-corresponds to
-.BR makePk:off ;
-.B +nomakepk
-to
-.BR makePK:on .)
-#endif
-#ifnews
-.TP
-.B \-nonews
-.RB ( .news )
-Inhibits the use of NeWS<tm> for displaying PostScript<tm> specials.
-Ghostscript, if enabled by the installation, will be used instead.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nonews
-corresponds to
-.BR news:off ;
-.B +news
-to
-.BR news:on .)
-#endif
-#ifps
-.TP
-.B \-nopostscript
-.RB ( .postscript )
-Turns off rendering of PostScript<tm> specials. Bounding boxes, if known,
-will be displayed instead. This option can also be toggled with the
-.RB ` v '
-keystroke.
-(For this option, the logic of the corresponding resource is reversed:
-.B \-nopostscript
-corresponds to
-.BR postscript:off ;
-.B +postscript
-to
-.BR postscript:on .)
-#endif
-#ifps
-.TP
-.B \-noscan
-.RB ( .prescan )
-Normally, when PostScript<tm> is turned on,
-.B xdvi
-will do a preliminary scan of the
-.I dvi
-file, in order to send any necessary header files before sending the
-PostScript code that requires them. This option turns off such prescanning.
-(It will be automatically be turned back on if
-.B xdvi
-detects any specials that require headers.) (For the
-.B \-noscan
-option, the logic of the corresponding resource is reversed:
-.B \-noscan
-corresponds to
-.BR prescan:off ;
-.B +noscan
-to
-.BR prescan:on .)
-#endif
-.TP
-.BI \-offsets " dimen"
-.RB ( .Offset )
-Specifies the size of both the horizontal and vertical offsets of the
-output on the page. By decree of the Stanford \*(Te\& Project,
-the default \*(Te\& 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.
-The argument
-.I dimen
-should be a decimal number optionally followed by any of the two-letter
-abbreviations for units accepted by \*(Te\&
-.RB ( pt ,
-.BR pc ,
-.BR in ,
-.BR bp ,
-.BR cm ,
-.BR mm ,
-.BR dd ,
-.BR cc ,
-or
-.BR sp ).
-By default, the unit will be
-.BR @DEFAULT_UNIT@.
-See also
-.B \-xoffset
-and
-.BR \-yoffset .
-.TP
-.BI \-p " pixels"
-.RB ( .pixelsPerInch )
-Defines the size of the fonts to use, in pixels per inch. The
-default value is @BDPI@. This option is provided only for backwards
-compatibility; the preferred way of setting the font size is by setting the
-Metafont mode at the same time; see the
-.B \-mfmode
-option.
-.TP
-.BI \-paper " papertype"
-.RB ( .paper )
-Specifies the size of the printed page. This may be of the form
-\fIwidth\fBx\fIheight\fR optionally followed by a unit, where
-.I width
-and
-.I height
-are decimal numbers giving the width and height of the paper, respectively,
-and the unit is any of the two-letter abbreviations for units accepted
-by \*(Te\&
-.RB ( pt ,
-.BR pc ,
-.BR in ,
-.BR bp ,
-.BR cm ,
-.BR mm ,
-.BR dd ,
-.BR cc ,
-or
-.BR sp ).
-By default, the unit will be
-.BR @DEFAULT_UNIT@.
-There are also synonyms which may be used:
-.B us
-(8.5x11in),
-.B usr
-(11x8.5in),
-.B legal
-(8.5x14in),
-.B foolscap
-(13.5x17in),
-as well as the ISO sizes
-.BR a1 - a7 ,
-.BR b1 - b7 ,
-.BR c1 - c7 ,
-.BR a1r - a7r
-.RB ( a1 - a7
-rotated), etc. The default size is @DEFAULT_PAGE_SIZE@.
-.TP
-.B \-rv
-.RB ( .reverseVideo )
-Causes the page to be displayed with white characters on a black background,
-instead of vice versa.
-.TP
-.BI \-s " shrink"
-.RB ( .shrinkFactor )
-Defines the initial shrink factor. The default value is @SHRINK@. If
-.I shrink
-is given as 0, then the initial shrink factor is computed so that the
-page fits within the window (as if the `s' keystroke were given without
-a number).
-.TP
-.BI \-S " density"
-.RB ( .densityPercent )
-Same as
-.BR \-density ,
-.I q.v.
-.TP
-.B \-safer
-.RB ( .safer )
-This option turns on all available security options; it is designed for use when
-.B xdvi
-is called by a browser that obtains a
-.I dvi
-or \*(Te\& file from another site.
-#ifps
-In the present case, this option selects
-#endif
-#ifghost
-.B +nogssafer
-and
-#endif
-#ifps
-.BR +allowshell .
-#endif
-#ifnops
-In the present case, this option is accepted but has no effect, since
-.B xdvi
-has been compiled without support for PostScript specials.
-#endif
-#ifbuttons
-.TP
-.BI \-shrinkbutton "n shrink"
-.RB ( .shrinkButton\fIn\fP )
-Specifies that the
-.IR n th
-button changing shrink factors shall change to shrink factor
-.IR factor .
-This is not very usefull in the normal run of things. xdvik scales the
-scaling factors according to resolution (currently 300dpi and 600dpi).
-Here
-.I n
-may be a number from 1 to 4. Typical
-.I factors
-are powers of 2.
-#endif
-.TP
-.BI \-sidemargin " dimen"
-.RB ( .sideMargin )
-Specifies the side margin (see
-.BR \-margins ).
-#ifsrc
-.TP
-.BI \-srcMode
-.RB ( .srcMode )
-Starts xdvi in src special mode (see the section SRC
-SPECIAL MODE below for details). The mode can be toggled
-with `Ctrl-s'; when the mode is on, the cursor
-has a different shape (see the \fB-srcCursor\fR option below).
-For security reasons, evaluation of src specials is off by default,
-and it might be a good idea to enable it only for selected .dvi files
-on the command line.
-.TP
-.BI \-srcVisibility
-.RB ( .srcVisibility )
-Makes the source specials visible by drawing small tick marks
-for each special. This can be toggled with the `V' key (see
-the section SRC SPECIAL MODE for more details).
-.TP
-.BI \-srcTickShape " n"
-.RB ( .srcTickShape )
-Specifies the shape of the src tick marks, where \fIn\fR can be
-one of \fB0\fR, \fB1\fR, \fB2\fR or \fB3\fR:
-\fB0\fR is a rectangle,
-\fB1\fR is a triangle,
-\fB2\fR is an upward angle and
-\fB3\fR is a downward angle.
-See the section SRC SPECIAL MODE for more details.
-.TP
-.BI \-srcTickSize " geometry"
-.RB ( .srcTickSize )
-Specifies the size of the src tick marks in pixels
-\fIwidth\fR x \fIheight\fR, with respect to magnification factor 1.
-Default is 40x70, which is a reasonable value for 600dpi
-fonts. For higher resolutions, you might want to increase
-the size. The two attributes \fIwidth\fR and \fIheight\fR only have a
-natural meaning for the \fBrectangle\fR shape; for the \fBtriangle\fR,
-\fIwidth\fR is ignored; for the \fBangle\fR shapes, \fIwidth\fR is half
-the width of the lines, and \fIheight\fR is the length of the lines.
-See the section SRC SPECIAL MODE for more details.
-.TP
-.BI \-srcCursor " n"
-.RB ( .srcCursor )
-The shape of the cursor in SRC SPECIAL MODE. For possible
-values, see e. g. `cursorfont.h'.
-.TP
-.BI \-srcJumpButton " button"
-.RB ( .srcJumpButton )
-The mouse button used in SRC SPECIAL MODE to
-jump to the next special near point. See
-the section SRC SPECIAL MODE for more details.
-.TP
-.BI \-srcEditorCommand " command string"
-.RB ( .srcEditorCommand )
-Specifies the editor command that will be called when
-the user wants to jump to a src special.
-This should be a C format string containing 2 placeholders
-(aka `conversion specifications'):
-%s (for the filename) and %u (for the line number) pointed
-to by that special. You should always enclose both of these
-conversion specifications into a pair of quotes like this: '%u';
-this will ensure that the shell won't interpret the resulting
-format string directly. This way it will do no harm when
-some evil user puts commands like `ls -lR /` into the src
-specials of a .dvi file, instead of the ordinary filename.
-The default for this command string is:
-.sp
-emacsclient --no-wait '+%u' '%s'
-.sp
-which will work together with Emacs. For Xemacs you would
-have to use something like:
-.sp
-gnuclient -q +'%u' '%s'
-.sp
-Note that when the command-line option, you'll have to
-enclose the string into another pair of quotes; don't
-enclose the string in quotes when specifying it as an
-X resource.
-.TP
-.BI \-srcSpecialFormat " n"
-.RB ( .srcSpecialFormat )
-The format of the
-.B \especial
-strings in the dvi file. The formats currently supported are:
-.sp
-\fB0\fR \especial{src:filename:linenumber}
-.sp
-\fB1\fR \especial{src:linenumber<space>filename}
-.sp
-\fB2\fR \especial{src:linenumber<space>*filename}
-.sp
-In the first format, the colon separating the linenumber from the filename
-is the last colon in the entire string.
-.sp
-The second format requires exactly one space between the line number and
-the file name.
-.sp
-In the third format, there can be any number of spaces (including 0 --
-but then of course the file name shouldn't start with a digit, so using
-no space at all is usually not a good idea).
-.sp
-Xdvi will warn you about specials that don't conform to the
-format currently selected.
-#endif
-.TP
-.B \-thorough
-.RB ( .thorough )
-.B xdvi
-will usually try to ensure that overstrike characters
-.RI ( e.g. ,
-.BR \enotin )
-are printed correctly. On monochrome displays, this is always possible
-with one logical operation, either
-.I and
-or
-.IR 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
-.B xdvi
-will instead use the
-.I copy
-operation, which does not handle overstriking correctly. The
-.B \-thorough
-option chooses the slower but more correct choice. See also
-.BR \-copy .
-.TP
-.BI \-topmargin " dimen"
-.RB ( .topMargin )
-Specifies the top and bottom margins (see
-.BR \-margins ).
-.TP
-#ifhyper
-.BI \-underlink
-.RB ( .underLink )
-Underline links. Default is true.
-#endif
-.TP
-.BI \-version
-Print information on the version of
-.BR xdvi .
-.TP
-.B \-warnspecials
-.RB ( .warnSpecials )
-Causes
-.B xdvi
-to issue warnings about
-.B \especial
-strings that it cannot process.
-.TP
-.BI \-xoffset " dimen"
-.RB ( .xOffset )
-Specifies the size of the horizontal offset of the output on the page. See
-.BR \-offsets .
-.TP
-.BI \-yoffset " dimen"
-.RB ( .yOffset )
-Specifies the size of the vertical offset of the output on the page. See
-.BR -offsets .
-.SH KEYSTROKES
-.B 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.
-Also, the ``Help'', ``Home'', ``Prior'', ``Next'', and arrow cursor keys
-are synonyms for
-.RB ` ? ',
-.RB ` ^ ',
-.RB ` b ',
-.RB ` f ',
-.RB ` l ',
-.RB ` r ',
-.RB ` u ',
-and
-.RB ` d '
-keys, respectively.
-.TP
-.B q
-Quits the program. Control-C and control-D will do this, too.
-.TP
-.B Q
-Quits the program with exit status 2.
-.TP
-.B n
-Moves to the next page (or to the
-.IR n th
-next page if a number is given). Synonyms are
-.RB ` f ',
-Space, Return, and Line Feed.
-.TP
-.B p
-Moves to the previous page (or back
-.I n
-pages). Synonyms are
-.RB ` b ',
-control-H, and Delete.
-.TP
-.B 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
-.RB ` P '
-keystroke, below. If no page number is given, then it goes to the last page.
-.TP
-.B P
-``This is page number
-.IR n .''
-This can be used to make the
-.RB ` g '
-keystroke refer to actual page numbers instead of absolute page numbers.
-.TP
-Control-L
-Redisplays the current page.
-.TP
-.B ^
-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
-.B \-margins
-option, above.
-.TP
-.B u
-Moves up two thirds of a window-full.
-.TP
-.B d
-Moves down two thirds of a window-full.
-.TP
-.B l
-Moves left two thirds of a window-full.
-.TP
-.B r
-Moves right two thirds of a window-full.
-.TP
-.B 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.
-.TP
-.B 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
-.B \-margins
-option.
-.TP
-.B 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.)
-.TP
-.B 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.
-#ifgrey
-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.
-#endif
-.TP
-.B t
-Toggles to the next unit in a sorted list of \*(Te\& dimension
-units for the popup magnifier ruler.
-.TP
-.B R
-Forces the
-.I dvi
-file to be reread. This allows you to preview many versions of the same
-file while running
-.B xdvi
-only once.
-.TP
-.B k
-Normally when
-.B xdvi
-switches pages, it moves to the home position as well. The
-.RB ` k '
-keystroke toggles a `keep-position' flag which, when set, will keep
-the same position when moving between pages. Also
-.RB ` 0k '
-and
-.RB ` 1k '
-clear and set this flag, respectively. See also the
-.B \-keep
-option.
-#ifbuttons
-.TP
-.B x
-Toggles expert mode (in which the buttons do not appear). Also
-.RB ` 0x '
-and
-.RB ` 1x '
-clear and reset this mode, respectively. See also the
-.B \-expert
-option.
-#endif
-#ifgrey
-.TP
-.B G
-This key toggles the use of greyscale anti-aliasing for displaying shrunken
-bitmaps. In addition, the key sequences
-.RB ` 0G '
-and
-.RB ` 1G '
-clear and set this flag, respectively. See also the
-.B \-nogrey
-option.
-.PP
-If given a numeric argument that is not 0 or 1, greyscale anti-aliasing is
-turned on, and the gamma resource is set to the value divided by
-100. E.g.,
-.RB ` 150G '
-turns on greyscale and sets gamma to 1.5.
-#endif
-#ifgrid
-.TP
-.B D
-This key toggles the use of grid over the document.
-If no number is given, the grid mode toggles.
-By prepending number, 3 grid levels can be set.
-The grid in each level is drawn in the colour specified.
-See also the
-.B \-grid1, \-grid2,
-and
-.B \-grid3
-options.
-#endif
-#ifps
-.TP
-.B v
-This key toggles the rendering of PostScript<tm> specials. If rendering
-is turned off, then bounding boxes are displayed when available.
-In addition the key sequences
-.RB ` 0v '
-and
-.RB ` 1v '
-clear and set this flag, respectively. See also the
-.B \-nopostscript
-option.
-#endif
-#ifghost
-.TP
-.B V
-This key toggles tha anti-aliasing of PostScript<tm> specials when
-.B Ghostscript
-is used as renderer. In addition the key sequences
-.RB ` 0V '
-and
-.RB ` 1V '
-clear and set this flag, See also the
-+.B \-gsalpha
-option.
-#endif
-#ifselfile
-.TP
-.B F
-Read a new
-.I dvi
-file. A file-selection widget is popped up for you to choose the dvi
-file from.
-#endif
-.SH MOUSE ACTIONS
-If the shrink factor is set to any number other than one, then clicking
-#ifkpathsea
-mouse button 3
-#endif
-#ifnokpathsea
-any mouse button
-#endif
-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
-.B \-mgs
-option. Moving the cursor while holding the button down will move the
-magnifying glass.
-#ifhyper
-.PP
-If the cursor is on a hypertext link (underlined by default), then
-that link overrides the magnifying glass for Buttons 1 and 2.
-If Button 1 is clicked over a link, then
-.B xdvi
-jumps to the target in the current window. If Button 2 is clicked over a link,
-then
-.B xdvi
-opens a new window on the target.
-.PP
-More precisely, for internal links, Button 1 jumps in the same window to
-the link, while Button 2 starts up a new
-.B xdvi
-on the link. For external links to
-.I dvi
-files, Button 1 changes the current
-.B xdvi
-to be reading that file, while Button 2 starts a new
-.B xdvi
-on that file. For other file types,
-.B mime.types
-and
-.B mailcap
-are parsed to determine the viewer; finally, if no suitable
-.B mailcap
-entry was found, if the
-.SB WWWBROWSER
-environment variable is set, or
-.B \-browser
-was specified on the command line, it is started up on the file.
-#endif
-.PP
-The scrollbars (if present) behave in the standard 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.
-.SH SIGNALS
-When
-.B xdvi
-receives a
-.SB SIGUSR1
-signal, it rereads the
-.I dvi
-file.
-#ifgrey
-.SH GREYSCALING AND COLORMAPS
-The greyscale anti-aliasing feature in
-.B xdvi
-will not work at its best if the display does not have enough colors available.
-This can happen if other applications are using most of the colormap
-(even if they are iconified). If this occurs, then
-.B xdvi
-will print an error message and turn on the
-.B -copy
-option. This will result in overstrike characters appearing wrong;
-it may also result in poor display quality if the number of available
-colors is very small.
-.PP
-Typically this problem occurs on displays that allocate eight bits
-of video memory per pixel. To see how many bits per pixel your display
-uses, type
-.B xwininfo
-in an
-.B xterm
-window, and then click the mouse on the root window when asked. The
-``Depth:'' entry will tell you how many bits are allocated per pixel.
-.PP
-Displays using at least 15 bits per pixel are typically
-.B TrueColor
-visuals, which do not have this problem, since their colormap is
-permanently allocated and available to all applications. (The visual
-class is also displayed by
-.BR xwininfo .)
-For more information on visual classes see the documentation for the
-X Window System.
-.PP
-To alleviate this problem, therefore, one may (a) run with more bits
-per pixel (this may require adding more video memory or replacing the video
-card), (b) shut down other applications that may be using much of the colormap
-and then restart
-.BR xdvi ,
-or (c) run
-.B xdvi
-with the
-.B \-install
-option.
-.PP
-One application which is often the cause of this problem is
-.BR Netscape .
-In this case there are two more alternatives to remedying the situation.
-One can run
-.RB `` "netscape -install" ''
-to cause
-.B Netscape
-to install a private colormap. This can cause colors to change in
-bizarre ways when the mouse is moved to a different window.
-Or, one can run
-.RB `` "netscape -ncols 220" ''
-to limit
-.B Netscape
-to a smaller number of colors. A smaller number will ensure that
-other applications have more colors available, but will degrade the
-color quality in the
-.B Netscape
-window.
-#endif
-#ifkpathsea
-.SH ENVIRONMENT
-Please see the
-.B kpathsea
-documentation.
-#endif
-
-#ifps
-.SH HANDLING OF POSTSCRIPT FIGURES
-.B xdvi
-can display PostScript files included in the
-.I dvi
-file. Such files are first searched for in the directory where the
-.I dvi
-file is, and then using normal
-.B Kpathsea
-rules. There is an exception to this, however: if the file name begins
-with a backtick
-.RB ( ` ),
-then the remaining characters in the file name give a shell command (often
-.BR zcat )
-which is executed; its standard output is then sent to be interpreted as
-PostScript. Note that there is some potential for security problems here;
-see the
-.B \-allowshell
-command-line option. It is better to use compressed files directly (see below).
-.PP
-If a file name is given (as opposed to a shell command),
-if that file name ends in
-.RB `` .Z '',
-.RB `` .gz '',
-or
-.RB `` .bz2 ''
-and if the first two bytes of the file indicate that it was compressed with
-.BR compress (1),
-.BR gzip (1),
-or
-.BR bzip2 (1)
-respectively, then the file is first uncompressed with
-.BR "uncompress \-c" ,
-.BR "gunzip \-c" ,
-or
-.BR "bunzip2 \-c" ,
-respectively. This is preferred over using a backtick to call the command
-directly, since you do not have to specify
-.B \-allowshell
-and since it allows for path searching.
-#endif
-#ifdef src
-.SH SRC SPECIAL MODE
-ADD SOMETHING HERE, including:
-.sp
-- general description (concept of separate mode; maybe something
-more about security issues)
-.sp
-- description of keys/buttons available in src special mode
-(\fBV\fR toggles visibility of tick marks, \fBX\fR highlights
-next special without jumping to it, \fBT\fR changes the
-shapes of the marks, Mouse button 2 jumps to
-next special unless user has specified another button
-with \fB-srcJumpButton\fR)
-.sp
-- meaning of the tick marks (reference points:
-the reference point is the upper-left corner for
-the rectangle shape, the top of the triangle for the triangular shape,
-the inner angle point for the upangle and the
-outer angle point for the downangle shape).
-.sp
-- searching of `next' special on page (xdvi will search `linewise',
-i.e. it will jump to the next special on the current line (to the
-right of the mouse click) if there is one, and to the first special on
-the next line else).
-.sp
-#endif
-.SH ENVIRONMENT
-.B xdvik
-uses the same environment variables and algorithms for finding
-font files as \*(Te\& and friends. See the documentation for the
-.B Kpathsea
-library for details (repeating it here is too cumbersome). In addition,
-.B xdvik
-accepts the following variables:
-.TP
-.SB DISPLAY
-Specifies which graphics display terminal to use.
-#ifnokpathsea
-.TP
-.SB XDVISIZES
-A list of font resolutions separated by colons. If a font cannot be found
-or made at its stated size, then these sizes are tried as a fallback.
-See the `Fallback font' section in the
-.B Kpathsea
-manual for more details.
-.B xdvi
-tries the actual size of the font before trying any of the given sizes.
-Each font resolution should be a positive integer, specifying the number
-of dots per inch, or a string of the form
-.BR magstep\fIn\fP ,
-where
-.I n
-is a number -9.5, -9, -8.5, ..., 8, 8.5, 9, or 9.5. The string
-.B magstep
-may be shortened to any non-empty initial substring (so that
-.B magstep0.5
-may be shortened to
-.B mag0.5
-or
-.B m0.5
-(but not
-.BR mag.5 )).
-The entries
-.BI magstep n
-signify the current pixels-per-inch value, multiplied by 1.2 raised to the
-.IR n th
-power, and rounded to the nearest integer.
-If the list begins with a colon, 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 @DEFAULT_FONT_SIZES@.
-#endif
-.TP
-.SB KPATHSEA_DEBUG
-Trace
-.B Kpathsea
-lookups; set it to
-.B -1
-for complete tracing.
-.TP
-.SB MIMELIBDIR
-Directory containing the
-.B mime.types
-file, if
-.B ~/.mime-types
-does not exist.
-.TP
-.SB MAILCAPDIR
-Directory containing the
-.B .mailcap
-file, if
-.B ~/.mailcap
-does not exist.
-#ifhyper
-.TP
-.SB WWWBROWSER
-The browser used to open URL's, if neither the
-.B \-browser
-option nor the
-.B .wwwBrowser
-resource are set. For more information on hyper-\*(Te\& support,
-see the `Hypertext' node in the
-.B dvipsk
-manual.
-#endif
-#ifps
-.TP
-.SB TMPDIR
-The directory to use for storing temporary files created when uncompressing
-PostScript files.
-#ifps
-.SH LIMITATIONS
-.B xdvi
-accepts many but not all types of PostScript specials accepted by
-.BR dvips .
-For example, it accepts most specials generated by
-.B epsf
-and
-.BR psfig ,
-It does not, however, support
-.B bop\-hook
-or
-.BR eop\-hook ,
-nor does it allow PostScript commands to affect the rendering of things that
-are not PostScript (for example, the ``NEAT'' and rotated ``A'' examples in the
-.B dvips
-manual). These restrictions are due to the design of
-.BR xdvi ;
-in all likelihood they will always remain.
-.PP
-La\*(Te\&2e color and rotation specials are not currently supported.
-#endif
-.SH FILES
-Please see the kpathsea documentation.
-.SH COPYRIGHTS
-.B xdvi
-itself is Copyrighted by Paul Vojta and distributed under the X-Consortium
-license.
-.B xdvi
-uses the
-.B libwww
-library of the World Wide Web Consortium, which includes computer software
-creaded and made available by CERN. It also uses the
-.B kpathsea
-library which is distributed under the GNU LIBRARY General Public License.
-.PP
-THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL PAUL VOJTA OR ANY OTHERS BE LIABLE FOR ANY CLAIM,
-DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
-OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
-THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-.SH SEE ALSO
-.BR X (1),
-.BR dvips (1),
-.BR Kpathsea documentation
-.SH 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. +Additional enhancements by many
-others. The current maintainer of the original
-.B xdvi
-is Paul Vojta, U.C. Berkeley; the maintainer of the
-.B xdvik
-variant is Nicolai Langfeldt, Dept. of Math, UiO, Norway, with the help
-of many others.