diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/xdvi.1')
-rw-r--r-- | Master/texmf/doc/man/man1/xdvi.1 | 4075 |
1 files changed, 0 insertions, 4075 deletions
diff --git a/Master/texmf/doc/man/man1/xdvi.1 b/Master/texmf/doc/man/man1/xdvi.1 deleted file mode 100644 index 32933b9d63f..00000000000 --- a/Master/texmf/doc/man/man1/xdvi.1 +++ /dev/null @@ -1,4075 +0,0 @@ -.\" Copyright (c) 1990-2004 Paul Vojta and others -.\" -.\" This is Paul's license, included here only for reference, it does not apply -.\" to all parts of the k version. -.\" ---- -.\" 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 OR ANY OTHER AUTHOR OF THIS SOFTWARE 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. -.\" ---- -.\" This is the xdvik license: -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" following is UGLY ... use La\*(Te\& instead: -.\" .if t .ds La L\\h'-0.1667m'\\v'-0.20v'A\\v'0.20v'\\h'-0.1667m'T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X -.\" .if n .ds La LaTeX -.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 "2012-04-01" "Xdvik 22.85" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH NAME -xdvi \- DVI Previewer for the X Window System -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH SYNOPSIS -.B xdvi -.nh -[\fB+\fP[\fIpage\fP]] -[\fB\--help\fP] -[\fB\-allowshell\fP] -[\fB\-altfont\fP \fIfont\fP] -[\fB\-bg\fP \fIcolor\fP] -[\fB\-browser\fP \fIWWWbrowser\fP] -[\fB\-copy\fP] -[\fB\-cr\fP \fIcolor\fP] -[\fB\-debug\fP \fIbitmask\fP|\fIstring[,string ...]\fP] -[\fB\-display\fP \fIhost:display\fP] -[\fB\-dvipspath\fP \fIpath\fP] -[\fB\-editor\fP \fIcommand\fP] -[\fB\-expert\fP] -[\fB\-expertmode\fP \fIflag\fP] -[\fB\-fg\fP \fIcolor\fP] -[\fB\-findstring\fP \fIstring\fP] -[\fB\-text-encoding\fP \fIencoding\fP] -[\fB\-font\fP \fIfont\fP] -[\fB\-fullscreen \fP] -[\fB\-gamma\fP \fIg\fP] -[\fB\-geometry\fP \fIgeometry\fP] -[\fB\-gsalpha\fP] -[\fB\-gspalette\fP \fIpalette\fP] -[\fB\-h\fP] -[\fB\-help\fP] -[\fB\-hl\fP \fIcolor\fP] -[\fB\-anchorposition\fP \fIanchor\fP] -[\fB\-hush\fP] -[\fB\-hushchars\fP] -[\fB\-hushchecksums\fP] -[\fB\-warnpecials\fP] -[\fB\-hushstdout\fP] -[\fB\-hushbell\fP] -[\fB\-icongeometry\fP \fIgeometry\fP] -[\fB\-iconic\fP] -[\fB\-install\fP] -[\fB\-interpreter\fP \fIpath\fP] -[\fB\-keep\fP] -[\fB\-l\fP] -[\fB\-license\fP] -[\fB\-linkcolor\fP \fIcolor\fP] -[\fB\-linkstyle\fP \fI0|1|2|3\fP] -[\fB\-margins\fP \fIdimen\fP] -[\fB\-mfmode\fP \fImode-def\fP[\fB:\fP\fIdpi\fP]] -[\fB\-mgs\fP[\fIn\fP] \fIsize\fP] -[\fB\-mousemode\fP \fI0|1|2\fP] -[\fB\-nocolor\fP] -[\fB\-nofork\fP] -[\fB\-noghostscript\fP] -[\fB\-nogrey\fP] -[\fB\-nogssafer\fP] -[\fB\-noinstall\fP] -[\fB\-nomakepk\fP] -[\fB\-nomatchinverted\fP] -[\fB\-noomega\fP] -[\fB\-noscan\fP] -[\fB\-not1lib\fP] -[\fB\-notempfile\fP] -[\fB\-offsets\fP \fIdimen\fP] -[\fB\-p\fP \fIpixels\fP] -[\fB\-paper\fP \fIpapertype\fP] -[\fB\-pause\fP] -[\fB\-pausespecial\fP \fIspecial-string\fP] -[\fB\-postscript\fP \fIflag\fP] -[\fB\-rulecolor\fP \fIcolor\fP] -[\fB\-rv\fP] -[\fB\-S\fP \fIdensity\fP] -[\fB\-s\fP \fIshrink\fP] -[\fB\-safer\fP] -[\fB\-sidemargin\fP \fIdimen\fP] -[\fB\-sourceposition\fP \fIline\fP[\fB:\fP\fIcol\fP][\ ]\fIfilename\fP] -[\fB\-statusline\fP] -[\fB\-thorough\fP] -[\fB\-topmargin\fP \fIdimen\fP] -[\fB\-unique\fP] -[\fB\-version\fP] -[\fB\-visitedlinkcolor\fP \fIcolor\fP] -[\fB\-warnspecials\fP] -[\fB\-watchfile\fP \fIsecs\fP] -[\fB\-wheelunit\fP \fIpixels\fP] -[\fB\-xoffset\fP \fIdimen\fP] -[\fB\-yoffset\fP \fIdimen\fP] -[\fIdvi_file\fP] -.hy -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH DESCRIPTION -.B Xdvi -is a program for previewing -.I dvi -files, as produced e.g. by the -.BR tex (1) -program, under the X window system. -.PP -.B Xdvi -can show the file shrunken by various -integer factors, and it has a ``magnifying glass'' for viewing -parts of the page enlarged (see the section MAGNIFIER below). This version -of -.B xdvi -is also referred to as -.B xdvik -since it uses the kpathsea library to locate and generate font files. -In addition to that, it supports the following features: -.RS 2 -.TP 2 -- -hyperlinks in DVI files (section HYPERLINKS), -.TP -- -direct rendering of Postscript<tm> Type1 fonts (section T1LIB), -.TP -- -source specials in the DVI file (section SOURCE SPECIALS), -.TP -- -string search in DVI files (section STRING SEARCH), -.TP -- -saving or printing (parts of) the DVI file (sections PRINT DIALOG and SAVE DIALOG). -.RE -.PP -.B Xdvi -can be compiled with the Motif toolkit or the Xaw (Athena) toolkit -(and variants of it), and the Motif version has a slightly different GUI; -these differences are noted below. -.PP -Before displaying a page of a DVI file, -.B xdvi -will check to see if the file has changed since the last time it was -displayed. If this is the case, it will reload the file. This -feature allows you to preview many versions of the same file while -running -.B xdvi -only once. Since it cannot read partial DVI files, -.B xdvik -versions starting from 22.74.3 will create a temporary copy of the -DVI file being viewed, to ensure that the file can be viewed without -interruptions. (The -.B \-notempfile -can be used to turn off this feature). -.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. -.PP -If no file name has been specified on the command line, -xdvi will try to open the most recently opened file; if the file -history (accessible via the -.B File > Open Recent -menu) is empty, or if none of the files in the history are valid DVI files, -it will pop up a file selector for choosing a file name. -(In previous versions, which didn't have a file history, the file selector -was always used; you can set the X resource -.B noFileArgUseHistory -to -.I false -to get back the old behaviour.) -.PP -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 -.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. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 \-bg " color" -.RB ( .background ) -Determines the color of the background. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-browser " browser" -.RB ( .wwwBrowser ) -Defines the web browser used for handling external URLs. The value of this -option or resource has the same syntax as the -.B BROWSER -environment variable; see the explanation of that variable in the -section `ENVIRONMENT' below for a detailed description. -If neither the option nor the X resource -.I wwwBrowser -is specified, the environment variables -.B BROWSER -and -.B WWWBROWSER -(in that order) are used to determine the browser command. If these are -not set either, the following default value is used: -\fBxdg-open %s:htmlview %s:firefox -remote -remote "openURL(%s,new-window)":mozilla -remote "openURL(%s,new-window)":netscape -raise -remote "openURL(%s,new-window)":xterm -e w3m %s:xterm -e lynx %s:xterm -e wget %s\fP -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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. -If greyscale anti-aliasing is in use, the -.B \-copy -operation will disable the use of colorplanes and make overstrikes come -out incorrectly. -See also -.BR \-thorough . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-cr " color" -.RB ( .cursorColor ) -Determines the color of the mouse cursor. The default is the same as -the foreground color. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-debug " bitmask|string[,string ...]" -.RB ( .debugLevel ) -If nonzero, prints additional information on standard output. The -argument can be either a bitmask specified as a decimal number, or -comma-separated list of strings. -.br -For the bitmask representation, multiple values can -be specified by adding the numbers that represent the individual bits; -e.g. to debug all all file searching and opening commands, use 4032 -(= 2048 + 1024 + 512 + 256 + 128 + 64). Use -1 to turn on debugging -of everything (this will produce huge output). -.br -For the string representation, use the strings listed in the following -table, with a comma to separate the values; e.g. to debug -all file searching and opening commands, use -.BR search,expand,paths,hash,stat,open . -(The option `kpathsea' is provided as a shorthand for these.) -Note that such a list may need to be quoted to prevent the shell -from interpreting commas or spaces in the list. -.br -The individual numbers and strings have the following meanings: -.nf -.sp 1n -.ta 1L +8L +12L - 1 bitmap Bitmap creation - 2 dvi DVI translation - 4 pk PK fonts - 8 batch Batch mode: Exit after - reading the DVI file - 16 event Event handling - 32 ps PostScript interpreter calls - 64 stat Kpathsea stat(2) calls - 128 hash Kpathsea hash table lookups - 256 open Kpathsea file opening - 512 paths Kpathsea path definitions - 1024 expand Kpathsea path expansion - 2048 search Kpathsea searching - 4032 kpathsea All Kpathsea options - 4096 htex Hypertex specials - 8192 src Source specials - 16384 client Client/server mode (see -unique - and -sourceposition options) - 32768 t1 Type1 font library messages - 65536 t1_verbose Verbose Type1 library messages - 131072 gui GUI elements -.sp 1n -.fi -Some of the Kpathsea debugging options are actually provided by Kpathsea; -see the Debugging section in the Kpathsea manual for more information on -these. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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. -If greyscaling is in use, this argument does not apply; use -.B \-gamma -instead. -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 \-dvipspath " path" -.RB ( .dvipsPath ) -Use -.I path -as the -.B dvips -program to use when printing. The default for this is -.BR dvips . -The program or script should read the DVI file from standard input, -and write the Postscript file to standard output. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-editor " editor" -.RB ( .editor ) -Specifies the editor that will be invoked when the -.I source-special() -action is triggered to start a reverse search (by default via Ctrl-Mouse 1). -The argument to this option is a format string in which occurrences of -.RB `` %f '' -are replaced by the file name, occurrences of -.RB `` %l '' -are replaced by the line number within the file, and optional -occurrences of -.RB `` %c '' -are replaced by the column number within the line. -.sp -If neither the option nor the X resource -.I .editor -is specified, the following environment variables are checked -to determine the editor command: -.BR XEDITOR , -.BR VISUAL , -and -.B EDITOR -(in this sequence). If the string is found as the value -of the -.SB VISUAL -or -.SB EDITOR -environment variables, then -.RI `` "xterm -e "'' -is prepended to the string; if the editor is specified by other means, then -it must be in the form of a shell command to pop up an X window with an -editor in it. If none of these variables is set, a warning message is displayed -and the command -.RI `` "xterm -e vi +%l %f"'' -is used. -.sp -If no -.RB `` %f '' -or -.RB `` %l '' -occurs in the string, the missing format strings are appended automatically. -(This is for compatibility with other programs when using one of the environment -variables). -.sp -A new instance of the editor is started each time this command is used; -therefore it is preferable to use an editor that can be invoked in -`client' mode to load new files into the same instance. Example -settings are: -.RS 7 -.TP 7 -.SB emacsclient --no-wait -(older Emacsen) -.TP -.SB gnuclient -q -(XEmacs and newer Emacsen) -.TP -.SB gvim --servername xdvi --remote -(VIM v6.0+; the `--servername xdvi' option will cause gvim to run a -dedicated instance for the files opened by xdvi.) -.TP -.SB nc -(nedit) -.PP -.sp -Note that those strings need to be enclosed -into quotes when using them on the command-line -to protect them from the shell; when using them -as argument for the -.I .editor -resource in an X resource file, no quotes should be used. -.sp -.B NOTE ON SECURITY: -The argument of this option isn't executed as a shell command, -but via -.I exec() -to prevent evil tricks with the contents of source specials. -.RE -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-expert -This option is only supported for backwards compatibility; -it is equivalent to -.BR "\-expertmode 0" , -which should be preferred. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-expertmode " flag" -.RB ( .expertMode ) -With an argument of -.IR 0 , -this option switches off the display of the buttons, scrollbars, -the toolbar (Motif only), -the statusline and the page list. These GUI elements -can also be (de)activated separately, by combining the -appropriate values in the -.I flag -argument. This acts similar to the -.B \-debug -option: The integer -.I flag -is treated as a bitmap where each bit represents one -element. If the bit has the value -.IR 1 , -the element is switched on, if it has the value -.IR 0 , -the element is switched off. The meaning of the bits -is as follows: -.nf -.sp 1n -.ta 1L +8L +12L - 1 statusline - 2 scrollbars - 4 Motif: pagelist, Xaw: buttons and pagelist - 8 toolbar (Motif only) - 16 menubar (Motif only) -.sp 1n -.fi -For example, to turn on only the statusline and the scrollbars, -use 3 (= 1 + 2). -See also the -.RB ` x ' -keystroke, where the bits are addressed by their positions, from 1 to -3 (Xaw) or 5 (Motif), respectively. -.PP -If the statusline is not active, all messages -that would normally be printed to the statusline will be printed to -.IR stdout , -unless the -.B \-hushstdout -option is used. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-fg " color" -.RB ( .foreground ) -Determines the color of the text (foreground). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-text-encoding " encoding" -.RB ( .textEncoding ) -Use -.I encoding -as text encoding of the string in the "Find" window. Usually, -this shouldn't be needed since the encoding is determined from the locale settings. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-findstring\fP \fIstring\fP -This option triggers a search for -.I string -in the DVI file mentioned on the command-line, similar to forward search -(see the description of the -.B sourceposition -option): -If there is already another -instance of -.B xdvi -running on the displaying that DVI file, it will cause that instance -to perform the search instead. The search starts at the top of the current -page of the DVI file. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-font " font" -.RB ( *font ) -Sets the font used in menus, buttons etc., as described in the -.I X(7x) -man page. The font for child windows can be set separately, -e.g.: -.RS 7 -.nf -.ft 3 -.sp 1n -xdvi*statusline*font: \e - -*-helvetica-medium-r-*-*-12-*-*-*-*-*-*-* -.sp 1n -.ft -.fi -.RE -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-foreground " color" -Same as -.BR -fg . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-fullscreen -When this option is used, xdvi will (try to) run in fullscreen mode, with -no window decorations. -This option is not guaranteed to work with all windowmanagers/desktops; -if you're experiencing problems with it, please use the -.B \-geometry -option instead, and a suitable window manager setting to remove -the window decorations. -When using this option for presentations, you might want -to get rid of all the control widgets as well, using the -.B -expertmode -option. This option can also be toggled at runtime using the -.B fullscreen -action (by default bound to Ctrl-l). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 grayscale displays; for monochrome, see -.BR \-density . -See also the -.RB ` S ' -keystroke. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-geometry " geometry" -.RB ( .geometry ) -Specifies the initial geometry of the main window, -as described in the -.I X(7x) -man page. The geometry of child windows can be set -separately, e.g.: -.br -.I xdvi*helpwindow.geometry: 600x800 -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 specials, for a nicer appearance. -It is available on newer versions of -.BR Ghostscript . -This option can also be toggled with the -.RB ` V ' -keystroke. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 -.BR \-h , " \-help" , " \--help" -Prints a short help text with an overview of the command-line options -to standard output. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-hl " color" -.RB ( .highlight ) -Determines the color of the page border, of the ruler in `ruler mode', -and of the highlighting markers in forward search and string search. -The default is the foreground color. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-anchorposition " anchor" -Jump to -.I anchor -after opening the DVI file. This is only useful when invoking -.B xdvi -from other applications. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 \-hushstdout -.RB ( .hushStdout ) -Suppresses printing of status messages to -.IR stdout . -Note that errors or warnings will still be printed to -.I stderr -even if this option is used. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-hushbell -.RB ( .hushBell ) -Don't sound the X bell when an error occurs. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 \-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. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-interpreter " filename" -.RB ( .interpreter ) -Use -.I filename -as the Ghostscript interpreter. By default it uses -.BR gs . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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. This flag is honored by all page switching actions and by -.B up-or-previous() / -.BR down-or-next() , -although the latter only honor the horizontal postion, not the vertical one. -This allows for a "continuous" scrolling back an forth through a document with -a display window narrower than a page width. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-l -.RB ( .listFonts ) -List the names of all fonts used. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-license -Prints licensing information. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-linkcolor -.RB ( .linkColor ) -Color used for unvisited hyperlinks (`Blue2' by default). Hyperlinks -are unvisited before you click on them, or after the DVI file has been reloaded. -The value should be either a valid X color name (such as -.IR DarkGoldenrod4 ) -or a hexadecimal color string (such as -.IR #8b6508 ). -See also -.B \-visitedlinkcolor -and -.BR \-linkstyle . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-linkstyle -.RB ( .LinkStyle ) -Determines the style in which hyperlinks are displayed. Possible -values and their meanings are: -.nf -.sp 1n -.ta 1L +8L - 0 No highlighting of links - 1 Underline links with \fIlink color\fR - 2 No underlining, color text with \fIlink color\fR - 3 Underline and display text colored with - \fIlink color\fR -.sp 1n -.fi -The values for \fIlink color\fR are specified by the options/resources -.BI \-linkcolor -and -.BI \-visitedlinkcolor -(which see). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 cm " (centimeters)". -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[ n ] " 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 -.BI \-mousemode " " [ 0 | 1 | 2 ] -.RB ( .mouseMode ) -Specifies the default mode of xdvi at startup: Magnifier (0), Text Selection Mode (1) -or Ruler Mode (2). See the section -.BR MODES , -below, for more information. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-nocolor -.RB ( .color ) -Turns off the use of color specials. This option can be toggled with the -.RB ` C ' -keystroke. -(Note: -.B \-nocolor -corresponds to -.BR color:off ; -.B +nocolor -to -.BR color:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-nofork -.RB ( .fork ) -With the -.B \-sourceposition -and -.B \-unique -options, the default behavior is for -.B xdvi -to put itself into the background (like a daemon) if there -is no appropriate instance of -.B xdvi -already running. -This argument makes it run in the foreground instead. This is useful -for debugging, or if your client application cannot deal well with -a program self-backgrounding itself in this way -- e.g., the IPC functions -in -.B emacs -are known to have problems with this. -If no -.B \-sourceposition -or -.B \-unique -argument is given, then this option has no effect. -(Note: -.B \-nofork -corresponds to -.BR fork:off ; -.B +nofork -to -.BR fork:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-noghostscript -.RB ( .ghostscript ) -Inhibits the use of Ghostscript for displaying PostScript<tm> specials. -(Note: -.B \-noghostscript -corresponds to -.BR ghostscript:off ; -.B +noghostscript -to -.BR ghostscript:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-nogrey -.RB ( .grey ) -Turns off the use of greyscale anti-aliasing when printing shrunken bitmaps. -(Note: -.B \-nogrey -corresponds to -.BR grey:off ; -.B +nogrey -to -.BR grey:on .) -See also the -.RB ` G ' -keystroke. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 . -(Note: -.B \-nogssafer -corresponds to -.BR gsSafer:off ; -.B +nogssafer -to -.BR gsSafer:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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. -(Note: -\-noinstall -corresponds -.BR install:off ; -there is no -.B +noinstall -option.) -See also -.BR \-install , -and the GREYSCALING AND COLORMAPS section. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-nomakepk -.RB ( .makePk ) -Turns off automatic generation of font files that cannot be found by other -means. -(Note: -.B \-nomakepk -corresponds to -.BR makePk:off ; -.B +nomakepk -to -.BR makePK:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-nomatchinverted -.RB ( .matchInverted ) -Don't highlight string search matches in inverted color; instead, draw a rectangle in -.I highlight -color (see the -.B \-hl -option) around the match. This option is activated automatically if -the display isn't running in TrueColor. -(Note: -.B \-nomatchinverted -corresponds to -.BR matchInverted:off ; -.B +nomatchinverted -to -.BR matchInverted:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-noomega -.RB ( .omega ) -This will disable the use of Omega extensions when interpreting DVI files. -By default, the additional opcodes -.I 129 -and -.I 134 -are recognized by xdvi as Omega extensions and interpreted as requests -to set 2-byte characters. The only drawback is that the virtual font -array will require 65536 positions instead of the default 256 positions, -i.e. the memory requirements of xdvi will be slightly larger. If you find -this unacceptable or encounter another problem with the Omega extensions, -you can switch this extension off by using -.B \-noomega -(but please do send a bug report if you find such problems - see the bug -address in the -.B AUTHORS -section below). -.br -(Note: -.B \-noomega -corresponds to -.BR "omega: off" ; -.B +noomega -to -.BR "omega: on" .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-noscan -.RB ( .prescan ) -By default, -.B xdvi -does a preliminary scan of the -.I dvi -file to process any -.B papersize -specials; this is especially important at startup since the paper size may be -needed to determine the window size. -If PostScript<tm> is in use, then prescanning is also necessary in order to -properly process header files. -In addition, prescanning is needed to correctly determine the background color -of a page. -This option turns off such prescanning. -(Prescanning will be automatically be turned back on if -.B xdvi -detects any of the specials mentioned above.) -(Note: -.B \-noscan -corresponds to -.BR prescan:off ; -.B +noscan -to -.BR prescan:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-not1lib -.RB ( .t1lib ) -This will disable the use of T1Lib to display PostScript<tm> fonts. -Use this option as a workaround when you encounter problems with the -display of T1Lib (but please don't forget to send a bug report in -this case, to the URL mentioned in the section AUTHORS below). -.br -(Note: -.B \-not1lib -corresponds to -.BR t1lib:off ; -.B +not1lib -to -.BR t1lib:on .) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-notempfile -.RB ( .tempFile ) -As mentioned in the section -.B DESCRIPTION -above, xdvi will create a temporary copy of the DVI file so that it -can be accessed without interruptions even while the file is being -rewritten by -.BR TeX . -Since this introduces the overhead of copying the file every time -it has changed, the -.B \-notempfile -allows you to turn off this behaviour. In this case, exposing parts of the -window while the DVI file is being written by \*(Te\& will erase the current -window contents until the DVI file can be completely reread. -.br -(Note: -.B \-notempfile -corresponds to -.BR tempFile:off ; -.B +notempfile -to -.BR tempFile: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 cm " (centimeters)". -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 is to set both the resolution -and the Metafont mode via the -.B \-mfmode -option (which see). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-paper " papertype" -.RB ( .paper ) -Specifies the size of the printed page. Note that in most cases it's -best to specify the paper size in the TeX input file via the line -.sp -.B \eusepackage[dvips]{geometry} -.sp -which will be recognized by both dvips and xdvi; in that case the -use of a `-paper' option should be unnecessary. -.br -The paper size may be specified in 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 is -.BR cm " (centimeters)"\fR. -.br -There are also synonyms which may be used: -.B us -(8.5x11in), -.B legal -(8.5x14in), -.B foolscap -(13.5x17in), -as well as the ISO sizes -.BR a1 - a7 , -.BR b1 - b7 , -.BR c1 - c7 . -Each of these also has a landscape or `rotated' variant: -.B usr -(11x8.5in), -.BR a1r - a7r , -etc. For compatibility with -.BR dvips , -the formats -.B letter -(8.5x11in), -.B ledger -(17x11in) -and -.B tabloid -(11x17in) -are also supported (these don't have rotated variants). -.br -Any of the above sizes may be preceded by a plus sign -.RB (` + '); -this causes the paper size given here to override any paper size given in the -.I dvi -file. The default paper size is 21 x 29.7 cm (A4 size). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-pause -.RB ( .pause ) -This option provides a simple implementation of incremental -(stepwise) display, which can be used for presentations. -When this option is used, -.B xdvi -will pause the display of the current page whenever it encounters a -special -.I special-string -.RI ( xdvi:pause -by default; the string can be customized via -.IR \-pausespecial , -see below), and the cursor will change its shape. The action -.B unpause-or-next() -(by default bound to the -.B Space -key) will display the next portion of the page up to the following -.IR special-string , -or until the end of the page is reached. -When the option is not used, specials containing -.I special-string -will be ignored. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-pausespecial " special-string" -.RB ( .pauseSpecial ) -Sets the special string that causes xdvi to pause when the -.I -pause -option is active. The default value of -.I special-string -is -.IR xdvi:pause . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-postscript " flag" -.RB ( .postscript ) -If -.I flag = 0, -rendering of PostScript<tm> specials is disabled; instead, bounding -boxes will be displayed (if available). A value of -.I 1 -(the default) switches PostScript<tm> specials on. With a value of -.IR 2 , -the PostScript<tm> specials are displayed along with their -bounding boxes; this allows you to visually check the correctness -of the bounding boxes. The values can also be toggled at runtime -with the -.RB ` v ' -keystroke and the corresponding numerical prefix arguments 0, 1 and 2. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-ps2pdfpath " path" -.RB ( .ps2pdfPath ) -Use -.I path -as a conversion program from Postscript to PDF. The program or script -should accept two command-line arguments: The Postscript file as first -argument, and the PDF output file as second argument. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-rulecolor " color" -.RB ( .ruleColor ) -Determines the color of the rules used for the the magnifier -(default: foreground color). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-q -.RB ( .noInitFile ) -Ignore the -.I $HOME/.xdvirc -startup file (i.e. don't read it at startup, and don't write it -at exit). This forces the defaults defined in -.I $HOME/.Xdefaults -to be used. See -.B FILES -for more information on -.IR $HOME/.xdvirc . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 " density" -.RB ( .densityPercent ) -Same as -.B \-density -(which see). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 -.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. -This option selects -.B +nogssafer -and -.BR +allowshell . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-sidemargin " dimen" -.RB ( .sideMargin ) -Specifies the side margin (see -.BR \-margins ). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-sourceposition " line" [: col "][ ]" filename -This option makes -.B xdvi -search in the -.I dvi -file for the place corresponding to the indicated line (and, optionally, -column) in the .tex source file, and highlight the place found by drawing a -rectangle in the -.I highlight -color (see the -.B \-hl -option) around the corresponding text. In addition, when run with this -argument (and the -.B \-nofork -option is not given, which see), -.B xdvi -will always return immediately: if it finds another instance of -.B xdvi -already showing -.I dvi_file, -then it will cause that instance to raise its window and move to the given -place in the -.I dvi -file; otherwise it will start up its own instance in the background. -If several instances of xdvi are displaying the respective -.I dvi -file, the instance which was last raised to the foreground will be used. -.sp -The space before -.I filename -is only needed if the filename starts -with a digit. When the space is used, the argument -needs to be enclosed in quotes to prevent the shell from -misinterpreting the space as argument separator. -.sp -This option requires that -.I dvi_file -be prepared with source special information. See the section on SOURCE SPECIALS -for details on how to do this. -.sp -Here is a more detailed description of how the filename in the -.I \-sourceposition -argument is matched with the filename in the source specials: -.RS 7 -.TP 3 -1. -If neither of the filenames contains a path name component, the filenames -are compared ignoring the -.RI ` .tex ' -extensions in both filenames. -.TP -2. -Otherwise, if one of the filenames does contain a path component (e.g.: -.IR ./test.tex , -.IR ../test.tex , -.IR /my/homedir/tex/test.tex -or any combination of these), both filenames are expanded to a full path, -with any occurrences of -.I ../ -and -.I ./ -expanded, and multiple slashes removed. -.br -The pathname in the -.I \-sourceposition -is expanded relative to the current working directory of the -.I xdvi \-sourceposition -invocation, and the pathnames in the source specials are expanded -relative to the path of the current DVI file being viewed. -.br -The path names are then compared ignoring the -.RI ` .tex ' -extensions in both path names. -.RE -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-statusline\fP -.RB ( .statusline ) -This option is obsolete; use -\fB\-expertmode \fP \fIflag\fP -instead (which see). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-thorough -.RB ( .thorough ) -.B Xdvi -will usually try to ensure that overstrike characters (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 -.B \-unique -.RB ( .unique ) -This option will make another instance of xdvi running on the same display -act as a `server'. For example, the invocation -.sp -.B xdvi -unique +5 file.dvi -.sp -will cause this other instance to load -.I file.dvi -on page 5 in place of the file that it is currently displaying. If there is -already another instance of xdvi already displaying the file -.IR file.dvi , -then it will just jump to page 5. -If the other instance of xdvi is displaying a different file, it will load -.I file.dvi -instead. Otherwise, if no other instance of -xdvi is currently running on the display, this option instead -starts a new instance of xdvi in the background (unless the -.I \-nofork -option is specified, which see) displaying page 5 of -.IR file.dvi . -.br -The filename and the -.B +n -option for the page number are the only options available for -controlling a remote instance of xdvi like this; all other options are -currently ignored. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-useTeXpages -Use logical \*(Te\& pages (the values of the -.I \ecount0 -register) instead of physical pages for the pagelist labels and -when jumping to a page in a document with the `g' keystroke (or the -.B goto-page() -action). -This option can be toggled via the -.RB ` T ' -keystroke. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-version -Print information on the version of -.BR xdvi . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-visitedlinkcolor -.RB ( .visitedLinkColor ) -Color used for visited hyperlinks (`Purple4' by default). Hyperlinks become -visited once you click on them. As for -.BR linkColor , -the value should be either a valid X color name or a hexadecimal color string. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B \-warnspecials -.RB ( .warnSpecials ) -Causes -.B xdvi -to print warnings about -.B \especial -strings that it cannot process to stderr. These warnings are suppressed by default. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-watchfile " n" -.RB ( .watchFile ) -If this option is set to a value larger than 0, xdvi will check -the DVI file for changes every -.I n -seconds. If the DVI file has been completely written by TeX, it will -be reloaded automatically. Fractional values (e.g. `2.5') are -possible. The default for this option is 0, i.e. no watching. -.br -Since xdvi cannot handle partial DVI files, it tries not to reload -the file while it is being rewritten. However, use of the magnifier -or switching of pages requires reading (a part of) the DVI file, and -if the -.B tempfile -option is switched off, this will erase the current contents of the window -until the DVI file can be read entirely. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BI \-wheelunit " pixels" -.RB ( .wheelUnit ) -Sets the number of pixels that a motion of a wheel mouse will move the -image up, down, left, or right. (See the -.B wheel -and -.B hwheel -actions, below, for more information on this.) -If set to zero, the wheel mouse functionality is (essentially) disabled. -The default value is 80. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 . -.PP - - - -.SH KEYSTROKES -.B Xdvi -recognizes the following keystrokes when typed in its window. -Each may optionally be preceded by a (positive or negative) number, a -`prefix argument', whose interpretation will depend on the particular keystroke. -This prefix argument can be discarded by pressing the ``Escape'' key. -If present, the ``Help'', ``Prior'' and ``Next'' keys are synonyms for -.RB ` ? ', -.RB ` b ', -and -.RB ` f ' -keys, respectively. -.PP -The key bindings listed here are those that -.B xdvi -assigns by default. The names appearing in brackets at the beginning -of the descriptions are the names of the actions associated with the -keys; these can be used to customize the key bindings, as explained in -more detail in the section -.B CUSTOMIZATION -below. If only a lowercase binding is listed, both upper- and lowercase -keys will work for that binding. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\" -.\" SPECIAL KEYS -.\" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR ESC " key" -.RB [ discard-number() ] -The escape key discards the numerical prefix for all actions -(useful when you mistyped a number). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR Return " key" -.RB [ forward-page() ] -Moves to the next page (or to the -.IR n th -next page if a number is given). Synonyms are -.RB ` n ', -.RB ` f ' -and Line Feed. -.TP -.BR Backspace " key" -.RB [ back-pagee() ] -Moves to the previous page (or back -.I n -pages). Synonyms are -.RB ` p ', -.RB ` b ' -and -.BR Ctrl-h . -.TP -.BR Delete " key" -.RB [ up-or-previous() ] -Moves up two-thirds of a window-full, or to the top of the previous page -if already at the top of the page. With a float argument, moves up the -corresponding fraction of a window-full. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR Space " key" -.RB [ unpause-or-next() ] -Moves down two-thirds of a window-full, or to the next page if already at -the bottom of the page. -.br -When the option -.BI \-pause " special-string" -is used and the display is currently paused, this key will instead -display the next portion of the page until the next -.I special-string -or the end of the page is encountered. See the description of the -.B \-pause -option for details. The action -.RB [ down-or-next() ] -does a similar thing, but without pausing; it is not bound to a key -by default. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR Ctrl-Home " (Xaw), " Ctrl-osfBeginLine " (Motif)" -.RB [ goto-page(1) ] -Moves to the first page of the document. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR Ctrl-End " (Xaw), " Ctrl-osfEndLine " (Motif)" -.RB [ goto-page() ] -Moves to the last page of the document. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR Home " (Xaw), " osfBeginLine " (Motif)" -.RB [ home-or-top() ] -Move to the ``home'' position of the page, or to the top of the page if -the -.I keep -flag is set (in this case, the page doesn't scroll horizontally). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR End " (Xaw), " osfEndLine " (Motif)" -.RB [ end-or-bottom() ] -Move to the ``end'' position of the page (the lower right-hand corner), -or to the bottom of the page if the -.I keep -flag is set (in this case, the page doesn't scroll horizontally). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\" -.\" ARROW KEYS -.\" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Down arrow -.RB [ down(0.015) ] -Scrolls page down. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Up arrow -.RB [ up(0.015) ] -Scrolls page up. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Right arrow -.RB [ right(0.015) ] -Scrolls page right. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Left arrow -.RB [ left(0.015) ] -Scrolls page left. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\" -.\" ORDINARY KEYS. Note that the special symbols ([ ] + - etc.) are not in -.\" strict ASCII order (found that more intuitive). Sequence for each letter -.\" is: Alt-Ctrl, Ctrl, uppercase, lowercase. -.\" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Alt-Ctrl-+ -.RB [ change-density(25) ] -Increase the darkness of the fonts in the DVI window by adding to the gamma value -(see also the -.RB ` S ' -keystroke). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Alt-Ctrl-- -.RB [ change-density(-25) ] -Decrease the darkness of the fonts in the DVI window by subtracting from the gamma value -(see also the -.RB ` S ' -keystroke). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-+ -.RB [ set-shrink-factor(+) ] -Increase the shrink factor (see also the -.RB ` s ' -keystroke). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-- -.RB [ set-shrink-factor(-) ] -Decrease the shrink factor (see also the -.RB ` s ' -keystroke). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctr-[ -.RB [ pagehistory-delete-backward() ] -Delete the current item in the page history and move to the history -item before the deleted one. With a prefix argument -.BR n , -delete -.B n -previous history items. See -.B PAGE HISTORY -for details. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B [ -.RB [ pagehistory-back() ] -Move back in the page history (see -.B PAGE HISTORY -for details). With a prefix argument -.BR n , -move back -.B n -history items. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctr-] -.RB [ pagehistory-delete-forward() ] -Delete the current item in the page history and move to the history -item after the deleted one. With a prefix argument -.BR n , -delete -.B n -next history items. See -.B PAGE HISTORY -for details. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B ] -.RB [ pagehistory-forward() ] -Move forward in the page history (see -.B PAGE HISTORY -for details). With a prefix argument -.BR n , -move forward -.B n -history items. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.BR ^ -.RB [ home() ] -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 ? -.RB [ help() ] -Same as the -.B h -key (which see). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B B -.RB [ htex-back() ] -This key jumps back to the previous hyperlink anchor. See the -section -.B HYPERLINKS -for more information on navigating the links. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B b -.RB [ back-page() ] -Moves to the previous page (or back -.I n -pages). Synonyms are -.RB ` p ', -.B Ctrl-h -and -.BR Backspace . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B C -.RB [ set-color() ] -This key toggles the use of color specials. The key sequences -.RB ` 0C ' -and -.RB ` 1C ' -turn interpretation of color specials off and on, respectively. -See also the -.B \-nocolor -option. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B c -.RB [ center() ] -Moves the page so that the point currently beneath the mouse cursor is moved to -the middle of the window, and warps the mouse cursor to the same place. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B D -.RB [ toggle-grid-mode() ] -This key toggles the use of a grid on the displayed page. -If no number is given, the grid mode is switched on or off. -By prepending a number from 1 to 3, 3 different grid levels can be set. -The units of the grid are inches or centimeters, depending -on whether the paper format is letter (in) or a4 (cm). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B d -.RB [ down() ] -Moves page down two thirds of a window-full. With a float argument to ``down'', -moves down the corresponding fraction of a window-full. -.\" Therefore, a more -.\" ``smooth'' scrolling using the ``Up'' and ``Down'' keys can be -.\" achieved by the the following setting: -.\" .sp -.\" xdvi.mainTranslations: #override\e -.\" .br -.\" <Key>Up:up(0.01)\en\e -.\" .br -.\" <Key>Down:down(0.01)\en -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-f -.RB [ find() ] -Pop up a window to search for a string in the DVI file. See the section -.BR "STRING SEARCH" , -below, for more details. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B f -.RB [ forward-page() ] -Moves to the next page (or to the -.IR n th -next page if a number is given). Synonyms are -.RB ` n ', -Return, and Line Feed. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B G -.RB [ set-greyscaling() ] -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. -.sp -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. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-g -.RB [ find-next() ] -Find the next match string in the DVI file; this can be used instead -of pressing the `Find' button in the search window. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B g -.RB [ goto-page() ] -Moves to the page with the given number. If no page number is given, xdvi jumps to the last page. -.br -If the option/resource -.B useTeXpages -is active, the numbers correspond to the actual page numbers in the TeX file; -otherwise, absolute page numbers (starting from 1) are used. In the latter case, -the page numbers can be changed with the -.RB ` P ' -keystroke, below. -Note that with the -.B useTeXpages -option it is possible that the same page number occurs multiple -times; in such a case, xdvi will use the first page number that matches. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B h -Pops up a help window with a short explanation of the most important key -bindings and concepts. -.\" -.\" Ummh, surely nobody will use the following ... -.\" -.\" For I18n purposes, the help texts and menu entries are configurable -.\" via the following X resources: -.\" .BR helpGeneral , -.\" #ifhyper -.\" .BR helpHypertex , -.\" #endif -.\" .BR helpOthercommands , -.\" .BR helpMarking , -.\" .BR helpPagemotion , -.\" .BR helpMousebuttons , -.\" .BR helpRulermode , -.\" .BR helpSearch and -.\" .BR helpSourcespecials . -.\" The values of this resource should be a text string, the first line of -.\" which should contain two fields separated by `\en'. The first field is -.\" used as list entry for the list of help topics on the left of the help -.\" window, and the second field is used as the heading on the right-hand side. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B k -.RB [ set-keep-flag() ] -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 Ctrl-l -.RB [ fullscreen(toggle) ] -Toggles fullscreen mode (see the description of the -.B \-fullscreen -option for more information on this). This is even more flaky than -using the command-line option: There is no universal standard -how a window could change its own geometry or window decorations at -run-time, so this will not work with most window managers or -desktops. Generally, it's better to use the window manager controls to -change the size or decorations of the xdvi window. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B l -.RB [ left() ] -Moves page left two thirds of a window-full. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B M -.RB [ set-margins() ] -Sets the margins so that the point currently under the mouse cursor defines -the upper left-hand corner of the text in the page. Note that the command -does -.I not -move the image, but only determines the margins -for the page switching commands. For details on how the margins -are used, see the -.B \-margins -option. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B m -.RB [ toggle-mark() ] -Toggles the mark for the current page in the page list. When a page -is marked, it is displayed with a small star `*' next to the page number. -The marked pages can then be printed or saved to a file. -A page or several pages can also be marked by clicking or dragging -.B Mouse-2 -in the page list. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-n -.RB [ toggle-mark()forward-page() ] -Toggles the mark for the current page in the page list, and moves to -the next page. This lets you quickly mark a series of subsequent pages. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B n -.RB [ forward-page() ] -Moves to the next page (or to the -.IR n th -next page if a number is given). Synonyms are -.RB ` f ', -Return, and Line Feed. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-o -.RB [ select-dvi-file() ] -Read a new -.I dvi -file. A file-selection widget is popped up for you to choose the DVI -file from. If a prefix argument -.I n -is given, the -.I n th -file from the file history is opened instead. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B P -.RB [ declare-page-number() ] -``This is page number -.IR n .'' -This can be used to make the -.RB ` g ' -keystroke refer to a different page number than the physical page. -(If you want to use `logical' or \*(Te\& page numbers instead of physical pages, -consider using the option -.B \-useTeXpages -instead.) -The argument -.I n -should be given as prefix to this key. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-p -.RB [ print() ] -Opens a popup window for printing the DVI file, or parts of it. -See the section -.B PRINT DIALOG -for an explanation of the options available, and the resources to customize -the default behaviour. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B p -.RB [ back-page() ] -Moves to the previous page (or back -.I n -pages). Synonyms are -.RB ` b ', -.B Ctrl-h -and -.BR Backspace . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B q -.RB [ quit() ] -Quits the program. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-r -.RB [ forward-page(0) ] -Redisplays the current page. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B R -.RB [ reread-dvi-file() ] -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 r -.RB [ right() ] -Moves page right two thirds of a window-full. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-s -.RB [ save() ] -Opens a popup window for saving the DVI file, or parts of it. See the section -SAVE DIALOG below for more information on this. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B S -.RB [ set-density() ] -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. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B s -.RB [ set-shrink-factor() ] -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.) -.\" NOTE: following only works in action string, not interactively!!! -.\" Two special values are -.\" .B + -.\" and -.\" .B - -.\" which zoom in and out respectively, by decrementing/incrementing the -.\" shrinkfactor by one step. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B T -.RB [ use-tex-pages() ] -Use logical \*(Te\& pages (the values of the -.I \ecount0 -register) instead of physical pages for the pagelist labels and -when jumping to a page in a document via -.BR goto-page() . -See also the -.B \-useTeXpages -option. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B t -.RB [ switch-magnifier-units() ] -Switches the units used for the magnifier tick marks, and for reporting -the distance between the mouse pointer and the ruler centre in -ruler mode (see the section -.BR MODES ). -The default value is specified by the X resource -.B tickUnits -(`mm' by default). The units toggle through the following -values; except for `px', they all correspond to \*(Te\&'s units: -.I mm -(millimeters) -.I pt -(\*(Te\& points), -.I in -(inches), -.I sp -(scaled points, the unit used internally by \*(Te\&) -.I bp -(big points or `Postscript points'), -.I cc -(cicero points), -.I dd -(didot points), -.I pc -(pica), and -.I px -(screen pixels). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-u -.RB [ back-page()toggle-mark() ] -Moves to the previous page, and toggles the mark for that page. This -is the dual action to -.BR Ctrl-n . -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B u -.RB [ up() ] -Moves page up two thirds of a window-full. With a float argument to ``up'', -moves up the corresponding fraction of a window-full. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-v -.RB [ show-source-specials() ] -Show bounding boxes for every source special on the current page, and print -the strings contained in these specials to stderr. With prefix 1, -show every bounding box on the page. This is for debugging purposes mainly. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B V -.RB [ set-gs-alpha() ] -This key toggles the 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, respectively. See also the -.B \-gsalpha -option. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B v -.RB [ set-ps() ] -This key toggles the rendering of PostScript<tm> specials between 3 states: -.RS 7 -.TP 0 -.SB - specials (like EPS graphics) are displayed; -.TP -.SB - specials are displayed along with their bounding box (if available); -.TP -.SB - only the bounding box is displayed. -.PP -.sp -The states can also be selected directly by using -.RB ` 1v ', -.RB ` 2v ' -and -.RB ` 0v ' -respectively. -See also the -.B \-postscript -option. -.RE -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Ctrl-x -.RB [ source-what-special() ] -Display information about the source special next to the mouse cursor in the -statusline. This is the same special that would be found by -.IR source-special() , -but without invoking the editor. For debugging purposes. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B x -.RB [ set-expert-mode() ] -Toggles expert mode, in which -the statusline, the scrollbars, the menu buttons, the toolbar (Motif only) -and the page list are not shown. -Typing -.RB ` 1x ' -toggles the display of the statusline at the bottom of -the window. Typing -.RB ` 2x ' -toggles the scrollbars (if available). For Xaw, -.RB ` 3x ' -toggles the menu buttons and the page list, for Motif, -it toggles the page list. In Motif, the additional bindings -.RB ` 4x ' -toggle the toolbar, and -.RB ` 5x ' -the menu bar. -.br -Without a prefix argument, all of the mentioned GUI elements are either -switched on (if they had been invisible before) or off. -.br -Toggling the scrollbars may behave erratically with the -Xaw widgets; e.g. the scrollbars may reappear after -resizing the window, and at certain window sizes one of the -scrollbars may fail to disappear. -.br -See also the option -.B \-expertmode -(the numbers above correspond to the bits in the argument to -.BR \-expertmode ). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH MOUSE ACTIONS IN THE MAIN WINDOW -The mouse actions can be customized by setting the X resource -.BR mouseTranslations . -Since there are three different mouse modes (see the section -.B MODES -below), there is a special action -.B mouse-modes -which lists the actions for each of the three modes: -\fBmouse-modes("ACTIONS-FOR-MODE1", "ACTIONS-FOR-MODE2", "ACTIONS-FOR-MODE3")\fR. -If only one argument is specified, this action is used for all modes. -The default bindings are as follows: -.RS 5 -.nf -.ft 3 -.sp 1n -xdvi.mouseTranslations: \e -Shift<Btn1Down>:mouse-modes("drag(+)")\en\e -Shift<Btn2Down>:mouse-modes("drag(|)")\en\e -Shift<Btn3Down>:mouse-modes("drag(-)")\en\e -Ctrl<Btn1Down>:mouse-modes("source-special()")\en\e -<Btn1Down>: mouse-modes("do-href()magnifier(*2)", "text-selection()", "ruler()")\en\e -<Btn2Down>: mouse-modes("do-href-newwindow()magnifier(*2)", "text-selection()", "ruler()")\en\e -<Btn3Down>: mouse-modes("magnifier(*3)")\en\e -<Btn4Down>: mouse-modes("wheel(-0.2)")\en\e -<Btn5Down>: mouse-modes("wheel(0.2)")\en\e -<Btn6Down>: mouse-modes("hwheel(-0.2)")\en\e -<Btn7Down>: mouse-modes("hwheel(0.2)")\en\e -.sp 1n -.ft -.fi -.RE -All of these actions are described in more detail below. -Note the use of quote symbols around the action strings, which are necessary -to group them into one argument. -Buttons 4, 5, 6, and 7 refer to wheel movements (wheel up/down/left/right) -on wheel mice. Not all mice support horizontal scrolling. -.PP -The X Toolkit routines that implement translations do not support event -types of -.B Btn6Down -or -.BR Btn7Down . -Because of this, -.B xdvi -implements its own parser for translations given in -.BR mouseTranslations . -This parser is more limited than the parser built in to the X Toolkit. -The string given in -.B mouseTranslations -should not begin with -.RB `` #replace '', -.RB `` #augment '', -or -.RB `` #override ''. -Modifiers of the form -.BI @ keysym -are not supported, and the event type must be of the form -.B BtnDown -or -.BI Btn n Down\fR,\fP -where -.I n -is a positive integer without leading zeroes. Also, some limitations apply -to the action field. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B do-href() -.TP -.B do-href-newwindow() -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -Usually, if a binding specifies more then one action, all actions -are executed in a sequence. The hyperlink bindings -.B do-href() -and -.B do-href-newwindow() -are special in that they are used as an -.I alternative -to other actions that might follow them -.I if -the mouse is currently located on a hyperlink. -In this case, none of the other actions will be executed; -otherwise, only the other actions are executed. -.br -The action -.B do-href() -jumps to the link target in the current xdvi -window (eventually switching to another page), and -.B do-href-newwindow() -opens a new instance of xdvi for the link target. -In both cases, the location of the target is -indicated by a small arrow drawn in the same color -as a visited link -in the left corner of the window. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B magnifier(n x m) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B magnifier(*n) -This action will pop up a ``magnifying glass'' which shows the unshrunk -image of the region around the mouse pointer. The magnifier disappears when -the mouse button is released. Moving the mouse cursor while holding the button down will move the -magnifier. -.br -Different mouse buttons produce different sized -windows, as indicated by the -the argument of the -.I magnifier() -action. Its argument is either a string of the form -.IR width x height , -as in the -.BI \-mgs n -command-line option, or one of the strings -.B *1 -through -.BR *5 , -referring to the value specified by the corresponding -.BI \-mgs n -option. -.\" Note that in order to assign magnifier actions to -.\" the buttons 4 or 5, you need to use the resource -.\" .B wheelTranslations -.\" (more about this resource below), e.g.: -.\" .sp -.\" xdvi.wheelTranslations: <Btn4Down>: magnifier(*4)\en\e -.\" <Btn5Down>: magnifier(*5)\en -.\" .sp -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B drag(+) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B drag(|) -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B drag(-) -Drags the page with the mouse. This action should have one parameter, the character -.RB `` | '', -.RB `` - '', -or -.RB `` + '', -indicating vertical dragging only, horizontal dragging only, or dragging in all -directions. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B source-special() -This action starts a ``reverse search'', -opening the editor at the location in the \*(Te\& file corresponding -to the pointer location in the DVI file. -See the section on SOURCE SPECIALS, below, for more information on this. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B wheel() -This action can be used to scroll the image with a wheel mouse, where it -is usually bound to mouse button 4 (wheel up) or 5 (wheel down). -The action takes one parameter, giving the distance to scroll the -image. If the parameter contains a decimal point, the distance is -given in wheel units; otherwise, pixels. A negative value scrolls up, -a positive value scrolls down. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B hwheel() -This action can be used to scroll the image horizontally with a wheel mouse, -where it is usually bound to mouse button 6 (wheel left) or 7 (wheel right). -The action takes one parameter, giving the distance to scroll the -image. If the parameter contains a decimal point, the distance is -given in wheel units; otherwise, pixels. A negative value scrolls left, -a positive value scrolls right. Not all mice support horizontal scrolling; -this is mostly for touchpads, trackpads, etc. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B text-selection() -This action allows you to mark a rectangular region of text in the DVI file. -The text is put into the X selection buffer and can be pasted into other -applictions (e.g. text editors). This works similar to the Plain text option -in the -.B Save -dialog; see the discussion there for more information on encoding issues. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B ruler() -This action creates a cross-shaped ruler. Moving the mouse and holding -the button down drags the ruler and lets you measure distances on the page. -See the section -.B Ruler Mode -for more information on this. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH UNBOUND ACTIONS -The following actions are not bound to a key by default, but are available -for customization. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B quit-confirm() -Pops up a confirmation window to quit xdvi. To bind it to the -.RB ` q ' -key instead of the default `quit()' action, put the following into your -.I ~/.Xdefaults -file: -.sp -xdvi.mainTranslations: #override\e -.br -<Key>q: quit-confirm()\en -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B down-or-next() -Similar to -.IR unpause-or-next() : -Moves down two-thirds of a window-full, or to the next page if already -at the bottom of the page. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B shrink-to-dpi() -This action takes one (required) argument. It sets the shrink factor to -an integer so as to approximate the use of fonts with the corresponding -number of dots per inch. If -.B xdvi -is using fonts scaled for -.I p -dots per inch, and the argument to -.B shrink-to-dpi -is -.IR n , -then the corresponding shrink factor is the ratio -.IR p / n , -rounded to the nearest integer. -.PP -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH CUSTOMIZATION -Key and mouse button assignments can be changed by setting the -.B mainTranslations -resource to a string of translations as defined in the documentation for the -X toolkit. The actions should take the form of action names listed in the -KEYSTROKES and MOUSE ACTIONS sections. -.PP -An exception to this are the Motif keys -.IR osfPageUp " (" PgUp ), -.IR osfPageDown " (" PgDown ), -.IR osfBeginLine " (" Home ) -and -.IR osfEndLine " (" End ) -which are currently not customizable in the Motif version. -.PP -Key actions will usually be without arguments; if they are passed an argument, -it represents the optional number or `prefix argument' typed prior to the action. -.PP -Some key actions may take special arguments, as follows: The argument of -.B goto-page -may be the letter -.RB ` e ', -indicating the action of going to the end of the document. -The argument of -.B set-shrink-factor -may be the letter -.RB ` a ', -indicating that the shrink factor should be set to the smallest value such that -the page will fit in the window, or one of the signs -.RB ` + ' -or -.RB ` - ', -indicating that the shrink factor should be increased or decreased, respectively. -Finally, actions that would perform a toggle, such as -.BR set-keep-flag , -may receive an argument -.RB ` t ', -indicating that the action should toggle regardless of the current prefix argument. -.PP -Mouse actions should refer only to -.B ButtonPress -events (e.g., -.BR "<Btn1Down>:magnifier(*1)" ). -The corresponding motion and release events will be handled internally. -A key action may be bound to a mouse event, but not vice versa. -.PP -Usually the string of translations should begin with -.RB `` #override '', -indicating that the default key and mouse button assignments should not -be discarded. -.PP -When keys or mouse buttons involving modifiers (such as Ctrl or Shift) -are customized together with their non-modified equivalents, the modified -keys should come first, for example: -.RS 5 -.nf -.ft 3 -.sp 1n -xdvi.mainTranslations: #override \e -Shift<Key>s: select-dvi-file()\en\e -Ctrl<Key>s: save()\en\e -<Key>s: find()\en -.sp 1n -.ft -.fi -.RE -.PP -Because -.B xdvi -needs to capture pointer motion events, and because the X Toolkit -translations mechanism cannot accommodate both motion events and double-click -events at the same time, it is not possible to specify double-click -actions in -.B xdvi -customizations. For information on this and other aspects of translations, -see the X Toolkit Intrinsics documentation. -.PP -There is no command-line option to set the -.B mainTranslations -resource, since changing this resource on the command line would be cumbersome. -To set the resource for testing purposes, use the -.B -xrm -command-line option provided by the X toolkit. For example, -\fBxdvi \-xrm 'XDvi.mainTranslations: #override "z":quit()' ...\fR -or -.B "xdvi \-xrm 'XDvi.mainTranslations: #override <Key>z:quit()' ..." -will cause the key -.RB ` z ' -to quit -.BR xdvi . -.PP -Some resources are provided to allow customization of the geometry of -the Xaw command buttons. Again, they are not changeable via command-line -options, other than via the -.B \-xrm -option. All of these resources take integer values. -.TP -.B buttonSideSpacing -The number of pixels to be placed on either side of the buttons. -The default value is 6. -.TP -.B buttonTopSpacing -The number of pixels between the top button and the top of the window. -The default value is 50. -.TP -.B buttonBetweenSpacing -The number of pixels between the buttons. -The default value is 20. -.TP -.B buttonBetweenExtra -The number of pixels of additional space to be inserted if the -.B buttonTranslations -resource string contains an extra newline character. -The default value is 50. -.TP -.B buttonBorderWidth -The border width of the button windows. The default value is 1. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH PAGE LIST -The scrollable page list on the right of the main window allows you to -jump directly to a page in the DVI file. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Mouse-1 -Jumps to the page the mouse is located on. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B Mouse-2 -.RB [ toggle-mark() ] -Toggle the mark of the current page. The marks are used by the `Print' -and `Save to file' dialogs to select only marked pages from the DVI file. -.PP -When the mouse pointer is inside the page list, the mouse wheel switches -to the next or previous page. -.PP -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH SCROLLBARS -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. -.PP -The scrollbars can be removed via the -.I -expertmode -flag/keystroke (which see). -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH MAGNIFIER -By default, the mouse buttons 1 to 5 will pop up a ``magnifying glass'' -that shows an unshrunken image of the page (i.e. an image at the resolution -determined by the option/X resource -.B pixels -or -.BR mfmode ) -at varying sizes. When the magnifier is moved, small ruler-like -tick marks are displayed at the edges of the magnifier (unless -the X resource -.B delayRulers -is set to false, in which case the tick marks will always be displayed). -The unit of the marks is determined by the X resource -.B tickUnits -(mm by default). This unit can be changed at runtime via the action -.BR switch-magnifier-units() , -by default bound to the keystroke -.RB ` t ' -(see the description of that key, and of switch-magnifier-units() for -more details on the units available). -.br -The length of the tick marks can be changed via the X resource -.B tickLength -(4 by default). A zero or negative value suppresses the tick marks. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH PAGE HISTORY -.B Xdvi -keeps a history of viewed pages, and you can move through the history -and delete items using the keys -.B [ -.RI ( pagehistory-back() ), -.B ] -.RI ( pagehistory-forward() ), -.B Ctr-[ -.RI ( pagehistory-delete-backward() ) -and -.B Ctr-] -.RI ( pagehistory-delete-forward() ). -.PP -When one of the history commands is used, the page history is displayed -in the status line at the bottom of the window, with the current list -item marked by square brackets `[', `]' and a left and right context of -at most 10 items. File boundaries are marked by `#'. -.PP -The size of the history can be customized with the X resource -.B pageHistorySize -(the default size is 1000 items). If the size is set to 0, the -history commands are disabled. -.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH HYPERLINKS -The actions -.B do-href() -and -.B do-href-newwindow() -(by default bound to Mouse-1 and Mouse-2 if the pointer is currently located -on a hyperlink) can be used to open the link target in the same window -.RB ( do-href() ) -or in a new window -.RB ( do-href-newwindow() ). -.PP -If the link target is not a file on the local disk, -xdvi tries to launch a web browser (as specified by the -.B -browser -command line option, the -.B BROWSER -environment variable or the -.B wwwBrowser -X resource, in this order) to retrieve the document. See the description -of the -.B BROWSER -environment variable, below, for an example setting. -.PP -If the file is a local file, xdvi tries to determine if it is a DVI -file. If it is, xdvi will try to display the file; otherwise it will -try to determine the MIME type of the file, and from that an -application suitable for opening the file. -This is done by parsing the files specified by the environment variable -.B EXTENSIONMAPS -for a mapping of filename extensions to MIME types, -and the files determined by the environment variable -.B MAILCAPS -for a mapping of MIME types to application programs. -See the descriptions of these variables in the section -.BR ENVIRONMENT , -below, for a more detailed description and the default values of these -variables. If no suitable files are found, a set of built-in default -MIME types and applications is used. -.PP -.B Xdvi -currently uses no heuristics apart from the filename suffix -to determine the mime type of a file. If a filename has no suffix, -the value of the resource -.B noMimeSuffix -is used (by default -.IR application/x-unknown ). -If the suffix doesn't match any of the suffixes in -.BR mime.types , -the value of the resource -.B unknownMimeSuffix -is used (by default -.IR application/x-unknown ). -If the -.B mailcap -entries do not list a viewer for a given mime type, xdvi will show -a warning popup. If you want to avoid this warning, and for example -want to always use the netscape browser for unknown MIME types, -you could add the following line to your ~/.mailcap file: -.RS 4 -.nf -.ft 3 -.sp 1n -application/xdvi-unknown; \e - netscape -raise -remote 'openURL(%s,new-window)' -.sp 1n -.ft -.fi -.RE -.\" As an example, consider the following settings, which are the default -.\" settings for buttons 1 and 2: -.\" .RS 5 -.\" .nf -.\" .ft 3 -.\" .sp 1n -.\" xdvi.mainTranslations: #override \e -.\" <Btn1Down>: do-href()magnifier(*1)\en\e -.\" <Btn2Down>: do-href-newwindow()magnifier(*2)\en\e -.\" <Btn3Down>: magnifier(*3)\en -.\" .sp 1n -.\" .ft -.\" .fi -.\" .RE -.\" .PP -.\" If a link points to a file which is not a DVI file (e.g. HTML, or -.\" PostScript), the files -.\" .B mime.types -.\" and -.\" .B mailcap -.\" are parsed to determine a suitable viewer; 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, the browser is launched to load the file. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH STRING SEARCH -The keystroke -.I Ctrl-f -or the menu entry -.I File > Find ... -(or the `Binoculars' symbol in the toolbar, for Motif) -opens a dialog window to search for a text string or -a regular expression in the DVI file. -The keystroke -.I Ctrl-g -jumps to the next match (like pressing the `Find' button in the search window). -.PP -By default, the matches are highlighted in inverted color. -If the display isn't running in TrueColor, or if the X resource -.B matchHighlightInverted -is set to false or the command-line option -.B \-nomatchinverted -is used, xdvi will instead draw a rectangle in -.I highlight -color (see the -.B \-hl -option) around the match. -.PP -If a match crosses a page boundary, only the part on the -first page is highlighted. -.B Xdvi -will scan up to 2 adjacent pages to match strings crossing page -boundaries; but note that header or footer -lines, or intervening float pages will be treated as parts of the -scanned text. Such text will usually cause multi-page matching to fail. -.PP -This emphasizes the fact that searching in the -formatted text (the DVI output) works differently from -searching in the source text: Searching in the DVI file makes it easier to -skip formatting instructions, and makes it possible to search for e.g. -hyphenation and equation numbers; but sometimes the -formatting results can also get in the way, e.g. in the case of -footnotes. In these cases it's better to search in the \*(Te\& source -instead. The use of -.I source specials -will make switching between the -xdvi display and the editor with the \*(Te\& source easier; see the -section -.B SOURCE SPECIALS -below for more information on this. -.PP -The text extracted from the DVI file is in encoded in UTF-8 -(you can view that text by saving the file in UTF-8 format via the -.I File > Save as ... -menu item). -If xdvi has been compiled with locale, -.I nl_langinfo() -and -.I iconv -support, the search term is converted from the character set -specified by the current locale into UTF-8. (See the output of -.B locale -a -for a list of locale settings available on your system). -If -.I nl_langinfo() -is not available, but -.I iconv -is, you can specify the input encoding for -.I iconv -via the X resource -.I textEncoding -(see the output of -.B iconv -l -for a list of valid encodings). If -.I iconv -support is not available, only the encodings -.I ISO-8859-1 -and -.I UTF-8 -are supported (these names are case-insensitive). -.PP -Ideographic characters from CJKV fonts are treated specially: All white space -(spaces and newlines) before and after such characters is ignored in -the search string and in the DVI file. -.PP -To match a newline character, use \fI\en\fR in the search string; -to match the string \fI\en\fR, use \fI\e\en\fR. -.PP -If the checkbox -.I Regular Expression -is activated, the string is treated as a regular expression in -extended POSIX syntax, with the following properties: -.RS 2 -.TP 2 -- -\fIa?\fR matches \fIa\fR zero or one times. -.TP -- -\fIa*\fR matches \fIa\fR zero or more times. -.TP -- -\fIa+\fR matches \fIa\fR one or more times. -Note that \fI*\fR and \fI+\fR are greedy, i.e. they match the longest possible substring. -.TP -- -The pattern \fI.\fR matches any character except for newline. To also match a newline, use `\fI(.|\en)\fR'. -.TP -- -\fIa{n}\fR matches \fIa\fR exactly n times. -.TP -- -\fIa{n,m}\fR matches \fIa\fR at least n and no more than m times. -.TP -- -\fIa|b\fR matches \fIa\fR or \fIb\fR. Brackets can be used -for grouping, e.g.: \fI(a|b)|c\fR. -.TP -- -The string matched by the nth group can be referenced by \fI\en\fR, e.g. \fI\e1\fR refers to the -first match. -.TP -- -The characters \fI^\fR and \fI$\fR match the beginning and the end of a line, respectively. -.TP -- -\fI[abc]\fR matches any of the letters a, b, c, and \fI[a-z]\fR matches all characters from a to z. -.TP -- -Each item in a regular expression can also be one of the following POSIX -character classes: -.br -.nf -.I [[:alnum:]] [[:alpha:]] [[:blank:]] [[:cntrl:]] [[:digit:]] -.I [[:graph:]] [[:lower:]] [[:print:]] [[:space:]] [[:upper:]] -.fi - - -These can be negated by inserting a \fI^\fR symbol after the first bracket: -.I [^[:alpha:]] - -For more details on POSIX regular expressions, see e.g. the -.B IEEE Std 1003.1 -standard definition available online from: - -.nf -http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap09.html -.fi -.TP -- -As a non-standard extension, the following Perl-like abbreviations -can be used instead of the POSIX classes: -.nf -.sp 1n -.ta 1L +8L +30L -Symbol Meaning POSIX Class - - \fI\ew\fR an alphanumeric character \fI[[:alnum:]]\fR - \fI\eW\fR a non-alphanumeric character \fI[^[:alnum:]]\fR - \fI\ed\fR a digit character \fI[[:digit:]]\fR - \fI\eD\fR a non-digit character \fI[^[:digit:]]\fR - \fI\es\fR a whitespace character \fI[[:space:]]\fR - \fI\eS\fR a non-whitespace character \fI[^[:space:]]\fR -.sp 1n -.fi -.TP -- -The following characters are special symbols; they need to be escaped -with \fI\e\fR in order to match them literally: \fI ( ) [ ] . * ? + ^ $ \e\fR. -.TP -- -Matches of length zero are silently skipped. -.RE -.PP -The dialog also provides checkboxes to: -.RS 2 -.TP 2 -- -search backwards; -.TP -- -match in a case-sensitive manner (the default is to ignore case, i.e. a search -string -.I Test -will match both the strings -.I test -and -.I TEST -in the DVI file); -.TP -- -ignore line breaks and hyphens: This removes all hyphens at the ends -of lines and the following newline characters, and replaces all -remaining newline characters by white spaces. So hyphenated words will -appear as one word to the search, and a search for two words with a space -in between will also match the words if they are separated by a linebreak. -.br -Note that the hyphen removal may cause unwanted side effects for compound words -containing hyphens that are wrapped after the hyphen, and that replacing the -newlines affects the interpretation of regular expressions as follows: -The \fI.\fR pattern will also match newlines, and \fI^\fR and \fI$\fR won't match -begin and end of lines any more. (Since currently there is no option for turning -off the greediness of \fI*\fR and \fI+\fR, turning on this option will usually -result in matches that are longer than desired.) -.RE -.PP -The current checkbox settings are saved in the -.I ~/.xdvirc -file. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH PRINT DIALOG -The print dialog window allows you to print all pages, marked pages -(click or drag Mouse-2 in the page list to mark them), or a range -of pages. Note that the page numbers always refer to physical pages, -so if you're using the option `use TeX pages', you may want to disable -it to make it easier to determine the correct page numbers (or avoid this -problem altogether by marking the pages to be printed). -.PP -The value of the -.B Printer -text filed is passed to -.B dvips -via the -.B -o! -mechanism, as a single argument after the `!'. Any arguments -listed in the -.B Dvips options -field are segmented at whitespaces and passed as separate arguments to dvips. -If you e.g. want to print the file 2-up, you should enter -the following string into the -.B Printer -field: -.RS 5 -.nf -.sp 1n - \fIpsnup -2 -q | lpr -Plp\fP -.sp 1n -.fi -.RE -.PP -There are several resources for customizing the behaviour and the default entries -of the print dialog: -.TP -.B dvipsPrinterString -.TP -.B dvipsOptionsString -These can be used to provide default entries for the -.B Printer -and the -.B Dvips options -text fields, respectively. If no paper size is specified in the DVI file -(via e.g. \eusepackage[dvips]{geometry} - this is the preferred method), -the input field is initialized with the current value of the -command line option/X resource -.BR paper . -E.g., the option -.I -paper a4r -is translated into the dvips options -.IR "-t a4 -t landscape" . -Note that no check is performed whether dvips actually understands these -options (it will ignore them if it can't); currently not all options -used by xdvi are also covered by dvips. -.TP -.B dvipsHangTime -.TP -.B dvipsFailHangTime -These specify the time (in milliseconds) that the printing progress window will -stay open after the -.B dvips -process has terminated. The value of -.BR dvipsHangTime -is used if the process terminates successfully; -.B dvipsFailHangTime -is used if it terminates with an error. The default values are 1.5 and 5 seconds, respectively. -If both values are negative, the window will stay open until it is closed by the user. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH SAVE DIALOG -This dialog allows you to save all or selected/marked pages in the current -DVI file. You can save in one of the following formats: -.RS 2 -.TP 2 -- -Postscript (uses -.B dvips -to convert the DVI file to a Postscript file, just like when printing -to a Postscript file). -.TP -- -PDF (first uses -.B dvips -to convert the DVI file to a Postscript file, then uses -.B ps2pdf -to convert the Postscript file to PDF). -.TP -- -Plain text in ISO-8859-1 or UTF-8 encoding. The latter will preserve more -of the special LaTeX characters e.g. from mathematical mode. Note however -that e.g. only few of LaTeX's mathematical symbols can be rendered correctly -as text; so this funcionality works best for plain text documents. -If a character cannot be displayed in the selected -charset, it is replaced by `\e' followed by the hexadecimal character code. -If a character is not recognized at all, it is replaced by `?'. -.RE -.PP -The programs for Postscript and PDF conversion can be customized via -the command line options or X resources -.BR -dvipspath / .dvipsPath -and -.BR -ps2pdfpath / .ps2pdfPath , -respectively; see the explanation of these options above for more details. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH MODES -The keystroke -.B Ctrl-m -[\fBswitch-mode()\fR] -switches between three different mouse bindings, -which can also be activated via the -.B Modes -menu (in Motif, this is a submenu of the -.B Options -menu called -.BR "Mouse Mode" ). -The default mode at startup can be customized via the X resource -.B mouseMode -or the command-line option -.BR \-mousemode . -The default startup mode is Magnifier Mode. -.PP -.B Note: -The modes are implemented by changing the -.I magnifier() -action. Switching the mode will not work if -.B Mouse-1 -has been customized to an action sequence that does -not contain the magnifier() action. -.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B "Magnifier Mode" -In this mode, the mouse buttons 1 to 5 pop up a ``magnifying glass'' -that shows an unshrunken image of the page (i.e. an image at the resolution -determined by the option/X resource -.B pixels -or -.BR mfmode ) -at varying sizes. When the magnifier is moved, small ruler-like -tick marks are displayed at the edges of the magnifier (unless -the X resource -.B delayRulers -is set to false, in which case the tick marks are always displayed). -The unit of the marks is determined by the X resource -.B tickUnits -(mm by default). This unit can be changed at runtime via the action -.BR switch-magnifier-units() , -by default bound to the keystroke -.RB ` t ' -(see the description of that key, and of switch-magnifier-units() for -more details on the units available). -.br -The length of the tick marks can be changed via the X resource -.B tickLength -(4 by default). A zero or negative value suppresses the tick marks. -.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B "Text Selection Mode" -This mode allows you to select a rectangular region of text in the DVI -file by holding down -.B Mouse-1 -and moving the mouse. The text is put into -the X primary selection so that it can be pasted into other X applications -with -.B Mouse-2 -as usual. -.br -If xdvi has been compiled with locale, -.I nl_langinfo() -and -.I iconv -support, the selected text is converted into the character set of the -current locale (see the output of -.B locale -a -for a list of locale settings available on your system). -If -.I nl_langinfo() -is not available, but -.I iconv -is, you can specify the input encoding for -.I iconv -via the X resource -.I textEncoding -(see the output of -.B iconv -l -for a list of valid encodings). If -.I iconv -support is not available, only the encodings -.I ISO-8859-1 -and -.I UTF-8 -are supported (these names are case-insensitive). -.br -Note that UTF-8 is -the only encoding that can render all characters (e.g. mathematical -symbols) of a DVI file. If ISO-8859-1 is active, characters that cannot be displayed -are replaced by `\e' followed by the hexadecimal character code. -For other encodings, such characters may trigger iconv error messages. -If a character is not recognized at all, it is replaced by `?'. -.br -To extract larger portions of text, you can alternatively -save selected pages or the entire file in text format via the -.B File > Save as ... -menu. -.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.B "Ruler Mode" -This mode provides a simple way of measuring distances on the page. -.br -When this mode is activated, the mouse cursor changes into a -thin cross, and a larger, cross-shaped ruler is drawn in the -highlight color at the mouse location. The ruler doesn't have -units attached to it; instead, the current distance between the -ruler and the mouse cursor is continuously printed to the -statusline. -.br -When activating Ruler Mode, the ruler is at first attached to -the mouse and can be moved around. It can then be positioned at -a fixed place by clicking -.BR Mouse-1 . -After that, the mouse cursor -can be moved to measure the horizontal -.RI ( dx ), -vertical -.RI ( dy ) -and direct (shortest) -.RI ( dr ) -distance between the ruler center point and the mouse. -.br -Clicking -.B Mouse-1 -again will move the ruler to the current mouse -position, and holding down -.B Mouse-1 -will drag the ruler around. -.br -In Ruler Mode, the following special keybindings extend or -replace the default bindings: -.RS 7 -.TP 7 -.B o -.RB [ ruler-snap-origin() ] -Snap the ruler back to the origin coordinate (0,0). -.TP -.B t -\fR[overrides \fBswitch-magnifier-units()\fP] -Toggle between various ruler units, which can be specified by the X -resource -.B tickUnits -(`mm' by default). -.TP -.B P -\fR[overrides \fBdeclare-page-number()\fP] -Print the distances shown in the statusline to standard output. -.RE -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH TOOLBAR (Motif only) -The Motif toolbar can also be customized. The XPM file used for the -toolbar icons can be specified via the resource -.BR toolbarPixmapFile , -which should contain a filename that can be found in one of -.B XFILESEARCHPATH -or -.B XDVIINPUTS -(see the section -.B FILE SEARCHING -below for more information on these variables). -.B Xdvi -will try to split this pixmap horizontally into -.I n -pieces, where each piece is as wide as the pixmap is high -and is treated as an image for toolbar button -.IR n . -This means that each icon should be a square, and that the entire -pixmap should have width -\fIn\fR x \fIh\fR if \fIh\fR is the height of the pixmap. -.PP -The resource -.B toolbarTranslations -can be used to map icons/buttons to specific actions. -The resource should contain a string separated by newline characters, -similar to the resources -.B mainTranslations -and -.BR menuTranslations . -Every line must contain either a spacer definition, or an icon definition: -.PP -A spacer definition is a string \fBSPACER(\fIn\fB)\fR, -where -.I n -is the number of pixels inserted as separator to the following button. -.PP -An icon definition is a colon-separated list containing the following elements: -.RS 2 -.TP 2 -.SB - the index of an icon in the pixmap file (starting from zero); -.TP -.SB - a long tooltip string, displayed in the status area; -.TP -.SB - a short tooltip string, displayed as popup; -.TP -.SB - a sequence of actions to be performed when the corresponding toolbar button is pushed. -.RE -.PP -To illustrate this, the default value of -.B toolbarTranslations -looks as follows: -.RS 5 -.nf -.ft 3 -.sp 1n -xdvi.toolbarTranslations: \e - SPACER(5)\en\e - 0:Open a new document (Key\e\e: Ctrl-f):\e - Open file:select-dvi-file()\en\e - SPACER(10)\en\e - 1:Reread this document (Key\e\e: R):\e - Reread file:reread-dvi-file()\en\e - SPACER(10)\en\e - 2:Go to the first page of this document (Key\e\e: 1g):\e - Go to first page:goto-page(1)\en\e - 3:Go to the previous page of this document (Key\e\e: p):\e - Go to previous page:back-page(1)\en\e - 4:Go to the next page of this document (Key\e\e: n):\e - Go to next page:forward-page(1)\en\e - 5:Go to the last page of this document (Key\e\e: g):\e - Go to last page:goto-page()\en\e - SPACER(10)\en\e - 6:Enlarge the display (Key\e\e: Ctrl-+):Zoom in:\e - set-shrink-factor(+)\en\e - 7:Shrink the display (Key\e\e: Ctrl--):Zoom out:\e - set-shrink-factor(-)\en\e - SPACER(10)\en\e - 8:Jump back to the previous hyperlink (Key\e\e: B):\e - Back hyperlink:htex-back()\en\e - SPACER(10)\en\e - 10:Print this document:Print:print()\en\e - SPACER(10)\en\e - 11:Toggle marks for odd pages (Key\e\e: 1m):\e - Toggle odd:toggle-mark(1)\en\e - 12:Toggle marks for even pages (Key\e\e: 2m):\e - Toggle even:toggle-mark(2)\en\e - 13:Toggle mark for current page (Key\e\e: 2m):\e - Toggle current:toggle-mark()\en\e - 14:Unmark all pages (Key\e\e: 0m):\e - Unmark all:toggle-mark(0)\en\e - SPACER(10)\en\e - 18:Display fonts darker (Key\e\e: Alt-Ctrl-+):\e - Fonts darker:change-density(5)\en\e - 19:Display fonts lighter (Key\e\e: Alt-Ctrl--):\e - Fonts lighter:change-density(-5)\en -.sp 1n -.ft -.fi -.RE -.PP -When the mouse remains over a toolbar button for a certain period, a `tooltip' -window is shown, describing what the button does using the -.I short tooltip string -from the above resource. At the same time, the -.I long tooltip string -is displayed in the statusline. -The appearance and behaviour of these tooltips can be customized via -the following resources: -.TP -.B tipShell.background -Background color of the tooltip window. -.TP -.B tipShell.fontSet -Font used for the tooltip. -.TP -.B tipShell.waitPeriod -The time (in milliseconds) the mouse pointer needs to be over -the button before the tooltip is shown. Set it to a negative value -to suppress the tooltips altogether. - -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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. - -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH HANDLING OF POSTSCRIPT FIGURES -.B Xdvi -can display Encapsulated PostScript (EPS) 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. -Since the execution of arbitrary shell commands with the user's -permissions is a huge security risk, evaluation of these backtick -commands is disabled by default. It needs to be activated via the -.B \-allowshell -command-line option. -.B NOTE: -You should never use this option when viewing documents that you -didn't compile yourself. The backtick specials are not needed for -uncompressing gzipped Postscript files, since -.B xdvi -can do that on the fly if the filename ends with -.I .eps.gz -or -.I .eps.Z -(and if the first bytes of the file indicate that the file is indeed -compressed). This is both safer and more flexible than the backtick -approach, since the default file searching rules will apply to such -filenames too. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH T1LIB -Using T1Lib, a library written by Rainer Menzner -(see ftp://sunsite.unc.edu/pub/Linux/libs/graphics/), -.B xdvi -can render Postscript<tm> Type1 fonts directly, without the -route via \*(Te\& pixel (pk) -fonts. The advantage of this is that only one size of each font needs -to be stored on disk. -Unless the -.B -not1lib -option is used, -.B xdvi -will try to render every font using T1Lib. Only as a fallback it will -invoke an external program (like -.BR mktexpk , -which in turn may invoke utilities like -.B ps2pk -or -.BR gsftopk ) -to generate a pixel font from the Type1 source. The direct rendering -of the -.B Computer Modern -fonts should work out-of-the box, whereas other Type1 fonts such as -the 35 `standard' Postscript<tm> fonts resident in printers may need -to be made accessible for use with xdvi, unless your system -administrator or TeX distribution has already done so (which is the case -e.g. for current teTeX systems). The -.B xdvik -distribution comes with a utility called -.B t1mapper -to make these fonts available for xdvi; -see the manual page for t1mapper(1) for usage details. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH SPECIALS (GENERALLY) -Any of the specials used by -.B xdvi -may be preceded by the characters -.RB `` xdvi: ''. -Doing so does not change the behavior of the special under -.BR xdvi , -but it tells other dvi drivers (such as e.g. dvips) to ignore the special. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH SOURCE SPECIALS -Some \*(Te\& implementations or macro packages provide the facility to -automatically include so-called `source specials' into a DVI file. -These contain the line number, eventually a column number, and the -filename of the .tex source. This makes it possible to jump from a .dvi -file to the corresponding place in the .tex source and vice versa (also -called `inverse search' - jumping from the DVI file to the TeX file is -also known as `reverse search', and jumping from the TeX file to the -DVI file as `forward search'). -.P -To be usable with -.BR xdvi , -source specials in the -.I dvi -file must have one of the following formats: -.RS 5 -.nf -.sp 1n - \fBsrc:\fP\fIline\fP[ ]\fIfilename\fP - \fBsrc:\fP\fIline\fP\fB:\fP\fIcol\fP[ ]\fIfilename\fP - \fBsrc:\fP\fIline\fP - \fBsrc:\fP\fIline\fP\fB:\fP\fIcol\fP - \fBsrc::\fP\fIcol\fP -.sp 1n -.fi -.RE -If -.I filename -or -.I line -are omitted, the most recent values are used. The first source special on -each page must be in one of the first two forms, since defaults are not -inherited across pages. -.sp -You will need a \*(Te\& implementation that provides an appropriate -switch (e.g. -.IR -src ) -or a macro package -(such as -.I srcltx.sty -or -.IR srctex.sty , -available from CTAN:macros/latex/contrib/supported/srcltx/) -to insert such source specials into the DVI file. -.sp -For reverse search, the combination -.I Ctrl-Mouse 1 -will make xdvi open an editor (the value of the -.I \-editor -command line option) with the file and the line number of the .tex -source. See the description of the -.I \-editor -option for more information -and example settings. -.P -For forward search, -.B xdvi -has a -.I \-sourceposition -option that makes -.B xdvi -jump to the page in -the DVI file corresponding to the given line (or the closest -line having a source special) of the specified file and highlight -the found region. See the description of the -.I \-sourceposition -option for more details. -.PP -More information on setting up various editors for use with source -specials can be found at: -.RS 5 -.nf -.sp 1n -http://xdvi.sourceforge.net/inverse-search.html -.sp 1n -.fi -.RE -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH PAPERSIZE SPECIALS -.B xdvi -accepts specials to set the paper size for the document. These specials -should be of the form -.RS 5 -.nf -.sp 1n - \fBpapersize=\fP[\fB*\fP]\fIwidth\fP,\fIheight\fP -.sp 1n -.fi -.RE -.PP -where -.I width -and -.I height -give the width and height of the paper, respectively. Each of these should -appear in the form of a decimal number 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 ). -If an asterisk -.RB ( * ) -appears just before the width, then the measurements refer to the document -dimensions (e.g., -.B pt -as opposed to -.BR truept ). -This allows a macro package to vary the page size according to elements -of the document; e.g., -.RS 5 -.ft 3 -.nf -.sp 1n -\especial{xdvi: papersize=*\enumber\ewd\emybox sp, - \enumber\eht\emybox sp} -.sp 1n -.ft -.fi -.RE -.PP -Except for the asterisk, this format is compatible with -.BR dvips . -.P -The last -.B papersize -special on a page determines the size of that page. If there is no such -special on a given page, the most recent -.B papersize -is used, or, if there are no -.B papersize -specials on any preceding page, then the value of the -.B paper -resource (or -.B \-paper -option on the command line) is used. Thus the paper size may vary for -different pages of the -.I dvi -file. -.P -If the -.B paper -resource (or -.B \-paper -command-line option) begins with a plus sign -.RB (` + '), -then all -.B papersize -specials in the -.I dvi -file are ignored. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH COLOR SPECIALS -The color specials supported by -.B xdvi -are the same as those supported by -.BR dvips , -except that the literal PostScript color specification (as in the -.B AggiePattern -example in the -.B dvips -documentation) is not supported. -There are also some restrictions due to the way xdvi's drawing routines -are implemented; e.g. the -.B \ecolorbox -and -.B \efcolorbox -macros don't work with -.BR xdvi . -See the section LIMITATIONS below for more information on these restrictions. -.B Xdvi -supports the same list of named colors as -.B dvips -does, namely: -.P -.BR Apricot , -.BR Aquamarine , -.BR Bittersweet , -.BR Black , -.BR Blue , -.BR BlueGreen , -.BR BlueViolet , -.BR BrickRed , -.BR Brown , -.BR BurntOrange , -.BR CadetBlue , -.BR CarnationPink , -.BR Cerulean , -.BR CornflowerBlue , -.BR Cyan , -.BR Dandelion , -.BR DarkOrchid , -.BR Emerald , -.BR ForestGreen , -.BR Fuchsia , -.BR Goldenrod , -.BR Gray , -.BR Green , -.BR GreenYellow , -.BR JungleGreen , -.BR Lavender , -.BR LimeGreen , -.BR Magenta , -.BR Mahogany , -.BR Maroon , -.BR Melon , -.BR MidnightBlue , -.BR Mulberry , -.BR NavyBlue , -.BR OliveGreen , -.BR Orange , -.BR OrangeRed , -.BR Orchid , -.BR Peach , -.BR Periwinkle , -.BR PineGreen , -.BR Plum , -.BR ProcessBlue , -.BR Purple , -.BR RawSienna , -.BR Red , -.BR RedOrange , -.BR RedViolet , -.BR Rhodamine , -.BR RoyalBlue , -.BR RoyalPurple , -.BR RubineRed , -.BR Salmon , -.BR SeaGreen , -.BR Sepia , -.BR SkyBlue , -.BR SpringGreen , -.BR Tan , -.BR TealBlue , -.BR Thistle , -.BR Turquoise , -.BR Violet , -.BR VioletRed , -.BR White , -.BR WildStrawberry , -.BR Yellow , -.BR YellowGreen , -.BR YellowOrange . -.P -Note that these names are case sensitive. -.P -The documentation of the La\*(Te\& -.B color -package provides more details on how to use such specials with -La\*(Te\&; see the -.B dvips -documentation for a detailed description of the -syntax and semantics of the color specials. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH SIGNALS -When -.B xdvi -receives a -.SB SIGUSR1 -signal, it rereads the -.I dvi -file. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH ENVIRONMENT -.B Xdvik -uses the same environment variables and algorithms for searching for -font files as \*(Te\& and friends. See the documentation for the -.B Kpathsea -library, -.BR kpathsea.dvi , -for a detailed description of these. -.PP -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 -(= all bits on) for complete tracing. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.SB EXTENSIONMAPS -A list of files to be searched for mime types entries (as for Acrobat Reader). -Earlier entries in one of these files override later ones. -If this variable is not set, the following default path is used: -.RS 7 -.nf -.ft 3 -.sp 1n -$HOME/.mime.types:/etc/mime.types:\e - /usr/etc/mime.types:/usr/local/etc/mime.types -.sp 1n -.ft -.fi -.RE - -.TP -.SB MAILCAPS -A list of files to be searched for mailcap entries, as defined by RFC -1343. See this RFC or the -.BR mailcap (4) -manual page for a detailed description of the mailcap file format. -Currently, only the following mailcap features are supported: -.RS 7 -.TP 7 -.BI test= command -The entry is only used if -.I command -can be executed via the -.B system() -call and if the system() call returns with value 0 (success). -The -.I command -string may contain the format string -.IR %s , -which will be replaced by the file name. -.TP -.BI needsterminal -If this flag is used, the command will be executed in a new xterm -window by prepending -.RI `` "xterm -e "'' -to the command string. -.RE -.PP -.RS 7 -All other fields in the mailcap entry are ignored by xdvi. -Earlier entries in one of these files override later ones. -If the variable is not defined, the following default path is used: -.RS 4 -.nf -.ft 3 -.sp 1n -$HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:\e - /usr/local/etc/mailcap -.sp 1n -.ft -.fi -.RE -.br -For security reasons, some special characters (i.e.: ( ) ` \e ;) -are escaped in the argument before passing it to -.BR system() . -.RE -.TP -.SB BROWSER -Determines the web browser used to open external links (i.e., all URLs that don't -start with the -.RI ` file: ' -scheme and are not relative links in the local DVI file), and to open links -for which no viewer has been specified in the -.B mailcap -files. The value of this variable is a colon-separated list of commands. Xdvi -will try each of them in sequence until one succeeds (i.e. doesn't immediately -return with status 0). This allows you to -specify your favourite browser at the beginning, -and fallback browsers at the end. Every occurrence of -.I %s -in the string is replaced by the target URL; every occurrence of -.I %% -is replaced by a single -.IR % . -If no -.I %s -is present, the URL string is added as an extra argument. -.br -An example setting is: -.RS 7 -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP 7 -.SB "netscape -raise -remote 'openURL(%s,new-window)':xterm -e lynx %s:xterm -e wget %s:lynx %s:wget %s" -.TP -See -.TP -.SB http://www.catb.org/~esr/BROWSER/ -.PP -for more details on the -.B BROWSER -environment variable. -.RE -.TP -.SB TMPDIR -The directory to use for storing temporary files created when uncompressing -PostScript files. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.SB XEDITOR -Determines the editor command used for source special `reverse -search', if neither the -.I \-editor -command-line option -nor the -.I .editor -resource are specified. See the description of the -.I \-editor -command line option for details on the format. -.TP -.SB VISUAL -Determines an editor to be opened in an xterm -window if neither of -.IR -editor , -.IR .editor , -or -.I XEDITOR -is specified. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.SB EDITOR -Determines an editor to be opened in an xterm -window if neither of -.IR -editor , -.IR .editor , -.I XEDITOR -or -.I VISUAL -is specified. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.TP -.SB WWWBROWSER -Obsolete; use -.B BROWSER -instead. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.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 rotation specials are currently not supported. -.PP -.B MetaPost -files containing included text are not supported. -.PP -.BR Xdvi 's -color handling doesn't support the -.B \ecolorbox -and -.B \efcolorbox -macros; this is not likely to change in the near future. This also -means that e.g. colored tables (as created by the -.I colortbl -package) may render incorrectly: Text in colors different from the -default foreground color may not be displayed. When the page is -redrawn (e.g. after using the magnifier), the background color of the -cells may overdraw the text. -.SH FILES -.TP -.SB $HOME/.xdvirc -A file that holds all settings that the user changed via the keys, the `Options' -and the Xaw `Modes' menu and the dialogs, as X resources. These resources override the -settings in -.BR $HOME/.Xdefaults . -This file is ignored if the -.B \-q -option is used or the -.B noInitFile -X resource is set. -.TP -.SB xdvi.cfg -A configuration file for the T1 font setup which needs to be supplied -in the directory determined by the -.B XDVIINPUTS -environment variable. Please see the file -.B http://xdvi.sourceforge.net/README.t1fonts -if that file is missing. -.SH SEE ALSO -.BR X (1), -.BR dvips (1), -.BR mktexpk (1), -.BR ps2pk (1), -.BR gsftopk (1), -.BR t1mapper (1), -.BR mailcap (4), -the -.B Kpathsea -documentation, -and the Xdvik home page at -.BR http://xdvi.sourceforge.net/ . -.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. -.PP -The current maintainer of the original -.B xdvi -is Paul Vojta, U.C. Berkeley. -.PP -Code for the xdvik variant has been contributed -by many people, whose names are scattered across the -source files. Xdvik is hosted on -.B CTAN:dviware/xdvik -and on SourceForge; for the most up-to-date information, please -visit: -.PP -.B http://xdvi.sourceforge.net -.PP -Please report all bugs to the SourceForge bug tracker: -.PP -.nf -.B http://sourceforge.net/tracker/?func=add&group_id=23164&atid=377580 -.PP - |