summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/xdvi.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/xdvi.1')
-rw-r--r--Master/texmf/doc/man/man1/xdvi.194
1 files changed, 73 insertions, 21 deletions
diff --git a/Master/texmf/doc/man/man1/xdvi.1 b/Master/texmf/doc/man/man1/xdvi.1
index 7e7027a4e1a..32933b9d63f 100644
--- a/Master/texmf/doc/man/man1/xdvi.1
+++ b/Master/texmf/doc/man/man1/xdvi.1
@@ -48,11 +48,11 @@
.\" .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)
+.\" # small and boldface (not all -man's provide it)
.de SB
\&\fB\s-1\&\\$1 \\$2\s0\fR
..
-.TH XDVI 1 "2009-05-18" "Xdvik 22.84.16"
+.TH XDVI 1 "2012-04-01" "Xdvik 22.85"
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH NAME
@@ -184,7 +184,8 @@ string search in DVI files (section STRING SEARCH),
saving or printing (parts of) the DVI file (sections PRINT DIALOG and SAVE DIALOG).
.RE
.PP
-Xdvi can be compiled with the Motif toolkit or the Xaw (Athena) toolkit
+.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
@@ -808,7 +809,8 @@ 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
+.IR #8b6508 ).
+See also
.B \-visitedlinkcolor
and
.BR \-linkstyle .
@@ -1469,8 +1471,7 @@ instead (which see).
.B \-thorough
.RB ( .thorough )
.B Xdvi
-will usually try to ensure that overstrike characters
-.RI ( e.g. ,
+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
@@ -1579,10 +1580,12 @@ until the DVI file can be read entirely.
.BI \-wheelunit " pixels"
.RB ( .wheelUnit )
Sets the number of pixels that a motion of a wheel mouse will move the
-image up or down. (See the
+image up, down, left, or right. (See the
.B wheel
-action, below, for more information on this.)
-If set to zero, the wheel mouse functionality is disabled.
+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
@@ -2310,14 +2313,45 @@ Ctrl<Btn1Down>:mouse-modes("source-special()")\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 neccessary
+Note the use of quote symbols around the action strings, which are necessary
to group them into one argument.
-The buttons 4 and 5 refer to wheel movements (wheel up/down) on wheel mice.
+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()
@@ -2415,6 +2449,16 @@ 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
@@ -2651,7 +2695,8 @@ The length of the tick marks can be changed via the X resource
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH PAGE HISTORY
-Xdvi keeps a history of viewed pages, and you can move through the 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() ),
@@ -2713,7 +2758,8 @@ 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
-Xdvi currently uses no heuristics apart from the filename suffix
+.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
@@ -3241,7 +3287,8 @@ or
(see the section
.B FILE SEARCHING
below for more information on these variables).
-Xdvi will try to split this pixmap horizontally into
+.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
@@ -3664,12 +3711,17 @@ 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 \ecolorbox and \efcolorbox macros don't work
-with xdvi. See the section LIMITATIONS below for more information on these
-restrictions.
-Xdvi supports the same list of named colors as with
-.BR dvips ,
-namely:
+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 ,
@@ -3794,7 +3846,7 @@ If this variable is not set, the following default path is used:
.ft 3
.sp 1n
$HOME/.mime.types:/etc/mime.types:\e
- /usr/etc/mime.types:/usr/local/etc/mimetypes
+ /usr/etc/mime.types:/usr/local/etc/mime.types
.sp 1n
.ft
.fi