Penguin
Recent Changes
Annotated edit history of elatex(1) version 1, including all changes. View license author blame.
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 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.