diff options
Diffstat (limited to 'Build/source/texk/owindvi/oxdvi.1')
-rw-r--r-- | Build/source/texk/owindvi/oxdvi.1 | 950 |
1 files changed, 0 insertions, 950 deletions
diff --git a/Build/source/texk/owindvi/oxdvi.1 b/Build/source/texk/owindvi/oxdvi.1 deleted file mode 100644 index fbec2e5b6b4..00000000000 --- a/Build/source/texk/owindvi/oxdvi.1 +++ /dev/null @@ -1,950 +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] -[\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] -[\fB\-nomakepk\fP] -.BI \-mfmode " mode-def\fR[\fP\fB:\fPdpi\fR]\fP" -[\fB\-l\fP] -[\fB\-rv\fP] -[\fB\-mgs\fP[\fIn\fP] \fIsize\fP] [\fB\-warnspecials\fP] -[\fB\-hush\fP] -[\fB\-hushchars\fP] [\fB\-hushchecksums\fP] -[\fB\-hushspecials\fP] -[\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] -[\fB\-grid1\fP \fIcolor\fP] -[\fB\-grid2\fP \fIcolor\fP] -[\fB\-grid3\fP \fIcolor\fP] -[\fB\-bw\fP \fIwidth\fP] -[\fB\-display\fP \fIhost:display\fP] [\fB\-geometry\fP \fIgeometry\fP] -[\fB\-icongeometry\fP \fIgeometry\fP] [\fB\-iconic\fP] -[\fB\-keep\fP] [\fB\-copy\fP] [\fB\-thorough\fP] -[\fB\-underlink\fP] -[\fB\-browser\fP \fIWWWbrowser\fP] -[\fB\-base\fP \fIbase URL\fP] -[\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] -[\fB\-debug\fP \fIbitmask\fP] [\fB\-version\fP] -[\fIdvi_file\fP] -.I dvi_file -.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. -.PP -If -.I dvi_file -is not specified, a file-selection widget is popped up for you to choose the -.I dvi -file. -.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. -.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 . -.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 (?). -.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 . -.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. -.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. -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 ) -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. -.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. -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. -.TP -.BI \-fg " color" -.RB ( .foreground ) -Determines the color of the text (foreground). -.TP -.BI \-foreground " color" -Same as -.BR -fg . -.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) -.TP -.BI \-geometry " geometry" -.RB ( *geometry ) -Specifies the initial geometry of the window. -.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 -.B \-hushspecials -.RB ( .hushSpecials ) -Causes -.B xdvi -to suppress warnings about -.B \especial -strings that it cannot process. -.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. -.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 in " (inches)". -See also -.BR \-sidemargin ", " \-topmargin , -and the keystroke -.RB ` M .' -.TP -.BI \-mfmode " mode-def" -.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. -The metafont mode is also passed to -.B metafont -during automatic creation of fonts. -By default, it is -.BR "unspecified" . -.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. -.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 .) -.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 in " (inches)". -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 600. 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 in " (inches)". -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 8.5 x 11 inches. -.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 8. 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. -In the present case, this option is accepted but has no effect, since -.B xdvi -has been compiled without support for PostScript specials. -.TP -.BI \-sidemargin " dimen" -.RB ( .sideMargin ) -Specifies the side margin (see -.BR \-margins ). -.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. -.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 -.BI \-underlink -.RB ( .underLink ) -Underline links. Default is true. -.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. -.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. -.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. -.TP -.B F -Read a new -.I dvi -file. A file-selection widget is popped up for you to choose the dvi -file from. -.SH MOUSE ACTIONS -If the shrink factor is set to any number other than one, then clicking -mouse button 3 -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. -.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. -.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. -.SH ENVIRONMENT -Please see the -.B kpathsea -documentation. - -.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 -.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. -.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. -.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. -.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. -.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. |