View Source: etex(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
ETEX
!!!ETEX
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ENVIRONMENT
FILES
BUGS
SEE ALSO
----
!!NAME


etex, einitex, evirtex - extended TeX
!!SYNOPSIS


__etex__ [[''options''] [[''commands'']
!!DESCRIPTION


This manual page is not meant to be exhaustive. The complete
documentation for this version of TEX can be found in the
info file or manual ''Web2C: A TeX
implementation''.


e-TEX is the first concrete result of an international
research


e-TEX can be used in two different modes: in
''compatibility mode'' it is supposed to be completely
interchangable with standard TEX. In ''extended mode''
several new primitives are added that facilitate (among
other things) bidirectional typesetting.


An extended mode format is generated by prefixing the name
of the source file for the format with an asterisk (*). Such
formats are often prefixed with an `e', hence __etex__ as
the extended version of __tex__ and __elatex__ as the
extended version of __latex__. However, __eplain__ is
an exception to this rule.


The __einitex__ and __evirtex__ commands are e-TEX's
analogues to the __initex__ and __virtex__ commands.
In this installation, they are symlinks to the __etex__
executable.


e-TEX's handling of its command-line arguments is similar to
that of TEX.
!!OPTIONS


This version of e-TEX understands the following command line
options.


__--efmt__ ''format''


Use ''format'' as the name of the format to be used,
instead of the name by which e-TEX was called or a
''%'' line.


__--file-line-error-style__


Print error messages in the form ''file:line:error''
which is similar to the way many compilers format
them.


__--help__


Print help message and exit.


__--ini__


Be __einitex__, for dumping formats; this is implicitly
true if the program is called as
__einitex__.


__--interaction__ ''mode''


Sets the interaction mode. The mode can be one of
''batchmode'', ''nonstopmode'', ''scrollmode'', and
''errorstopmode''. The meaning of these modes is the same
as that of the corresponding commands.


__--ipc__


Send DVI output to a socket as well as the usual output
file. Whether this option is available is the choice of the
installer.


__--ipc-start__


As __--ipc__, and starts the server at the other end as
well. Whether this option is available is the choice of the
installer.


__--kpathsea-debug__ ''bitmask''


Sets path searching debugging flags according to the
bitmask. See the ''Kpathsea'' manual for
details.


__--maketex__ ''fmt''


Enable mktex''fmt'', where ''fmt'' must be one of
''tex'' or ''tfm''.


__--mltex__


Enable MLTEX extensions.


__--no-maketex__ ''fmt''


Disable mktex''fmt'', where ''fmt'' must be one of
''tex'' or ''tfm''.


__--output-comment__ ''string''


Use ''string'' for the DVI file comment instead of the
date.


__--recorder__


Enable the filename recorder. This leaves a trace of the
files opened for input and output in a file with extension
''.fls''.


__--progname__ ''name''


Pretend to be program ''name''. This affects both the
format used and the search paths.


__--shell-escape__


Enable the __write18{__''command''__}__ construct.
The ''command'' can be any Bourne shell command. This
construct is normally disallowed for security
reasons.


__--translate-file__ ''tcxname''


Use the ''tcxname'' translation table.


__--version__


Print version information and exit.
!!ENVIRONMENT


See the Kpathsearch library documentation (the `Path
specifications' node) for precise details of how the
environment variables are used. The __kpsewhich__ utility
can be used to query the values of the
variables.


One caveat: In most e-TEX formats, you cannot use ~ in a
filename you give directly to e-TEX, because ~ is an active
character, and hence is expanded, not taken as part of the
filename. Other programs, such as M ETAFONT ,
do not have this problem.


TEXMFOUTPUT


Normally, e-TEX puts its output files in the current
directory. If any output file cannot be opened there, it
tries to open it in the directory specified in the
environment variable TEXMFOUTPUT. There is no default value
for that variable. For example, if you say ''tex paper''
and the current directory is not writable, if TEXMFOUTPUT
has the value ''/tmp'', e-TEX attempts to create
''/tmp/paper.log'' (and ''/tmp/paper.dvi'', if any
output is produced.)


TEXINPUTS


Search path for ''input'' and ''openin'' files. This
should probably start with ``.'', so that user files are
found before system files. An empty path component will be
replaced with the paths defined in the ''texmf.cnf''
file. For example, set TEXINPUTS to
''


TEXFONTS


Search path for font metric (''.tfm'')
files.


TEXFORMATS


Search path for format files.


TEXPOOL


search path for __einitex__ internal
strings.


TEXEDIT


Command template for switching to editor. The default,
usually __vi__, is set when e-TEX is
compiled.
!!FILES


The location of the files mentioned below varies from system
to system. Use the __kpsewhich__ utility to find their
locations.


''etex.pool''


Encoded text of e-TEX's messages.


''texfonts.map''


Filename mapping definitions.


''*.tfm''


Metric files for e-TEX's fonts.


''*.efmt''


Predigested e-TEX format (.efmt) files.
!!BUGS


This version of e-TEX fails to trap arithmetic overflow when
dimensions are added or subtracted. Cases where this occurs
are rare, but when it does the generated ''DVI'' file
will be invalid.
!!SEE ALSO


tex(1), mf(1).
----
6 pages link to etex(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:21:59 am by "perry"
Edit PageHistory Diff Info LikePages