.!
.! This is a RUNOFF source file that produces part of a VMS-style HELP
.! library for the August DECUS TeX Collection.  To build the library,
.! execute MAKE_TEX_HLB.COM.
.!
.NO PAGING
.NO FLAGS ALL
.LEFT MARGIN 1
.RIGHT MARGIN 70

.INDENT -1
1 TeX
.INDENT 5
The TeX command typesets a file of text. To be more specific, it processes
an input file containing the text of a document with interspersed commands
that describe how the text should be formatted. It produces two files as
output, a Device Independent (DVI) file that contains commands that can be
translated into commands for a variety of output devices, and a
`transcript' or `log file' that contains summary information and diagnostic
messages for any errors discovered in the input file. 
.SKIP
For a description of what goes on inside TeX, you should consult 
The TeXbook by Donald E. Knuth, ISBN 0-201-13448-9, published jointly by 
the American Mathematical Society and Addison-Wesley Publishing Company. 
Some documentation can be found in TEX_DISK:[TEX.DOC.TEX].
.SKIP
Format:
.SKIP
.INDENT +3
     tex [ &format ] input-file
.INDENT -1
2 Parameters
.SKIP
&format
.SKIP
The format specification indicates a particular format to be loaded.
Normally, you will omit the format, and TeX will use the default PLAIN
format. 
.SKIP
input-file, ...
.SKIP
The input file specification indicates the file to be formatted; TeX uses
TEX as a default file extension. If you omit the input file entirely, TeX
accepts input from the terminal. You specify command options using the
conventional VAX/VMS arrangement -- options begin with a slash mark (/),
and are placed following the command name or following the input file
specification. 
.SKIP
Output files are always created in the current directory; the DVI file has
the file type DVI, and the log file has the file type LIS. When you fail to
specify an input file name, TeX bases the output names on the file
specification associated with the logical name TEX_OUTPUT. 
.!
.!  The rest of this stuff isn't correct, so I took it out.
.!  Pete Siemsen, 27-Feb-1990.
.!
.IF qualifiers
.INDENT -1
2 Qualifiers
.INDENT -1
/BATCH
.SKIP
Set batch mode -- no interaction on errors and no output to the terminal.
Normally, TeX is set up for interactive use; it stops when it encounters an
error and allows you to correct it, and prints status and diagnostic
information at the terminal. The /BATCH setting is preferred for batch use;
TeX will barrel on through as though you had specified `BATCHMODE' in the
input file or typed `Q' in response to the first error message. 
.INDENT -1
/FONT_DIRECTORY=(name,...)
.SKIP
Specify directories containing TeX Font Metric (TFM) font definition files,
and the order in which they will be searched to locate each TFM file. A
null value in the list indicates the current directory. The search
procedure TeX uses to locate font files is to first search each of
directories specified by the /FONT_DIRECTORY option, and then search the
standard font directory defined by the logical name TEX_FONTS. 
.SKIP
A complete TFM file name specification is formed by combining a TFM file
name from the input file with a default directory and default file type of
TFM. It is normal practice to specify only a simple file name in the input
file and let TeX supply the defaults, since this tends to protect the user
from installation dependencies and changes to TeX. When searching for a TFM
file, TeX will try alternate default directories until it finds the TFM
file or runs out of alternatives. 
.SKIP
Default is /FONT_DIRECTORY=(TEX_FONTS); TeX looks in the directory
associated with the logical name TEX_FONTS for font definition files.
.INDENT -1
/INPUT_DIRECTORY=(name,...)
.SKIP
Specify directories containing input files, and the order in which they
will be searched to locate each input file. A null value in the list
indicates the current directory. This qualifier operates in a manner
similar to /FONT_DIRECTORY. The search procedure TeX uses to locate input
files is to first search each of directories specified by 
the /FONT_DIRECTORY option, then search the current directory, and finally
search the standard input directory defined by the logical name TEX_INPUTS.
.SKIP
Default is /INPUT_DIRECTORY=(,TEX_INPUTS); TeX looks in your current
directory for input files, then in the directory associated with the
logical name TEX_INPUTS.
.ENDIF qualifiers