TEXMGR(1)

NAME
texmgr - TeX dvi file previewer for MGR

SYNOPSIS
texmgr [-f n] [-m n] [-b n] [-d n] [-s ddd] dvifilename

texmgr -V

DESCRIPTION
texmgr will read a tex dvi file and display it in a MGR window. Texmgr was derived from the 3b1 previewer, tex3b1. Both previewers do subsampling of glyphs (shrinking) so that you can use fonts of higher resolution than the screen itself. This means only one set of fonts (the printer fonts) are needed.

Texmgr reads /usr/local/lib/tex/fontdesc to find the directory where font files are stored. You can use any combination of pk, gf and pxl font files. In addition, the choice to make boxes or leave blanks when missing fonts are encountered is controlled by this file, based on information from the tfm file.

Since the resolution of most CRT displays is much lower than that of most printers, texmgr can generally display only a partial page at a time. Therefore, commands exist to move the page around on the screen as well as to select a new page to view.

Texmgr potentially displays each partial page in three possible magnifications (really "shrinkages"). These three shrink values allow users to zoom in (a small shrink value) or zoom out (a large shrink values) as a dvi file is being previewed.

OPTIONS

V   Just print the version number of the current texmgr and a usage statement. No previewing is done.

b   [-b n] selects the blacker value. The current default is 3, if your fonts are already thick then you might get by with a smaller number. You may want a larger number on MGR to make up for otherwise dropped pixels due to subsampling during shrinking of glyphs.

f   [-f n] selects the starting page for texmgr to display. This page number is strictly the count from the start of the dvi file and not the page number that TeX places at the bottom of the file.

m   [-m n] chooses which of the shrink values (there are three) to make the default. For instance, suppose shrink values are 2,3,5 (or 235 as a shrink triple) then saying -m 3 would select 1/5 (shrink value 5) as the default magnification. Normally the shrink values are ordered: (1) detailed view, (2) normal view, (3) overview. The middle shrink value is the default at program startup.

d   [-d n] changes the dots per inch (dpi) font value. Normally one would recompile the code with the right value for their own system, but if that is not possible then ``-d 240'' will allow you to run with fonts built at 240 dpi.

s   [-s ddd] changes the default shrink values. These values are displayed in the middle button magnification menu. Changing from one magnification to another is equivalent to selecting one of these three values. For some types of work or for some font sizes it makes sense to be able to control these shrink values. ``-s 248'', for example, might give you a reasonable view of the page for a default (shrink of 4) while allowing you to zoom out (shrink of 8) and zoom in (shrink of 2) using the interactive commands 'm' and 'M' or the magnification menu.

    Note that most printers have pixels much smaller than those on your screen, and hence a shrink value of 1 (full resolution) will look very much larger on the screen. This 3-tuple method of naming three individual numbers is a bit strange and limits you to values from 1 to 9. For very high resolution devices (Linotype machines?) this may be too limiting. Most MGR users, however, won't need to shrink more than 9.

COMMANDS
Interactive commands:

?   Displays a summary of these interactive commands.

Screen movement commands:

h   Move viewport a bit to the left.

j   Move viewport a bit to the right.

k   Move viewport a bit up.

l   Move viewport a bit down.

H   Move viewport completely to the left. (X coordinate goes to 0.)

J   Move viewport completely to the right. (Left Margin is completely visible.)

K   Move viewport to the top of the page. (Y coordinate goes to 0.)

L   Move viewport to the bottom of the page.

<ff>,r
    Either '^L' or 'r' reset the current page (X and Y coordinates back to 0, same as 'H' then 'K').

Commands to move to different pages:

<space>,f,n,<nl>,<cr>
    ' ', 'f', 'n', '^J', and '^M' all move to next page. A number preceding any of the above will move forward that many pages (default is one).

b,p,<bs>,<del>
    'b', 'p', '^H', and '^?' all move to the previous page. A number preceding any of the above will move backward that many pages (default is one).

<n>g,<n>G
    A number followed by g or G will go to the requested page: ``21G''. Note the syntax may seem backwards, but it is easy to parse. Just think ``less'' and ``vi'' here. The default page number is one.

Other interactive commands:

m   Use the next shrink value following the current one, normally, making the text look smaller on the screen.

M   Use the shrink value preceding the current one, normally making the text look larger on the screen. Once these magnifications have been computed for a page, moving between one and another is relatively fast.

Z   Reshape the window to toggle between a window filling the entire display screen and one filling most of the left-hand side of the display.

R   Re-open the dvi file. This generally isn't necessary.

q,x,^C,^D
    All these options leave texmgr.

MOUSE
You can choose different magnifications with the menu that is activated with the middle mouse button.

If you press the right mouse button, the location pointed to by the arrow is placed as close to the center of the screen as possible. Placing the arrow slightly above and left of center, and hitting the right button a number of times will move you diagonally through the page at the current magnification.

A rule of thumb that seems to work for me is to make gross motions with the keyboard (hjkl and HJKL) and fine selections with the mouse. Indeed, the only way to select exactly that section of the page you want on the screen is to use the mouse.

AUTHOR
The code is based on texsun, which was written by Dirk Grunwald. It uses Chris Torek's dvi library. The 3b1 port is by Andy Fyfe andy@csvax.caltech.edu. The port to MGR on the 3b1 is by Ross A. Jekel, s83949@ursa.calvin.edu until August 1991 (after that at some graduate school). The Linux Mgr port for the 386 and SPARC by Michael Haardt and Vincent Broman in 1993.

FILES
/usr/local/lib/tex/fontdesc
and all the pk, gf, pxl and tfm files pointed to therein.

THINGS TO IMPROVE
This was really just a simple rewrite and is rather slow because it downloads the raster for a character every time it is used. Someone should work on a version that will download fonts containing the characters to the server.

SEE ALSO
tex(1), latex(1), mgr(1), mf(1)