summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/etex.1
diff options
context:
space:
mode:
authorPeter Breitenlohner <peb@mppmu.mpg.de>2011-02-08 11:18:27 +0000
committerPeter Breitenlohner <peb@mppmu.mpg.de>2011-02-08 11:18:27 +0000
commit5d6b6b9df364c0561ba9eae296b04c780ec8dd07 (patch)
tree5bec4522c451fa4a185085ef69893e01730c1e2a /Master/texmf/doc/man/man1/etex.1
parent4e0aa3cac68c35a0bd5e9d78b67e820ae9fea4d0 (diff)
more manpage updates
git-svn-id: svn://tug.org/texlive/trunk@21345 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man/man1/etex.1')
-rw-r--r--Master/texmf/doc/man/man1/etex.166
1 files changed, 25 insertions, 41 deletions
diff --git a/Master/texmf/doc/man/man1/etex.1 b/Master/texmf/doc/man/man1/etex.1
index dbecf3291ff..9326f10e9c8 100644
--- a/Master/texmf/doc/man/man1/etex.1
+++ b/Master/texmf/doc/man/man1/etex.1
@@ -1,4 +1,4 @@
-.TH ETEX 1 "7 January 2007" "pdftex 1.40" "Web2C 7.5.7"
+.TH ETEX 1 "14 May 2010" "pdftex 1.40" "Web2C 2011/dev"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF M\s-2ETAFONT\s0
@@ -19,19 +19,21 @@
.if n .ds AX AmSTeX
.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
.if n .ds AY AmSLaTeX
+.if n .ds WB Web
+.if t .ds WB W\s-2EB\s0
.\"=====================================================================
.SH NAME
-etex, einitex, evirtex \- extended TeX
+etex \- extended (plain) TeX
.SH SYNOPSIS
.B etex
.RI [ options ]
-[\fB&\fR \fIformat\fR ]
-[ \fIfile\fR | \fB\e\fR \fIcommands\fR ]
+.RI [ \fB&\fPformat ]
+.RI [ file | \fB\e\fPcommands ]
.\"=====================================================================
.SH DESCRIPTION
Run the e-\*(TX typesetter on
.IR file ,
-usually creating
+by default creating
.IR file.dvi .
If the file argument has no extension, ".tex" will be appended to it.
Instead of a filename, a set of e-\*(TX commands can be given, the first
@@ -40,7 +42,7 @@ With a
.BI & format
argument e-\*(TX uses a different set of precompiled commands,
contained in
-.IR format.fmt ;
+.IR format\fB.fmt\fP ;
it is usually better to use the
.B -fmt
.I format
@@ -61,30 +63,7 @@ several new primitives are added that facilitate (among other things)
bidirectional typesetting.
.PP
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
-.B etex
-as the extended version of
-.B tex
-and
-.B elatex
-as the extended version of
-.BR latex .
-However,
-.B eplain
-is an exception to this rule.
-.PP
-The
-.B einitex
-and
-.B evirtex
-commands are e-\*(TX's analogues to the
-.B initex
-and
-.B virtex
-commands. In this installation, they are symbolic links to the
-.B etex
-executable. These symbolic links may not exist at all.
+source file for the format with an asterisk (*).
.PP
e-\*(TX's handling of its command-line arguments is similar to that of
the other \*(TX programs in the
@@ -223,7 +202,8 @@ for the
file comment instead of the date.
.TP
.BI -output-directory \ directory
-.rb Write output files in
+.rb
+Write output files in
.I directory
instead of the current directory. Look up input files in
.I directory
@@ -324,7 +304,7 @@ expanded, not taken as part of the filename. Other programs, such as
\*(MF, do not have this problem.
.PP
.TP
-TEXMFOUTPUT
+.B TEXMFOUTPUT
Normally, e-\*(TX 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.
@@ -337,35 +317,38 @@ e-\*(TX attempts to create
.I /tmp/paper.log
(and
.IR /tmp/paper.dvi ,
-if any output is produced.)
+if any output is produced.) TEXMFOUTPUT is also checked for input
+files, as \*(TX often generates files that need to be subsequently
+read; for input, no suffixes (such as ``.tex'') are added by default,
+the input name is simply checked as given.
.TP
-TEXINPUTS
+.B TEXINPUTS
Search path for
.I \einput
and
.I \eopenin
files.
-This should probably start with ``.'', so
+This should start with ``.'', so
that user files are found before system files. An empty path
component will be replaced with the paths defined in the
.I texmf.cnf
-file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the
+file. For example, set TEXINPUTS to ".:/home/user/tex:" to prepend the
current direcory and ``/home/user/tex'' to the standard search path.
.TP
-TEXFORMATS
+.B TEXFORMATS
Search path for format files.
.TP
-TEXPOOL
+.B TEXPOOL
search path for
.B etex
internal strings.
.TP
-TEXEDIT
+.B TEXEDIT
Command template for switching to editor. The default, usually
.BR vi ,
is set when e-\*(TX is compiled.
.TP
-TFMFONTS
+.B TFMFONTS
Search path for font metric
.RI ( .tfm )
files.
@@ -420,7 +403,8 @@ file will be invalid.
.BR mf (1).
.\"=====================================================================
.SH AUTHORS
-e-\*(TX was developed by Peter Breitenlohner (and the NTS team).
+e-\*(TX was developed by Peter Breitenlohner and the NTS team; Peter
+later continued its development outside of the team.
.PP
\*(TX was designed by Donald E. Knuth,
who implemented it using his \*(WB system for Pascal programs.