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.
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.
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 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.)
Anselm Lingnau <firstname.lastname@example.org>