NAME
tkdvi - Tk-based DVI previewer
SYNOPSIS
tkdvi ?option ... fileName option ... fileName?
OPTIONS
-overview Indicates that the following DVI file(s) should be
displayed as reduced 4 by 4 overviews. This gives a
view of 16 pages at once, so page breaks and float
positions can be conveniently checked.
-papersize size Specifies the paper size to be assumed for the
following DVI file(s). Valid sizes include a4 (and
other DIN sizes), letter, and legal. All these
sizes can have an r appended to indicate landscape
(‘rotated’) format. The default is a4.
-present Switches to ‘presentation’ mode, displaying A6
landscape documents at shrink factor 3, with the
window covering all of the screen with all
extraneous user interface elements (scrollbars,
menu bar, tool bar, page selector) turned off. This
is probably not useful without appropriate LaTeX
style support and on screens with a resolution
different from 1024x768.
-single Indicates that the following DVI file(s) should be
displayed as single pages.
-shrink factor Specifies the linear shrink factor to be applied to
the following DVI file(s) on the screen. This can
be any positive integer. The default is 8, which
gives reasonable results at 600 dpi.
-spread Indicates that the following DVI file(s) should be
displayed as two-page ‘spreads’.
_________________________________________________________________
DESCRIPTION
TkDVI is a simple previewer for TeX DVI files built around the dvi(n)
Tcl/Tk extension. It displays pages from DVI files in windows on the
screen. TkDVI takes a number of command line arguments which are
either options or the names of DVI files to be displayed. Any options
stay in force for all the DVI files that follow them on the command
line, until countermanded by other options.
INITIALIZATION FILES
On startup, TkDVI reads X11 resources from the file tkdvi.ad in an
installation-specific directory (usually /usr/local/share/tkdvi) or the
directory given in the environment variable TKDVI_TCLLIB (if this
exists). It also reads resources from the file $HOME/.tkdvi-resources
if it exists. Furthermore, it arranges to autoload procedures from the
directory $HOME/.tk/tkdvi. In particular, TkDVI tries to invoke a
procedure called userInit before it starts looking at the command line
(but after the X11 resources have been loaded). You can supply an
implementation of userInit by putting it in a file in $HOME/.tk/tkdvi
and setting up an appropriate tclIndex file in that directory.
DVI BROWSERS
TkDVI starts a ‘DVI browser’ for each DVI file named on the command
line (you can open several browsers for a single file by mentioning it
several times; it will be actually loaded only once). This is a window
containing a representation of the DVI file’s contents together with
the appropriate scroll bars, menu bar and a page selector. See
tkdvi::browser(3tcl) for details about the browser’s features.
The ‘q’ key is a shortcut for quitting TkDVI.
THE PAGE SELECTOR
The page selector is displayed to the left of the DVI page. It shows a
list of the page numbers in the DVI file and makes it possible to jump
to any page directly by clicking on its number. The current page (or,
in the spread and overview modes, the page in the upper left corner of
the window) has its number framed in the page selector.
It is also possible to select individual pages for printing, by
clicking on the page numbers in question using button 2 (usually the
middle button). A little red box to the left of the page number will
light up, and only the selected pages will be printed when ‘Print
Marked Pages’ is selected from the ‘File’ menu. (This requires a
version of dvips(1) that understands the -pp option, as any reasonably
recent version will.)
AUTHOR
Anselm Lingnau <lingnau@tm.informatik.uni-frankfurt.de>