version 1 showing authors affecting page license.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
ETEX |
|
|
2 |
!!!ETEX |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
ENVIRONMENT |
|
|
8 |
FILES |
|
|
9 |
BUGS |
|
|
10 |
SEE ALSO |
|
|
11 |
---- |
|
|
12 |
!!NAME |
|
|
13 |
|
|
|
14 |
|
|
|
15 |
etex, einitex, evirtex - extended TeX |
|
|
16 |
!!SYNOPSIS |
|
|
17 |
|
|
|
18 |
|
|
|
19 |
__etex__ [[''options''] [[''commands''] |
|
|
20 |
!!DESCRIPTION |
|
|
21 |
|
|
|
22 |
|
|
|
23 |
This manual page is not meant to be exhaustive. The complete |
|
|
24 |
documentation for this version of TEX can be found in the |
|
|
25 |
info file or manual ''Web2C: A TeX |
|
|
26 |
implementation''. |
|
|
27 |
|
|
|
28 |
|
|
|
29 |
e-TEX is the first concrete result of an international |
|
|
30 |
research |
|
|
31 |
|
|
|
32 |
|
|
|
33 |
e-TEX can be used in two different modes: in |
|
|
34 |
''compatibility mode'' it is supposed to be completely |
|
|
35 |
interchangable with standard TEX. In ''extended mode'' |
|
|
36 |
several new primitives are added that facilitate (among |
|
|
37 |
other things) bidirectional typesetting. |
|
|
38 |
|
|
|
39 |
|
|
|
40 |
An extended mode format is generated by prefixing the name |
|
|
41 |
of the source file for the format with an asterisk (*). Such |
|
|
42 |
formats are often prefixed with an `e', hence __etex__ as |
|
|
43 |
the extended version of __tex__ and __elatex__ as the |
|
|
44 |
extended version of __latex__. However, __eplain__ is |
|
|
45 |
an exception to this rule. |
|
|
46 |
|
|
|
47 |
|
|
|
48 |
The __einitex__ and __evirtex__ commands are e-TEX's |
|
|
49 |
analogues to the __initex__ and __virtex__ commands. |
|
|
50 |
In this installation, they are symlinks to the __etex__ |
|
|
51 |
executable. |
|
|
52 |
|
|
|
53 |
|
|
|
54 |
e-TEX's handling of its command-line arguments is similar to |
|
|
55 |
that of TEX. |
|
|
56 |
!!OPTIONS |
|
|
57 |
|
|
|
58 |
|
|
|
59 |
This version of e-TEX understands the following command line |
|
|
60 |
options. |
|
|
61 |
|
|
|
62 |
|
|
|
63 |
__--efmt__ ''format'' |
|
|
64 |
|
|
|
65 |
|
|
|
66 |
Use ''format'' as the name of the format to be used, |
|
|
67 |
instead of the name by which e-TEX was called or a |
|
|
68 |
''%'' line. |
|
|
69 |
|
|
|
70 |
|
|
|
71 |
__--file-line-error-style__ |
|
|
72 |
|
|
|
73 |
|
|
|
74 |
Print error messages in the form ''file:line:error'' |
|
|
75 |
which is similar to the way many compilers format |
|
|
76 |
them. |
|
|
77 |
|
|
|
78 |
|
|
|
79 |
__--help__ |
|
|
80 |
|
|
|
81 |
|
|
|
82 |
Print help message and exit. |
|
|
83 |
|
|
|
84 |
|
|
|
85 |
__--ini__ |
|
|
86 |
|
|
|
87 |
|
|
|
88 |
Be __einitex__, for dumping formats; this is implicitly |
|
|
89 |
true if the program is called as |
|
|
90 |
__einitex__. |
|
|
91 |
|
|
|
92 |
|
|
|
93 |
__--interaction__ ''mode'' |
|
|
94 |
|
|
|
95 |
|
|
|
96 |
Sets the interaction mode. The mode can be one of |
|
|
97 |
''batchmode'', ''nonstopmode'', ''scrollmode'', and |
|
|
98 |
''errorstopmode''. The meaning of these modes is the same |
|
|
99 |
as that of the corresponding commands. |
|
|
100 |
|
|
|
101 |
|
|
|
102 |
__--ipc__ |
|
|
103 |
|
|
|
104 |
|
|
|
105 |
Send DVI output to a socket as well as the usual output |
|
|
106 |
file. Whether this option is available is the choice of the |
|
|
107 |
installer. |
|
|
108 |
|
|
|
109 |
|
|
|
110 |
__--ipc-start__ |
|
|
111 |
|
|
|
112 |
|
|
|
113 |
As __--ipc__, and starts the server at the other end as |
|
|
114 |
well. Whether this option is available is the choice of the |
|
|
115 |
installer. |
|
|
116 |
|
|
|
117 |
|
|
|
118 |
__--kpathsea-debug__ ''bitmask'' |
|
|
119 |
|
|
|
120 |
|
|
|
121 |
Sets path searching debugging flags according to the |
|
|
122 |
bitmask. See the ''Kpathsea'' manual for |
|
|
123 |
details. |
|
|
124 |
|
|
|
125 |
|
|
|
126 |
__--maketex__ ''fmt'' |
|
|
127 |
|
|
|
128 |
|
|
|
129 |
Enable mktex''fmt'', where ''fmt'' must be one of |
|
|
130 |
''tex'' or ''tfm''. |
|
|
131 |
|
|
|
132 |
|
|
|
133 |
__--mltex__ |
|
|
134 |
|
|
|
135 |
|
|
|
136 |
Enable MLTEX extensions. |
|
|
137 |
|
|
|
138 |
|
|
|
139 |
__--no-maketex__ ''fmt'' |
|
|
140 |
|
|
|
141 |
|
|
|
142 |
Disable mktex''fmt'', where ''fmt'' must be one of |
|
|
143 |
''tex'' or ''tfm''. |
|
|
144 |
|
|
|
145 |
|
|
|
146 |
__--output-comment__ ''string'' |
|
|
147 |
|
|
|
148 |
|
|
|
149 |
Use ''string'' for the DVI file comment instead of the |
|
|
150 |
date. |
|
|
151 |
|
|
|
152 |
|
|
|
153 |
__--recorder__ |
|
|
154 |
|
|
|
155 |
|
|
|
156 |
Enable the filename recorder. This leaves a trace of the |
|
|
157 |
files opened for input and output in a file with extension |
|
|
158 |
''.fls''. |
|
|
159 |
|
|
|
160 |
|
|
|
161 |
__--progname__ ''name'' |
|
|
162 |
|
|
|
163 |
|
|
|
164 |
Pretend to be program ''name''. This affects both the |
|
|
165 |
format used and the search paths. |
|
|
166 |
|
|
|
167 |
|
|
|
168 |
__--shell-escape__ |
|
|
169 |
|
|
|
170 |
|
|
|
171 |
Enable the __write18{__''command''__}__ construct. |
|
|
172 |
The ''command'' can be any Bourne shell command. This |
|
|
173 |
construct is normally disallowed for security |
|
|
174 |
reasons. |
|
|
175 |
|
|
|
176 |
|
|
|
177 |
__--translate-file__ ''tcxname'' |
|
|
178 |
|
|
|
179 |
|
|
|
180 |
Use the ''tcxname'' translation table. |
|
|
181 |
|
|
|
182 |
|
|
|
183 |
__--version__ |
|
|
184 |
|
|
|
185 |
|
|
|
186 |
Print version information and exit. |
|
|
187 |
!!ENVIRONMENT |
|
|
188 |
|
|
|
189 |
|
|
|
190 |
See the Kpathsearch library documentation (the `Path |
|
|
191 |
specifications' node) for precise details of how the |
|
|
192 |
environment variables are used. The __kpsewhich__ utility |
|
|
193 |
can be used to query the values of the |
|
|
194 |
variables. |
|
|
195 |
|
|
|
196 |
|
|
|
197 |
One caveat: In most e-TEX formats, you cannot use ~ in a |
|
|
198 |
filename you give directly to e-TEX, because ~ is an active |
|
|
199 |
character, and hence is expanded, not taken as part of the |
|
|
200 |
filename. Other programs, such as M ETAFONT , |
|
|
201 |
do not have this problem. |
|
|
202 |
|
|
|
203 |
|
|
|
204 |
TEXMFOUTPUT |
|
|
205 |
|
|
|
206 |
|
|
|
207 |
Normally, e-TEX puts its output files in the current |
|
|
208 |
directory. If any output file cannot be opened there, it |
|
|
209 |
tries to open it in the directory specified in the |
|
|
210 |
environment variable TEXMFOUTPUT. There is no default value |
|
|
211 |
for that variable. For example, if you say ''tex paper'' |
|
|
212 |
and the current directory is not writable, if TEXMFOUTPUT |
|
|
213 |
has the value ''/tmp'', e-TEX attempts to create |
|
|
214 |
''/tmp/paper.log'' (and ''/tmp/paper.dvi'', if any |
|
|
215 |
output is produced.) |
|
|
216 |
|
|
|
217 |
|
|
|
218 |
TEXINPUTS |
|
|
219 |
|
|
|
220 |
|
|
|
221 |
Search path for ''input'' and ''openin'' files. This |
|
|
222 |
should probably start with ``.'', so that user files are |
|
|
223 |
found before system files. An empty path component will be |
|
|
224 |
replaced with the paths defined in the ''texmf.cnf'' |
|
|
225 |
file. For example, set TEXINPUTS to |
|
|
226 |
'' |
|
|
227 |
|
|
|
228 |
|
|
|
229 |
TEXFONTS |
|
|
230 |
|
|
|
231 |
|
|
|
232 |
Search path for font metric (''.tfm'') |
|
|
233 |
files. |
|
|
234 |
|
|
|
235 |
|
|
|
236 |
TEXFORMATS |
|
|
237 |
|
|
|
238 |
|
|
|
239 |
Search path for format files. |
|
|
240 |
|
|
|
241 |
|
|
|
242 |
TEXPOOL |
|
|
243 |
|
|
|
244 |
|
|
|
245 |
search path for __einitex__ internal |
|
|
246 |
strings. |
|
|
247 |
|
|
|
248 |
|
|
|
249 |
TEXEDIT |
|
|
250 |
|
|
|
251 |
|
|
|
252 |
Command template for switching to editor. The default, |
|
|
253 |
usually __vi__, is set when e-TEX is |
|
|
254 |
compiled. |
|
|
255 |
!!FILES |
|
|
256 |
|
|
|
257 |
|
|
|
258 |
The location of the files mentioned below varies from system |
|
|
259 |
to system. Use the __kpsewhich__ utility to find their |
|
|
260 |
locations. |
|
|
261 |
|
|
|
262 |
|
|
|
263 |
''etex.pool'' |
|
|
264 |
|
|
|
265 |
|
|
|
266 |
Encoded text of e-TEX's messages. |
|
|
267 |
|
|
|
268 |
|
|
|
269 |
''texfonts.map'' |
|
|
270 |
|
|
|
271 |
|
|
|
272 |
Filename mapping definitions. |
|
|
273 |
|
|
|
274 |
|
|
|
275 |
''*.tfm'' |
|
|
276 |
|
|
|
277 |
|
|
|
278 |
Metric files for e-TEX's fonts. |
|
|
279 |
|
|
|
280 |
|
|
|
281 |
''*.efmt'' |
|
|
282 |
|
|
|
283 |
|
|
|
284 |
Predigested e-TEX format (.efmt) files. |
|
|
285 |
!!BUGS |
|
|
286 |
|
|
|
287 |
|
|
|
288 |
This version of e-TEX fails to trap arithmetic overflow when |
|
|
289 |
dimensions are added or subtracted. Cases where this occurs |
|
|
290 |
are rare, but when it does the generated ''DVI'' file |
|
|
291 |
will be invalid. |
|
|
292 |
!!SEE ALSO |
|
|
293 |
|
|
|
294 |
|
|
|
295 |
tex(1), mf(1). |
|
|
296 |
---- |