\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\f0\b\i\ulnone\fs72\fc0\cf0 TeXview and NeXT TeX Hints
\fs32 \
Command Keys and Keyboard Shortcuts\
\b0\i0\fs24 Like other NeXT applications, TeXview supports command key shortcuts for menu operations. Each menu item with a letter (or number) to the right of the command can be executed by holding down the command key and pressing the appropriate letter. If the key window is the main TeXview previewing window, holding down the command key is unecessary. Thus, most operations can be performed with a single keystroke.\
To go to a particular page number, just type the page number while the Preview window is active; the first digit or minus sign will automatically activate the page number field for you.\
In addition, TeXview also supports use of the arrow keys to scroll around on the page and to move from page to page. The right and left arrow keys move to the next and previous pages, respectively, while the up and down arrow keys move around on the page.\
If you hold down the shift key while hitting an arrow key, the size of the movement is reduced by a factor of four. If you hold down the control key, the size of the movement is reduced by a factor of sixteen. If you hold both control and shift key down, the size of the movement is reduced by a factor of sixty-four. When a left or right arrow key motion is reduced in such a way, a reduction of `four' is used to move around on the page rather than page to page. Thus, shift left arrow will move a screenful to the left; control left arrow will move a quarter screenful to the left. For example, to center the page horizontally, hit shift left arrow followed by control right arrow twice.\
The space key can also be used to move to the next page, and backspace and delete can both be used to move back a page.
\b\i\fs32 \
Windows\
\b0\i0\fs24 The TeXview program has numerous windows and panels. You can move from one window to the next with command up or down arrow. (You still need to click on the window to activate it.)\
The preview window is the main window in which your document appears. This is the large window with horizontal and vertical scrollbars. It can be brought to front and made active with command-P.\
The console window is used to run dvips, the printer driver, and METAFONT, the font generation program; it is also used to record error and status messages. It can be brought to front with command-C. You cannot type into this window. The commands that run in this window must run to completion before TeXview will respond to any commands.\
The TeX window is used to run TeX and BibTeX over your document. You can type in this window, and you can perform other TeXview operations while a command is running in this window. If TeX (or any other command executing in this window) pauses for terminal input, you can type a response. You can also use control-C or control-D or control-backslash to abort processing in this window. The command-T keystroke will bring this window to front.\
TeXview also has a command panel that contains buttons for common operations in TeXview; many people find such a command panel more convenient than command keys or menu options. Indeed, one common mode of operation for TeXview is to hide the main preview window while you are editing your main document, leaving TeXview's command window visible on some portion of the screen. Once your edits are done, you simply need to save your file from the editor and then hit the `TeX' button on the command panel to run TeX and preview your file.\
TeXview also has several other windows and panels, including this hints window, the Info panel, the Preferences panel, the Print panel, and the Open panel, all of which are brought up at the appropriate times.\
\b\i\fs32 \
Mouse Tricks\
\b0\i0\fs24 In TeXview, the mouse can be used to perform more operations than just selecting buttons and menu items. If you click on the main Preview window, you can then drag the page around (holding the mouse button down). In addition, if you click on the main Preview window without dragging the mouse around, the position on the page at which you clicked will be displayed in the Command window, along with the distance from the last place you clicked. With this feature, you can measure distances in the window. For extra accuracy, you can zoom to a higher resolution; at 400 dots per inch, you can measure on-screen with an accuracy of better than a fifth of a point.
\b\i\fs32 \
Running TeX\
\b0\i0\fs24 TeX comes in many different flavors. Some people use plain TeX; others use the LaTeX macro package. Some use AMSTeX; some use phyzzx. NeXT TeX comes supplied with plain, LaTeX, and SliTeX; other formats can easily be added.\
Unfortunately, there is no completely dependable way to determine the appropriate format from the name or the contents of a particular file. For this reason, NeXT TeX establishes the convention that if the first line of the TeX file looks like\
%&
\i formatname
\i0 \
then the format specified by
\i formatname
\i0 is loaded into TeX before processing begins. Thus, the `TeX' command can be used, and a file ending in .tex can be opened, without knowing the format beforehand, if this comment is used. For LaTeX, the comment would appear as\
%& latex\
and similarly for other commands. Note that you must use all lower case.\
[Note that the LaTeX command uses exactly the same executable as the TeX command. The way NeXT TeX determines what format to load is according to the following rules:\
1. If a file name is given on the command line, and the first two characters of that file are % and & respectively, then the next space delimited word is used as the name of the format file to load.\
2. If no such specification is found, then the command name that invoked TeX is used as the name of the format file. (Thus, tex and latex and slitex are all links to the very same file, but name of the command used to invoke that executable is used as the format name.)]\
NeXT TeX also has special -v and -V command line switches that tell TeX to send the pages directly to TeXview as they are finished. The -V command line switch also tells TeX to start up a new TeXview if one isn't already running. These switches are used by TeXview internally when it invokes TeX. If you want to invoke TeX yourself, say within a shell window from EMACS, using the -V option will automatically display your document as it is TeX'ed, with no further commands necessary.\
You can also specify a custom format in the Preferences panel and use the compile/custom menu item or Custom command button to use that format. Note that in any case, subsequent uses of `reTeX' or `tex -v' will automatically use the most recent format used.\
\b\i\fs32 \
Zoom and Unzoom Resolutions\
\b0\i0\fs24 TeXview supports a large number of resolutions at which .dvi files can be viewed. The defaults are 91 dots per inch at the unzoom level and 120 dots per inch at the zoom level. You can toggle between the zoom and unzoom levels by selecting the zoom option at the bottom of the Preview window. Note that at any time you are either in `zoom' or `unzoom' mode, and that each of these modes has its own resolution, and that there is no restriction that the zoom resolution be higher than the unzoom resolution.\
In addition, you can change the resolution for the current mode by selecting a different resolution in the Command window.\
TeXview will run faster if you select two resolutions to use for your work and use them whenever possible. This is because whenever you choose another resolution, another set of fonts needs to be calculated and loaded, and this can take some time. The more resolutions you use in a session, the more fonts that need to be loaded and the more memory that TeXview requires. This is the reasoning behind the zoom and unzoom sizes. So select your resolutions and save the TeXview configuration.
\b\i\fs32 \
Preferences\
\b0\i0\fs24 Selecting Save Preferences on the Preferences panel saves not only the values of the switches on that panel, but it also saves the positions of the Preview, Console, Command, and TeX windows, the current zoom and unzoom resolutions, and various other parameters. All of these are saved as dwrite variables, so they can be examined from the shell with dread -o TeXview or changed with dwrite. TeXview does not automatically save the preferences on exit.
\b\i\fs32 \
Generating Fonts\
\b0\i0\fs24 TeX, by default, uses the Computer Modern typeface family. This set of fonts is fully scalable, but the scaling is done by METAFONT, rather than PostScript, and thus TeXview needs bitmapped versions of the fonts at the appropriate resolution for display. If TeXview cannot find a font at the appropriate resolution, it can either invoke METAFONT to generate the font automatically, or it can select a substitute font and scale it to fit. You can control this decision by selecting the appropriate radio button on the Preferences panel.\
If you choose `generate fonts', then every time such a font is needed, METAFONT will be called to generate the font. The METAFONT command is run in TeXview's console window so you can see what is going on. Creating such a font could take several minutes; if a few fonts are needed, then TeXview will be effectively locked up for a while. However, once the fonts are generated, they are stored on disk, so the next time you need those fonts, they will be available.\
If the fonts are not generated, then the screen display will not be ideal. TeXview writes a line mentioning what font is missing to the file /LocalLibrary/Fonts/TeXFonts/pk/NeededFonts. By executing this file at any time, you can create all of the fonts that TeXview wanted but couldn't find. (After executing the file, make sure you delete it. This file is an excellent candidate to be run in a cron script.)
\b\i\fs32 \
Additional Information\
\b0\i0\fs24 For more information on TeXview in particular and NeXT TeX in general, please print out the NeXT TeX manual. To do this, simply select the Info/View Manual menu item and then select Print. The manual contains a complete bibliography on TeX.
\b\i\fs32 \
Contacting Radical Eye Software\
\b0\i0\fs24 At Radical Eye Software, we are very interested in your comments and suggestions. Please send us mail at Radical Eye Software, Box 2081, Stanford, CA 94309. You can also send us a FAX at (415) 327-3329, or contact us as radical.eye on Byte Information Exchange (BIX).
\b0\i0\fs24 There is no way we could thank everyone who has constributed ideas to NeXT TeX, but Radical Eye Software would like to extend special thanks to the following people. Doctor Tom Marchioro II constantly sent suggestions, relayed messages from others, tested alpha and beta versions, contributed fine coffee, and made many other contributions. Other people who made immense contributions include Janet Coursey, Dmitri Linde, John Loyola, Susan Skulina, and Cameron Smith. In addition, we want to thank the literally hundreds of others who sent megabytes of mail with suggestions and assistance.