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

.INDENT -1
1 eTeX
.INDENT 5
The eTeX 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 eTeX, you should consult 
the eTeX web page at http://www.rhbnc.ac.uk/e-TeX/.
.SKIP
Format:
.SKIP
.INDENT +3
     ETEX  input-file
.INDENT -1
2 Parameters
.SKIP
input-file, ...
.SKIP
The input file specification indicates the file to be formatted; eTeX uses
TEX as a default file extension. If you omit the input file entirely, eTeX
accepts input from the terminal. You specify command options using the
conventional OpenVMS 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. 

.SKIP
.INDENT -1
2 Qualifiers
.INDENT -1
/FORMAT 
.SKIP
  /FORMAT=[file-spec]		D=/FORMAT=ETEX_FORMATS:ETEX
.SKIP
Indicates which format file TeX uses upon activation.  The default format
file is ETEX_FORMATS:ETEX.FMT.  This is the ETEX format discussed in 
http://www.rhbnc.ac.uk/e-TeX/src/etex_src.html.
.SKIP
.INDENT -1
/INIT
.SKIP
 /INIT  
.break
 /NOINIT
.SKIP
 Indicates that you wish run eTeX in the initialization, or eINITeX, mode.
 This mode is used to compile format files.
.SKIP
.INDENT -1
/BATCH
.SKIP
Set batch mode -- no interaction on errors and no output to the terminal.
Normally, eTeX 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. 
.SKIP
.INDENT -1
/OUTPUT
.SKIP
 /OUTPUT[=file-spec]
.break
 /NOOUTPUT
.SKIP
    Controls where the output of the command is sent.   If  you  do  not
    enter  the  qualifier,  or  if  you  enter  /OUTPUT  without  a file
    specification, the output is sent to  a file with the same name as
    the input file, only with the extension .DVI.
.SKIP
    If you enter /NOOUTPUT, output is suppressed.

.SKIP
.INDENT -1
/LOG_FILE
.SKIP
 /LOG_FILE[=file-spec]
.break
 /NOLOG_FILE
  Controls where the log output of the command is sent.   If  you  do  not
  enter  the  qualifier,  or  if  you  enter  /LOG_FILE without  a file
  specification, the log output is sent to  the  a file with the same name
  as the input file, only with the extension .LIS.
.SKIP
  If you enter /NOLOG_FILE, the log output file is suppressed.

.SKIP
.INDENT -1
/TEXFONTS
.SKIP
 /TEXFONTS=(name,...)			D=/TEXFONTS=ETEX_FONT_METRICS:
.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 search each of
directories specified by the /TEXFONTS option.
.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 eTeX supply the defaults, since this tends to protect the user
from installation dependencies and changes to eTeX. When searching for a TFM
file, eTeX will try alternate default directories until it finds the TFM
file or runs out of alternatives. 
.SKIP
Default is /TEXFONTS=(ETEX_FONT_METRICS); TeX looks in the directory
associated with the logical name TEX_FONTS for font definition files.
.SKIP
.INDENT -1
/TEXINPUTS
.SKIP
 /TEXINPUTS=(name,...)			/D=/TEXINPUTS=ETEX_INPUTS:
.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 /TEXFONTS. The search procedure TeX uses to locate input
files is to first search your current directory and then search each of 
directories specified by the /TEXINPUTS option.
.SKIP
Default is /TEXINPUTS=(ETEX_INPUTS); TeX looks in the directory associated 
with the logical name ETEX_INPUTS.
.SKIP
.INDENT -1
/TEXFORMATS
.SKIP
 /TEXFORMATS=(name,...)			/D=/TEXFORMATS=ETEX_FORMATS:
.SKIP
Specify directories containing format 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 /TEXFONTS. The search procedure eTeX uses to locate input
files is to search each of directories specified by 
the /TEXFORMATS option.
.SKIP
Default is /TEXFORMATS=(ETEX_FORMATS); eTeX looks in the directory associated 
with the logical name ETEX_FORMATS.
.SKIP
.INDENT -1
/EDITOR
.SKIP
 /EDITOR=name			D=/EDITOR=(ETEX_EDIT:)
.break
 /NOEDITOR
.SKIP
Specify the editor TeX is to use when the "e" (edit) option is used when
TeX finds an error.  The editors can be callable editors such as TPU or EDT, 
or command procedures.  This works similarly to how the MAIL program allows
use of editors under SEND/EDIT.
.skip
The default is to use the editor defined by the logical name ETEX_EDIT.
.skip
Valid callable editors are EDT, TPU, and LSE.  Any other editor must be
called by way of a command procedure.
.SKIP
.INDENT -1
/DIAGNOSTICS
.SKIP
 /DIAGNOSTICS=[file-spec]
.break
 /NODIAGNOSTICS
.SKIP
Create a Diagnostics file for the Language Sensitive Editor (LSE).
.SKIP
.INDENT -1
/JOBNAME_SYMBOL
.SKIP
 /JOBNAME_SYMBOL
.SKIP
 Indicates the name of a symbol in which eTeX should store the name
 of the DVI file it writes.
 Default is /JOBNAME_SYMBOL=ETEX_JOBNAME.
.SKIP
.INDENT -1
.INDENT -1
/CONTINUE
.SKIP
 /CONTINUE
.break
 /NOCONTINUE [D]
.SKIP
 Indicates that eTeX should continue after editing a file.
.SKIP