Debian Codegraph @

texmf-dist/doc/web2c/web2c.html

raw
1 <!DOCTYPE html>
2 <html>
3 <!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6 <!-- This file documents the installation and use of the programs in Web2c,
7 an implementation of Donald Knuth's TeX system.
8
9 Copyright © 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
10 2004, 2005, 2007, 2008, 2009, 2010-2026 Karl Berry & Olaf Weber.
11
12 Permission is granted to make and distribute verbatim copies of this
13 manual provided the copyright notice and this permission notice are
14 preserved on all copies.
15
16
17 Permission is granted to copy and distribute modified versions of this
18 manual under the conditions for verbatim copying, provided that the
19 entire resulting derived work is distributed under the terms of a
20 permission notice identical to this one.
21
22 Permission is granted to copy and distribute translations of this manual
23 into another language, under the above conditions for modified versions,
24 except that this permission notice may be stated in a translation -->
25 <title>Web2c: A TeX implementation</title>
26
27 <meta name="description" content="Web2c: A TeX implementation">
28 <meta name="keywords" content="Web2c: A TeX implementation">
29 <meta name="resource-type" content="document">
30 <meta name="distribution" content="global">
31 <meta name="Generator" content="makeinfo">
32 <meta name="viewport" content="width=device-width,initial-scale=1">
33
34 <link href="#Top" rel="start" title="Top">
35 <link href="#Index" rel="index" title="Index">
36 <link href="#SEC_Contents" rel="contents" title="Table of Contents">
37 <link href="http://tug.org/texinfohtml" rel="up" title="(dir)">
38 <link href="#Introduction" rel="next" title="Introduction">
39 <style type="text/css">
40 <!--
41 a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
42 a.summary-letter-printindex {text-decoration: none}
43 div.example {margin-left: 3.2em}
44 kbd.kbd {font-style: oblique}
45 span.r {font-family: initial; font-weight: normal; font-style: normal}
46 span:hover a.copiable-link {visibility: visible}
47 td.printindex-index-entry {vertical-align: top}
48 td.printindex-index-section {vertical-align: top; padding-left: 1em}
49 th.entries-header-printindex {text-align:left}
50 th.sections-header-printindex {text-align:left; padding-left: 1em}
51 ul.mark-bullet {list-style-type: disc}
52 ul.toc-numbered-mark {list-style: none}
53 -->
54 </style>
55
56
57 </head>
58
59 <body lang="en">
60
61
62
63
64
65
66
67
68
69
70 <div class="top-level-extent" id="Top">
71 <div class="nav-panel">
72 <p>
73 Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
74 </div>
75 <h1 class="top" id="Web2c"><span>Web2c<a class="copiable-link" href="#Web2c"> &para;</a></span></h1>
76
77 <p>This document describes how to install and use the programs in the Web2c
78 implementation of the TeX system, especially for Unix systems. It
79 corresponds to Web2c version 2026, released in
80 January 2026.
81 </p>
82
83
84 <div class="region-contents" id="SEC_Contents">
85 <h2 class="contents-heading">Table of Contents</h2>
86
87 <div class="contents">
88
89 <ul class="toc-numbered-mark">
90 <li><a id="toc-Introduction" href="#Introduction">1 Introduction</a></li>
91 <li><a id="toc-Installation" href="#Installation">2 Installation</a>
92 <ul class="toc-numbered-mark">
93 <li><a id="toc-configure-options" href="#configure-options">2.1 <code class="code">configure</code> options</a></li>
94 <li><a id="toc-Compile_002dtime-options" href="#Compile_002dtime-options">2.2 Compile-time options</a></li>
95 <li><a id="toc-Additional-targets" href="#Additional-targets">2.3 Additional targets</a></li>
96 <li><a id="toc-Trip_002c-trap_002c-and-mptrap_003a-Torture-tests" href="#Triptrap">2.4 Trip, trap, and mptrap: Torture tests</a></li>
97 </ul></li>
98 <li><a id="toc-Commonalities" href="#Commonalities">3 Commonalities</a>
99 <ul class="toc-numbered-mark">
100 <li><a id="toc-Option-conventions" href="#Option-conventions">3.1 Option conventions</a></li>
101 <li><a id="toc-Common-options" href="#Common-options">3.2 Common options</a></li>
102 <li><a id="toc-Path-searching" href="#Path-searching">3.3 Path searching</a></li>
103 <li><a id="toc-Output-file-location" href="#Output-file-location">3.4 Output file location</a></li>
104 </ul></li>
105 <li><a id="toc-Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX" href="#Three-programs">4 Three programs: Metafont, MetaPost, and TeX</a>
106 <ul class="toc-numbered-mark">
107 <li><a id="toc-Runtime-options" href="#Runtime-options">4.1 Runtime options</a></li>
108 <li><a id="toc-Initial-and-virgin" href="#Initial-and-virgin">4.2 Initial and virgin</a></li>
109 <li><a id="toc-Memory-dumps" href="#Memory-dumps">4.3 Memory dumps</a>
110 <ul class="toc-numbered-mark">
111 <li><a id="toc-Creating-memory-dumps" href="#Creating-memory-dumps">4.3.1 Creating memory dumps</a></li>
112 <li><a id="toc-Determining-the-memory-dump-to-use" href="#Determining-the-memory-dump-to-use">4.3.2 Determining the memory dump to use</a></li>
113 <li><a id="toc-Hardware-and-memory-dumps" href="#Hardware-and-memory-dumps">4.3.3 Hardware and memory dumps</a></li>
114 </ul></li>
115 <li><a id="toc-Editor-invocation" href="#Editor-invocation">4.4 Editor invocation</a></li>
116 <li><a id="toc-_005cinput-filenames" href="#g_t_005cinput-filenames">4.5 <code class="code">\input</code> filenames</a>
117 <ul class="toc-numbered-mark">
118 <li><a id="toc-_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022" href="#g_t_005cinput-quoted-filename">4.5.1 <code class="code">\input</code> quoted filename: <code class="code">\input &quot;some name&quot;</code></a></li>
119 <li><a id="toc-_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d" href="#g_t_005cinput-braced-filename">4.5.2 <code class="code">\input</code> braced filename: <code class="code">\input{some name}</code></a></li>
120 <li><a id="toc-_005cinput-filename-caveats" href="#g_t_005cinput-filename-caveats">4.5.3 <code class="code">\input</code> filename caveats</a></li>
121 </ul></li>
122 </ul></li>
123 <li><a id="toc-TeX_003a-Typesetting" href="#TeX">5 TeX: Typesetting</a>
124 <ul class="toc-numbered-mark">
125 <li><a id="toc-tex-invocation" href="#tex-invocation">5.1 <code class="code">tex</code> invocation</a></li>
126 <li><a id="toc-Initial-TeX" href="#Initial-TeX">5.2 Initial TeX</a></li>
127 <li><a id="toc-Formats" href="#Formats">5.3 Formats</a></li>
128 <li><a id="toc-Languages-and-hyphenation" href="#Languages-and-hyphenation">5.4 Languages and hyphenation</a>
129 <ul class="toc-numbered-mark">
130 <li><a id="toc-MLTeX_003a-Multi_002dlingual-TeX" href="#MLTeX">5.4.1 MLTeX: Multi-lingual TeX</a>
131 <ul class="toc-numbered-mark">
132 <li><a id="toc-_005ccharsubdef_003a-Character-substitutions" href="#g_t_005ccharsubdef">5.4.1.1 <code class="code">\charsubdef</code>: Character substitutions</a></li>
133 <li><a id="toc-_005ctracingcharsubdef_003a-Substitution-diagnostics" href="#g_t_005ctracingcharsubdef">5.4.1.2 <code class="code">\tracingcharsubdef</code>: Substitution diagnostics</a></li>
134 </ul></li>
135 <li><a id="toc-TCX-files_003a-Character-translations" href="#TCX-files">5.4.2 TCX files: Character translations</a></li>
136 <li><a id="toc-Patgen_003a-Creating-hyphenation-patterns" href="#patgen-invocation">5.4.3 Patgen: Creating hyphenation patterns</a></li>
137 </ul></li>
138 <li><a id="toc-Shell-escapes" href="#Shell-escapes">5.5 Shell escapes</a></li>
139 <li><a id="toc-IPC-and-TeX" href="#IPC-and-TeX">5.6 IPC and TeX</a></li>
140 <li><a id="toc-Extended-TeX-engines" href="#TeX-extensions">5.7 Extended TeX engines</a></li>
141 </ul></li>
142 <li><a id="toc-Metafont_003a-Creating-typeface-families" href="#Metafont">6 Metafont: Creating typeface families</a>
143 <ul class="toc-numbered-mark">
144 <li><a id="toc-mf-invocation" href="#mf-invocation">6.1 <code class="code">mf</code> invocation</a></li>
145 <li><a id="toc-Initial-Metafont" href="#Initial-Metafont">6.2 Initial Metafont</a></li>
146 <li><a id="toc-Modes_003a-Device-definitions-for-Metafont" href="#Modes">6.3 Modes: Device definitions for Metafont</a></li>
147 <li><a id="toc-Online-Metafont-graphics" href="#Online-Metafont-graphics">6.4 Online Metafont graphics</a></li>
148 <li><a id="toc-GFtoDVI_003a-Character-proofs-of-fonts" href="#gftodvi-invocation">6.5 GFtoDVI: Character proofs of fonts</a></li>
149 <li><a id="toc-MFT_003a-Prettyprinting-Metafont-source" href="#mft-invocation">6.6 MFT: Prettyprinting Metafont source</a></li>
150 </ul></li>
151 <li><a id="toc-MetaPost_003a-Generating-PostScript" href="#MetaPost">7 MetaPost: Generating PostScript</a>
152 <ul class="toc-numbered-mark">
153 <li><a id="toc-mpost-invocation" href="#mpost-invocation">7.1 <code class="code">mpost</code> invocation</a></li>
154 <li><a id="toc-Initial-MetaPost" href="#Initial-MetaPost">7.2 Initial MetaPost</a></li>
155 <li><a id="toc-DVItoMP_003a-DVI-to-MPX-conversion" href="#dvitomp-invocation">7.3 DVItoMP: DVI to MPX conversion</a></li>
156 </ul></li>
157 <li><a id="toc-BibTeX_003a-Bibliographies" href="#BibTeX">8 BibTeX: Bibliographies</a>
158 <ul class="toc-numbered-mark">
159 <li><a id="toc-BibTeX-invocation" href="#bibtex-invocation">8.1 BibTeX invocation</a></li>
160 <li><a id="toc-Basic-BibTeX-style-files" href="#Basic-BibTeX-style-files">8.2 Basic BibTeX style files</a></li>
161 </ul></li>
162 <li><a id="toc-WEB_003a-Literate-programming" href="#WEB">9 WEB: Literate programming</a>
163 <ul class="toc-numbered-mark">
164 <li><a id="toc-Tangle_003a-Translate-WEB-to-Pascal" href="#tangle-invocation">9.1 Tangle: Translate WEB to Pascal</a></li>
165 <li><a id="toc-Weave_003a-Translate-WEB-to-TeX" href="#weave-invocation">9.2 Weave: Translate WEB to TeX</a></li>
166 <li><a id="toc-Pooltype_003a-Display-WEB-pool-files" href="#pooltype-invocation">9.3 Pooltype: Display WEB pool files</a></li>
167 </ul></li>
168 <li><a id="toc-DVI-utilities" href="#DVI-utilities">10 DVI utilities</a>
169 <ul class="toc-numbered-mark">
170 <li><a id="toc-DVIcopy_003a-Canonicalize-virtual-font-references" href="#dvicopy-invocation">10.1 DVIcopy: Canonicalize virtual font references</a></li>
171 <li><a id="toc-DVItype_003a-Plain-text-transliteration-of-DVI-files" href="#dvitype-invocation">10.2 DVItype: Plain text transliteration of DVI files</a>
172 <ul class="toc-numbered-mark">
173 <li><a id="toc-DVItype-output-example" href="#dvitype-output-example">10.2.1 DVItype output example</a></li>
174 </ul></li>
175 </ul></li>
176 <li><a id="toc-Font-utilities" href="#Font-utilities">11 Font utilities</a>
177 <ul class="toc-numbered-mark">
178 <li><a id="toc-Font-file-formats" href="#Font-file-formats">11.1 Font file formats</a></li>
179 <li><a id="toc-GFtoPK_003a-Generic-to-packed-font-conversion" href="#gftopk-invocation">11.2 GFtoPK: Generic to packed font conversion</a></li>
180 <li><a id="toc-PKtoGF_003a-Packed-to-generic-font-conversion" href="#pktogf-invocation">11.3 PKtoGF: Packed to generic font conversion</a></li>
181 <li><a id="toc-PKtype_003a-Plain-text-transliteration-of-packed-fonts" href="#pktype-invocation">11.4 PKtype: Plain text transliteration of packed fonts</a></li>
182 <li><a id="toc-GFtype_003a-Plain-text-transliteration-of-generic-fonts" href="#gftype-invocation">11.5 GFtype: Plain text transliteration of generic fonts</a></li>
183 <li><a id="toc-TFtoPL_003a-TeX-font-metric-to-property-list-conversion" href="#tftopl-invocation">11.6 TFtoPL: TeX font metric to property list conversion</a></li>
184 <li><a id="toc-PLtoTF_003a-Property-list-to-TeX-font-metric-conversion" href="#pltotf-invocation">11.7 PLtoTF: Property list to TeX font metric conversion</a></li>
185 <li><a id="toc-VFtoVP_003a-Virtual-font-to-virtual-property-lists" href="#vftovp-invocation">11.8 VFtoVP: Virtual font to virtual property lists</a></li>
186 <li><a id="toc-VPtoVF_003a-Virtual-property-lists-to-virtual-font" href="#vptovf-invocation">11.9 VPtoVF: Virtual property lists to virtual font</a></li>
187 <li><a id="toc-Font-utilities-available-elsewhere" href="#Font-utilities-available-elsewhere">11.10 Font utilities available elsewhere</a></li>
188 </ul></li>
189 <li><a id="toc-Legalisms" href="#Legalisms">Appendix A Legalisms</a></li>
190 <li><a id="toc-References" href="#References">Appendix B References</a></li>
191 <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
192 </ul>
193 </div>
194 </div>
195 <hr>
196 <div class="chapter-level-extent" id="Introduction">
197 <div class="nav-panel">
198 <p>
199 Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Web2c</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
200 </div>
201 <h2 class="chapter" id="Introduction-1"><span>1 Introduction<a class="copiable-link" href="#Introduction-1"> &para;</a></span></h2>
202
203 <a class="index-entry-id" id="index-introduction"></a>
204
205 <p>This manual corresponds to version 2026 of Web2c, released in
206 January 2026.
207 </p>
208 <a class="index-entry-id" id="index-Knuth_002c-Donald-E_002e"></a>
209 <a class="index-entry-id" id="index-TeX_002c-Web2c-implementation-of"></a>
210 <a class="index-entry-id" id="index-Hobby_002c-John"></a>
211 <a class="index-entry-id" id="index-Breitenlohner_002c-Peter"></a>
212 <p><em class="dfn">Web2c</em> (also spelled Web2C) is the name of a TeX
213 implementation, originally for Unix, but now also running under
214 Windows and other operating systems. By <em class="dfn">TeX implementation</em>,
215 we mean all of the standard programs developed by the Stanford TeX
216 project led by Donald&nbsp;E. Knuth: Metafont, DVItype, GFtoDVI,
217 BibTeX, Tangle, etc., as well as TeX itself. Other programs are
218 also included: DVIcopy, written by Peter Breitenlohner, MetaPost and
219 its utilities (derived from Metafont), by John Hobby, and many more.
220 </p>
221 <a class="index-entry-id" id="index-translation-from-WEB-to-C"></a>
222 <a class="index-entry-id" id="index-strategy_002c-overall"></a>
223 <p>General strategy: Web2c works, as its name implies, by translating the
224 WEB source in which TeX is written into C source code. Its output is
225 not self-contained, however; it makes extensive use of many macros and
226 functions in a library (the <samp class="file">web2c/lib</samp> directory in the sources).
227 Therefore, it will not work without change on an arbitrary WEB program.
228 </p>
229 <a class="index-entry-id" id="index-licensing-terms"></a>
230 <a class="index-entry-id" id="index-freedom-of-Web2c"></a>
231 <a class="index-entry-id" id="index-ice-cream"></a>
232 <p>Availability: All of Web2c is freely available&mdash;&ldquo;free&rdquo; both in the
233 sense of no cost (free ice cream) and of having the source code to
234 modify and/or redistribute (free speech). See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite class="cite">Kpathsea</cite>, for the practical details of how to obtain Web2c.
235 </p>
236 <p>Different parts of the Web2c distribution have different licensing
237 terms, however, reflecting the different circumstances of their
238 creation; consult each source file for exact details. The main
239 practical implication for redistributors of Web2c is that most of the
240 executables are covered by the GNU General Public License or GNU
241 Lesser General Public License, and therefore anyone who gets a binary
242 distribution must also be able to get the sources, as explained by the
243 terms of the GPL (<a class="url" href="https://gnu.org/licenses/">https://gnu.org/licenses/</a>). The GPL covers the
244 Web2c executables, including <code class="code">tex</code>, because the Free Software
245 Foundation sponsored the initial development of the Kpathsea library
246 that Web2c uses. The basic source files from Stanford, however, have
247 their own copyright terms or are in the public domain, and are not
248 covered by the GPL.
249 </p>
250 <a class="index-entry-id" id="index-history"></a>
251 <a class="index-entry-id" id="index-Rokicki_002c-Tomas"></a>
252 <a class="index-entry-id" id="index-Trickey_002c-Howard"></a>
253 <a class="index-entry-id" id="index-Curtis_002c-Pavel"></a>
254 <a class="index-entry-id" id="index-Morgan_002c-Tim"></a>
255 <a class="index-entry-id" id="index-Berry_002c-Karl"></a>
256 <a class="index-entry-id" id="index-Weber_002c-Olaf"></a>
257 <p>History: Tomas Rokicki originated the TeX-to-C system in 1987,
258 working from the first change files for TeX under Unix, which were
259 done primarily by Howard Trickey and Pavel Curtis. Tim Morgan then
260 took over development and maintenance for a number of years; the name
261 changed to Web-to-C somewhere in there. In 1990, Karl Berry became
262 the maintainer. He made many changes to the original sources, and
263 started using the shorter name Web2c. In 1997, Olaf Weber took over,
264 and then in 2006, Karl started taking care of it again. No
265 significant development or changes have been needed for many years,
266 though dozens of other people have contributed in many ways; their
267 names are listed in the <samp class="file">ChangeLog</samp> files.
268 </p>
269 <a class="index-entry-id" id="index-teTeX-distribution"></a>
270 <p>Originally, Web2c was distributed as its own package, alongside the
271 original web programs from Stanford and other components. It was also
272 the basis for the teTeX distribution (now discontinued). Around
273 2004, the packaging focus shifted entirely to the TeX Live
274 distribution (<a class="url" href="https://tug.org/texlive/">https://tug.org/texlive/</a>), though the same Web2c
275 is at the heart of the release.
276 </p>
277 <a class="index-entry-id" id="index-acknowledgements"></a>
278 <a class="index-entry-id" id="index-Martin_002c-Rick"></a>
279 <a class="index-entry-id" id="index-Morris_002c-Bob"></a>
280 <a class="index-entry-id" id="index-Stallman_002c-Richard"></a>
281 <p>Other acknowledgements by Karl: The University of Massachusetts at Boston
282 (particularly Rick Martin and Bob Morris) provided computers and ftp
283 access to me for many years. Richard Stallman at the Free Software
284 Foundation employed me while I wrote the original path searching library
285 (for the GNU font utilities). (rms also gave us Emacs, GDB, and GCC,
286 without which I cannot imagine developing Web2c.) And, of course,
287 TeX would not exist in the first place without Donald&nbsp;E. Knuth.
288 </p>
289 <a class="index-entry-id" id="index-reading_002c-additional"></a>
290 <p>Further reading: See <a class="xref" href="#References">References</a>.
291 </p>
292
293
294 <hr>
295 </div>
296 <div class="chapter-level-extent" id="Installation">
297 <div class="nav-panel">
298 <p>
299 Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
300 </div>
301 <h2 class="chapter" id="Installation-1"><span>2 Installation<a class="copiable-link" href="#Installation-1"> &para;</a></span></h2>
302
303 <a class="index-entry-id" id="index-configuration"></a>
304 <a class="index-entry-id" id="index-compilation"></a>
305 <a class="index-entry-id" id="index-installation"></a>
306
307 <p>(A copy of this chapter is in the distribution file <samp class="file">web2c/INSTALL</samp>.)
308 </p>
309 <p>Installing Web2c is mostly the same as installing any other
310 Kpathsea-using program. Therefore, for the basic steps involved,
311 see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite class="cite">Kpathsea</cite>. (A copy is in the file
312 <samp class="file">kpathsea/INSTALL</samp>.)
313 </p>
314 <p>One peculiarity to Web2c is that the source distribution comes in two
315 files: <samp class="file">web.tar.gz</samp> and <samp class="file">web2c.tar.gz</samp>. You must retrieve and
316 unpack them both. (We have two because the former archive contains the
317 very large and seldom-changing original WEB source files.)
318 See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite class="cite">Kpathsea</cite>.
319 </p>
320 <a class="index-entry-id" id="index-mpost_002c-reason-for-name-change"></a>
321 <p>Another peculiarity is the MetaPost program. Although it has been
322 installed previously as <code class="code">mp</code>, as of Web2c 7.0 the installed name is
323 now <code class="code">mpost</code>, to avoid conflict with the <code class="code">mp</code> program that does
324 prettyprinting. This approach was recommended by the MetaPost author,
325 John Hobby. If you as the TeX administrator wish to make it
326 available under its shorter name as well, you will have to set up a link
327 or some such yourself. And of course individual users can do the same.
328 </p>
329 <p>For solutions to common installation problems and information on how to
330 report a bug, see the file <samp class="file">kpathsea/BUGS</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite class="cite">Kpathsea</cite>). See also the Web2c home page,
331 <a class="url" href="http://www.tug.org/web2c">http://www.tug.org/web2c</a>.
332 </p>
333 <p>Points worth repeating:
334 </p>
335 <ul class="itemize mark-bullet">
336 <li><a class="index-entry-id" id="index-directory-structure"></a>
337 <a class="index-entry-id" id="index-basic-fonts-and-macros"></a>
338 <a class="index-entry-id" id="index-fonts_002c-basic"></a>
339 <a class="index-entry-id" id="index-macros_002c-basic"></a>
340 Before starting the standard compilation and installation you must
341 install the basic fonts, macros, and other library files.
342 See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite class="cite">Kpathsea</cite>.
343
344 </li><li>If you do not wish to use the standard file locations, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing
345 search paths</a> in <cite class="cite">Kpathsea</cite>.
346
347 </li><li>Some Web2c features are enabled or disabled at <code class="code">configure</code> time,
348 as described in the first section below.
349
350 </li></ul>
351
352
353
354 <ul class="mini-toc">
355 <li><a href="#configure-options" accesskey="1"><code class="code">configure</code> options</a></li>
356 <li><a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a></li>
357 <li><a href="#Additional-targets" accesskey="3">Additional targets</a></li>
358 <li><a href="#Triptrap" accesskey="4">Trip, trap, and mptrap: Torture tests</a></li>
359 </ul>
360 <hr>
361 <div class="section-level-extent" id="configure-options">
362 <div class="nav-panel">
363 <p>
364 Next: <a href="#Compile_002dtime-options" accesskey="n" rel="next">Compile-time options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
365 </div>
366 <h3 class="section" id="configure-options-1"><span>2.1 <code class="code">configure</code> options<a class="copiable-link" href="#configure-options-1"> &para;</a></span></h3>
367
368 <a class="index-entry-id" id="index-configuration_002c-compile_002dtime"></a>
369 <a class="index-entry-id" id="index-compile_002dtime-options"></a>
370 <a class="index-entry-id" id="index-configure-_002d_002dwith_002f_002d_002denable-options"></a>
371 <p>This section gives pointers to descriptions of the &lsquo;<samp class="samp">--with</samp>&rsquo; and
372 &lsquo;<samp class="samp">--enable</samp>&rsquo; <code class="code">configure</code> arguments that Web2c accepts. Some are
373 specific to Web2c, others are generic to all Kpathsea-using programs.
374 </p>
375 <p>For a list of all the options <code class="code">configure</code> accepts, run
376 &lsquo;<samp class="samp">configure --help</samp>&rsquo;. The generic options are listed first, and the
377 package-specific options come last.
378 </p>
379 <p>For a description of the generic options (which mainly allow you to
380 specify installation directories) and basic <code class="code">configure</code> usage,
381 see <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code class="code">configure</code> scripts</a> in <cite class="cite">Autoconf</cite>, a copy is in the file <samp class="file">kpathsea/CONFIGURE</samp>.
382 </p>
383 <dl class="table">
384 <dt>&lsquo;<samp class="samp">--disable-dump-share</samp>&rsquo;</dt>
385 <dd><p>Do not make fmt/base/mem files sharable across different endian
386 architectures. See <a class="xref" href="#Hardware-and-memory-dumps">Hardware and memory dumps</a>.
387 </p>
388 </dd>
389 <dt>&lsquo;<samp class="samp">--without-maketexmf-default</samp>&rsquo;</dt>
390 <dt>&lsquo;<samp class="samp">--without-maketexpk-default</samp>&rsquo;</dt>
391 <dt>&lsquo;<samp class="samp">--without-maketextfm-default</samp>&rsquo;</dt>
392 <dt>&lsquo;<samp class="samp">--with-maketextex-default</samp>&rsquo;</dt>
393 <dd><p>Enable or disable the dynamic generation programs. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex
394 configuration</a> in <cite class="cite">Kpathsea</cite>. The defaults are the inverse of
395 the options, i.e., everything is enabled except <code class="code">mktextex</code>.
396 </p>
397 </dd>
398 <dt>&lsquo;<samp class="samp">--enable-shared</samp>&rsquo;</dt>
399 <dd><p>Build Kpathsea as a shared library. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite class="cite">Kpathsea</cite>.
400 </p>
401 </dd>
402 <dt>&lsquo;<samp class="samp">--with-editor=<var class="var">cmd</var></samp>&rsquo;</dt>
403 <dd><p>Change the default editor invoked by the &lsquo;<samp class="samp">e</samp>&rsquo; interactive command.
404 See <a class="xref" href="#Editor-invocation">Editor invocation</a>.
405 </p>
406 </dd>
407 <dt>&lsquo;<samp class="samp">--with-epsfwin</samp>&rsquo;</dt>
408 <dt>&lsquo;<samp class="samp">--with-hp2627win</samp>&rsquo;</dt>
409 <dt>&lsquo;<samp class="samp">--with-mftalkwin</samp>&rsquo;</dt>
410 <dt>&lsquo;<samp class="samp">--with-nextwin</samp>&rsquo;</dt>
411 <dt>&lsquo;<samp class="samp">--with-regiswin</samp>&rsquo;</dt>
412 <dt>&lsquo;<samp class="samp">--with-suntoolswin</samp>&rsquo;</dt>
413 <dt>&lsquo;<samp class="samp">--with-tektronixwin</samp>&rsquo;</dt>
414 <dt>&lsquo;<samp class="samp">--with-unitermwin</samp>&rsquo;</dt>
415 <dt>&lsquo;<samp class="samp">--with-x</samp>&rsquo;</dt>
416 <dt>&lsquo;<samp class="samp">--with-x-toolkit=KIT</samp>&rsquo;</dt>
417 <dt>&lsquo;<samp class="samp">--with-x11win</samp>&rsquo;</dt>
418 <dt>&lsquo;<samp class="samp">--with-x11</samp>&rsquo;</dt>
419 <dd><p>Define Metafont graphics support; by default, no graphics support is
420 enabled. See <a class="xref" href="#Online-Metafont-graphics">Online Metafont graphics</a>.
421 </p>
422 </dd>
423 <dt>&lsquo;<samp class="samp">--x-includes=<var class="var">dir</var></samp>&rsquo;</dt>
424 <dt>&lsquo;<samp class="samp">--x-libraries=<var class="var">dir</var></samp>&rsquo;</dt>
425 <dd><p>Define the locations of the X11 include files and libraries; by default,
426 <code class="code">configure</code> does its best to guess). See <a data-manual="autoconf" href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite class="cite">Autoconf</cite>. A copy is in <samp class="file">kpathsea/CONFIGURE</samp>.
427 </p></dd>
428 </dl>
429
430
431 <hr>
432 </div>
433 <div class="section-level-extent" id="Compile_002dtime-options">
434 <div class="nav-panel">
435 <p>
436 Next: <a href="#Additional-targets" accesskey="n" rel="next">Additional targets</a>, Previous: <a href="#configure-options" accesskey="p" rel="prev"><code class="code">configure</code> options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
437 </div>
438 <h3 class="section" id="Compile_002dtime-options-1"><span>2.2 Compile-time options<a class="copiable-link" href="#Compile_002dtime-options-1"> &para;</a></span></h3>
439
440 <a class="index-entry-id" id="index-compile_002dtime-options-1"></a>
441 <a class="index-entry-id" id="index-_0023define-options"></a>
442 <a class="index-entry-id" id="index-_002dD-compiler-options"></a>
443 <p>In addition to the <code class="code">configure</code> options listed in the previous
444 section, there are a few things that can be affected at compile-time
445 with C definitions, rather than with <code class="code">configure</code>. Using any of
446 these is unusual.
447 </p>
448 <p>To specify extra compiler flags (&lsquo;<samp class="samp">-D<var class="var">name</var></samp>&rsquo; in this case), the
449 simplest thing to do is:
450 </p><div class="example">
451 <pre class="example-preformatted">make XCFLAGS=&quot;<var class="var">ccoptions</var>&quot;
452 </pre></div>
453 <p>You can also set the <code class="code">CFLAGS</code> environment variable before
454 running <code class="code">configure</code>. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite class="cite">Kpathsea</cite>.
455 </p>
456 <p>Anyway, here are the possibilities:
457 </p>
458 <dl class="table">
459 <dt><a class="index-entry-id" id="index-fixed_002dpoint-arithmetic"></a>
460 <a class="index-entry-id" id="index-floating_002dpoint-arithmetic"></a>
461 <a class="index-entry-id" id="index-assembly-language-routines"></a>
462 <a class="index-entry-id" id="index-fraction-routines"></a>
463 <a id="index-FIXPT"></a><span>&lsquo;<samp class="samp">-DFIXPT</samp>&rsquo;<a class="copiable-link" href="#index-FIXPT"> &para;</a></span></dt>
464 <dt>&lsquo;<samp class="samp">-DNO_MF_ASM</samp>&rsquo;</dt>
465 <dd><p>Use the original WEB fixed-point routines for Metafont and MetaPost
466 arithmetic calculations regarding fractions. By default,
467 assembly-language routines are used on x86 hardware with GNU C (unless
468 &lsquo;<samp class="samp">NO_MF_ASM</samp>&rsquo; is defined), and floating-point routines are used
469 otherwise.
470 </p>
471 </dd>
472 <dt><a id="index-IPC_005fDEBUG"></a><span>&lsquo;<samp class="samp">-DIPC_DEBUG</samp>&rsquo;<a class="copiable-link" href="#index-IPC_005fDEBUG"> &para;</a></span></dt>
473 <dd><p>Report on various interprocess communication activities. See <a class="xref" href="#IPC-and-TeX">IPC and TeX</a>.
474 </p></dd>
475 </dl>
476
477
478 <hr>
479 </div>
480 <div class="section-level-extent" id="Additional-targets">
481 <div class="nav-panel">
482 <p>
483 Next: <a href="#Triptrap" accesskey="n" rel="next">Trip, trap, and mptrap: Torture tests</a>, Previous: <a href="#Compile_002dtime-options" accesskey="p" rel="prev">Compile-time options</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
484 </div>
485 <h3 class="section" id="Additional-targets-1"><span>2.3 Additional targets<a class="copiable-link" href="#Additional-targets-1"> &para;</a></span></h3>
486
487 <a class="index-entry-id" id="index-additional-Make-targets"></a>
488 <a class="index-entry-id" id="index-targets_002c-additional-Make"></a>
489 <a class="index-entry-id" id="index-Make-targets_002c-additional"></a>
490
491 <p>Web2c has several Make targets besides the standard ones. You can invoke
492 these either in the top level directory of the source distribution (the
493 one containing <samp class="file">kpathsea/</samp> and <samp class="file">web2c/</samp>), or in the
494 <samp class="file">web2c/</samp> directory.
495 </p>
496 <dl class="table">
497 <dt><a class="index-entry-id" id="index-non_002dUnix-system_002c-compiling-on"></a>
498 <a id="index-c_002dsources-Makefile-target"></a><span>&lsquo;<samp class="samp">c-sources</samp>&rsquo;<a class="copiable-link" href="#index-c_002dsources-Makefile-target"> &para;</a></span></dt>
499 <dd><p>Make only the C files, translated from the Web sources, presumably
500 because you want to take them to a non-Unix machine.
501 </p>
502 </dd>
503 <dt><a class="index-entry-id" id="index-install_002dformats-Make-target"></a>
504 <a id="index-formats-Make-target"></a><span>&lsquo;<samp class="samp">formats</samp>&rsquo;<a class="copiable-link" href="#index-formats-Make-target"> &para;</a></span></dt>
505 <dt>&lsquo;<samp class="samp">install-formats</samp>&rsquo;</dt>
506 <dd><p>Make or install all the memory dumps (see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). By
507 default, the standard plain formats plus <samp class="file">latex.fmt</samp> are made. You
508 can add other formats by redefining the <code class="code">fmts</code>, <code class="code">bases</code>, and
509 <code class="code">mems</code> variables. See the top of <samp class="file">web2c/Makefile</samp> for the
510 possibilities.
511 </p>
512 </dd>
513 <dt><a class="index-entry-id" id="index-install_002dfmts-Make-target"></a>
514 <a id="index-fmts-Make-target"></a><span>&lsquo;<samp class="samp">fmts</samp>&rsquo;<a class="copiable-link" href="#index-fmts-Make-target"> &para;</a></span></dt>
515 <dt>&lsquo;<samp class="samp">install-fmts</samp>&rsquo;</dt>
516 <dd><p>Make or install the TeX <samp class="file">.fmt</samp> files. See <a class="xref" href="#Initial-TeX">Initial TeX</a>.
517 </p>
518 </dd>
519 <dt><a class="index-entry-id" id="index-install_002dbases-Make-target"></a>
520 <a id="index-bases-Make-target"></a><span>&lsquo;<samp class="samp">bases</samp>&rsquo;<a class="copiable-link" href="#index-bases-Make-target"> &para;</a></span></dt>
521 <dt>&lsquo;<samp class="samp">install-bases</samp>&rsquo;</dt>
522 <dd>
523 <p>Make or install the Metafont <samp class="file">.base</samp> files. See <a class="xref" href="#Initial-Metafont">Initial Metafont</a>.
524 </p>
525 </dd>
526 <dt><a class="index-entry-id" id="index-install_002dmems-Make-target"></a>
527 <a id="index-mems-Make-target"></a><span>&lsquo;<samp class="samp">mems</samp>&rsquo;<a class="copiable-link" href="#index-mems-Make-target"> &para;</a></span></dt>
528 <dt>&lsquo;<samp class="samp">install-mems</samp>&rsquo;</dt>
529 <dd><p>Make or install the MetaPost <samp class="file">.mem</samp> files. See <a class="xref" href="#Initial-MetaPost">Initial MetaPost</a>.
530 </p>
531 </dd>
532 <dt><a class="index-entry-id" id="index-trip-Make-target"></a>
533 <a class="index-entry-id" id="index-trap-Make-target"></a>
534 <a class="index-entry-id" id="index-mptrap-Make-target"></a>
535 <a id="index-triptrap-Make-target"></a><span>&lsquo;<samp class="samp">triptrap</samp>&rsquo;<a class="copiable-link" href="#index-triptrap-Make-target"> &para;</a></span></dt>
536 <dt>&lsquo;<samp class="samp">trip</samp>&rsquo;</dt>
537 <dt>&lsquo;<samp class="samp">trap</samp>&rsquo;</dt>
538 <dt>&lsquo;<samp class="samp">mptrap</samp>&rsquo;</dt>
539 <dd><p>To run the torture tests for TeX, Metafont, and MetaPost
540 (respectively). See the next section.
541 </p>
542 </dd>
543 </dl>
544
545
546 <hr>
547 </div>
548 <div class="section-level-extent" id="Triptrap">
549 <div class="nav-panel">
550 <p>
551 Previous: <a href="#Additional-targets" accesskey="p" rel="prev">Additional targets</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
552 </div>
553 <h3 class="section" id="Trip_002c-trap_002c-and-mptrap_003a-Torture-tests"><span>2.4 Trip, trap, and mptrap: Torture tests<a class="copiable-link" href="#Trip_002c-trap_002c-and-mptrap_003a-Torture-tests"> &para;</a></span></h3>
554
555 <a class="index-entry-id" id="index-Gruff_002c-Billy-Goat"></a>
556 <a class="index-entry-id" id="index-trip-test"></a>
557 <a class="index-entry-id" id="index-trap-test"></a>
558 <a class="index-entry-id" id="index-mptrap-test"></a>
559 <a class="index-entry-id" id="index-torture-tests"></a>
560
561 <a class="index-entry-id" id="index-tripman_002etex"></a>
562 <a class="index-entry-id" id="index-trapman_002etex"></a>
563 <a class="index-entry-id" id="index-mptrap_002ereadme"></a>
564 <p>To validate your TeX, Metafont, and MetaPost executables, run
565 &lsquo;<samp class="samp">make triptrap</samp>&rsquo;. This runs the trip, trap, and mptrap &ldquo;torture
566 tests&rdquo;. See the files <samp class="file">triptrap/tripman.tex</samp>,
567 <samp class="file">triptrap/trapman.tex</samp>, and <samp class="file">triptrap/mptrap.readme</samp> for
568 detailed information and background on the tests.
569 </p>
570 <p>The differences between your executables&rsquo; behavior and the standard
571 values will show up on your terminal. The usual differences (these are
572 all acceptable) are:
573 </p>
574 <ul class="itemize mark-bullet">
575 <li>string usage and table sizes;
576 </li><li>glue set ratios;
577 </li><li>&lsquo;<samp class="samp">down4</samp>&rsquo;, &lsquo;<samp class="samp">right4</samp>&rsquo;, and &lsquo;<samp class="samp">y4</samp>&rsquo; commands in DVItype output;
578 </li><li>dates and times.
579 </li></ul>
580
581 <p>Any other differences are trouble. The most common culprit in
582 the past has been compiler bugs, especially when optimizing.
583 See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite class="cite">Kpathsea</cite>.
584 </p>
585 <p>The files <samp class="file">trip.diffs</samp>, <samp class="file">mftrap.diffs</samp>, and
586 <samp class="file">mptrap.diffs</samp> in the <samp class="file">triptrap</samp> directory show the standard
587 diffs against the original output. If you diff your diffs against these
588 files, you should come up clean. For example
589 </p><div class="example">
590 <pre class="example-preformatted">make trip &gt;&amp;mytrip.diffs
591 diff triptrap/trip.diffs mytrip.diffs
592 </pre></div>
593
594 <p>To run the tests separately, use the targets <code class="code">trip</code>, <code class="code">trap</code>,
595 and <code class="code">mptrap</code>.
596 </p>
597 <p>To run simple tests for all the programs as well as the torture tests,
598 run &lsquo;<samp class="samp">make check</samp>&rsquo;. You can compare the output to the distributed
599 file <samp class="file">tests/check.log</samp> if you like.
600 </p>
601
602 <hr>
603 </div>
604 </div>
605 <div class="chapter-level-extent" id="Commonalities">
606 <div class="nav-panel">
607 <p>
608 Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs: Metafont, MetaPost, and TeX</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
609 </div>
610 <h2 class="chapter" id="Commonalities-1"><span>3 Commonalities<a class="copiable-link" href="#Commonalities-1"> &para;</a></span></h2>
611
612 <a class="index-entry-id" id="index-commonalities"></a>
613
614 <p>Many aspects of the TeX system are the same among more than one
615 program, so we describe those pieces together, here.
616 </p>
617 <p>Another kind of commonality is the extensions to TeX that are
618 available across all the engines; see <a class="pxref" href="#TeX-extensions">Extended TeX engines</a>.
619 </p>
620
621
622 <ul class="mini-toc">
623 <li><a href="#Option-conventions" accesskey="1">Option conventions</a></li>
624 <li><a href="#Common-options" accesskey="2">Common options</a></li>
625 <li><a href="#Path-searching" accesskey="3">Path searching</a></li>
626 <li><a href="#Output-file-location" accesskey="4">Output file location</a></li>
627 </ul>
628 <hr>
629 <div class="section-level-extent" id="Option-conventions">
630 <div class="nav-panel">
631 <p>
632 Next: <a href="#Common-options" accesskey="n" rel="next">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
633 </div>
634 <h3 class="section" id="Option-conventions-1"><span>3.1 Option conventions<a class="copiable-link" href="#Option-conventions-1"> &para;</a></span></h3>
635
636 <a class="index-entry-id" id="index-option-conventions"></a>
637 <a class="index-entry-id" id="index-conventions-for-options_002c"></a>
638
639 <a class="index-entry-id" id="index-getopt_005flong_005fonly"></a>
640 <p>To provide a clean and consistent behavior, we chose to have all these
641 programs use the GNU function <code class="code">getopt_long_only</code> to parse command
642 lines. It is used in a restricted mode where all the options have to
643 come before the rest of the arguments.
644 </p>
645 <a class="index-entry-id" id="index-_002d-starts-option-names"></a>
646 <a class="index-entry-id" id="index-_002d_002d-starts-option-names"></a>
647 <p>As a result, you can:
648 </p><ul class="itemize mark-bullet">
649 <li>use &lsquo;<samp class="samp">-</samp>&rsquo; or &lsquo;<samp class="samp">--</samp>&rsquo; to start an option name;
650
651 </li><li>use any unambiguous abbreviation for an option name;
652
653 </li><li>separate option names and values with either &lsquo;<samp class="samp">=</samp>&rsquo; or one or more
654 spaces;
655
656 </li><li><a class="index-entry-id" id="index-_002d-starting-a-filename"></a>
657 <a class="index-entry-id" id="index-filenames-starting-with-_002d"></a>
658 use filenames that would otherwise look like options by putting them
659 after an option &lsquo;<samp class="samp">--</samp>&rsquo;.
660 </li></ul>
661
662 <p>By convention, non-option arguments, if specified, generally define the
663 name of an input file, as documented for each program.
664 </p>
665 <p>If a particular option with a value is given more than once, it is the
666 last value that counts.
667 </p>
668 <p>For example, the following command line specifies the options
669 &lsquo;<samp class="samp">foo</samp>&rsquo;, &lsquo;<samp class="samp">bar</samp>&rsquo;, and &lsquo;<samp class="samp">verbose</samp>&rsquo;; gives the value &lsquo;<samp class="samp">baz</samp>&rsquo;
670 to the &lsquo;<samp class="samp">abc</samp>&rsquo; option, and the value &lsquo;<samp class="samp">xyz</samp>&rsquo; to the &lsquo;<samp class="samp">quux</samp>&rsquo;
671 option; and specifies the filename <samp class="file">-myfile-</samp>.
672 </p>
673 <div class="example">
674 <pre class="example-preformatted">-foo --bar -verb -abc=baz -quux karl --quux xyz -- -myfile-
675 </pre></div>
676
677
678 <hr>
679 </div>
680 <div class="section-level-extent" id="Common-options">
681 <div class="nav-panel">
682 <p>
683 Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Option-conventions" accesskey="p" rel="prev">Option conventions</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
684 </div>
685 <h3 class="section" id="Common-options-1"><span>3.2 Common options<a class="copiable-link" href="#Common-options-1"> &para;</a></span></h3>
686
687 <a class="index-entry-id" id="index-common-options"></a>
688 <p>All of these programs accept the standard GNU &lsquo;<samp class="samp">--help</samp>&rsquo; and
689 &lsquo;<samp class="samp">--version</samp>&rsquo; options, and several programs accept
690 &lsquo;<samp class="samp">--verbose</samp>&rsquo;. Rather than writing identical descriptions for
691 every program, they are described here.
692 </p>
693 <dl class="table">
694 <dt><a class="index-entry-id" id="index-help_002c-online"></a>
695 <a id="index-_002d_002dhelp-common-option"></a><span>&lsquo;<samp class="samp">--help</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dhelp-common-option"> &para;</a></span></dt>
696 <dd><p>Print a usage message listing basic usage and all available options to
697 standard output, then exit successfully.
698 </p>
699 </dd>
700 <dt><a class="index-entry-id" id="index-verbosity_002c-enabling"></a>
701 <a id="index-_002d_002dverbose-common-option"></a><span>&lsquo;<samp class="samp">--verbose</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dverbose-common-option"> &para;</a></span></dt>
702 <dd><p>Print progress reports to standard output.
703 </p>
704 </dd>
705 <dt><a class="index-entry-id" id="index-version-number_002c-finding"></a>
706 <a id="index-_002d_002dversion-common-option"></a><span>&lsquo;<samp class="samp">--version</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dversion-common-option"> &para;</a></span></dt>
707 <dd><p>Print the version number to standard output, then exit successfully.
708 </p></dd>
709 </dl>
710
711 <p>TeX, Metafont, and MetaPost have a number of additional options in
712 common:
713 </p>
714 <dl class="table">
715 <dt><a id="index-_002dcnf_002dline"></a><span>&lsquo;<samp class="samp">-cnf-line=<var class="var">str</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dcnf_002dline"> &para;</a></span></dt>
716 <dd><p>Parse <var class="var">str</var> as if it were a line in the <samp class="file">texmf.cnf</samp>
717 configuration file, overriding all other settings. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Path-searching-options">Path
718 searching options</a> in <cite class="cite">Kpathsea</cite>.
719 </p>
720 </dd>
721 <dt><a class="index-entry-id" id="index-_002dfile_002dline_002derror_002dstyle"></a>
722 <a class="index-entry-id" id="index-changing-error-messages-style"></a>
723 <a id="index-_002dno_002dfile_002dline_002derror"></a><span>&lsquo;<samp class="samp">-file-line-error</samp>&rsquo;<a class="copiable-link" href="#index-_002dno_002dfile_002dline_002derror"> &para;</a></span></dt>
724 <dd><a class="index-entry-id" id="index-_002dfile_002dline_002derror"></a>
725 </dd>
726 <dt>&lsquo;<samp class="samp">-no-file-line-error</samp>&rsquo;</dt>
727 <dd><p>Change (or do not change) the way error messages are printed. The
728 alternate style looks like error messages from many compilers and is
729 easier to parse for some editors that invoke TeX. This option used
730 to be called &lsquo;<samp class="samp">-file-line-error-style</samp>&rsquo;.
731 </p>
732 </dd>
733 <dt><a class="index-entry-id" id="index-_002dbase_003ddumpname"></a>
734 <a class="index-entry-id" id="index-_002dmem_003ddumpname"></a>
735 <a class="index-entry-id" id="index-dump-file"></a>
736 <a id="index-_002dfmt_003ddumpname"></a><span>&lsquo;<samp class="samp">-fmt=<var class="var">dumpname</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dfmt_003ddumpname"> &para;</a></span></dt>
737 <dt>&lsquo;<samp class="samp">-base=<var class="var">dumpname</var></samp>&rsquo;</dt>
738 <dt>&lsquo;<samp class="samp">-mem=<var class="var">dumpname</var></samp>&rsquo;</dt>
739 <dd><p>Use <var class="var">dumpname</var> instead of the program name or a &lsquo;<samp class="samp">%&amp;</samp>&rsquo; line to
740 determine the name of the memory dump file read (&lsquo;<samp class="samp">fmt</samp>&rsquo; for TeX,
741 &lsquo;<samp class="samp">base</samp>&rsquo; for Metafont, &lsquo;<samp class="samp">mem</samp>&rsquo; for MetaPost). See <a class="xref" href="#Memory-dumps">Memory dumps</a>. Also sets the program name to <var class="var">dumpname</var> if no
742 &lsquo;<samp class="samp">-progname</samp>&rsquo; option was given.
743 </p>
744 </dd>
745 <dt><a class="index-entry-id" id="index-stopping-at-the-first-error"></a>
746 <a id="index-_002dhalt_002don_002derror"></a><span>&lsquo;<samp class="samp">-halt-on-error</samp>&rsquo;<a class="copiable-link" href="#index-_002dhalt_002don_002derror"> &para;</a></span></dt>
747 <dd><p>Stop processing and exit when an error occurs, as opposed to the normal
748 process of trying to recover and continue.
749 </p>
750 </dd>
751 <dt><a class="index-entry-id" id="index-program-names_002c-special"></a>
752 <a class="index-entry-id" id="index-initial-form_002c-enabling"></a>
753 <a id="index-_002dini"></a><span>&lsquo;<samp class="samp">-ini</samp>&rsquo;<a class="copiable-link" href="#index-_002dini"> &para;</a></span></dt>
754 <dd><p>Enable the &ldquo;initial&rdquo; form of the program (see <a class="pxref" href="#Initial-and-virgin">Initial and virgin</a>). This is implicitly set if the program name is <code class="code">initex</code>
755 resp. <code class="code">inimf</code>.
756 </p>
757 </dd>
758 <dt><a class="index-entry-id" id="index-interaction-mode"></a>
759 <a id="index-_002dinteraction_003dstring"></a><span>&lsquo;<samp class="samp">-interaction=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dinteraction_003dstring"> &para;</a></span></dt>
760 <dd><p>Set the interaction mode from the command line. The <var class="var">string</var> must
761 be one of &lsquo;<samp class="samp">batchmode</samp>&rsquo;, &lsquo;<samp class="samp">nonstopmode</samp>&rsquo;, &lsquo;<samp class="samp">scrollmode</samp>&rsquo;, or
762 &lsquo;<samp class="samp">errorstopmode</samp>&rsquo;.
763 </p>
764 </dd>
765 <dt><a class="index-entry-id" id="index-job-name"></a>
766 <a id="index-_002djobname_003dstring"></a><span>&lsquo;<samp class="samp">-jobname=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002djobname_003dstring"> &para;</a></span></dt>
767 <dd><p>Set the job name to <var class="var">string</var>, instead of deriving it from the name
768 of the input file.
769 </p>
770 </dd>
771 <dt><a class="index-entry-id" id="index-KPATHSEA_005fDEBUG"></a>
772 <a class="index-entry-id" id="index-debugging-flags_002c-specifying"></a>
773 <a class="index-entry-id" id="index-path-searching-debugging"></a>
774 <a id="index-_002dkpathsea_002ddebug_003dnumber"></a><span>&lsquo;<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dkpathsea_002ddebug_003dnumber"> &para;</a></span></dt>
775 <dd><p>Set path searching debugging flags according to the bits of <var class="var">number</var>
776 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite class="cite">Kpathsea</cite>). You can also specify this in
777 <code class="code">KPATHSEA_DEBUG</code> environment variable (for all Web2c programs).
778 (The command line value overrides.) The most useful value is &lsquo;<samp class="samp">-1</samp>&rsquo;,
779 to get all available output.
780 </p>
781 </dd>
782 <dt><a class="index-entry-id" id="index-output-directory_002c-specifying"></a>
783 <a id="index-_002doutput_002ddirectory"></a><span>&lsquo;<samp class="samp">-output-directory=<var class="var">dirname</var></samp>&rsquo;<a class="copiable-link" href="#index-_002doutput_002ddirectory"> &para;</a></span></dt>
784 <dd><p>Specify the directory <var class="var">dirname</var> to which output files are written.
785 Also look for input files in <var class="var">dirname</var> first, before looking along
786 the normal search path. Input files are only looked for as specified;
787 no default extension is added. See <a class="xref" href="#Output-file-location">Output file location</a>.
788 </p>
789 </dd>
790 <dt><a class="index-entry-id" id="index-parsing-the-first-line"></a>
791 <a id="index-_002dno_002dparse_002dfirst_002dline"></a><span>&lsquo;<samp class="samp">-parse-first-line</samp>&rsquo;<a class="copiable-link" href="#index-_002dno_002dparse_002dfirst_002dline"> &para;</a></span></dt>
792 <dd><a class="index-entry-id" id="index-_002dparse_002dfirst_002dline"></a>
793 </dd>
794 <dt>&lsquo;<samp class="samp">-no-parse-first-line</samp>&rsquo;</dt>
795 <dd><p>Check or disable checking whether the first line of the main input
796 file starts with &lsquo;<samp class="samp">%&amp;</samp>&rsquo;, and parse it if it does. This line can be
797 used specify the format and/or a TCX file.
798 </p>
799 </dd>
800 <dt><a class="index-entry-id" id="index-binaries_002c-linking"></a>
801 <a class="index-entry-id" id="index-linking-binaries"></a>
802 <a class="index-entry-id" id="index-program-names_002c-special-1"></a>
803 <a id="index-_002dprogname_003dstring"></a><span>&lsquo;<samp class="samp">-progname=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dprogname_003dstring"> &para;</a></span></dt>
804 <dd><p>Set program (and memory dump) name to <var class="var">string</var>. This may affect the
805 search paths and other values used (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>). Using this option is equivalent to making a link named
806 <var class="var">string</var> to the binary and then invoking the binary under that
807 name. See <a class="xref" href="#Memory-dumps">Memory dumps</a>.
808 </p>
809 </dd>
810 <dt><a class="index-entry-id" id="index-file-recorder"></a>
811 <a id="index-_002drecorder"></a><span>&lsquo;<samp class="samp">-recorder</samp>&rsquo;<a class="copiable-link" href="#index-_002drecorder"> &para;</a></span></dt>
812 <dd><p>Enable the filename recorder. This makes the program save a list of the
813 opened files into a file with (by default) extension &lsquo;<samp class="samp">.fls</samp>&rsquo;. For
814 Aleph, this option is always on, and the file has extension &lsquo;<samp class="samp">.ofl</samp>&rsquo;.
815 </p>
816 <a class="index-entry-id" id="index-pid_002c-used-in-recorder-filename"></a>
817 <p>Ordinarily, the &lsquo;<samp class="samp">.fls</samp>&rsquo; file is written to the same location as
818 the &lsquo;<samp class="samp">.log</samp>&rsquo; file, for example, respecting
819 <samp class="option">-output-directory</samp> if it is given (see <a class="pxref" href="#Output-file-location">Output file location</a>). However, if TeX processing is done on the command line
820 (or in response to the &lsquo;<samp class="samp">**</samp>&rsquo; prompt), the &lsquo;<samp class="samp">.fls</samp>&rsquo; might be
821 written to the current directory, or include an integer (the current
822 pid), as in <samp class="file">texput1234.fls</samp>. You can use <samp class="option">-jobname</samp> to
823 explicitly set the basename.
824 </p>
825 </dd>
826 <dt><a class="index-entry-id" id="index-translation-file-for-TeX_002c-specifying"></a>
827 <a class="index-entry-id" id="index-_002etcx-character-translation-files"></a>
828 <a class="index-entry-id" id="index-first-line-of-the-main-input-file"></a>
829 <a id="index-_002dtranslate_002dfile_003dtcxfile"></a><span>&lsquo;<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dtranslate_002dfile_003dtcxfile"> &para;</a></span></dt>
830 <dd><p>Use <var class="var">tcxfile</var> to define which characters are printable and translations
831 between the internal and external character sets. Moreover,
832 <var class="var">tcxfile</var> can be explicitly declared in the first line of the main
833 input file &lsquo;<samp class="samp">%&amp; -translate-file=<var class="var">tcxfile</var></samp>&rsquo;.
834 This is the recommended method for portability reasons.
835 See <a class="xref" href="#TCX-files">TCX files: Character translations</a>.
836 </p>
837 </dd>
838 <dt><a class="index-entry-id" id="index-8-bit-clean"></a>
839 <a class="index-entry-id" id="index-8-bit-clean-output_002c-specifying"></a>
840 <a id="index-_002d8bit"></a><span>&lsquo;<samp class="samp">-8bit</samp>&rsquo;<a class="copiable-link" href="#index-_002d8bit"> &para;</a></span></dt>
841 <dd><p>This option specifies that by default all characters should be
842 considered printable. If &lsquo;<samp class="samp">-translate-file</samp>&rsquo; was given as well,
843 then the TCX file may mark characters as non-printable. This is a
844 no-op in engines natively supporting Unicode.
845 </p>
846 </dd>
847 </dl>
848
849
850 <hr>
851 </div>
852 <div class="section-level-extent" id="Path-searching">
853 <div class="nav-panel">
854 <p>
855 Next: <a href="#Output-file-location" accesskey="n" rel="next">Output file location</a>, Previous: <a href="#Common-options" accesskey="p" rel="prev">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
856 </div>
857 <h3 class="section" id="Path-searching-1"><span>3.3 Path searching<a class="copiable-link" href="#Path-searching-1"> &para;</a></span></h3>
858
859 <a class="index-entry-id" id="index-path-searching"></a>
860
861 <a class="index-entry-id" id="index-texmf_002ecnf"></a>
862 <a class="index-entry-id" id="index-configuration-file-reading"></a>
863 <p>All of the Web2c programs, including TeX, which do path searching use
864 the Kpathsea routines to do so. The precise names of the environment
865 and configuration file variables which get searched for particular file
866 formatted are therefore documented in the Kpathsea manual
867 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>). Reading
868 <samp class="file">texmf.cnf</samp> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>), invoking
869 <code class="code">mktex&hellip;</code> scripts (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite class="cite">Kpathsea</cite>), and so on are all handled by Kpathsea.
870 </p>
871 <a class="index-entry-id" id="index-font-aliases"></a>
872 <a class="index-entry-id" id="index-aliases-for-fonts"></a>
873 <a class="index-entry-id" id="index-texfonts_002emap"></a>
874 <p>The programs which read fonts make use of another Kpathsea feature:
875 <samp class="file">texfonts.map</samp>, which allows arbitrary aliases for the actual names
876 of font files; for example, &lsquo;<samp class="samp">Times-Roman</samp>&rsquo; for &lsquo;<samp class="samp">ptmr8r.tfm</samp>&rsquo;.
877 The distributed (and installed by default) <samp class="file">texfonts.map</samp> includes
878 aliases for many widely available PostScript fonts by their PostScript
879 names.
880 </p>
881
882 <hr>
883 </div>
884 <div class="section-level-extent" id="Output-file-location">
885 <div class="nav-panel">
886 <p>
887 Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
888 </div>
889 <h3 class="section" id="Output-file-location-1"><span>3.4 Output file location<a class="copiable-link" href="#Output-file-location-1"> &para;</a></span></h3>
890
891 <a class="index-entry-id" id="index-output-file-location"></a>
892 <a class="index-entry-id" id="index-current-directory_002c-used-for-output"></a>
893 <a class="index-entry-id" id="index-_002e_002c-used-for-output"></a>
894 <p>All the programs generally follow the usual convention for output
895 files; namely, they are placed in the directory current when the
896 program is run, regardless of any input file location; or, in a few
897 cases, output is to standard output. The main programs (TeX,
898 Metafont, MetaPost) provide several ways to override this, as
899 explained below.
900 </p>
901 <p>For example, if you run &lsquo;<samp class="samp">tex /tmp/foo</samp>&rsquo;, by default the output
902 will be in <samp class="file">./foo.dvi</samp> and <samp class="file">./foo.log</samp>, not
903 <samp class="file">/tmp/foo.dvi</samp> and <samp class="file">/tmp/foo.log</samp>.
904 </p>
905 <a class="index-entry-id" id="index-input-from-the-output-directory"></a>
906 <a class="index-entry-id" id="index-reading-from-the-output-directory"></a>
907 <p>An explicitly-given output location is also checked for input files,
908 as TeX often generates files that need to be subsequently read.
909 For input, the input filename is simply checked as given. No
910 suffixes, such as &lsquo;<samp class="samp">.tex</samp>&rsquo;, are added by default, and no exhaustive
911 path searching is done.
912 </p>
913 <h4 class="subheading" id="Override-1_003a-_002doutput_002ddirectory-option"><span>Override 1: &lsquo;<samp class="samp">-output-directory</samp>&rsquo; option<a class="copiable-link" href="#Override-1_003a-_002doutput_002ddirectory-option"> &para;</a></span></h4>
914
915 <a class="index-entry-id" id="index-_002doutput_002ddirectory-1"></a>
916 <a class="index-entry-id" id="index-output-directory_002c-specifying-1"></a>
917 <p>If the &lsquo;<samp class="samp">-output-directory</samp>&rsquo; option is specified, all output files
918 that would normally be written in the current directory are written in
919 the specified directory instead. See <a class="xref" href="#Common-options">Common options</a>.
920 </p>
921 <h4 class="subheading" id="Override-2_003a-TEXMF_005fOUTPUT_005fDIRECTORY-environment-variable"><span>Override 2: <code class="code">TEXMF_OUTPUT_DIRECTORY</code> environment variable<a class="copiable-link" href="#Override-2_003a-TEXMF_005fOUTPUT_005fDIRECTORY-environment-variable"> &para;</a></span></h4>
922
923 <a class="index-entry-id" id="index-TEXMF_005fOUTPUT_005fDIRECTORY"></a>
924 <a class="index-entry-id" id="index-_005cwrite18_002c-output-location-for"></a>
925
926 <p>Furthermore, if the &lsquo;<samp class="samp">-output-directory</samp>&rsquo; option is specified, its
927 argument is saved in the environment variable
928 <code class="code">TEXMF_OUTPUT_DIRECTORY</code>. This is for the benefit of any
929 subprograms that might be called via <code class="code">\write18</code> (see <a class="pxref" href="#Shell-escapes">Shell escapes</a>), such as <code class="command">kpsewhich</code> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Invoking-kpsewhich">Invoking
930 kpsewhich</a> in <cite class="cite">Kpathsea</cite>). (This feature was added in TeX
931 Live 2024.)
932 </p>
933 <p>If the &lsquo;<samp class="samp">-output-directory</samp>&rsquo; option is not specified, but the
934 environment variable <code class="code">TEXMF_OUTPUT_DIRECTORY</code> is set, then the
935 environment variable value is used just as if it had been given to the
936 option.
937 </p>
938 <p>Warning: we most strongly recommend always setting
939 <code class="code">TEXMF_OUTPUT_DIRECTORY</code> temporarily, for a given run. It has
940 great potential for confusion, since with it set, output files will
941 not be in the expected place. To reduce this chance somewhat,
942 <code class="code">TEXMF_OUTPUT_DIRECTORY</code> must be set in the environment, not a
943 configuration file.
944 </p>
945 <h4 class="subheading" id="Override-3_003a-TEXMFOUTPUT-environment-variable"><span>Override 3: <code class="code">TEXMFOUTPUT</code> environment variable<a class="copiable-link" href="#Override-3_003a-TEXMFOUTPUT-environment-variable"> &para;</a></span></h4>
946
947 <a class="index-entry-id" id="index-TEXMFOUTPUT_002c-used-if-_002e-unwritable"></a>
948 <a class="index-entry-id" id="index-readonly-directory_002c-running-TeX-in"></a>
949 <a class="index-entry-id" id="index-readonly-directory_002c-running-TeX-in-1"></a>
950
951 <p>Finally, if neither &lsquo;<samp class="samp">-output-directory</samp>&rsquo; nor
952 <code class="code">TEXMF_OUTPUT_DIRECTORY</code> is set, <em class="emph">and</em> an output file is not
953 writable, then the main programs (TeX, Metafont, MetaPost), plus
954 BibTeX for this one case, make an exception: if the config file or
955 environment variable value <code class="code">TEXMFOUTPUT</code> is set (it is not by
956 default), the output file is written to the directory specified.
957 Usually this is because the current directory is not writable, and
958 thus all output files are written to <code class="code">TEXMFOUTPUT</code>, but
959 technically it works on a file-by-file basis.
960 </p>
961 <p>None of these explicitly-given output locations are checked until (and
962 unless) the program needs to write a file. For example, the
963 invocation<br> <code class="code">tex --output-directory=/nonesuch \\end</code><br> won&rsquo;t
964 generate an error until TeX tries to write the log file:<br> &lsquo;<samp class="samp">!
965 I can't write on file `texput.log'.</samp>&rsquo;.
966 </p>
967
968 <hr>
969 </div>
970 </div>
971 <div class="chapter-level-extent" id="Three-programs">
972 <div class="nav-panel">
973 <p>
974 Next: <a href="#TeX" accesskey="n" rel="next">TeX: Typesetting</a>, Previous: <a href="#Commonalities" accesskey="p" rel="prev">Commonalities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
975 </div>
976 <h2 class="chapter" id="Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX"><span>4 Three programs: Metafont, MetaPost, and TeX<a class="copiable-link" href="#Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX"> &para;</a></span></h2>
977
978 <a class="index-entry-id" id="index-three-programs"></a>
979 <a class="index-entry-id" id="index-TeX_002c-Metafont_002c-and-MetaPost"></a>
980 <a class="index-entry-id" id="index-Metafont_002c-MetaPost_002c-and-TeX"></a>
981 <a class="index-entry-id" id="index-MetaPost_002c-TeX_002c-and-Metafont"></a>
982
983 <p>TeX, Metafont, and MetaPost have a number of features in common.
984 Besides the ones here, command-line options and other commonalities
985 are described in the previous section.
986 </p>
987
988
989 <ul class="mini-toc">
990 <li><a href="#Runtime-options" accesskey="1">Runtime options</a></li>
991 <li><a href="#Initial-and-virgin" accesskey="2">Initial and virgin</a></li>
992 <li><a href="#Memory-dumps" accesskey="3">Memory dumps</a></li>
993 <li><a href="#Editor-invocation" accesskey="4">Editor invocation</a></li>
994 <li><a href="#g_t_005cinput-filenames" accesskey="5"><code class="code">\input</code> filenames</a></li>
995 </ul>
996 <hr>
997 <div class="section-level-extent" id="Runtime-options">
998 <div class="nav-panel">
999 <p>
1000 Next: <a href="#Initial-and-virgin" accesskey="n" rel="next">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1001 </div>
1002 <h3 class="section" id="Runtime-options-1"><span>4.1 Runtime options<a class="copiable-link" href="#Runtime-options-1"> &para;</a></span></h3>
1003
1004 <a class="index-entry-id" id="index-runtime-options"></a>
1005
1006 <a class="index-entry-id" id="index-configuration-file-values"></a>
1007 <a class="index-entry-id" id="index-array-sizes"></a>
1008 <a class="index-entry-id" id="index-texmf_002ecnf-1"></a>
1009 <p>Besides the configure- and compile-time options described in the
1010 installation section (see <a class="pxref" href="#Installation">Installation</a>), you can control a number
1011 of parameters in the <samp class="file">texmf.cnf</samp> runtime file read by Kpathsea
1012 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite class="cite">Kpathsea</cite>).
1013 </p>
1014 <p>The main purpose of <samp class="file">texmf.cnf</samp> is to specify search paths, but
1015 array sizes and other options are also set there. Most are rather
1016 obscure. Here are a few of the more interesting values:
1017 </p>
1018 <dl class="vtable">
1019 <dt><a id="index-main_005fmemory"></a><span>&lsquo;<samp class="samp">main_memory</samp>&rsquo;<a class="copiable-link" href="#index-main_005fmemory"> &para;</a></span></dt>
1020 <dd><p>Total words of memory available, for TeX, Metafont, and MetaPost.
1021 Must remake the format file after changing.
1022 </p>
1023 </dd>
1024 <dt><a id="index-extra_005fmem_005fbot"></a><span>&lsquo;<samp class="samp">extra_mem_bot</samp>&rsquo;<a class="copiable-link" href="#index-extra_005fmem_005fbot"> &para;</a></span></dt>
1025 <dd><a class="index-entry-id" id="index-boxes_002c-memory-for"></a>
1026 <a class="index-entry-id" id="index-glue_002c-memory-for"></a>
1027 <a class="index-entry-id" id="index-breakpoints_002c-memory-for"></a>
1028 <a class="index-entry-id" id="index-PiCTeX_002c-increasing-memory-for"></a>
1029 <p>Extra space for &ldquo;large&rdquo; TeX data structures (default 0): boxes,
1030 glue, breakpoints, et al. If you use PiCTeX, you may well want to
1031 set this.
1032 </p>
1033 </dd>
1034 <dt><a id="index-expand_005fdepth"></a><span>&lsquo;<samp class="samp">expand_depth</samp>&rsquo;<a class="copiable-link" href="#index-expand_005fdepth"> &para;</a></span></dt>
1035 <dd><a class="index-entry-id" id="index-recursive-expansion-limit"></a>
1036 <a class="index-entry-id" id="index-expansion-limit_002c-recursive"></a>
1037 <a class="index-entry-id" id="index-runtime-stack-overflow"></a>
1038 <a class="index-entry-id" id="index-overflow_002c-of-runtime-stack"></a>
1039 <a class="index-entry-id" id="index-segmentation-fault"></a>
1040 <a class="index-entry-id" id="index-SIGSEGV"></a>
1041 <p>Limit on recursive expansion calls before TeX aborts (default
1042 10000). If a TeX program does an unterminated recursive expansion,
1043 TeX will dutifully expand macros until the system&rsquo;s runtime stack
1044 overflows, typically with a segmentation fault (SIGSEGV). This
1045 parameter was introduced to minimize the chance of that unpleasant
1046 (though not dangerous) crash, instead allowing TeX to quit with a
1047 more informative message.
1048 </p>
1049 <a class="index-entry-id" id="index-libsigsegv-library"></a>
1050 <p>The crash can still happen, though, if the system has an exceptionally
1051 small memory allocation for its stack. There is no quantitative way to
1052 determine the limit, and it does not seem worth implementing
1053 system-dependent heuristics to guess at the number, since it&rsquo;s highly
1054 improbable that any real TeX code will ever need more than 10000
1055 recursive expansions (it has never happened). For the same reason,
1056 using the libsigsegv library (<a class="url" href="https://gnu.org/s/libsigsegv">https://gnu.org/s/libsigsegv</a>) does
1057 not seem worth the effort.
1058 </p>
1059 </dd>
1060 <dt><a id="index-texmf_005fcasefold_005fsearch"></a><span>&lsquo;<samp class="samp">texmf_casefold_search</samp>&rsquo;<a class="copiable-link" href="#index-texmf_005fcasefold_005fsearch"> &para;</a></span></dt>
1061 <dd><p>See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Casefolding-search">Casefolding search</a> in <cite class="cite">Kpathsea</cite>.
1062 </p>
1063 </dd>
1064 </dl>
1065
1066 <a class="index-entry-id" id="index-array-limit_002c-fixed"></a>
1067 <a class="index-entry-id" id="index-swap-space_002c-as-array-limit"></a>
1068 <a class="index-entry-id" id="index-reallocation-of-arrays"></a>
1069 <a class="index-entry-id" id="index-dynamic-array-allocation"></a>
1070 <p>Ideally all arrays would be dynamically expanded as necessary, so the
1071 only limiting factor would be the amount of swap space available, or
1072 some configurable limit much larger than can currently be supported.
1073 </p>
1074 <p>Unfortunately, implementing this is extremely difficult, as the fixed
1075 size of arrays is assumed in many places throughout the source code.
1076 These runtime limits are a practical compromise between the
1077 compile-time limits in previous versions, and truly dynamic arrays.
1078 (On the other hand, the Web2c BibTeX implementation does do true
1079 dynamic reallocation of some arrays.)
1080 </p>
1081 <a class="index-entry-id" id="index-modifying-texmf_002ecnf-in-TeX-Live"></a>
1082 <a class="index-entry-id" id="index-location-of-texmf_002ecnf-in-TeX-Live"></a>
1083 <p>Nowadays there is rarely a reason to modify the values. But if you do
1084 wish to modify <samp class="file">texmf.cnf</samp>, in TeX Live the best approach is
1085 to put your changes, and only your changes at the top of the TL
1086 installation tree. That is, if the system <samp class="file">texmf.cnf</samp> is
1087 installed in
1088 <samp class="file">/some/path/to/texlive/YYYY/texmf-dist/web2c/texmf.cnf</samp> is put
1089 your custom settings in <samp class="file">/some/path/to/texlive/YYY/texmf.cnf</samp>,
1090 where <var class="var">YYYY</var> is the year of installation (if you use that
1091 subdirectory; it&rsquo;s the default). That way, unrelated changes to the
1092 system <samp class="file">texmf.cnf</samp> can happen with normal updates, without
1093 affecting your local values.
1094 </p>
1095
1096 <hr>
1097 </div>
1098 <div class="section-level-extent" id="Initial-and-virgin">
1099 <div class="nav-panel">
1100 <p>
1101 Next: <a href="#Memory-dumps" accesskey="n" rel="next">Memory dumps</a>, Previous: <a href="#Runtime-options" accesskey="p" rel="prev">Runtime options</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1102 </div>
1103 <h3 class="section" id="Initial-and-virgin-1"><span>4.2 Initial and virgin<a class="copiable-link" href="#Initial-and-virgin-1"> &para;</a></span></h3>
1104
1105 <a class="index-entry-id" id="index-executables_002c-shared-initial-and-virgin"></a>
1106 <p>The TeX and Metafont programs each have two main variants, called
1107 <em class="dfn">initial</em> and <em class="dfn">virgin</em>. MetaPost no longer makes this
1108 distinction.
1109 </p>
1110 <p>The initial form is enabled if:
1111 </p><ol class="enumerate">
1112 <li> <a class="index-entry-id" id="index-_002dini-1"></a>
1113 the &lsquo;<samp class="samp">-ini</samp>&rsquo; option was specified; or
1114 </li><li> the program name is <samp class="file">initex</samp> resp. <samp class="file">inimf</samp>; or
1115 </li><li> the first line of the main input file is &lsquo;<samp class="samp">%&amp;ini</samp>&rsquo;;
1116 </li></ol>
1117 <p>otherwise, the virgin form is used.
1118 </p>
1119 <a class="index-entry-id" id="index-virgin-programs"></a>
1120 <a class="index-entry-id" id="index-production-use"></a>
1121 <p>The <em class="dfn">virgin</em> form is the one generally invoked for production use.
1122 The first thing it does is read a memory dump (see <a class="pxref" href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a>), and then proceeds on with the main job.
1123 </p>
1124 <a class="index-entry-id" id="index-initial-programs"></a>
1125 <a class="index-entry-id" id="index-initializations_002c-lengthy"></a>
1126 <p>The <em class="dfn">initial</em> form is generally used only to create memory dumps
1127 (see the next section). It starts up more slowly than the virgin form,
1128 because it must do lengthy initializations that are encapsulated in the
1129 memory dump file.
1130 </p>
1131
1132 <hr>
1133 </div>
1134 <div class="section-level-extent" id="Memory-dumps">
1135 <div class="nav-panel">
1136 <p>
1137 Next: <a href="#Editor-invocation" accesskey="n" rel="next">Editor invocation</a>, Previous: <a href="#Initial-and-virgin" accesskey="p" rel="prev">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1138 </div>
1139 <h3 class="section" id="Memory-dumps-1"><span>4.3 Memory dumps<a class="copiable-link" href="#Memory-dumps-1"> &para;</a></span></h3>
1140
1141 <a class="index-entry-id" id="index-memory-dumps"></a>
1142
1143 <a class="index-entry-id" id="index-dumping-memory"></a>
1144 <a class="index-entry-id" id="index-macros_002c-predefining-in-memory-dumps"></a>
1145 <a class="index-entry-id" id="index-predefined-macros-and-memory-dumps"></a>
1146 <p>In typical use, TeX and Metafont require a large number of
1147 macros to be predefined; therefore, they support <em class="dfn">memory dump</em>
1148 files, which can be read much more efficiently than ordinary source
1149 code.
1150 </p>
1151
1152
1153 <ul class="mini-toc">
1154 <li><a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a></li>
1155 <li><a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a></li>
1156 <li><a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a></li>
1157 </ul>
1158 <hr>
1159 <div class="subsection-level-extent" id="Creating-memory-dumps">
1160 <div class="nav-panel">
1161 <p>
1162 Next: <a href="#Determining-the-memory-dump-to-use" accesskey="n" rel="next">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1163 </div>
1164 <h4 class="subsection" id="Creating-memory-dumps-1"><span>4.3.1 Creating memory dumps<a class="copiable-link" href="#Creating-memory-dumps-1"> &para;</a></span></h4>
1165
1166 <a class="index-entry-id" id="index-memory-dumps_002c-creating"></a>
1167 <a class="index-entry-id" id="index-creating-memory-dumps"></a>
1168 <a class="index-entry-id" id="index-writing-memory-dumps"></a>
1169
1170 <p>The programs both create memory dumps in slightly idiosyncratic (thought
1171 substantially similar) way, so we describe the details in separate
1172 sections (references below). The basic idea is to run the initial
1173 version of the program (see <a class="pxref" href="#Initial-and-virgin">Initial and virgin</a>), read the source
1174 file to define the macros, and then execute the <code class="code">\dump</code> primitive.
1175 </p>
1176 <p>Also, each program uses a different filename extension for its memory
1177 dumps, since although they are completely analogous they are not
1178 interchangeable (TeX cannot read a Metafont memory dump, or vice
1179 versa).
1180 </p>
1181 <p>Here are the filename extensions with references to examples of
1182 creating memory dumps:
1183 </p>
1184 <dl class="table">
1185 <dt>TeX</dt>
1186 <dd><p>(&lsquo;<samp class="samp">.fmt</samp>&rsquo;) See <a class="xref" href="#Initial-TeX">Initial TeX</a>.
1187 </p>
1188 </dd>
1189 <dt>Metafont</dt>
1190 <dd><p>(&lsquo;<samp class="samp">.base</samp>&rsquo;) See <a class="xref" href="#Initial-Metafont">Initial Metafont</a>.
1191 </p></dd>
1192 </dl>
1193
1194 <p>MetaPost used to have an equivalent memory dump, called &lsquo;<samp class="samp">.mem</samp>&rsquo;,
1195 but no longer uses this; it now reads only source files.
1196 </p>
1197 <p>When making memory dumps, the programs read environment variables and
1198 configuration files for path searching and other values as usual. If
1199 you are making a new installation and have environment variables
1200 pointing to an old one, for example, you will probably run into
1201 difficulties.
1202 </p>
1203
1204 <hr>
1205 </div>
1206 <div class="subsection-level-extent" id="Determining-the-memory-dump-to-use">
1207 <div class="nav-panel">
1208 <p>
1209 Next: <a href="#Hardware-and-memory-dumps" accesskey="n" rel="next">Hardware and memory dumps</a>, Previous: <a href="#Creating-memory-dumps" accesskey="p" rel="prev">Creating memory dumps</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1210 </div>
1211 <h4 class="subsection" id="Determining-the-memory-dump-to-use-1"><span>4.3.2 Determining the memory dump to use<a class="copiable-link" href="#Determining-the-memory-dump-to-use-1"> &para;</a></span></h4>
1212
1213 <a class="index-entry-id" id="index-memory-dump-to-use_002c-determining"></a>
1214 <a class="index-entry-id" id="index-fmt-file_002c-determining"></a>
1215 <a class="index-entry-id" id="index-base-file_002c-determining"></a>
1216
1217 <p>The virgin form (see <a class="pxref" href="#Initial-and-virgin">Initial and virgin</a>) of each program always
1218 reads a memory dump before processing normal source input. All three
1219 programs determine the memory dump to use in the same way:
1220 </p>
1221 <ol class="enumerate">
1222 <li> If the first non-option command-line argument begins with &lsquo;<samp class="samp">&amp;</samp>&rsquo;, the
1223 program uses the remainder of that argument as the memory dump name.
1224 For example, running &lsquo;<samp class="samp">tex \&amp;super</samp>&rsquo; reads <samp class="file">super.fmt</samp>. The
1225 backslash merely protects the &lsquo;<samp class="samp">&amp;</samp>&rsquo; against interpretation by the
1226 shell; quotes could also be used. TeX must see only the &lsquo;<samp class="samp">&amp;</samp>&rsquo;.
1227
1228 </li><li> <a class="index-entry-id" id="index-_002dfmt_003dfmt"></a>
1229 <a class="index-entry-id" id="index-_002dbase_003dbase"></a>
1230 If the &lsquo;<samp class="samp">-fmt</samp>&rsquo; resp. &lsquo;<samp class="samp">-base</samp>&rsquo; option is
1231 specified, its value is used.
1232
1233 </li><li> <a class="index-entry-id" id="index-_002dprogname_003dstring-1"></a>
1234 If the &lsquo;<samp class="samp">-progname</samp>&rsquo; option is specified, its value is used.
1235
1236 </li><li> <a class="index-entry-id" id="index-_0025_0026-magic-number"></a>
1237 If the first line of the main input file (which must be specified on
1238 the command line, not in response to the &lsquo;<samp class="samp">**</samp>&rsquo; prompt) is
1239 <code class="code">%&amp;<var class="var">dump</var></code>, and <var class="var">dump</var> is an existing memory dump of the
1240 appropriate type, <var class="var">dump</var> is used.
1241
1242 <p>The first line of the main input file can also specify which character
1243 translation file is to be used: <code class="code">%&amp;-translate-file=<var class="var">tcxfile</var></code>
1244 (see <a class="pxref" href="#TCX-files">TCX files: Character translations</a>).
1245 </p>
1246 <p>These two roles can be combined: <code class="code">%&amp;<var class="var">dump</var>
1247 -translate-file=<var class="var">tcxfile</var></code>. If this is done, the name of the dump
1248 must be given first.
1249 </p>
1250 </li><li> <a class="index-entry-id" id="index-program-name_002c-determines-memory-dump"></a>
1251 <a class="index-entry-id" id="index-links-to-binaries"></a>
1252 Otherwise, the program uses the program invocation name, most simply
1253 <samp class="file">tex</samp> resp. <samp class="file">mf</samp>. For example, if <samp class="file">latex</samp> is a link
1254 to <samp class="file">tex</samp>, and the user runs &lsquo;<samp class="samp">latex foo</samp>&rsquo;, <samp class="file">latex.fmt</samp>
1255 will be used.
1256
1257 </li></ol>
1258
1259 <hr>
1260 </div>
1261 <div class="subsection-level-extent" id="Hardware-and-memory-dumps">
1262 <div class="nav-panel">
1263 <p>
1264 Previous: <a href="#Determining-the-memory-dump-to-use" accesskey="p" rel="prev">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1265 </div>
1266 <h4 class="subsection" id="Hardware-and-memory-dumps-1"><span>4.3.3 Hardware and memory dumps<a class="copiable-link" href="#Hardware-and-memory-dumps-1"> &para;</a></span></h4>
1267
1268 <a class="index-entry-id" id="index-hardware-and-memory-dumps"></a>
1269 <a class="index-entry-id" id="index-memory-dumps-and-hardware"></a>
1270 <a class="index-entry-id" id="index-sharing-memory-dumps"></a>
1271 <a class="index-entry-id" id="index-portable-memory-dumps"></a>
1272 <a class="index-entry-id" id="index-fmt-files_002c-sharing"></a>
1273 <a class="index-entry-id" id="index-base-files_002c-sharing"></a>
1274
1275 <a class="index-entry-id" id="index-LittleEndian-machines"></a>
1276 <a class="index-entry-id" id="index-BigEndian-machines"></a>
1277 <a class="index-entry-id" id="index-endian-dependencies"></a>
1278 <a class="index-entry-id" id="index-machine-dependencies"></a>
1279 <a class="index-entry-id" id="index-architecture-dependencies"></a>
1280 <a class="index-entry-id" id="index-dependencies_002c-hardware"></a>
1281 <a class="index-entry-id" id="index-32_002dbit-architecture"></a>
1282 <a class="index-entry-id" id="index-64_002dbit-architecture"></a>
1283 <a class="index-entry-id" id="index-long-data-type_002c-size-of"></a>
1284 <p>By default, most memory dump files are sharable among architectures of
1285 different types; specifically, among machines of different endianness
1286 (see <a data-manual="libc" href="https://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite class="cite">GNU C Library</cite>) and with different word
1287 sizes (4-byte <code class="code">long</code> vs. 8-byte <code class="code">long</code>). This is a
1288 feature of the Web2c implementation, and is not true of all TeX
1289 implementations.
1290 </p>
1291 <a class="index-entry-id" id="index-Lua_002c-and-unportable-memory-dumps"></a>
1292 <p>However, with the advent of Lua as an embedded scripting language,
1293 some dumps have become unportable, namely <code class="code">lualatex</code>,
1294 <code class="code">optex</code>, and <code class="code">context</code>. These formats precompile Lua code
1295 into bytecode, which is architecture-specific for the sake of speed.
1296 With TeX Live, if you need to support multiple architectures with
1297 the same tree, you can explicitly set <code class="code">TEXMFSYSVAR</code> to different
1298 directories on the different systems. More discussion:
1299 <a class="url" href="https://github.com/latex3/latex2e/issues/775">https://github.com/latex3/latex2e/issues/775</a>.
1300 </p>
1301 <a class="index-entry-id" id="index-tl_002dcheck_002dfmtshare"></a>
1302 <p>The script <code class="code">tl-check-fmtshare</code> in the TeX Live source tree
1303 (<samp class="file">Master/tlpkg/bin</samp>) provides a relatively easy way to test that
1304 a <samp class="file">.fmt</samp> built on the local host can be loaded by a TeX engine
1305 built on some remote host.
1306 </p>
1307 <a class="index-entry-id" id="index-byte-swapping"></a>
1308 <a class="index-entry-id" id="index-swapping-bytes"></a>
1309 <a class="index-entry-id" id="index-_002d_002ddisable_002ddump_002dshare-configure-option"></a>
1310 <p>If you specify &lsquo;<samp class="samp">--disable-dump-share</samp>&rsquo; to <code class="code">configure</code>,
1311 however, memory dumps will be endian-dependent. The reason to do this
1312 is speed. To achieve endian-independence, the reading of memory dumps
1313 on LittleEndian architectures, such as PC&rsquo;s and DEC architectures, is
1314 somewhat slowed (all the multibyte values have to be swapped).
1315 Usually, this is not noticeable, and the advantage of being able to
1316 share memory dumps across all platforms at a site outweighs the speed
1317 loss. But if you&rsquo;re trying to squeeze out every possible bit of
1318 performance, you may wish to do this.
1319 </p>
1320 <a class="index-entry-id" id="index-floating_002dpoint-values"></a>
1321 <a class="index-entry-id" id="index-glue-ratio-representations"></a>
1322 <p>TeXnically, even without &lsquo;<samp class="samp">--disable-dump-share</samp>&rsquo;, sharing of
1323 <samp class="file">.fmt</samp> files cannot be guaranteed to work. Floating-point values
1324 are always written in native format, and hence will generally not be
1325 readable across platforms. Fortunately, TeX uses floating point
1326 only to represent glue ratios, and none of the common formats (plain,
1327 LaTeX, AMSTeX, &hellip;) do any glue setting at
1328 <samp class="file">.fmt</samp>-creation time. Metafont does not use floating point in
1329 any dumped value at all.
1330 </p>
1331 <a class="index-entry-id" id="index-date-and-time_002c-in-memory-dumps"></a>
1332 <a class="index-entry-id" id="index-time-and-date_002c-in-memory-dumps"></a>
1333 <a class="index-entry-id" id="index-memory-dumps_002c-contain-date-and-time"></a>
1334 <p>Different memory dump files will never compare equal byte-for-byte,
1335 because the programs dump the current date and time. So don&rsquo;t be
1336 alarmed by this difference.
1337 </p>
1338 <a class="index-entry-id" id="index-Harbison_002c-Samuel-P_002e"></a>
1339 <a class="index-entry-id" id="index-Steele-Jr_002e_002c-Guy-L_002e"></a>
1340 <p>If you don&rsquo;t know what endianness your machine is, and you&rsquo;re curious,
1341 here is a little C program to tell you. (The <code class="code">configure</code> script
1342 contains a similar program.) This is from the book <cite class="cite">C: A Reference
1343 Manual</cite>, by Samuel P. Harbison and Guy L. Steele
1344 Jr. (see <a class="pxref" href="#References">References</a>).
1345 </p>
1346 <div class="example">
1347 <pre class="example-preformatted">main ()
1348 {
1349 /* Are we little or big endian? From Harbison&amp;Steele. */
1350 union
1351 {
1352 long l;
1353 char c[sizeof (long)];
1354 } u;
1355 u.l = 1;
1356 if (u.c[0] == 1)
1357 printf (&quot;LittleEndian\n&quot;);
1358 else if (u.c[sizeof (long) - 1] == 1)
1359 printf (&quot;BigEndian\n&quot;);
1360 else
1361 printf (&quot;unknownEndian&quot;);
1362
1363 exit (u.c[sizeof (long) - 1] == 1);
1364 }
1365 </pre></div>
1366
1367 <p>You can add <code class="code">printf(&quot;long %d\n&quot;, sizeof(long));</code> to see the size
1368 of the <code class="code">long</code> data type.
1369 </p>
1370
1371 <hr>
1372 </div>
1373 </div>
1374 <div class="section-level-extent" id="Editor-invocation">
1375 <div class="nav-panel">
1376 <p>
1377 Next: <a href="#g_t_005cinput-filenames" accesskey="n" rel="next"><code class="code">\input</code> filenames</a>, Previous: <a href="#Memory-dumps" accesskey="p" rel="prev">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1378 </div>
1379 <h3 class="section" id="Editor-invocation-1"><span>4.4 Editor invocation<a class="copiable-link" href="#Editor-invocation-1"> &para;</a></span></h3>
1380
1381 <a class="index-entry-id" id="index-editor-invoked-at-error"></a>
1382 <a class="index-entry-id" id="index-errors_002c-editor-invoked-at"></a>
1383 <a class="index-entry-id" id="index-e-response-at-error-prompt"></a>
1384
1385 <p>TeX, Metafont, and MetaPost all (by default) stop and ask for user
1386 intervention at an error. If the input came from a file, and the user
1387 responds with <kbd class="kbd">e</kbd> or <kbd class="kbd">E</kbd>, the program invokes an editor.
1388 </p>
1389 <a class="index-entry-id" id="index-TEXEDIT"></a>
1390 <a class="index-entry-id" id="index-MFEDIT"></a>
1391 <a class="index-entry-id" id="index-MPEDIT"></a>
1392 <a class="index-entry-id" id="index-_002d_002dwith_002deditor_003dcmd"></a>
1393 <a class="index-entry-id" id="index-texmf_002ecnf-for-editors"></a>
1394 <p>Specifying &lsquo;<samp class="samp">--with-editor=<var class="var">cmd</var></samp>&rsquo; to <code class="code">configure</code> sets the
1395 default editor command string to <var class="var">cmd</var>. The environment
1396 variables/configuration values <code class="code">TEXEDIT</code>, <code class="code">MFEDIT</code>, and
1397 <code class="code">MPEDIT</code> (respectively) override this. If &lsquo;<samp class="samp">--with-editor</samp>&rsquo; is
1398 not specified, the default is <code class="code">vi +%d %s</code> on Unix, and an
1399 invocation of the TeXworks editor on Windows. (See
1400 <samp class="file">texmf.cnf</samp> for the precise values.)
1401 </p>
1402 <p>In this string, &lsquo;<samp class="samp">%d</samp>&rsquo; is replaced by the line number of the error,
1403 and &lsquo;<samp class="samp">%s</samp>&rsquo; is replaced by the name of the current input file.
1404 </p>
1405
1406 <hr>
1407 </div>
1408 <div class="section-level-extent" id="g_t_005cinput-filenames">
1409 <div class="nav-panel">
1410 <p>
1411 Previous: <a href="#Editor-invocation" accesskey="p" rel="prev">Editor invocation</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs: Metafont, MetaPost, and TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1412 </div>
1413 <h3 class="section" id="g_t_005cinput-filenames-1"><span>4.5 <code class="code">\input</code> filenames<a class="copiable-link" href="#g_t_005cinput-filenames-1"> &para;</a></span></h3>
1414
1415 <a class="index-entry-id" id="index-input-filenames"></a>
1416 <a class="index-entry-id" id="index-filename-conventions_002c-in-input-files"></a>
1417 <a class="index-entry-id" id="index-_005cinput-filenames"></a>
1418
1419 <a class="anchor" id="Input-filenames"></a>
1420 <p>TeX, Metafont, and MetaPost source programs can all read other source
1421 files with the <code class="code">\input</code> (TeX) and <code class="code">input</code> (MF and MP)
1422 primitives:
1423 </p><div class="example">
1424 <pre class="example-preformatted">\input <var class="var">name</var> % in TeX
1425 </pre></div>
1426
1427 <a class="index-entry-id" id="index-space_002dterminated-filenames"></a>
1428 <a class="index-entry-id" id="index-whitespace_002dterminated-filenames"></a>
1429 <a class="index-entry-id" id="index-terminator-for-filenames"></a>
1430 <p>The file <var class="var">name</var> can always be terminated with whitespace; for
1431 Metafont and MetaPost, the statement terminator &lsquo;<samp class="samp">;</samp>&rsquo; also works.
1432 (LaTeX and other macro packages provide other interfaces to
1433 <code class="code">\input</code> that allow different notation; here we are concerned only
1434 with the primitive operation.)
1435 </p>
1436 <p>As an extension to standard TeX (allowed by Knuth&rsquo;s conditions),
1437 Web2c also supports specifying the filename in double quotes
1438 (<code class="code">&quot;some name&quot;</code>) and in a group, i.e., braces (<code class="code">{some
1439 name}</code>), which is convenient for filenames containing spaces or other
1440 special characters, as described in the sections below.
1441 </p>
1442 <p>In all cases, space tokens are ignored after the filename is read.
1443 </p>
1444 <a class="index-entry-id" id="index-_0022-character_002c-ignored-in-filenames"></a>
1445 <a class="index-entry-id" id="index-double-quote-character_002c-ignored-in-filenames"></a>
1446 <p>Also, double quote (<code class="code">&quot;</code>) characters are ignored within the
1447 filename; there is no way to read files whose names contain a <code class="code">&quot;</code>.
1448 </p>
1449 <a class="index-entry-id" id="index-portable-filenames"></a>
1450 <p>For maximal portability of your document across systems, use only the
1451 characters &lsquo;<samp class="samp">a</samp>&rsquo;&ndash;&lsquo;<samp class="samp">z</samp>&rsquo;, &lsquo;<samp class="samp">0</samp>&rsquo;&ndash;&lsquo;<samp class="samp">9</samp>&rsquo;, and at most one
1452 &lsquo;<samp class="samp">.</samp>&rsquo;. Do not use anything but simple filenames, since directory
1453 separators vary among systems; instead, add the necessary directories
1454 to the appropriate search path.
1455 </p>
1456
1457
1458 <ul class="mini-toc">
1459 <li><a href="#g_t_005cinput-quoted-filename" accesskey="1"><code class="code">\input</code> quoted filename: <code class="code">\input &quot;some name&quot;</code></a></li>
1460 <li><a href="#g_t_005cinput-braced-filename" accesskey="2"><code class="code">\input</code> braced filename: <code class="code">\input{some name}</code></a></li>
1461 <li><a href="#g_t_005cinput-filename-caveats" accesskey="3"><code class="code">\input</code> filename caveats</a></li>
1462 </ul>
1463 <hr>
1464 <div class="subsection-level-extent" id="g_t_005cinput-quoted-filename">
1465 <div class="nav-panel">
1466 <p>
1467 Next: <a href="#g_t_005cinput-braced-filename" accesskey="n" rel="next"><code class="code">\input</code> braced filename: <code class="code">\input{some name}</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code class="code">\input</code> filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1468 </div>
1469 <h4 class="subsection" id="g_t_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022"><span>4.5.1 <code class="code">\input</code> quoted filename: <code class="code">\input &quot;some name&quot;</code><a class="copiable-link" href="#g_t_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022"> &para;</a></span></h4>
1470
1471 <a class="index-entry-id" id="index-_005cinput-quoted-filename"></a>
1472 <a class="index-entry-id" id="index-quoted-filename-for-_005cinput"></a>
1473
1474 <p>As of Web2c version 7.5.3 (2004), double-quote characters can be used
1475 to include spaces or other special characters. In typical use, the
1476 &lsquo;<samp class="samp">&quot;</samp>&rsquo; characters surround the entire filename:
1477 </p><div class="example">
1478 <pre class="example-preformatted">\input &quot;filename with spaces&quot;
1479 </pre></div>
1480
1481 <p>Technically, the quote characters can be used inside the name, and
1482 can enclose any characters, as in:
1483 </p><div class="example">
1484 <pre class="example-preformatted">\input filename&quot; &quot;with&quot; &quot;spaces
1485 </pre></div>
1486
1487 <p>One more point. In LaTeX, the quotes are needed inside the braces
1488 of its <code class="code">\input</code> macro, thus:
1489 </p><div class="example">
1490 <pre class="example-preformatted">\input{a b} % fails
1491 \input{&quot;a b&quot;} % ok
1492 </pre></div>
1493
1494 <p>There is no way to quote the quote character.
1495 </p>
1496
1497 <hr>
1498 </div>
1499 <div class="subsection-level-extent" id="g_t_005cinput-braced-filename">
1500 <div class="nav-panel">
1501 <p>
1502 Next: <a href="#g_t_005cinput-filename-caveats" accesskey="n" rel="next"><code class="code">\input</code> filename caveats</a>, Previous: <a href="#g_t_005cinput-quoted-filename" accesskey="p" rel="prev"><code class="code">\input</code> quoted filename: <code class="code">\input &quot;some name&quot;</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code class="code">\input</code> filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1503 </div>
1504 <h4 class="subsection" id="g_t_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d"><span>4.5.2 <code class="code">\input</code> braced filename: <code class="code">\input{some name}</code><a class="copiable-link" href="#g_t_005cinput-braced-filename_003a-_005cinput_007bsome-name_007d"> &para;</a></span></h4>
1505
1506 <a class="index-entry-id" id="index-_005cinput-braced-_0028grouped_0029-filename"></a>
1507 <a class="index-entry-id" id="index-braced-filename-for-_005cinput"></a>
1508 <a class="index-entry-id" id="index-group_002ddelimited-filename-for-_005cinput"></a>
1509
1510 <p>As of Web2c 2020, <code class="code">\input</code> filenames in TeX engines (this does
1511 not apply in Metafont and MetaPost) can also be specified within a
1512 TeX group, typically curly braces. For example:
1513 </p><div class="example">
1514 <pre class="example-preformatted">\input{filename with spaces}
1515 </pre></div>
1516
1517 <p>As always with TeX, the brace characters are not hardwired; what
1518 counts is the category code: the first token after the <code class="code">\input</code>
1519 must be of catcode&nbsp;1 (begin group), and it is matched with the
1520 next character of catcode&nbsp;2 (end group).
1521 </p>
1522 <p>Within the group-delimited filename, braces are treated as normal
1523 characters.
1524 </p>
1525 <p>As with all forms of filenames, following spaces are ignored (after
1526 the end group), and double quote (<code class="code">&quot;</code>) characters are ignored
1527 within the filename.
1528 </p>
1529
1530 <hr>
1531 </div>
1532 <div class="subsection-level-extent" id="g_t_005cinput-filename-caveats">
1533 <div class="nav-panel">
1534 <p>
1535 Previous: <a href="#g_t_005cinput-braced-filename" accesskey="p" rel="prev"><code class="code">\input</code> braced filename: <code class="code">\input{some name}</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code class="code">\input</code> filenames</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1536 </div>
1537 <h4 class="subsection" id="g_t_005cinput-filename-caveats-1"><span>4.5.3 <code class="code">\input</code> filename caveats<a class="copiable-link" href="#g_t_005cinput-filename-caveats-1"> &para;</a></span></h4>
1538
1539 <a class="index-entry-id" id="index-_005cinput-filename-caveats"></a>
1540 <a class="index-entry-id" id="index-caveats-for-_005cinput-filenames"></a>
1541 <a class="index-entry-id" id="index-tokenization_002c-and-_005cinput-filenames"></a>
1542 <a class="index-entry-id" id="index-expansion_002c-and-_005cinput-filenames"></a>
1543 <a class="index-entry-id" id="index-multiple-spaces_002c-and-_005cinput-filenames"></a>
1544 <a class="index-entry-id" id="index-tabs_002c-and-_005cinput-filenames"></a>
1545 <p>The quoting mechanisms just described come into play <em class="emph">after</em>
1546 TeX has tokenized and expanded the input. So, multiple spaces and
1547 tabs will generally be seen as a single space, active characters such
1548 as &lsquo;<samp class="samp">~</samp>&rsquo; are expanded first (generally causing an error), and so
1549 on. More examples below.
1550 </p>
1551 <a class="index-entry-id" id="index-NUL-bytes_002c-not-allowed-in-filenames"></a>
1552 <a class="index-entry-id" id="index-eight_002dbit-characters-in-filenames"></a>
1553 <a class="index-entry-id" id="index-meta-characters-in-filenames"></a>
1554 <p>Various C library routines and Unix itself use the null byte
1555 (character code zero, ASCII NUL) to terminate strings. So filenames
1556 in Web2c cannot contain nulls, even though TeX itself does not
1557 treat NUL specially.
1558 </p>
1559 <a class="index-entry-id" id="index-CON_002c-reserved-filename-on-Windows"></a>
1560 <a class="index-entry-id" id="index-NUL_002c-reserved-filename-on-Windows"></a>
1561 <a class="index-entry-id" id="index-COM1_002e_002e0_002c-reserved-filename-on-Windows"></a>
1562 <p>Windows reserves a long list of alphanumeric filenames,
1563 case-insensitive and with any extension, such as &lsquo;<samp class="samp">CON</samp>&rsquo;,
1564 &lsquo;<samp class="samp">NUL</samp>&rsquo;, &lsquo;<samp class="samp">COM1</samp>&rsquo;, &lsquo;<samp class="samp">con.tex</samp>&rsquo;, etc.; see Windows systems
1565 documentation for the whole list. Trying to use such names will cause
1566 a system error on Windows.
1567 </p>
1568 <a class="index-entry-id" id="index-_007e-expansion-in-filenames"></a>
1569 <a class="index-entry-id" id="index-_0024-expansion-in-filenames"></a>
1570 <p>Finally, the present Web2c implementation does &lsquo;<samp class="samp">~</samp>&rsquo; and &lsquo;<samp class="samp">$</samp>&rsquo;
1571 expansion on <var class="var">name</var>, on all platforms, unlike Knuth&rsquo;s original
1572 program. Thus:
1573 </p>
1574 <div class="example">
1575 <pre class="example-preformatted">\input ~jsmith/$foo.bar
1576 </pre></div>
1577
1578 <p>will dereference the environment variable or Kpathsea config file
1579 value &lsquo;<samp class="samp">foo</samp>&rsquo; and read that file, extended with &lsquo;<samp class="samp">.bar</samp>&rsquo;, in
1580 user &lsquo;<samp class="samp">jsmith</samp>&rsquo;&rsquo;s home directory. You can also use braces in the
1581 variable expansion, as in &lsquo;<samp class="samp">${foo}bar</samp>&rsquo;, if you want to follow
1582 the variable name with a letter, numeral, or &lsquo;<samp class="samp">_</samp>&rsquo;.
1583 </p>
1584 <p>(So, another way to get a program to read a filename containing
1585 whitespace is to define an environment variable and dereference it.)
1586 </p>
1587 <a class="index-entry-id" id="index-_005cstring_002c-and-_005cinput-filenames"></a>
1588 <p>In all the common TeX formats (plain TeX, LaTeX, ConTeXt,
1589 &hellip;), the characters &lsquo;<samp class="samp">~</samp>&rsquo; and &lsquo;<samp class="samp">$</samp>&rsquo; have special category
1590 codes, so to use them within a document you have to change their
1591 catcodes or use <code class="code">\string</code>.
1592 </p>
1593
1594 <hr>
1595 </div>
1596 </div>
1597 </div>
1598 <div class="chapter-level-extent" id="TeX">
1599 <div class="nav-panel">
1600 <p>
1601 Next: <a href="#Metafont" accesskey="n" rel="next">Metafont: Creating typeface families</a>, Previous: <a href="#Three-programs" accesskey="p" rel="prev">Three programs: Metafont, MetaPost, and TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1602 </div>
1603 <h2 class="chapter" id="TeX_003a-Typesetting"><span>5 TeX: Typesetting<a class="copiable-link" href="#TeX_003a-Typesetting"> &para;</a></span></h2>
1604
1605 <a class="index-entry-id" id="index-TeX_002c-description-of"></a>
1606 <a class="index-entry-id" id="index-typesetting"></a>
1607 <a class="index-entry-id" id="index-mathematical-typesetting"></a>
1608
1609 <p>TeX is a typesetting system: it was especially designed to handle
1610 complex mathematics, as well as most ordinary text typesetting.
1611 </p>
1612 <a class="index-entry-id" id="index-batch-languages"></a>
1613 <a class="index-entry-id" id="index-word-processor_002c-not"></a>
1614 <p>TeX is a batch language, like C or Pascal, and not an interactive
1615 &ldquo;word processor&rdquo;: you compile a TeX input file into a corresponding
1616 device-independent (DVI) file (and then translate the DVI file to the
1617 commands for a particular output device). This approach has both
1618 considerable disadvantages and considerable advantages. For a complete
1619 description of the TeX language, see <cite class="cite">The TeXbook</cite>
1620 (see <a class="pxref" href="#References">References</a>). Many other books on TeX, introductory and
1621 otherwise, are available.
1622 </p>
1623
1624
1625 <ul class="mini-toc">
1626 <li><a href="#tex-invocation" accesskey="1"><code class="code">tex</code> invocation</a></li>
1627 <li><a href="#Initial-TeX" accesskey="2">Initial TeX</a></li>
1628 <li><a href="#Formats" accesskey="3">Formats</a></li>
1629 <li><a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a></li>
1630 <li><a href="#Shell-escapes" accesskey="5">Shell escapes</a></li>
1631 <li><a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a></li>
1632 <li><a href="#TeX-extensions" accesskey="7">Extended TeX engines</a></li>
1633 </ul>
1634 <hr>
1635 <div class="section-level-extent" id="tex-invocation">
1636 <div class="nav-panel">
1637 <p>
1638 Next: <a href="#Initial-TeX" accesskey="n" rel="next">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1639 </div>
1640 <h3 class="section" id="tex-invocation-1"><span>5.1 <code class="code">tex</code> invocation<a class="copiable-link" href="#tex-invocation-1"> &para;</a></span></h3>
1641
1642 <a class="index-entry-id" id="index-tex"></a>
1643 <a class="index-entry-id" id="index-TeX_002c-invocation"></a>
1644
1645 <p>TeX (usually invoked as <code class="code">tex</code>) formats the given text and
1646 commands, and outputs a corresponding device-independent representation
1647 of the typeset document. This section merely describes the options
1648 available in the Web2c implementation. For a complete description of
1649 the TeX typesetting language, see <cite class="cite">The TeXbook</cite>
1650 (see <a class="pxref" href="#References">References</a>).
1651 </p>
1652 <p>TeX, Metafont, and MetaPost process the command line (described
1653 here) and determine their memory dump (fmt) file in the same way
1654 (see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). Synopses:
1655 </p>
1656 <div class="example">
1657 <pre class="example-preformatted">tex [<var class="var">option</var>]... [<var class="var">texname</var>[.tex]] [<var class="var">more-input</var>]
1658 tex [<var class="var">option</var>]... \<var class="var">more-input</var>
1659 tex [<var class="var">option</var>]... &amp;<var class="var">fmt</var> <var class="var">first-line</var>
1660 </pre></div>
1661
1662 <p>In short, TeX prepends <code class="code">\input </code> to non-option command line
1663 arguments or the input to the &lsquo;<samp class="samp">**</samp>&rsquo; prompt, and then processes the
1664 result as normal TeX input, including expansion.
1665 </p>
1666 <p>The most common invocation is &lsquo;<samp class="samp">tex somefile</samp>&rsquo;, which reads
1667 &lsquo;<samp class="samp">somefile.tex</samp>&rsquo;, normally from the current directory. It is
1668 equivalent to <code class="code">\input somefile</code>.
1669 </p>
1670 <p>In more detail:
1671 </p>
1672 <a class="index-entry-id" id="index-_002etex"></a>
1673 <a class="index-entry-id" id="index-TeX_002c-input-files-found"></a>
1674 <p>TeX searches the usual places for the main input file <var class="var">texname</var>
1675 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>), extending
1676 <var class="var">texname</var> with <samp class="file">.tex</samp> if necessary. To see all the
1677 relevant paths, set the environment variable <code class="code">KPATHSEA_DEBUG</code> to
1678 &lsquo;<samp class="samp">-1</samp>&rsquo; before running the program.
1679 </p>
1680 <p>After <var class="var">texname</var> is read, TeX processes any remaining
1681 <var class="var">more-input</var> on the command line as regular TeX input. Also,
1682 if the first non-option argument begins with a TeX escape character
1683 (usually <code class="code">\</code>), TeX processes all non-option command-line
1684 arguments as a line of regular TeX input. The backslash or other
1685 escape character usually has to be escaped to avoid being processed by
1686 your shell.
1687 </p>
1688 <p>If no arguments or options are specified, TeX prompts for an input
1689 filename with &lsquo;<samp class="samp">**</samp>&rsquo;. Whatever input is given in response to
1690 &lsquo;<samp class="samp">**</samp>&rsquo; is processed exactly like a command line not starting with
1691 an escape character, i.e., <code class="code">\input</code> is prepended and then the
1692 entire line is processed as normal TeX intput.
1693 </p>
1694 <p>Thus, the text of an input filename, as well as any text following a
1695 filename, is subject to TeX&rsquo;s normal macro expansion. As a result, a
1696 &lsquo;<samp class="samp">~</samp>&rsquo; character is normally not usable within a filename, since by
1697 default &lsquo;<samp class="samp">~</samp>&rsquo; is defined (in plain TeX, LaTeX, etc.) to be
1698 an active character that expands into several primitive tokens that
1699 can&rsquo;t be part of a filename. As a special case in Web2c, a &lsquo;<samp class="samp">~</samp>&rsquo;
1700 <em class="emph">beginning</em> a filename refers to a user&rsquo;s home directory
1701 (see <a class="pxref" href="#g_t_005cinput-filename-caveats"><code class="code">\input</code> filename caveats</a>), but you still have to arrange for
1702 TeX to see a &lsquo;<samp class="samp">~</samp>&rsquo; character rather than the expansion of &lsquo;<samp class="samp">~</samp>&rsquo;.
1703 </p>
1704 <p>To summarize the usual cases (in all these cases, <code class="code">tex</code> also
1705 reads <samp class="file">tex.fmt</samp> before starting any processing):
1706 </p>
1707 <ul class="itemize mark-bullet">
1708 <li>&lsquo;<samp class="samp">tex foo</samp>&rsquo; executes &lsquo;<samp class="samp">\input foo</samp>&rsquo;.
1709
1710 </li><li>&lsquo;<samp class="samp">tex foo bar</samp>&rsquo; executes &lsquo;<samp class="samp">\input foo bar</samp>&rsquo;, which inputs
1711 <samp class="file">foo.tex</samp> and then typesets &lsquo;<samp class="samp">bar</samp>&rsquo;.
1712
1713 </li><li>&lsquo;<samp class="samp">tex \\end</samp>&rsquo; executes &lsquo;<samp class="samp">\end</samp>&rsquo;; here the double backslash
1714 is one common way of escaping the backslash for the shell. TeX only
1715 sees one backslash.
1716
1717 </li><li>&lsquo;<samp class="samp">tex</samp>&rsquo; with no arguments prints a &lsquo;<samp class="samp">**</samp>&rsquo; prompt.
1718 Entering &lsquo;<samp class="samp">foo bar</samp>&rsquo; at the &lsquo;<samp class="samp">**</samp>&rsquo; prompt again executes
1719 &lsquo;<samp class="samp">\input foo</samp>&rsquo; and typesets &lsquo;<samp class="samp">bar</samp>&rsquo;.
1720 </li></ul>
1721
1722 <a class="index-entry-id" id="index-texput"></a>
1723 <p>TeX writes its main output, a DVI file, to
1724 <samp class="file"><var class="var">basetexname</var>.dvi</samp>, where <var class="var">basetexname</var> is the basename
1725 of <var class="var">texname</var>, or &lsquo;<samp class="samp">texput</samp>&rsquo; if no input file was specified.
1726 </p>
1727 <p>A DVI file is a device-independent binary representation of your
1728 document. You can translate the DVI file, using independent programs,
1729 to whatever may be needed, such as a PDF file (see dvipdfmx(1)),
1730 a PostScript file (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite class="cite">Dvips</cite>), an SVG file
1731 (see dvisvgm(1)), etc. There are also variants of TeX that can
1732 produce PDF files directly, namely pdfTeX and LuaTeX (see <a class="pxref" href="#TeX-extensions">Extended TeX engines</a>).
1733 </p>
1734 <p>The program accepts the following options, as well as the standard
1735 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
1736 </p>
1737 <dl class="table">
1738 <dt>&lsquo;<samp class="samp">-enc</samp>&rsquo;</dt>
1739 <dt>&lsquo;<samp class="samp">-[no]-file-line-error</samp>&rsquo;</dt>
1740 <dt>&lsquo;<samp class="samp">-fmt=<var class="var">fmtname</var></samp>&rsquo;</dt>
1741 <dt>&lsquo;<samp class="samp">-halt-on-error</samp>&rsquo;</dt>
1742 <dt>&lsquo;<samp class="samp">-ini</samp>&rsquo;</dt>
1743 <dt>&lsquo;<samp class="samp">-interaction=<var class="var">string</var></samp>&rsquo;</dt>
1744 <dt>&lsquo;<samp class="samp">-ipc</samp>&rsquo;</dt>
1745 <dt>&lsquo;<samp class="samp">-ipc-start</samp>&rsquo;</dt>
1746 <dt>&lsquo;<samp class="samp">-jobname=<var class="var">string</var></samp>&rsquo;</dt>
1747 <dt>&lsquo;<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>&rsquo;</dt>
1748 <dt>&lsquo;<samp class="samp">-[no]parse-first-line</samp>&rsquo;</dt>
1749 <dt>&lsquo;<samp class="samp">-output-directory</samp>&rsquo;</dt>
1750 <dt>&lsquo;<samp class="samp">-progname=<var class="var">string</var></samp>&rsquo;</dt>
1751 <dt>&lsquo;<samp class="samp">-recorder</samp>&rsquo;</dt>
1752 <dt>&lsquo;<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>&rsquo;</dt>
1753 <dt>&lsquo;<samp class="samp">-8bit</samp>&rsquo;</dt>
1754 <dd><p>These options are common to TeX, Metafont, and MetaPost.
1755 See <a class="xref" href="#Common-options">Common options</a>.
1756 </p>
1757 </dd>
1758 <dt><a class="index-entry-id" id="index-Unicode-input"></a>
1759 <a class="index-entry-id" id="index-UTF_002d8-input"></a>
1760 <a id="index-_002denc"></a><span>&lsquo;<samp class="samp">-enc</samp>&rsquo;<a class="copiable-link" href="#index-_002denc"> &para;</a></span></dt>
1761 <dd><p>Enable encTeX extensions, such as <code class="code">\mubyte</code>. This can be used
1762 to support the Unicode UTF-8 input encoding, although using an engine
1763 with native Unicode support is more common nowadays.
1764 <a class="url" href="http://www.olsak.net/enctex.html">http://www.olsak.net/enctex.html</a>.
1765 </p>
1766 </dd>
1767 <dt><a class="index-entry-id" id="index-_002dipc_002dstart"></a>
1768 <a class="index-entry-id" id="index-_002d_002denable_002dipc-configure-option"></a>
1769 <a id="index-_002dipc"></a><span>&lsquo;<samp class="samp">-ipc</samp>&rsquo;<a class="copiable-link" href="#index-_002dipc"> &para;</a></span></dt>
1770 <dt>&lsquo;<samp class="samp">-ipc-start</samp>&rsquo;</dt>
1771 <dd><p>With either option, TeX writes its DVI output to a socket as well as
1772 to the usual <samp class="file">.dvi</samp> file. With &lsquo;<samp class="samp">-ipc-start</samp>&rsquo;, TeX also
1773 opens a server program at the other end to read the output. See <a class="xref" href="#IPC-and-TeX">IPC and TeX</a>.
1774 </p>
1775 <p>These options are available only if the &lsquo;<samp class="samp">--enable-ipc</samp>&rsquo; option was
1776 specified to <code class="code">configure</code> during installation of Web2c.
1777 </p>
1778 </dd>
1779 <dt><a class="index-entry-id" id="index-_002dno_002dmktex_003dfiletype"></a>
1780 <a id="index-_002dmktex_003dfiletype"></a><span>&lsquo;<samp class="samp">-mktex=<var class="var">filetype</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmktex_003dfiletype"> &para;</a></span></dt>
1781 <dt>&lsquo;<samp class="samp">-no-mktex=<var class="var">filetype</var></samp>&rsquo;</dt>
1782 <dd><p>Turn on or off the &lsquo;<samp class="samp">mktex</samp>&rsquo; script associated with <var class="var">filetype</var>.
1783 For TeX proper, <var class="var">filetype</var> can only be &lsquo;<samp class="samp">tex</samp>&rsquo; and
1784 &lsquo;<samp class="samp">tfm</samp>&rsquo;, but for pdfTeX and LuaTeX, it can also be &lsquo;<samp class="samp">pk</samp>&rsquo;.
1785 </p>
1786 </dd>
1787 <dt><a class="index-entry-id" id="index-MLTeX_002c-enabling"></a>
1788 <a class="index-entry-id" id="index-program-names_002c-special-2"></a>
1789 <a id="index-_002dmltex"></a><span>&lsquo;<samp class="samp">-mltex</samp>&rsquo;<a class="copiable-link" href="#index-_002dmltex"> &para;</a></span></dt>
1790 <dd><p>If we are <code class="code">INITEX</code> (see <a class="pxref" href="#Initial-and-virgin">Initial and virgin</a>), enable MLTeX
1791 extensions such as <code class="code">\charsubdef</code>. Implicitly set if the program
1792 name is <code class="code">mltex</code>. See <a class="xref" href="#MLTeX">MLTeX</a>.
1793 </p>
1794 </dd>
1795 <dt><a class="index-entry-id" id="index-output_005fcomment-for-DVI-files"></a>
1796 <a class="index-entry-id" id="index-DVI-comment_002c-specifying"></a>
1797 <a class="index-entry-id" id="index-regression-testing"></a>
1798 <a id="index-_002doutput_002dcomment_003dstring"></a><span>&lsquo;<samp class="samp">-output-comment=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002doutput_002dcomment_003dstring"> &para;</a></span></dt>
1799 <dd><p>Use <var class="var">string</var> as the DVI file comment. Ordinarily, this comment
1800 records the date and time of the TeX run, but if you are doing
1801 regression testing, you may not want the DVI file to have this spurious
1802 difference. This is also taken from the environment variable and
1803 config file value &lsquo;<samp class="samp">output_comment</samp>&rsquo;.
1804 </p>
1805 </dd>
1806 <dt><a id="index-_002dshell_002drestricted"></a><span>&lsquo;<samp class="samp">-shell-escape</samp>&rsquo;<a class="copiable-link" href="#index-_002dshell_002drestricted"> &para;</a></span></dt>
1807 <dd><a class="index-entry-id" id="index-_002dshell_002descape"></a>
1808 </dd>
1809 <dt>&lsquo;<samp class="samp">-no-shell-escape</samp>&rsquo;</dt>
1810 <dd><a class="index-entry-id" id="index-_002dno_002dshell_002descape"></a>
1811 </dd>
1812 <dt>&lsquo;<samp class="samp">-shell-restricted</samp>&rsquo;</dt>
1813 <dd><p>Enable, or disable, or enable with restrictions the
1814 <code class="code">\write18{<var class="var">shell-command</var>}</code> feature for external execution of
1815 shell commands. See <a class="xref" href="#Shell-escapes">Shell escapes</a>.
1816 </p>
1817 </dd>
1818 <dt><a id="index-_002ddisable_002dwrite18"></a><span>&lsquo;<samp class="samp">-enable-write18</samp>&rsquo;<a class="copiable-link" href="#index-_002ddisable_002dwrite18"> &para;</a></span></dt>
1819 <dd><a class="index-entry-id" id="index-_002denable_002dwrite18"></a>
1820 </dd>
1821 <dt>&lsquo;<samp class="samp">-disable-write18</samp>&rsquo;</dt>
1822 <dd><p>Synonyms for <samp class="option">-shell-escape</samp> and <samp class="option">-no-shell-escape</samp>, for
1823 compatibility with MiKTeX. (MiKTeX also accepts both pairs of
1824 options.) See <a class="xref" href="#Shell-escapes">Shell escapes</a>.
1825 </p>
1826 </dd>
1827 <dt><a id="index-generating-source-specials"></a><span>&lsquo;<samp class="samp">-src-specials</samp>&rsquo;<a class="copiable-link" href="#index-generating-source-specials"> &para;</a></span></dt>
1828 <dt>&lsquo;<samp class="samp">-src-specials=<var class="var">string</var></samp>&rsquo;</dt>
1829 <dd><p>This option makes TeX output specific source information using
1830 &lsquo;<samp class="samp">\special</samp>&rsquo; commands in the DVI file. These &lsquo;<samp class="samp">\special</samp>&rsquo; track
1831 the current filename and line number.
1832 </p>
1833 <p>Using the first form of this option, the &lsquo;<samp class="samp">\special</samp>&rsquo; commands are
1834 inserted automatically.
1835 </p>
1836 <p>In the second form of the option, <var class="var">string</var> is
1837 a comma separated list of the following values: &lsquo;<samp class="samp">cr</samp>&rsquo;,
1838 &lsquo;<samp class="samp">display</samp>&rsquo;, &lsquo;<samp class="samp">hbox</samp>&rsquo;, &lsquo;<samp class="samp">math</samp>&rsquo;, &lsquo;<samp class="samp">par</samp>&rsquo;, &lsquo;<samp class="samp">parend</samp>&rsquo;,
1839 &lsquo;<samp class="samp">vbox</samp>&rsquo;. You can use this list to specify where you want TeX to
1840 output such commands. For example, &lsquo;<samp class="samp">-src-specials=cr,math</samp>&rsquo; will
1841 output source information every line and every math formula.
1842 </p>
1843 <p>These commands can be used with the appropriate DVI viewer and text
1844 editor to switch from the current position in the editor to the same
1845 position in the viewer and back from the viewer
1846 to the editor.
1847 </p>
1848 <p>This option works by inserting &lsquo;<samp class="samp">\special</samp>&rsquo; commands into the token
1849 stream, and thus in principle these additional tokens can be recovered
1850 or seen by the tricky-enough macros. If you run across a case, let us
1851 know, because this counts as a bug. However, such bugs are very hard
1852 to fix, requiring significant changes to TeX, so please don&rsquo;t count
1853 on it.
1854 </p>
1855 <p>Redefining &lsquo;<samp class="samp">\special</samp>&rsquo; will not affect the functioning of this
1856 option. The commands inserted into the token stream are
1857 hard-coded to always use the &lsquo;<samp class="samp">\special</samp>&rsquo; primitive.
1858 </p>
1859 <p>TeX does not pass the <code class="code">TRIP</code> test when this option is enabled.
1860 </p>
1861 </dd>
1862 </dl>
1863
1864 <p>Other input and output that can happen:
1865 </p>
1866 <ul class="itemize mark-bullet">
1867 <li><a class="index-entry-id" id="index-mktextfm_002c-disabling"></a>
1868 <a class="index-entry-id" id="index-_005cfont-and-dynamic-generation"></a>
1869 TeX also reads TFM files for any fonts you load in your document with
1870 the <code class="code">\font</code> primitive. By default, it runs an external program
1871 named <samp class="file">mktextfm</samp> to create any nonexistent TFM files. You can
1872 disable this at configure-time or runtime (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex
1873 configuration</a> in <cite class="cite">Kpathsea</cite>).
1874
1875 </li><li><a class="index-entry-id" id="index-_005copenout-and-security"></a>
1876 <a class="index-entry-id" id="index-security_002c-and-_005copenout"></a>
1877 <a class="index-entry-id" id="index-output-files_002c-written-by-TeX-programs"></a>
1878 <a class="index-entry-id" id="index-Trojan-horses-and-TeX-programs"></a>
1879 <a class="index-entry-id" id="index-dot-files_002c-written-by-TeX-programs"></a>
1880 <a class="index-entry-id" id="index-security_002c-and-output-files"></a>
1881 TeX can write output files, via the <code class="code">\openout</code> primitive. This
1882 raises the possibility of a Trojan horse attack: an unwitting user
1883 could run a TeX program that overwrites, say,
1884 <samp class="file">$HOME/.ssh/authorized_keys</samp>. (MetaPost has a <code class="code">write</code>
1885 primitive with similar implications.)
1886
1887 <p>To alleviate this and similar problems, the functions
1888 <code class="code">kpathsea_out_name_ok</code> and <code class="code">kpathsea_in_name_ok</code> from the
1889 Kpathsea library (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling sequence</a> in <cite class="cite">Kpathsea</cite>) are
1890 used to determine if a given filename is acceptable to be opened for
1891 output or input, depending on the setting of the configuration
1892 variables <code class="code">openout_any</code> and <code class="code">openin_any</code>: &lsquo;<samp class="samp">a</samp>&rsquo; (for
1893 &ldquo;any&rdquo;, the default for <code class="code">openin_any</code>), &lsquo;<samp class="samp">r</samp>&rsquo; (for
1894 &ldquo;restricted&rdquo;), or &lsquo;<samp class="samp">p</samp>&rsquo; (for &ldquo;paranoid&rdquo;, the default for
1895 <code class="code">openout_any</code>).
1896 </p>
1897 <p>In any case, all <code class="code">\openout</code> filenames are recorded in the log file,
1898 except those opened on the first line of input, which is processed before
1899 the log file has been opened.
1900 </p>
1901 </li></ul>
1902
1903 <hr>
1904 </div>
1905 <div class="section-level-extent" id="Initial-TeX">
1906 <div class="nav-panel">
1907 <p>
1908 Next: <a href="#Formats" accesskey="n" rel="next">Formats</a>, Previous: <a href="#tex-invocation" accesskey="p" rel="prev"><code class="code">tex</code> invocation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1909 </div>
1910 <h3 class="section" id="Initial-TeX-1"><span>5.2 Initial TeX<a class="copiable-link" href="#Initial-TeX-1"> &para;</a></span></h3>
1911
1912 <a class="index-entry-id" id="index-initial-TeX"></a>
1913 <a class="index-entry-id" id="index-TeX_002c-initial"></a>
1914
1915 <a class="index-entry-id" id="index-_002efmt"></a>
1916 <a class="index-entry-id" id="index-fmt-files"></a>
1917 <p>The <em class="dfn">initial</em> form of TeX is invoked by &lsquo;<samp class="samp">tex -ini</samp>&rsquo;. It
1918 does lengthy initializations avoided by the &ldquo;virgin&rdquo; (<code class="code">vir</code>)
1919 form, so as to be capable of dumping &lsquo;<samp class="samp">.fmt</samp>&rsquo; files (see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). For a detailed comparison of virgin and initial forms,
1920 see <a class="pxref" href="#Initial-and-virgin">Initial and virgin</a>.
1921 </p>
1922 <p>For a list of options and other information, see <a class="pxref" href="#tex-invocation"><code class="code">tex</code> invocation</a>.
1923 </p>
1924 <a class="index-entry-id" id="index-plain_002efmt"></a>
1925 <a class="index-entry-id" id="index-tex_002efmt"></a>
1926 <a class="index-entry-id" id="index-format-files"></a>
1927 <p>Unlike Metafont and MetaPost, many format files are commonly used with
1928 TeX. The standard one implementing the features described in
1929 <cite class="cite">The TeXbook</cite> is &lsquo;<samp class="samp">plain.fmt</samp>&rsquo;, also known as
1930 &lsquo;<samp class="samp">tex.fmt</samp>&rsquo; (again, see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). It is created by
1931 default during installation, but you can also do so by hand if
1932 necessary:
1933 </p>
1934 <div class="example">
1935 <pre class="example-preformatted">tex -ini '\input plain \dump'
1936 </pre></div>
1937
1938 <p>(The quotes prevent interpretation of the backslashes from the shell.)
1939 Then put the resulting <samp class="file">plain.fmt</samp> where TeX will find it, and
1940 link <samp class="file">tex.fmt</samp> to it. Any existing <samp class="file">tex.fmt</samp> can be found
1941 with the invocation:
1942 </p>
1943 <div class="example">
1944 <pre class="example-preformatted">kpsewhich --all --engine=/ tex.fmt
1945 </pre></div>
1946
1947 <p>See <a class="xref" href="#Formats">Formats</a>, for more details on TeX formats.
1948 </p>
1949 <hr>
1950 </div>
1951 <div class="section-level-extent" id="Formats">
1952 <div class="nav-panel">
1953 <p>
1954 Next: <a href="#Languages-and-hyphenation" accesskey="n" rel="next">Languages and hyphenation</a>, Previous: <a href="#Initial-TeX" accesskey="p" rel="prev">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1955 </div>
1956 <h3 class="section" id="Formats-1"><span>5.3 Formats<a class="copiable-link" href="#Formats-1"> &para;</a></span></h3>
1957
1958 <a class="index-entry-id" id="index-formats-for-TeX"></a>
1959 <a class="index-entry-id" id="index-TeX_002c-format-packages-for"></a>
1960 <a class="index-entry-id" id="index-macro-packages_002c-major-TeX"></a>
1961
1962 <p>TeX <em class="dfn">formats</em> are large collections of macros, often dumped
1963 into a <samp class="file">.fmt</samp> file (see <a class="pxref" href="#Memory-dumps">Memory dumps</a>) by <code class="code">tex -ini</code>
1964 (see <a class="pxref" href="#Initial-TeX">Initial TeX</a>). A number of formats are in reasonably
1965 widespread use. The formats are generally selected, installed, and
1966 updated as part of a larger TeX distribution, such as TeX Live
1967 (<a class="url" href="https://tug.org/texlive">https://tug.org/texlive</a>).
1968 </p>
1969 <dl class="table">
1970 <dt><a id="index-LaTeX"></a><span><code class="t">latex</code><a class="copiable-link" href="#index-LaTeX"> &para;</a></span></dt>
1971 <dd><p>The most widely used format, called LaTeX, based on LaTeX2e and
1972 also incorporating LaTeX3; new versions are released approximately
1973 every six months, with patches issued as needed. The old release was
1974 called &lsquo;LaTeX 2.09&rsquo;, and is no longer maintained or supported,
1975 though compatibility for 2.09 documents is retained. LaTeX
1976 attempts to provide generic markup instructions, such as
1977 &ldquo;emphasize&rdquo;, instead of specific typesetting instructions, such as
1978 &ldquo;use the 10<span class="dmn">pt</span> Computer Modern italic font&rdquo;. The LaTeX home
1979 page: <a class="url" href="https://www.latex-project.org">https://www.latex-project.org</a>.
1980 </p>
1981 </dd>
1982 <dt><a class="index-entry-id" id="index-LaTeX-testing"></a>
1983 <a class="index-entry-id" id="index-testing-LaTeX"></a>
1984 <a id="index-latex_002ddev"></a><span><code class="t">latex-dev</code><a class="copiable-link" href="#index-latex_002ddev"> &para;</a></span></dt>
1985 <dd><p>A set of formats and executables made so that anyone interested can
1986 easily help test upcoming LaTeX releases. They correspond to new
1987 formats which have been tested by the LaTeX team for stability and
1988 usability. Testing by as many users as possible is desired and
1989 requested. Simply changing the regular engine name (e.g.,
1990 <code class="command">pdflatex</code>), to have a <code class="t">-dev</code> suffix
1991 (<code class="command">pdflatex-dev</code>) in your invocations is all that should be
1992 needed. No changes to source documents should be required.
1993 </p>
1994 </dd>
1995 <dt><a id="index-ConTeXt"></a><span><code class="t">context</code><a class="copiable-link" href="#index-ConTeXt"> &para;</a></span></dt>
1996 <dd><p>ConTeXt is an independent macro package which also supports a
1997 document structuring approach. It can also create interactive PDF
1998 files and has an integrated MetaPost library for graphics, among many
1999 other advanced features. It uses its own engine, LuaMetaTeX,
2000 developed in tandem. The ConTeXt home page:
2001 <a class="url" href="http://www.pragma-ade.com">http://www.pragma-ade.com</a>.
2002 </p>
2003 </dd>
2004 <dt><a class="index-entry-id" id="index-expanded-plain-format"></a>
2005 <a id="index-Eplain"></a><span><code class="t">eplain</code><a class="copiable-link" href="#index-Eplain"> &para;</a></span></dt>
2006 <dd><p>An &ldquo;expanded plain&rdquo; format that provides various common features
2007 (e.g., symbolic cross-referencing, tables of contents, indexing,
2008 citations using BibTeX), for those authors who prefer to handle
2009 their own high-level formatting. The Eplain home page:
2010 <a class="url" href="https://tug.org/eplain">https://tug.org/eplain</a>.
2011 </p>
2012 </dd>
2013 <dt><a class="index-entry-id" id="index-Info-format"></a>
2014 <a class="index-entry-id" id="index-Free-Software-Foundation-documentation-system"></a>
2015 <a id="index-Texinfo"></a><span><code class="t">texinfo</code><a class="copiable-link" href="#index-Texinfo"> &para;</a></span></dt>
2016 <dd><p>The documentation system developed and maintained by the Free Software
2017 Foundation for their software manuals. It can be automatically
2018 converted into HTML, plain text, a machine-readable online format
2019 called Info, etc. The Texinfo home page:
2020 <a class="url" href="https://www.gnu.org/software/texinfo">https://www.gnu.org/software/texinfo</a>.
2021 </p>
2022 </dd>
2023 <dt><a class="index-entry-id" id="index-American-Mathematical-Society_002c-typesetting-system"></a>
2024 <a class="index-entry-id" id="index-Mathematical-Reviews"></a>
2025 <a id="index-AMSTeX"></a><span><code class="t">amstex</code><a class="copiable-link" href="#index-AMSTeX"> &para;</a></span></dt>
2026 <dd><p>This was the official typesetting system of the American Mathematical
2027 Society; nowadays, the AMS recommends authors use LaTeX; the AMS
2028 provides a number of LaTeX packages important for math typesetting.
2029 The AMS&rsquo;s TeX page:
2030 <a class="url" href="https://www.ams.org/tex">https://www.ams.org/tex</a>.
2031 </p>
2032 </dd>
2033 <dt><a class="index-entry-id" id="index-slides_002c-producing"></a>
2034 <a class="index-entry-id" id="index-beamer_002c-package"></a>
2035 <a class="index-entry-id" id="index-slides_002c-package"></a>
2036 <a class="index-entry-id" id="index-ltx_002dtalk_002c-package"></a>
2037 <a id="index-SliTeX"></a><span><code class="t">slitex</code><a class="copiable-link" href="#index-SliTeX"> &para;</a></span></dt>
2038 <dd><p>An obsolete LaTeX 2.09 format for making slides. In core
2039 LaTeX2e, it is replaced by the &lsquo;<samp class="samp">slides</samp>&rsquo; document class. As of
2040 2025, the &lsquo;<samp class="samp">ltx-talk</samp>&rsquo; class is also provided for typesetting
2041 presentations, including accessibility support:
2042 <a class="url" href="https://ctan.org/pkg/ltx-talk">https://ctan.org/pkg/ltx-talk</a>. The &lsquo;<samp class="samp">beamer</samp>&rsquo; package is
2043 perhaps the most commonly used method for making slides nowadays:
2044 <a class="url" href="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer</a>.
2045 </p>
2046 </dd>
2047 </dl>
2048
2049
2050 <hr>
2051 </div>
2052 <div class="section-level-extent" id="Languages-and-hyphenation">
2053 <div class="nav-panel">
2054 <p>
2055 Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previous: <a href="#Formats" accesskey="p" rel="prev">Formats</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2056 </div>
2057 <h3 class="section" id="Languages-and-hyphenation-1"><span>5.4 Languages and hyphenation<a class="copiable-link" href="#Languages-and-hyphenation-1"> &para;</a></span></h3>
2058
2059 <a class="index-entry-id" id="index-language-support-in-TeX"></a>
2060 <a class="index-entry-id" id="index-human-languages_002c-supported-in-TeX"></a>
2061 <a class="index-entry-id" id="index-hyphenation-and-languages"></a>
2062
2063 <p>TeX supports most natural languages. See also <a class="ref" href="#TeX-extensions">TeX extensions</a>.
2064 </p>
2065
2066
2067 <ul class="mini-toc">
2068 <li><a href="#MLTeX" accesskey="1">MLTeX: Multi-lingual TeX</a></li>
2069 <li><a href="#TCX-files" accesskey="2">TCX files: Character translations</a></li>
2070 <li><a href="#patgen-invocation" accesskey="3">Patgen: Creating hyphenation patterns</a></li>
2071 </ul>
2072 <hr>
2073 <div class="subsection-level-extent" id="MLTeX">
2074 <div class="nav-panel">
2075 <p>
2076 Next: <a href="#TCX-files" accesskey="n" rel="next">TCX files: Character translations</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2077 </div>
2078 <h4 class="subsection" id="MLTeX_003a-Multi_002dlingual-TeX"><span>5.4.1 MLTeX: Multi-lingual TeX<a class="copiable-link" href="#MLTeX_003a-Multi_002dlingual-TeX"> &para;</a></span></h4>
2079
2080 <a class="index-entry-id" id="index-mltex"></a>
2081 <a class="index-entry-id" id="index-Multi_002dlingual-TeX"></a>
2082
2083 <a class="index-entry-id" id="index-Ferguson_002c-Michael"></a>
2084 <a class="index-entry-id" id="index-Raichle_002c-Bernd"></a>
2085 <a class="index-entry-id" id="index-accents_002c-hyphenating-words-with"></a>
2086 <a class="index-entry-id" id="index-glyph-substitutions"></a>
2087 <a class="index-entry-id" id="index-substitutions-of-font-glyphs"></a>
2088 <p>Multi-lingual TeX (<code class="code">mltex</code>) is an extension of TeX originally
2089 written by Michael Ferguson and now updated and maintained by Bernd
2090 Raichle. With the advent of Unicode, it has become obsolete, though
2091 it is still supported in Web2c in the event of bugs or compilation
2092 bugs.
2093 </p>
2094 <p>MLTeX allows the use of non-existing glyphs in a font by declaring
2095 glyph substitutions. These are restricted to substitutions of an
2096 accented character glyph, which need not be defined in the current
2097 font, by its appropriate <code class="code">\accent</code> construction using a base and
2098 accent character glyph, which do have to exist in the current font.
2099 This substitution is automatically done behind the scenes, if
2100 necessary, and thus MLTeX additionally supports hyphenation of
2101 words containing an accented character glyph for fonts missing this
2102 glyph (e.g., Computer Modern). Standard TeX suppresses hyphenation
2103 in this case.
2104 </p>
2105 <p>MLTeX works at <samp class="file">.fmt</samp>-creation time: the basic idea is to
2106 specify the &lsquo;<samp class="samp">-mltex</samp>&rsquo; option to TeX when you <code class="code">\dump</code> a
2107 format. Then, when you subsequently invoke TeX and read that
2108 <code class="code">.fmt</code> file, the MLTeX features described below will be enabled.
2109 </p>
2110 <p>Generally, you use special macro files to create an MLTeX <code class="code">.fmt</code>
2111 file.
2112 </p>
2113 <p>The sections below describe the two new primitives that MLTeX defines.
2114 Aside from these, MLTeX is completely compatible with standard TeX.
2115 </p>
2116
2117
2118 <ul class="mini-toc">
2119 <li><a href="#g_t_005ccharsubdef" accesskey="1"><code class="code">\charsubdef</code>: Character substitutions</a></li>
2120 <li><a href="#g_t_005ctracingcharsubdef" accesskey="2"><code class="code">\tracingcharsubdef</code>: Substitution diagnostics</a></li>
2121 </ul>
2122 <hr>
2123 <div class="subsubsection-level-extent" id="g_t_005ccharsubdef">
2124 <div class="nav-panel">
2125 <p>
2126 Next: <a href="#g_t_005ctracingcharsubdef" accesskey="n" rel="next"><code class="code">\tracingcharsubdef</code>: Substitution diagnostics</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX: Multi-lingual TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2127 </div>
2128 <h4 class="subsubsection" id="g_t_005ccharsubdef_003a-Character-substitutions"><span>5.4.1.1 <code class="code">\charsubdef</code>: Character substitutions<a class="copiable-link" href="#g_t_005ccharsubdef_003a-Character-substitutions"> &para;</a></span></h4>
2129
2130 <a class="index-entry-id" id="index-_005ccharsubdef-and-MLTeX"></a>
2131
2132 <p>The most important primitive MLTeX adds is <code class="code">\charsubdef</code>, used
2133 in a way reminiscent of <code class="code">\chardef</code>:
2134 </p><div class="example">
2135 <pre class="example-preformatted">\charsubdef <var class="var">composite</var> [=] <var class="var">accent</var> <var class="var">base</var>
2136 </pre></div>
2137
2138 <p>Each of <var class="var">composite</var>, <var class="var">accent</var>, and <var class="var">base</var> are font glyph
2139 numbers, expressed in the usual TeX syntax: <code class="t">`\e</code> symbolically,
2140 <code class="t">'145</code> for octal, <code class="t">&quot;65</code> for hex, <code class="t">101</code> for decimal.
2141 </p>
2142 <p>MLTeX&rsquo;s <code class="code">\charsubdef</code> declares how to construct an accented
2143 character glyph (not necessarily existing in the current font) using two
2144 character glyphs (that do exist). Thus it defines whether a character
2145 glyph code, either typed as a single character or using the <code class="code">\char</code>
2146 primitive, will be mapped to a font glyph or to an <code class="code">\accent</code> glyph
2147 construction.
2148 </p>
2149 <p>For example, if you assume glyph code 138
2150 <a class="index-entry-id" id="index-e_002dcircumflex"></a>
2151 (decimal) for an e-circumflex
2152 and you are using the Computer Modern fonts, which have the circumflex
2153 accent in position 18 and lowercase &lsquo;e&rsquo; in the usual ASCII position 101
2154 decimal, you would use <code class="code">\charsubdef</code> as follows:
2155 </p>
2156 <div class="example">
2157 <pre class="example-preformatted">\charsubdef 138 = 18 101
2158 </pre></div>
2159
2160 <p>For the plain TeX format to make use of this substitution, you have
2161 to redefine the circumflex accent macro <code class="code">\^</code> in such a way that if
2162 its argument is character &lsquo;e&rsquo; the expansion <code class="code">\char138 </code> is used
2163 instead of <code class="code">\accent18 e</code>. Similar <code class="code">\charsubdef</code> declaration
2164 and macro redefinitions have to be done for all other accented
2165 characters.
2166 </p>
2167 <p>To disable a previous <code class="code">\charsubdef <var class="var">c</var></code>, redefine <var class="var">c</var>
2168 as a pair of zeros. For example:
2169 </p><div class="example">
2170 <pre class="example-preformatted">\charsubdef '321 = 0 0 % disable N tilde
2171 </pre></div>
2172 <a class="index-entry-id" id="index-N-tilde"></a>
2173 <p>(Octal <code class="t">'321</code> is the ISO Latin-1 value for the Spanish N tilde.)
2174 </p>
2175 <p><code class="code">\charsubdef</code> commands should only be given once. Although in
2176 principle you can use <code class="code">\charsubdef</code> at any time, the result is
2177 unspecified. If <code class="code">\charsubdef</code> declarations are changed, usually
2178 either incorrect character dimensions will be used or MLTeX will
2179 output missing character warnings. (The substitution of a
2180 <code class="code">\charsubdef</code> is used by TeX when appending the character node
2181 to the current horizontal list, to compute the width of a horizontal box
2182 when the box gets packed, and when building the <code class="code">\accent</code>
2183 construction at <code class="code">\shipout</code>-time. In summary, the substitution is
2184 accessed often, so changing it is not desirable, nor generally useful.)
2185 </p>
2186
2187 <hr>
2188 </div>
2189 <div class="subsubsection-level-extent" id="g_t_005ctracingcharsubdef">
2190 <div class="nav-panel">
2191 <p>
2192 Previous: <a href="#g_t_005ccharsubdef" accesskey="p" rel="prev"><code class="code">\charsubdef</code>: Character substitutions</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX: Multi-lingual TeX</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2193 </div>
2194 <h4 class="subsubsection" id="g_t_005ctracingcharsubdef_003a-Substitution-diagnostics"><span>5.4.1.2 <code class="code">\tracingcharsubdef</code>: Substitution diagnostics<a class="copiable-link" href="#g_t_005ctracingcharsubdef_003a-Substitution-diagnostics"> &para;</a></span></h4>
2195
2196 <a class="index-entry-id" id="index-_005ctracingcharsubdef-and-MLTeX"></a>
2197 <a class="index-entry-id" id="index-redefined-character-substitutions"></a>
2198 <p>To help diagnose problems with &lsquo;<samp class="samp">\charsubdef</samp>&rsquo;, MLTeX provides a
2199 new primitive parameter, <code class="code">\tracingcharsubdef</code>. If positive, every
2200 use of <code class="code">\charsubdef</code> will be reported. This can help track down
2201 when a character is redefined.
2202 </p>
2203 <a class="index-entry-id" id="index-_005ctracinglostchars-and-MLTeX"></a>
2204 <p>In addition, if the TeX parameter <code class="code">\tracinglostchars</code> is 100
2205 or more, the character substitutions performed at <code class="code">\shipout</code>-time
2206 will be recorded.
2207 </p>
2208
2209 <hr>
2210 </div>
2211 </div>
2212 <div class="subsection-level-extent" id="TCX-files">
2213 <div class="nav-panel">
2214 <p>
2215 Next: <a href="#patgen-invocation" accesskey="n" rel="next">Patgen: Creating hyphenation patterns</a>, Previous: <a href="#MLTeX" accesskey="p" rel="prev">MLTeX: Multi-lingual TeX</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2216 </div>
2217 <h4 class="subsection" id="TCX-files_003a-Character-translations"><span>5.4.2 TCX files: Character translations<a class="copiable-link" href="#TCX-files_003a-Character-translations"> &para;</a></span></h4>
2218
2219 <a class="index-entry-id" id="index-TCX-character-translation-files"></a>
2220 <a class="index-entry-id" id="index-_002etcx-character-translation-files-1"></a>
2221 <a class="index-entry-id" id="index-character-translation-files"></a>
2222
2223 <a class="index-entry-id" id="index-international-characters"></a>
2224 <a class="index-entry-id" id="index-8_002dbit-characters"></a>
2225 <a class="index-entry-id" id="index-accented-character"></a>
2226 <p>TCX (TeX character translation) files help TeX support direct
2227 input of 8-bit international characters if fonts containing those
2228 characters are being used. Specifically, they map an input (keyboard)
2229 character code to the internal TeX character code (a superset of
2230 ASCII).
2231 </p>
2232 <p>Of the various proposals for handling more than one input encoding,
2233 TCX files were chosen because they follow Knuth&rsquo;s original ideas for
2234 the use of the &lsquo;<samp class="samp">xchr</samp>&rsquo; and &lsquo;<samp class="samp">xord</samp>&rsquo; tables. He ventured that
2235 these would be changed in the WEB source in order to adjust the actual
2236 version to a given environment. It turns out, however, that
2237 recompiling the WEB sources is not as simple a task as Knuth may have
2238 imagined; therefore, TCX files, providing the possibility of changing
2239 of the conversion tables on on-the-fly, have been implemented instead.
2240 </p>
2241 <p>This approach limits the portability of TeX documents, as some
2242 implementations do not support it (or use a different method for
2243 input-internal reencoding). It may also be problematic to determine
2244 the encoding to use for a TeX document of unknown provenance; in
2245 the worst case, failure to do so correctly may result in subtle errors
2246 in the typeset output. But we feel the benefits outweigh these
2247 disadvantages.
2248 </p>
2249 <p>This is entirely independent of the MLTeX extension (see <a class="pxref" href="#MLTeX">MLTeX: Multi-lingual TeX</a>):
2250 whereas a TCX file defines how an input keyboard character is mapped to
2251 TeX&rsquo;s internal code, MLTeX defines substitutions for a
2252 non-existing character glyph in a font with a <code class="code">\accent</code>
2253 construction made out of two separate character glyphs. TCX files
2254 involve no new primitives; it is not possible to specify
2255 that an input (keyboard) character maps to more than one character.
2256 </p>
2257 <a class="index-entry-id" id="index-WEB2C_002c-search-path-for-TCX-files"></a>
2258 <p>Information on specifying TCX files:
2259 </p>
2260 <ul class="itemize mark-bullet">
2261 <li>The best way to specify a TCX file is to list it explicitly in the
2262 first line of the main document:
2263 <div class="example">
2264 <pre class="example-preformatted">%&amp; -translate-file=<var class="var">tcxfile</var>
2265 </pre></div>
2266
2267 </li><li>You can also specify a TCX file to be used on a particular TeX run
2268 with the command-line option &lsquo;<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>&rsquo;.
2269
2270 </li><li>TCX files are searched for along the <code class="code">WEB2C</code> path.
2271
2272 </li><li>Initial TeX (see <a class="pxref" href="#Initial-TeX">Initial TeX</a>) ignores TCX files.
2273 </li></ul>
2274
2275 <a class="index-entry-id" id="index-il1_002dt1_002etcx"></a>
2276 <a class="index-entry-id" id="index-il2_002dt1_002etcx"></a>
2277 <a class="index-entry-id" id="index-empty_002etcx"></a>
2278 <a class="index-entry-id" id="index-Cork-encoding-and-ISO-input"></a>
2279 <a class="index-entry-id" id="index-T1-encoding-and-ISO-input"></a>
2280 <p>The Web2c distribution comes with a number of TCX files. Two
2281 important ones are <samp class="file">il1-t1.tcx</samp> and <samp class="file">il2-t1.tcx</samp>, which
2282 support ISO Latin 1 and ISO Latin 2, respectively, with Cork-encoded
2283 fonts (a.k.a.&nbsp;the LaTeX T1 encoding). TCX files for Czech,
2284 Polish, and Slovak are also provided.
2285 </p>
2286 <p>One other notable TCX file is <samp class="file">empty.tcx</samp>, which is, well,
2287 empty. Its purpose is to reset Web2C&rsquo;s behavior to the default (only
2288 visible ASCII being printable, as described below) when a format was
2289 dumped with another TCX being active&mdash;which is in fact the case for
2290 everything but plain TeX in the TeX Live and other distributions.
2291 Thus:
2292 </p>
2293 <div class="example">
2294 <pre class="example-preformatted">latex somefile8.tex
2295 &rArr; terminal etc. output with 8-bit chars
2296 latex --translate-file=empty.tcx somefile8.tex
2297 &rArr; terminal etc. output with ^^ notation
2298 </pre></div>
2299
2300 <a class="index-entry-id" id="index-syntax-of-TCX-files"></a>
2301 <p>Syntax of TCX files:
2302 </p><ol class="enumerate">
2303 <li> <a class="index-entry-id" id="index-blank-lines_002c-in-TCX-files"></a>
2304 Line-oriented. Blank lines are ignored.
2305
2306 </li><li> <a class="index-entry-id" id="index-whitespace_002c-in-TCX-files"></a>
2307 Whitespace is ignored except as a separator.
2308
2309 </li><li> <a class="index-entry-id" id="index-comments_002c-in-TCX-files"></a>
2310 Comments start with &lsquo;<samp class="samp">%</samp>&rsquo; and continue to the end of the line.
2311
2312 </li><li> Otherwise, a line consists of one or two character codes, optionally
2313 followed by 0 or 1. The last number indicates whether <var class="var">dest</var> is
2314 considered printable.
2315 <div class="example">
2316 <pre class="example-preformatted"><var class="var">src</var> [<var class="var">dest</var> [<var class="var">prnt</var>]]
2317 </pre></div>
2318
2319 </li><li> <a class="index-entry-id" id="index-character-codes_002c-in-TCX-files"></a>
2320 <a class="index-entry-id" id="index-octal-character-codes_002c-in-TCX-files"></a>
2321 <a class="index-entry-id" id="index-hex-character-codes_002c-in-TCX-files"></a>
2322 <a class="index-entry-id" id="index-decimal-character-codes_002c-in-TCX-files"></a>
2323 Each character code may be specified in octal with a leading &lsquo;<samp class="samp">0</samp>&rsquo;,
2324 hexadecimal with a leading &lsquo;<samp class="samp">0x</samp>&rsquo;, or decimal otherwise. Values must
2325 be between 0 and 255, inclusive (decimal).
2326
2327 </li><li> If the <var class="var">dest</var> code is not specified, it is taken to be the same as
2328 <var class="var">src</var>.
2329
2330 </li><li> If the same <var class="var">src</var> code is specified more than once, it is the last
2331 definition that counts.
2332 </li></ol>
2333
2334 <a class="index-entry-id" id="index-printable-characters_002c-specifying"></a>
2335 <a class="index-entry-id" id="index-_005e_005e-notation_002c-avoiding"></a>
2336 <p>Finally, here&rsquo;s what happens: when TeX sees an input character with
2337 code <var class="var">src</var>, it 1) changes <var class="var">src</var> to <var class="var">dest</var>; and 2) makes the
2338 <var class="var">dest</var> code &ldquo;printable&rdquo;, i.e., printed as-is in diagnostics and the
2339 log file rather than in &lsquo;<samp class="samp">^^</samp>&rsquo; notation.
2340 </p>
2341 <p>By default, no characters are translated, and character codes between 32
2342 and 126 inclusive (decimal) are printable.
2343 </p>
2344 <p>Specifying translations for the printable ASCII characters (codes
2345 32&ndash;127) will yield unpredictable results. Additionally you shouldn&rsquo;t
2346 make the following characters printable: <code class="code">^^I</code> (TAB), <code class="code">^^J</code>
2347 (line feed), <code class="code">^^M</code> (carriage return), and <code class="code">^^?</code> (delete),
2348 since TeX uses them in various ways.
2349 </p>
2350 <a class="index-entry-id" id="index-font-character-code_002c-translating"></a>
2351 <a class="index-entry-id" id="index-keyboard-character-code_002c-translating"></a>
2352 <p>Thus, the idea is to specify the input (keyboard) character code for
2353 <var class="var">src</var>, and the output (font) character code for <var class="var">dest</var>.
2354 </p>
2355 <a class="index-entry-id" id="index-interaction-between-TCX-files-and-_002d8bit_002e"></a>
2356 <p>By default, only the printable ASCII characters are considered printable
2357 by TeX. If you specify the &lsquo;<samp class="samp">-8bit</samp>&rsquo; option, all characters are
2358 considered printable by default. If you specify both the &lsquo;<samp class="samp">-8bit</samp>&rsquo;
2359 option and a TCX file, then the TCX can set specific characters to be
2360 non-printable.
2361 </p>
2362 <p>Both the specified TCX encoding and whether characters are printable
2363 are saved in the dump files (like <samp class="file">tex.fmt</samp>). So by giving these
2364 options in combination with &lsquo;<samp class="samp">-ini</samp>&rsquo;, you control the defaults seen
2365 by anyone who uses the resulting dump file.
2366 </p>
2367 <p>When loading a dump, if the &lsquo;<samp class="samp">-8bit</samp>&rsquo; option was given, then all
2368 characters become printable by default.
2369 </p>
2370 <p>When loading a dump, if a TCX file was specified, then the TCX data from
2371 the dump is ignored and the data from the file used instead.
2372 </p>
2373
2374 <hr>
2375 </div>
2376 <div class="subsection-level-extent" id="patgen-invocation">
2377 <div class="nav-panel">
2378 <p>
2379 Previous: <a href="#TCX-files" accesskey="p" rel="prev">TCX files: Character translations</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2380 </div>
2381 <h4 class="subsection" id="Patgen_003a-Creating-hyphenation-patterns"><span>5.4.3 Patgen: Creating hyphenation patterns<a class="copiable-link" href="#Patgen_003a-Creating-hyphenation-patterns"> &para;</a></span></h4>
2382
2383 <a class="index-entry-id" id="index-patgen"></a>
2384 <a class="index-entry-id" id="index-hyphenation-patterns_002c-creating"></a>
2385 <a class="index-entry-id" id="index-languages_002c-hyphenation-rules-for"></a>
2386
2387 <p>Patgen creates hyphenation patterns from dictionary files for use with
2388 TeX. Synopsis:
2389 </p>
2390 <div class="example">
2391 <pre class="example-preformatted">patgen <var class="var">dictionary</var> <var class="var">patterns</var> <var class="var">output</var> <var class="var">translate</var>
2392 </pre></div>
2393
2394 <p>Each argument is a filename. No path searching is done. The output is
2395 written to the file <var class="var">output</var>.
2396 </p>
2397
2398 <p>In addition, Patgen prompts interactively for other values.
2399 </p>
2400 <p>For more information, see <cite class="cite">Word hy-phen-a-tion by com-put-er</cite> by
2401 Frank Liang (see <a class="pxref" href="#References">References</a>), and also the <samp class="file">patgen.web</samp> source file.
2402 </p>
2403 <p>The only options are &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>).
2404 </p>
2405
2406 <hr>
2407 </div>
2408 </div>
2409 <div class="section-level-extent" id="Shell-escapes">
2410 <div class="nav-panel">
2411 <p>
2412 Next: <a href="#IPC-and-TeX" accesskey="n" rel="next">IPC and TeX</a>, Previous: <a href="#Languages-and-hyphenation" accesskey="p" rel="prev">Languages and hyphenation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2413 </div>
2414 <h3 class="section" id="Shell-escapes-1"><span>5.5 Shell escapes<a class="copiable-link" href="#Shell-escapes-1"> &para;</a></span></h3>
2415
2416 <a class="index-entry-id" id="index-shell-commands-in-TeX"></a>
2417 <a class="index-entry-id" id="index-security_002c-and-shell-escapes"></a>
2418 <a class="index-entry-id" id="index-restricted-shell-escapes"></a>
2419 <a class="index-entry-id" id="index-system-command"></a>
2420 <a class="index-entry-id" id="index-shell_005fescape-enabling-in-TeX"></a>
2421 <a class="index-entry-id" id="index-_005cimmediate_005cwrite18"></a>
2422 <a class="index-entry-id" id="index-_005cwrite18-shell-escape-extension"></a>
2423 <a class="index-entry-id" id="index-system-C-library-function"></a>
2424 <a class="index-entry-id" id="index-texmf_002ecnf-for-shell-escapes"></a>
2425
2426 <p>TeX can execute <em class="dfn">shell escapes</em>, that is, arbitrary shell
2427 commands. Although tremendously useful, this also has obvious
2428 security implications. Therefore, as of TeX Live 2009, a
2429 <em class="dfn">restricted</em> mode for shell escapes is the default mode of
2430 operation, which allows executing only certain commands, as specified
2431 in the <samp class="file">texmf.cnf</samp> configuration file.
2432 </p>
2433 <ul class="itemize mark-bullet">
2434 <li>Unrestricted shell escapes are allowed if the option
2435 <samp class="option">--shell-escape</samp> is specified, or if the environment variable
2436 or config file value <code class="code">shell_escape</code> is set to &lsquo;<samp class="samp">t</samp>&rsquo; or
2437 &lsquo;<samp class="samp">y</samp>&rsquo; and &lsquo;<samp class="samp">1</samp>&rsquo;.
2438
2439 </li><li>Restricted shell escapes are allowed if <code class="code">shell_escape</code> is set to
2440 &lsquo;<samp class="samp">p</samp>&rsquo;. This is the default.
2441
2442 </li><li>Shell escapes are completely disabled if <samp class="option">--no-shell-escape</samp> is
2443 specified, or if <code class="code">shell_escape</code> is set to anything else.
2444 </li></ul>
2445
2446 <p>When enabled, the TeX construct to execute a system command is
2447 <code class="code">\write18{<var class="var">shell-command</var>}</code>; for example:
2448 </p>
2449 <div class="example">
2450 <pre class="example-preformatted">\write18{echo &quot;hello, world&quot;}
2451 </pre></div>
2452
2453 <a class="index-entry-id" id="index-_005coutput-routine_002c-and-_005cwrite"></a>
2454 <p>From TeX&rsquo;s point of view, this is a normal <code class="code">\write</code> command,
2455 and is therefore subject to the usual TeX expansions. Also, the
2456 system call either happens during the &lsquo;<samp class="samp">\output</samp>&rsquo; routine or right
2457 away, according to the absence or presence of the <code class="code">\immediate</code>
2458 prefix, as usual for <code class="code">\write</code>.
2459 </p>
2460 <a class="index-entry-id" id="index-exit-status_002c-of-shell-escape"></a>
2461 <p>The <var class="var">shell-command</var> string is passed to the command shell (via the
2462 C library function <code class="code">system</code>). The output of <var class="var">shell-command</var>
2463 is not diverted anywhere, so it will not appear in the log file, or
2464 anywhere but the terminal output. The exit status of the system call
2465 is also not available to TeX.
2466 </p>
2467 <p>In unrestricted mode, the argument is simply passed straight to
2468 <code class="code">system</code> unaltered.
2469 </p>
2470 <p>In restricted mode, ASCII double quote characters (<code class="verb">&quot;</code>) should
2471 always be used in the argument to <code class="code">\write18</code> where quoting of
2472 arguments is needed, as in the example above. This is to achieve some
2473 measure of system independence. On Unix systems, these are replaced
2474 with single quote (<code class="verb">'</code>) characters to avoid insecure further
2475 expansion (from, e.g., <code class="verb">`...`</code>). Care is also taken on Windows
2476 to avoid additional expansions. Mismatched quotation marks in the
2477 command string result in a diagnostic message in the log file, and no
2478 execution is performed.
2479 </p>
2480 <a class="index-entry-id" id="index-shell_005fescape_005fcommands"></a>
2481 <p>After quotation processing, if the first word (delimited by a space or
2482 tab) of the command is in the list specified by the
2483 <code class="code">shell_escape_commands</code> configuration value, the command is
2484 executed. Otherwise it is not. In any case, a message is written to
2485 the log file.
2486 </p>
2487 <p>The <code class="code">shell_escape_commands</code> value is a comma-separated list of
2488 words. Whitespace is significant, and typically should not be
2489 present. The default definition in <samp class="file">texmf.cnf</samp> looks like this,
2490 with more commands included:
2491 </p>
2492 <div class="example">
2493 <pre class="example-preformatted">shell_escape_commands = bibtex,kpsewhich,repstopdf,...
2494 </pre></div>
2495
2496 <a class="index-entry-id" id="index-pipes_002c-reading-and-writing"></a>
2497 <a class="index-entry-id" id="index-_005copenin_002c-and-pipes"></a>
2498 <a class="index-entry-id" id="index-_005cinput_002c-and-pipes"></a>
2499 <a class="index-entry-id" id="index-_005copenout_002c-and-pipes"></a>
2500 <a class="index-entry-id" id="index-_005cpdfshellescape"></a>
2501 <p>pdfTeX and LuaTeX support reading (via <code class="code">\input</code> and
2502 <code class="code">\openin</code>) and writing (via <code class="code">\openout</code>) from pipes if the
2503 first character is &lsquo;<samp class="samp">|</samp>&rsquo;. The following command is then treated
2504 exactly the same as the argument to <code class="code">\write18</code>. In these
2505 engines, the primitive variable <code class="code">\pdfshellescape</code> is set to 0 if
2506 shell escapes are disabled, 1 if they are enabled, and 2 if they are
2507 enabled with restrictions.
2508 </p>
2509 <a class="index-entry-id" id="index-web-environments_002c-and-security"></a>
2510 <p>The purpose of this feature is to make it possible for TeX
2511 documents to perform useful external actions in the common case of an
2512 individual user running a known document on his or her own machine.
2513 In environments such as CGI scripts or wikis where the input has to be
2514 considered untrustworthy, shell escapes should be completely disabled.
2515 </p>
2516 <p>Programs intended to be called from TeX in restricted should
2517 implement the &ldquo;paranoid&rdquo; safety measures regarding output files that
2518 TeX itself does. See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling sequence</a> in <cite class="cite">Kpathsea</cite>.
2519 </p>
2520 <hr>
2521 </div>
2522 <div class="section-level-extent" id="IPC-and-TeX">
2523 <div class="nav-panel">
2524 <p>
2525 Next: <a href="#TeX-extensions" accesskey="n" rel="next">Extended TeX engines</a>, Previous: <a href="#Shell-escapes" accesskey="p" rel="prev">Shell escapes</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2526 </div>
2527 <h3 class="section" id="IPC-and-TeX-1"><span>5.6 IPC and TeX<a class="copiable-link" href="#IPC-and-TeX-1"> &para;</a></span></h3>
2528
2529 <a class="index-entry-id" id="index-IPC"></a>
2530 <a class="index-entry-id" id="index-sockets"></a>
2531 <p>(If anyone uses this feature and needs documentation, write
2532 <a class="email" href="mailto:[email protected]">[email protected]</a>.)
2533 </p>
2534 <p>This functionality is available only if the &lsquo;<samp class="samp">--enable-ipc</samp>&rsquo; option
2535 was specified to <code class="code">configure</code> during installation of Web2c
2536 (see <a class="pxref" href="#Installation">Installation</a>).
2537 </p>
2538 <a class="index-entry-id" id="index-IPC_005fDEBUG-1"></a>
2539 <p>If you define <code class="code">IPC_DEBUG</code> before compilation (e.g., with &lsquo;<samp class="samp">make
2540 XCFLAGS=-DIPC_DEBUG</samp>&rsquo;), TeX will print messages to standard error
2541 about its socket operations. This may be helpful if you are, well,
2542 debugging.
2543 </p>
2544
2545 <hr>
2546 </div>
2547 <div class="section-level-extent" id="TeX-extensions">
2548 <div class="nav-panel">
2549 <p>
2550 Previous: <a href="#IPC-and-TeX" accesskey="p" rel="prev">IPC and TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX: Typesetting</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2551 </div>
2552 <h3 class="section" id="Extended-TeX-engines"><span>5.7 Extended TeX engines<a class="copiable-link" href="#Extended-TeX-engines"> &para;</a></span></h3>
2553
2554 <a class="index-entry-id" id="index-extensions-to-TeX"></a>
2555 <a class="index-entry-id" id="index-TeX_002c-extensions-to"></a>
2556
2557 <p>The base TeX program has been extended in many ways.
2558 </p>
2559 <a class="index-entry-id" id="index-cross_002dengine-functionality"></a>
2560 <p>There has been a substantial effort to make a set of extended
2561 functionality available across all actively-updated engines, so that
2562 formats, notably LaTeX, can rely on it. A list of this common
2563 extended functionality is in a <cite class="cite">LaTeX News</cite> article,
2564 <a class="url" href="https://www.latex-project.org/news/latex2e-news/ltnews31.pdf">https://www.latex-project.org/news/latex2e-news/ltnews31.pdf</a>.
2565 For engines in TeX Live, the detailed documentation for these
2566 primitives is mostly in the pdfTeX manual
2567 (<a class="url" href="https://pdftex.org">https://pdftex.org</a>).
2568 </p>
2569 <p>In addition, each engine (naturally) has its own particular features,
2570 described in its own manual. Here&rsquo;s a partial list of the engines.
2571 </p>
2572 <dl class="table">
2573 <dt><a class="index-entry-id" id="index-primitives_002c-new"></a>
2574 <a id="index-e_002dTeX"></a><span>e-TeX<a class="copiable-link" href="#index-e_002dTeX"> &para;</a></span></dt>
2575 <dd><p>Adds many new primitives, including right-to-left typesetting and more
2576 registers. Now frozen. More info: <a class="url" href="https://ctan.org/pkg/etex">https://ctan.org/pkg/etex</a>.
2577 </p>
2578 </dd>
2579 <dt><a class="index-entry-id" id="index-Omega"></a>
2580 <a class="index-entry-id" id="index-Unicode"></a>
2581 <a id="index-Aleph"></a><span>Aleph<a class="copiable-link" href="#index-Aleph"> &para;</a></span></dt>
2582 <dd><p>This adds Unicode support, right-to-left typesetting, and more, based
2583 on the Omega engine, with the e-TeX and other extensions. Aleph is
2584 maintained only for serious bug fixes and does not include the common
2585 functionality mentioned above. More info:
2586 <a class="url" href="https://ctan.org/pkg/aleph">https://ctan.org/pkg/aleph</a>, <a class="url" href="https://ctan.org/pkg/omega">https://ctan.org/pkg/omega</a>.
2587 </p>
2588 </dd>
2589 <dt><a class="index-entry-id" id="index-PDF"></a>
2590 <a class="index-entry-id" id="index-micro_002dtypography"></a>
2591 <a class="index-entry-id" id="index-hypertext"></a>
2592 <a class="index-entry-id" id="index-etex-is-pdfTeX"></a>
2593 <a id="index-pdfTeX"></a><span>pdfTeX<a class="copiable-link" href="#index-pdfTeX"> &para;</a></span></dt>
2594 <dd><p>Can produce PDF as well as DVI files. It also incorporates the
2595 e-TeX extensions, new primitives for hypertext and
2596 micro-typography, reading/writing from pipes, and much more. In
2597 TeX Live, the command <code class="command">etex</code> invokes pdfTeX to make all
2598 these additions available with DVI output. Home page:
2599 <a class="url" href="https://pdftex.org">https://pdftex.org</a>.
2600 </p>
2601 </dd>
2602 <dt><a class="index-entry-id" id="index-Lua"></a>
2603 <a class="index-entry-id" id="index-UTF_002d8-input_002c-native"></a>
2604 <a class="index-entry-id" id="index-OpenType-support"></a>
2605 <a class="index-entry-id" id="index-TrueType-support"></a>
2606 <a class="index-entry-id" id="index-system-fonts_002c-using"></a>
2607 <a id="index-LuaTeX"></a><span>LuaTeX<a class="copiable-link" href="#index-LuaTeX"> &para;</a></span></dt>
2608 <dd><p>Embeds the Lua programming language (<a class="url" href="http://lua.org">http://lua.org</a>) and opens
2609 up the TeX typesetting engine to control from Lua, starting from
2610 the pdfTeX capabilities as a base. Also natively supports UTF-8
2611 input, the OpenType and TrueType font formats, and use of system
2612 fonts. Home page: <a class="url" href="https://luatex.org">https://luatex.org</a>.
2613 </p>
2614 </dd>
2615 <dt><a class="index-entry-id" id="index-Unicode-input_002c-native"></a>
2616 <a id="index-XeTeX"></a><span>XeTeX<a class="copiable-link" href="#index-XeTeX"> &para;</a></span></dt>
2617 <dd><p>Combines support for Unicode input, the OpenType and TrueType font
2618 formats, and use of system fonts with the capabilities of pdfTeX,
2619 with the exception of the font expansion part of micro-typography.
2620 Home page: <a class="url" href="https://tug.org/xetex">https://tug.org/xetex</a>.
2621 </p>
2622 </dd>
2623 <dt><a class="index-entry-id" id="index-HINT-_0028Hint-Is-Not-TeX_0029"></a>
2624 <a id="index-hiTeX"></a><span>hiTeX<a class="copiable-link" href="#index-hiTeX"> &para;</a></span></dt>
2625 <dd><p>Outputs its own HINT format, which is designed for reading
2626 technical documents on mobile devices. More info:
2627 <a class="url" href="https://ctan.org/pkg/hitex">https://ctan.org/pkg/hitex</a>.
2628 </p>
2629 </dd>
2630 <dt><a class="index-entry-id" id="index-upTeX"></a>
2631 <a id="index-pTeX"></a><span>pTeX<a class="copiable-link" href="#index-pTeX"> &para;</a></span></dt>
2632 <dt>upTeX</dt>
2633 <dd><p>With additional support for Japanese; pTeX was the original engine,
2634 and upTeX has native Unicode support and thus is more useful for
2635 Chinese and Korean. More info: <a class="url" href="https://ctan.org/pkg/ptex">https://ctan.org/pkg/ptex</a>,
2636 <a class="url" href="https://ctan.org/pkg/uptex">https://ctan.org/pkg/uptex</a>.
2637 </p>
2638 </dd>
2639 <dt><a class="index-entry-id" id="index-eupTeX"></a>
2640 <a id="index-epTeX"></a><span>epTeX<a class="copiable-link" href="#index-epTeX"> &para;</a></span></dt>
2641 <dt>eupTeX</dt>
2642 <dd><p>Further extends pTeX and upTeX with the e-TeX extensions.
2643 More info: <a class="url" href="https://ctan.org/pkg/eptex">https://ctan.org/pkg/eptex</a>,
2644 <a class="url" href="https://ctan.org/pkg/euptex">https://ctan.org/pkg/euptex</a>.
2645 </p>
2646 </dd>
2647 </dl>
2648
2649
2650 <hr>
2651 </div>
2652 </div>
2653 <div class="chapter-level-extent" id="Metafont">
2654 <div class="nav-panel">
2655 <p>
2656 Next: <a href="#MetaPost" accesskey="n" rel="next">MetaPost: Generating PostScript</a>, Previous: <a href="#TeX" accesskey="p" rel="prev">TeX: Typesetting</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2657 </div>
2658 <h2 class="chapter" id="Metafont_003a-Creating-typeface-families"><span>6 Metafont: Creating typeface families<a class="copiable-link" href="#Metafont_003a-Creating-typeface-families"> &para;</a></span></h2>
2659
2660 <a class="index-entry-id" id="index-Metafont"></a>
2661 <a class="index-entry-id" id="index-typeface-families"></a>
2662 <a class="index-entry-id" id="index-geometric-designs"></a>
2663 <a class="index-entry-id" id="index-shapes"></a>
2664 <a class="index-entry-id" id="index-font-design"></a>
2665
2666 <p>Metafont is a system for producing shapes; it was designed for producing
2667 complete typeface families, but it can also produce geometric designs,
2668 dingbats, etc. And it has considerable mathematical and
2669 equation-solving capabilities which can be useful entirely on their own.
2670 </p>
2671 <p>Metafont is a batch language, like C or Pascal: you compile a Metafont
2672 program into a corresponding font, rather than interactively drawing
2673 lines or curves. This approach has both considerable disadvantages
2674 (people unfamiliar with conventional programming languages will be
2675 unlikely to find it usable) and considerable advantages (you can make
2676 your design intentions specific and parameterizable). For a complete
2677 description of the Metafont language, see <cite class="cite">The METAFONTbook</cite>
2678 (see <a class="pxref" href="#References">References</a>).
2679 </p>
2680
2681
2682 <ul class="mini-toc">
2683 <li><a href="#mf-invocation" accesskey="1"><code class="code">mf</code> invocation</a></li>
2684 <li><a href="#Initial-Metafont" accesskey="2">Initial Metafont</a></li>
2685 <li><a href="#Modes" accesskey="3">Modes: Device definitions for Metafont</a></li>
2686 <li><a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a></li>
2687 <li><a href="#gftodvi-invocation" accesskey="5">GFtoDVI: Character proofs of fonts</a></li>
2688 <li><a href="#mft-invocation" accesskey="6">MFT: Prettyprinting Metafont source</a></li>
2689 </ul>
2690 <hr>
2691 <div class="section-level-extent" id="mf-invocation">
2692 <div class="nav-panel">
2693 <p>
2694 Next: <a href="#Initial-Metafont" accesskey="n" rel="next">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2695 </div>
2696 <h3 class="section" id="mf-invocation-1"><span>6.1 <code class="code">mf</code> invocation<a class="copiable-link" href="#mf-invocation-1"> &para;</a></span></h3>
2697
2698 <a class="index-entry-id" id="index-mf"></a>
2699 <a class="index-entry-id" id="index-Metafont-invocation"></a>
2700
2701 <p>Metafont (usually invoked as <code class="code">mf</code>) reads character definitions
2702 specified in the Metafont programming language, and outputs the
2703 corresponding font. This section merely describes the options available
2704 in the Web2c implementation. For a complete description of the Metafont
2705 language, see <cite class="cite">The Metafontbook</cite> (see <a class="pxref" href="#References">References</a>).
2706 </p>
2707 <p>Metafont processes its command line and determines its memory dump
2708 (base) file in a way exactly analogous to MetaPost and TeX
2709 (see <a class="pxref" href="#tex-invocation"><code class="code">tex</code> invocation</a>, and see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). Synopses:
2710 </p>
2711 <div class="example">
2712 <pre class="example-preformatted">mf [<var class="var">option</var>]... [<var class="var">mfname</var>[.mf]] [<var class="var">mf-commands</var>]
2713 mf [<var class="var">option</var>]... \<var class="var">first-line</var>
2714 mf [<var class="var">option</var>]... &amp;<var class="var">base</var> <var class="var">args</var>
2715 </pre></div>
2716
2717 <p>Most commonly, a Metafont invocation looks like this:
2718 </p><div class="example">
2719 <pre class="example-preformatted">mf '\mode:=<var class="var">mode</var>; mag:=<var class="var">magnification</var>; input <var class="var">mfname</var>'
2720 </pre></div>
2721 <p>(The single quotes avoid unwanted interpretation by the shell.)
2722 </p>
2723 <a class="index-entry-id" id="index-_002emf"></a>
2724 <a class="index-entry-id" id="index-Metafont-input-files"></a>
2725 <a class="index-entry-id" id="index-EC-fonts"></a>
2726 <a class="index-entry-id" id="index-mktexmf_002c-disabling"></a>
2727 <p>Metafont searches the usual places for the main input file <var class="var">mfname</var>
2728 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>), extending
2729 <var class="var">mfname</var> with <samp class="file">.mf</samp> if necessary. To see all the relevant
2730 paths, set the environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo;
2731 before running the program. By default, Metafont runs an external
2732 program named <samp class="file">mktexmf</samp> to create any nonexistent Metafont source
2733 files you input. You can disable this at configure-time or runtime
2734 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite class="cite">Kpathsea</cite>). This is mostly
2735 for the sake of the EC fonts, which can be generated at any size.
2736 </p>
2737 <a class="index-entry-id" id="index-_002ennngf-generic-fonts"></a>
2738 <a class="index-entry-id" id="index-mfput"></a>
2739 <a class="index-entry-id" id="index-GF-output"></a>
2740 <a class="index-entry-id" id="index-GF-files_002c-output-by-Metafont"></a>
2741 <a class="index-entry-id" id="index-PK-files_002c-not-output-by-Metafont"></a>
2742 <p>Metafont writes the main GF output to the file
2743 <samp class="file"><var class="var">basemfname</var>.<var class="var">nnn</var>gf</samp>, where <var class="var">nnn</var> is the font
2744 resolution in pixels per inch, and <var class="var">basemfname</var> is the basename of
2745 <var class="var">mfname</var>, or &lsquo;<samp class="samp">mfput</samp>&rsquo; if no input file was specified. A GF file
2746 contains bitmaps of the actual character shapes. Usually GF files are
2747 converted immediately to PK files with GFtoPK (see <a class="pxref" href="#gftopk-invocation">GFtoPK: Generic to packed font conversion</a>), since PK files contain equivalent information, but are
2748 more compact. (Metafont output in GF format rather than PK for only
2749 historical reasons.)
2750 </p>
2751 <a class="index-entry-id" id="index-_002etfm-output"></a>
2752 <a class="index-entry-id" id="index-TFM-files_002c-output-by-Metafont"></a>
2753 <p>Metafont also usually writes a metric file in TFM format to
2754 <samp class="file"><var class="var">basemfname</var>.tfm</samp>. A TFM file contains character dimensions,
2755 kerns, and ligatures, and spacing parameters. TeX reads only this
2756 <code class="t">.tfm</code> file, not the GF file.
2757 </p>
2758 <a class="index-entry-id" id="index-mode-needed-to-run-Metafont"></a>
2759 <a class="index-entry-id" id="index-proof-mode"></a>
2760 <a class="index-entry-id" id="index-2602gf"></a>
2761 <a class="index-entry-id" id="index-_002e2602gf"></a>
2762 <p>The <var class="var">mode</var> in the example command above is a name referring to a
2763 device definition (see <a class="pxref" href="#Modes">Modes: Device definitions for Metafont</a>); for example, <code class="code">localfont</code> or
2764 <code class="code">ljfour</code>. These device definitions must generally be precompiled
2765 into the base file. If you leave this out, the default is <code class="code">proof</code>
2766 mode, as stated in <cite class="cite">The Metafontbook</cite>, in which Metafont outputs at
2767 a resolution of 2602<span class="dmn">dpi</span>; this is usually not what you want. The
2768 remedy is simply to assign a different mode&mdash;<code class="code">localfont</code>, for
2769 example.
2770 </p>
2771 <p>The <var class="var">magnification</var> assignment in the example command above is a
2772 magnification factor; for example, if the device is 600<span class="dmn">dpi</span> and you
2773 specify <code class="code">mag:=2</code>, Metafont will produce output at 1200<span class="dmn">dpi</span>.
2774 Very often, the <var class="var">magnification</var> is an expression such as
2775 <code class="code">magstep(.5)</code>, corresponding to a TeX &ldquo;magstep&rdquo;, which are
2776 factors of
2777 </p>
2778 <p>After running Metafont, you can use the font in a TeX document as
2779 usual. For example:
2780 </p><div class="example">
2781 <pre class="example-preformatted">\font\myfont = newfont
2782 \myfont Now I am typesetting in my new font (minimum hamburgers).
2783 </pre></div>
2784
2785 <p>The program accepts the following options, as well as the standard
2786 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
2787 </p><dl class="table">
2788 <dt>&lsquo;<samp class="samp">-[no]-file-line-error</samp>&rsquo;</dt>
2789 <dt>&lsquo;<samp class="samp">-fmt=<var class="var">fmtname</var></samp>&rsquo;</dt>
2790 <dt>&lsquo;<samp class="samp">-halt-on-error</samp>&rsquo;</dt>
2791 <dt>&lsquo;<samp class="samp">-ini</samp>&rsquo;</dt>
2792 <dt>&lsquo;<samp class="samp">-interaction=<var class="var">string</var></samp>&rsquo;</dt>
2793 <dt>&lsquo;<samp class="samp">-jobname=<var class="var">string</var></samp>&rsquo;</dt>
2794 <dt>&lsquo;<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>&rsquo;</dt>
2795 <dt>&lsquo;<samp class="samp">-[no]parse-first-line</samp>&rsquo;</dt>
2796 <dt>&lsquo;<samp class="samp">-output-directory</samp>&rsquo;</dt>
2797 <dt>&lsquo;<samp class="samp">-progname=<var class="var">string</var></samp>&rsquo;</dt>
2798 <dt>&lsquo;<samp class="samp">-recorder</samp>&rsquo;</dt>
2799 <dt>&lsquo;<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>&rsquo;</dt>
2800 <dt>&lsquo;<samp class="samp">-8bit</samp>&rsquo;</dt>
2801 <dd><p>These options are common to TeX, Metafont, and MetaPost.
2802 See <a class="xref" href="#Common-options">Common options</a>.
2803 </p>
2804 </dd>
2805 <dt><a class="index-entry-id" id="index-_002dno_002dmktex_003dfiletype-1"></a>
2806 <a id="index-_002dmktex_003dfiletype-1"></a><span>&lsquo;<samp class="samp">-mktex=<var class="var">filetype</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmktex_003dfiletype-1"> &para;</a></span></dt>
2807 <dt>&lsquo;<samp class="samp">-no-mktex=<var class="var">filetype</var></samp>&rsquo;</dt>
2808 <dd><p>Turn on or off the &lsquo;<samp class="samp">mktex</samp>&rsquo; script associated with <var class="var">filetype</var>.
2809 The only value that makes sense for <var class="var">filetype</var> is &lsquo;<samp class="samp">mf</samp>&rsquo;.
2810 </p></dd>
2811 </dl>
2812
2813
2814 <hr>
2815 </div>
2816 <div class="section-level-extent" id="Initial-Metafont">
2817 <div class="nav-panel">
2818 <p>
2819 Next: <a href="#Modes" accesskey="n" rel="next">Modes: Device definitions for Metafont</a>, Previous: <a href="#mf-invocation" accesskey="p" rel="prev"><code class="code">mf</code> invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2820 </div>
2821 <h3 class="section" id="Initial-Metafont-1"><span>6.2 Initial Metafont<a class="copiable-link" href="#Initial-Metafont-1"> &para;</a></span></h3>
2822
2823 <a class="index-entry-id" id="index-initial-Metafont"></a>
2824 <a class="index-entry-id" id="index-Metafont_002c-initial"></a>
2825
2826 <a class="index-entry-id" id="index-_002ebase"></a>
2827 <a class="index-entry-id" id="index-base-files"></a>
2828 <p><code class="code">inimf</code> is the &ldquo;initial&rdquo; form of Metafont, which does lengthy
2829 initializations avoided by the &ldquo;virgin&rdquo; (<code class="code">vir</code>) form, so as to
2830 be capable of dumping &lsquo;<samp class="samp">.base</samp>&rsquo; files (see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). For
2831 a detailed comparison of virgin and initial forms, see <a class="ref" href="#Initial-and-virgin">Initial and virgin</a>.
2832 </p>
2833 <p>For a list of options and other information, see <a class="ref" href="#mf-invocation"><code class="code">mf</code> invocation</a>.
2834 </p>
2835 <a class="index-entry-id" id="index-plain_002ebase"></a>
2836 <a class="index-entry-id" id="index-mf_002ebase"></a>
2837 <p>The only memory dump file commonly used with Metafont is the default
2838 &lsquo;<samp class="samp">plain.base</samp>&rsquo;, also known as &lsquo;<samp class="samp">mf.base</samp>&rsquo; (again, see <a class="pxref" href="#Memory-dumps">Memory dumps</a>). It is created by default during installation, but you can also
2839 do so by hand if necessary:
2840 </p><div class="example">
2841 <pre class="example-preformatted">mf -ini '\input plain; input modes; dump'
2842 </pre></div>
2843 <p>(The quotes prevent interpretation of the backslashes from the shell.)
2844 Then install the resulting <samp class="file">plain.base</samp> where Metafont will find
2845 it, and link <samp class="file">mf.base</samp> to it.
2846 </p>
2847 <p>For an explanation of the additional <samp class="file">modes.mf</samp> file,
2848 see <a class="ref" href="#Modes">Modes: Device definitions for Metafont</a>. This file has no counterpart in TeX or MetaPost.
2849 </p>
2850 <a class="index-entry-id" id="index-cmmf_002ebase-not-recommended"></a>
2851 <a class="index-entry-id" id="index-cm_002ebase"></a>
2852 <a class="index-entry-id" id="index-cmbase_002emf"></a>
2853 <a class="index-entry-id" id="index-Computer-Modern-macros"></a>
2854 <a class="index-entry-id" id="index-base-files_002c-plain-only"></a>
2855 <p>In the past, it was sometimes useful to create a base file
2856 <samp class="file">cmmf.base</samp> (a.k.a. <samp class="file">cm.base</samp>), with the Computer Modern
2857 macros also included in the base file. Nowadays, however, the
2858 additional time required to read <samp class="file">cmbase.mf</samp> is exceedingly small,
2859 usually not enough to be worth the administrative hassle of updating the
2860 <samp class="file">cmmf.base</samp> file when you install a new version of <samp class="file">modes.mf</samp>.
2861 <a class="index-entry-id" id="index-type-design_002c-personal"></a>
2862 People developing a typeface with Metafont may find it worthwhile to
2863 create their own base file.
2864 </p>
2865
2866 <hr>
2867 </div>
2868 <div class="section-level-extent" id="Modes">
2869 <div class="nav-panel">
2870 <p>
2871 Next: <a href="#Online-Metafont-graphics" accesskey="n" rel="next">Online Metafont graphics</a>, Previous: <a href="#Initial-Metafont" accesskey="p" rel="prev">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2872 </div>
2873 <h3 class="section" id="Modes_003a-Device-definitions-for-Metafont"><span>6.3 Modes: Device definitions for Metafont<a class="copiable-link" href="#Modes_003a-Device-definitions-for-Metafont"> &para;</a></span></h3>
2874
2875 <a class="index-entry-id" id="index-modes-file-needed-for-Metafont"></a>
2876 <a class="index-entry-id" id="index-base-files_002c-need-mode-definitions"></a>
2877 <a class="index-entry-id" id="index-device-definitions_002c-for-Metafont"></a>
2878 <a class="index-entry-id" id="index-printer-characteristics_002c-for-Metafont"></a>
2879 <p>Running Metafont and creating Metafont base files requires information
2880 that TeX and MetaPost do not: <em class="dfn">mode</em> definitions which specify
2881 device characteristics, so Metafont can properly rasterize the shapes.
2882 </p>
2883 <a class="index-entry-id" id="index-modes_002emf-recommended-modes-file"></a>
2884 <p>When making a base file, a file containing modes for locally-available
2885 devices should be input after <samp class="file">plain.mf</samp>. One commonly used file
2886 is <samp class="file">modes.mf</samp> (<a class="url" href="https://ctan.org/pkg/modes">https://ctan.org/pkg/modes</a>); it includes all
2887 known definitions.
2888 </p>
2889 <a class="index-entry-id" id="index-small-Metafont-memory-and-modes"></a>
2890 <a class="index-entry-id" id="index-mode_005fdef"></a>
2891 <a class="index-entry-id" id="index-mode_005fsetup"></a>
2892 <p>If, however, for some reason you have decreased the memory available in
2893 your Metafont, you may need to copy <samp class="file">modes.mf</samp> and remove the
2894 definitions irrelevant to you (probably most of them) instead of using
2895 it directly. (Or, if you&rsquo;re a Metafont hacker, maybe you can suggest a
2896 way to redefine <code class="code">mode_def</code> and/or <code class="code">mode_setup</code>; right now, the
2897 amount of memory used is approximately four times the total length of
2898 the <code class="code">mode_def</code> names, and that&rsquo;s a lot.)
2899 </p>
2900 <p>If you have a device not included in <samp class="file">modes.mf</samp>, please see
2901 comments in that file for how to create the new definition, and please
2902 send the definition to <a class="email" href="mailto:[email protected]">[email protected]</a> to get it included
2903 in the next release of <samp class="file">modes.mf</samp>.
2904 </p>
2905 <a class="index-entry-id" id="index-smode-and-dynamic-Metafont-mode-definition"></a>
2906 <a class="index-entry-id" id="index-dynamic-Metafont-mode-definitions-with-smode"></a>
2907 <p>Usually, when you run Metafont you must supply the name of a mode that
2908 was dumped in the base file. But you can also define the mode
2909 characteristics dynamically, by invoking Metafont with an assignment to
2910 <code class="code">smode</code> instead of <code class="code">mode</code>, like this:
2911 </p><div class="example">
2912 <pre class="example-preformatted">mf '\smode:=&quot;newmode.mf&quot;; mag:=<var class="var">magnification</var>; input <var class="var">mfname</var>'
2913 </pre></div>
2914 <p>This is most useful when you are working on the definition of a new
2915 mode.
2916 </p>
2917 <p>The <var class="var">magnification</var> and <var class="var">mfname</var> arguments are explained in
2918 <a class="ref" href="#mf-invocation"><code class="code">mf</code> invocation</a>. In the file <samp class="file">newmode.mf</samp>, you should have the
2919 following (with no <code class="code">mode_def</code> or <code class="code">enddef</code>), if you are using
2920 <samp class="file">modes.mf</samp> conventions:
2921 </p><div class="example">
2922 <pre class="example-preformatted">mode_param (pixels_per_inch, <var class="var">dpi</var>);
2923 mode_param (blacker, <var class="var">b</var>);
2924 mode_param (fillin, <var class="var">f</var>);
2925 mode_param (o_correction, <var class="var">o</var>);
2926 mode_common_setup_;
2927 </pre></div>
2928 <p>(Of course, you should use real numbers for <var class="var">dpi</var>, <var class="var">b</var>, <var class="var">f</var>,
2929 and <var class="var">o</var>.)
2930 </p>
2931 <p>For more information on the use of <code class="code">smode</code>, or if you are not using
2932 <samp class="file">modes.mf</samp>, see page 269 of <cite class="cite">The Metafontbook</cite>.
2933 </p>
2934
2935 <hr>
2936 </div>
2937 <div class="section-level-extent" id="Online-Metafont-graphics">
2938 <div class="nav-panel">
2939 <p>
2940 Next: <a href="#gftodvi-invocation" accesskey="n" rel="next">GFtoDVI: Character proofs of fonts</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes: Device definitions for Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2941 </div>
2942 <h3 class="section" id="Online-Metafont-graphics-1"><span>6.4 Online Metafont graphics<a class="copiable-link" href="#Online-Metafont-graphics-1"> &para;</a></span></h3>
2943
2944 <a class="index-entry-id" id="index-online-Metafont-graphics"></a>
2945 <a class="index-entry-id" id="index-Metafont-graphics"></a>
2946
2947 <p>The Web2c implementation of Metafont can do online graphics with a
2948 number of devices. (See <cite class="cite">The Metafontbook</cite> for more information
2949 about how to draw on your screen.) The default graphics support is
2950 determined at compile time.
2951 </p>
2952 <p>The two Kpathsea configuration variables <code class="code">screen_width</code> and
2953 <code class="code">screen_depth</code> define the width and height of the window used by
2954 Metafont. They can be set in the environment or a Kpathsea
2955 configuration file (see <a data-manual="Kpathsea" href="Kpathsea.html#path-sources">path sources</a> in <cite class="cite">kpathsea</cite>). They
2956 default to 1664 and 1200, respectively.
2957 </p>
2958 <a class="index-entry-id" id="index-MFTERM"></a>
2959 <a class="index-entry-id" id="index-TERM"></a>
2960 <p>Metafont examines the <code class="code">MFTERM</code> environment variable or config file
2961 value at runtime, or the <code class="code">TERM</code> environment variable if
2962 <code class="code">MFTERM</code> is not set, to determine the device support to use.
2963 Some devices are system-specific and not always available.
2964 </p>
2965 <a class="index-entry-id" id="index-DISPLAY"></a>
2966 <a class="index-entry-id" id="index-X-server_002c-and-Metafont"></a>
2967 <p>If <code class="code">MFTERM</code> is not set, but the <code class="code">DISPLAY</code> environment
2968 variable is set (to a valid X server specification like &lsquo;<samp class="samp">:0</samp>&rsquo;),
2969 the Metafont window support for X is used, assuming it was detected
2970 and included at compile time.
2971 </p>
2972 <p>Here is a table of the possibilities, showing the <code class="code">MFTERM</code> value
2973 and the corresponding <code class="code">configure</code> option(s) in parentheses.
2974 </p>
2975 <dl class="vtable">
2976 <dt><a id="index-amiga"></a><span><code class="code">amiga</code><a class="copiable-link" href="#index-amiga"> &para;</a></span></dt>
2977 <dd><a class="index-entry-id" id="index-_002d_002denable_002damigawin"></a>
2978 <p>(&lsquo;<samp class="samp">--enable-amigawin</samp>&rsquo;) Amiga systems.
2979 </p>
2980 </dd>
2981 <dt><a id="index-epsf"></a><span><code class="code">epsf</code><a class="copiable-link" href="#index-epsf"> &para;</a></span></dt>
2982 <dd><a class="index-entry-id" id="index-Herberts_002c-Mathias"></a>
2983 <a class="index-entry-id" id="index-_002d_002denable_002depsfwin"></a>
2984 <p>(&lsquo;<samp class="samp">--enable-epsfwin</samp>&rsquo;) Pseudo-window server for Encapsulated
2985 PostScript (see <samp class="file">web2c/window/epsf.c</samp>). This device produces an
2986 EPS file containing the graphics which would be displayed online on
2987 other devices. The name of the EPS file defaults to metafont.eps but
2988 can be changed by setting the MFEPSF environment variable to the new
2989 filename. Contributed by Mathias Herberts.
2990 </p>
2991 </dd>
2992 <dt><a id="index-hp2627"></a><span><code class="code">hp2627</code><a class="copiable-link" href="#index-hp2627"> &para;</a></span></dt>
2993 <dd><a class="index-entry-id" id="index-_002d_002denable_002dhp2627win"></a>
2994 <p>(&lsquo;<samp class="samp">--enable-hp2627win</samp>&rsquo;) HP2627a color graphics terminals.
2995 </p>
2996 </dd>
2997 <dt><a id="index-mftalk"></a><span><code class="code">mftalk</code><a class="copiable-link" href="#index-mftalk"> &para;</a></span></dt>
2998 <dd><a class="index-entry-id" id="index-_002d_002denable_002dmftalkwin"></a>
2999 <p>(&lsquo;<samp class="samp">--enable-mftalkwin</samp>&rsquo;) Generic window server (see
3000 <samp class="file">web2c/window/mftalk.c</samp>). </p>
3001 </dd>
3002 <dt><a id="index-next"></a><span><code class="code">next</code><a class="copiable-link" href="#index-next"> &para;</a></span></dt>
3003 <dd><a class="index-entry-id" id="index-_002d_002denable_002dnext"></a>
3004 <a class="index-entry-id" id="index-DrawingServant"></a>
3005 <p>(&lsquo;<samp class="samp">--enable-nextwin</samp>&rsquo;) NeXT window system. This requires a separate
3006 program, called <code class="code">DrawingServant</code>, available separately. See the
3007 <samp class="file">web2c/window/next.c</samp>.
3008 </p>
3009 </dd>
3010 <dt><a id="index-regis"></a><span><code class="code">regis</code><a class="copiable-link" href="#index-regis"> &para;</a></span></dt>
3011 <dd><a class="index-entry-id" id="index-_002d_002denable_002dregiswin"></a>
3012 <a class="index-entry-id" id="index-Regis-graphics-support"></a>
3013 <p>(&lsquo;<samp class="samp">--enable-regiswin</samp>&rsquo;) Regis terminals.
3014 </p>
3015 </dd>
3016 <dt><a id="index-sun"></a><span><code class="code">sun</code><a class="copiable-link" href="#index-sun"> &para;</a></span></dt>
3017 <dd><a class="index-entry-id" id="index-SunView"></a>
3018 <a class="index-entry-id" id="index-Suntools"></a>
3019 <a class="index-entry-id" id="index-_002d_002denable_002dsuntoolswin"></a>
3020 <a class="index-entry-id" id="index-sun_002dgfx_002ec"></a>
3021 <p>(&lsquo;<samp class="samp">--enable-suntoolswin</samp>&rsquo;) The old Suntools (not any flavor of X)
3022 window system. (You can get the even older SunWindows <code class="code">gfx</code> system
3023 with <samp class="file">sun-gfx.c</samp>.)
3024 </p>
3025 </dd>
3026 <dt><a id="index-tek"></a><span><code class="code">tek</code><a class="copiable-link" href="#index-tek"> &para;</a></span></dt>
3027 <dd><a class="index-entry-id" id="index-Tektronix"></a>
3028 <a class="index-entry-id" id="index-_002d_002denable_002dtektronixwin"></a>
3029 <p>(&lsquo;<samp class="samp">--enable-tektronixwin</samp>&rsquo;) Tektronix terminals.
3030 </p>
3031 </dd>
3032 <dt><a id="index-uniterm"></a><span><code class="code">uniterm</code><a class="copiable-link" href="#index-uniterm"> &para;</a></span></dt>
3033 <dd><a class="index-entry-id" id="index-Poole_002c-Simon"></a>
3034 <a class="index-entry-id" id="index-Tektronix-4014"></a>
3035 <a class="index-entry-id" id="index-_002d_002denable_002dunitermwin"></a>
3036 <p>(&lsquo;<samp class="samp">--enable-unitermwin</samp>&rsquo;) Uniterm, Simon Poole&rsquo;s emulator of a smart
3037 Tektronix 4014 terminal. This may work with regular Tektronix terminals
3038 as well; it&rsquo;s faster than the driver &lsquo;<samp class="samp">--enable-tektronixwin</samp>&rsquo; selects.
3039 </p>
3040 </dd>
3041 <dt><a id="index-win32win"></a><span><code class="code">win32win</code><a class="copiable-link" href="#index-win32win"> &para;</a></span></dt>
3042 <dd><p>Microsoft Windows.
3043 </p>
3044 </dd>
3045 <dt><a class="index-entry-id" id="index-Xt"></a>
3046 <a class="index-entry-id" id="index-Xlib"></a>
3047 <a id="index-xterm"></a><span><code class="code">xterm</code><a class="copiable-link" href="#index-xterm"> &para;</a></span></dt>
3048 <dd><a class="index-entry-id" id="index-_002d_002dwith_002dx"></a>
3049 <p>&lsquo;<samp class="samp">--with-x</samp>&rsquo; The X window system (version 11).
3050 </p>
3051 <a class="index-entry-id" id="index-_002d_002dwith_002dmf_002dx_002dtoolkit"></a>
3052 <a class="index-entry-id" id="index-toolkits_002c-X"></a>
3053 <a class="index-entry-id" id="index-X-toolkits-and-Metafont"></a>
3054 <a class="index-entry-id" id="index-Xt-support"></a>
3055 <a class="index-entry-id" id="index-Xlib-support"></a>
3056 <p>There are two variants of the X11 support, one that works with the Xt
3057 toolkit (<samp class="file">X11-Xt.c</samp>), and another that works directly with Xlib
3058 (<samp class="file">X11-Xlib.c</samp>). If <code class="code">--with-mf-x-toolkit</code> is specified when
3059 building Metafont, the Xt version is used, else Xlib.
3060 </p>
3061 <a class="index-entry-id" id="index-_002d_002ddisable_002dmf_002dnowin"></a>
3062 <a class="index-entry-id" id="index-non_002dwindows_002dcapable-Metafont"></a>
3063 <a class="index-entry-id" id="index-Metafont-without-online-graphics"></a>
3064 <p>Specify &lsquo;<samp class="samp">--disable-mf-nowin</samp>&rsquo; in order not to build a separate
3065 non-windows-capable Metafont executable <code class="code">mf-nowin</code>.
3066 </p>
3067 <a class="index-entry-id" id="index-X-resources"></a>
3068 <a class="index-entry-id" id="index-X-class-name-for-Metafont"></a>
3069 <a class="index-entry-id" id="index-class-name-for-Metafont"></a>
3070 <a class="index-entry-id" id="index-geometry-for-Metafont"></a>
3071 <a class="index-entry-id" id="index-Metafont-geometry"></a>
3072 <a class="index-entry-id" id="index-_002eXdefaults"></a>
3073 <a class="index-entry-id" id="index-_002eXresources"></a>
3074 <a class="index-entry-id" id="index-_002dgeometry_002c-supported-with-Xt"></a>
3075 <p>You cannot specify any of the usual X options (e.g., &lsquo;<samp class="samp">-geometry</samp>&rsquo;)
3076 on the Metafont command line, but you can specify X resources in your
3077 <samp class="file">~/.Xdefaults</samp> or <samp class="file">~/.Xresources</samp> file. The class name is
3078 <code class="code">Metafont</code>. If you&rsquo;re using the Xt support, all the usual X toolkit
3079 resources are supported. If you&rsquo;re using the Xlib support, only the
3080 <code class="code">geometry</code> resource is supported.
3081 </p>
3082 <a class="index-entry-id" id="index-DISPLAY-1"></a>
3083 <p>You specify the X display to which Metafont connects in the
3084 <code class="code">DISPLAY</code> environment variable, as usual.
3085 </p>
3086 </dd>
3087 </dl>
3088
3089 <a class="index-entry-id" id="index-Metafont-online-support_002c-new-devices"></a>
3090 <a class="index-entry-id" id="index-new-graphics-support-for-Metafont"></a>
3091 <a class="index-entry-id" id="index-texmfmp_002ec"></a>
3092 <p>Writing support for a new device is straightforward. Aside from defining
3093 the basic drawing routines that Metafont uses (see <samp class="file">mf.web</samp>), you
3094 only have to add another entry to the tables on the last page of
3095 <samp class="file">web2c/lib/texmfmp.c</samp>. Or you can write an independent program and
3096 use MFtalk (see <samp class="file">web2c/window/mftalk.c</samp>).
3097 </p>
3098
3099 <hr>
3100 </div>
3101 <div class="section-level-extent" id="gftodvi-invocation">
3102 <div class="nav-panel">
3103 <p>
3104 Next: <a href="#mft-invocation" accesskey="n" rel="next">MFT: Prettyprinting Metafont source</a>, Previous: <a href="#Online-Metafont-graphics" accesskey="p" rel="prev">Online Metafont graphics</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3105 </div>
3106 <h3 class="section" id="GFtoDVI_003a-Character-proofs-of-fonts"><span>6.5 GFtoDVI: Character proofs of fonts<a class="copiable-link" href="#GFtoDVI_003a-Character-proofs-of-fonts"> &para;</a></span></h3>
3107
3108 <a class="index-entry-id" id="index-gftodvi"></a>
3109 <a class="index-entry-id" id="index-character-proofs-of-fonts"></a>
3110 <a class="index-entry-id" id="index-font-proofs"></a>
3111 <a class="index-entry-id" id="index-proof-sheets_002c-of-fonts"></a>
3112
3113 <p>GFtoDVI makes <em class="dfn">proof sheets</em> from a GF bitmap file as output by, for
3114 example, Metafont (see <a class="pxref" href="#Metafont">Metafont: Creating typeface families</a>). This is an indispensable aid for
3115 font designers or Metafont hackers. Synopsis:
3116 </p>
3117 <div class="example">
3118 <pre class="example-preformatted">gftodvi [<var class="var">option</var>]... <var class="var">gfname</var>[gf]
3119 </pre></div>
3120
3121 <p>The font <var class="var">gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
3122 lookup</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
3123 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
3124 the program.
3125 </p>
3126 <p>The suffix &lsquo;<samp class="samp">gf</samp>&rsquo; is supplied if not already present. This suffix is
3127 not an extension, no &lsquo;<samp class="samp">.</samp>&rsquo; precedes it; for instance, <samp class="file">cmr10.600gf</samp>.
3128 </p>
3129 <p>The output filename is the basename of <var class="var">gfname</var> extended with
3130 <samp class="file">.dvi</samp>, e.g., &lsquo;<samp class="samp">gftodvi /wherever/foo.600gf</samp>&rsquo; creates
3131 <samp class="file">./foo.dvi</samp>.
3132 </p>
3133 <p>The characters from <var class="var">gfname</var> appear one per page in the DVI output,
3134 with labels, titles, and annotations, as specified in Appendix H
3135 (Hardcopy Proofs) of <cite class="cite">The Metafontbook</cite>.
3136 </p>
3137 <p>GFtoDVI uses several fonts besides <var class="var">gfname</var> itself:
3138 </p>
3139 <ul class="itemize mark-bullet">
3140 <li><a class="index-entry-id" id="index-gray-font"></a>
3141 <em class="dfn">gray font</em> (default <samp class="file">gray</samp>): for the pixels that make
3142 up the character. Simply using black is not right, since then labels,
3143 key points, and other information could not be shown.
3144
3145 </li><li><a class="index-entry-id" id="index-title-font"></a>
3146 <em class="dfn">title font</em> (default <samp class="file">cmr8</samp>): for the header information at
3147 the top of each output page.
3148
3149 </li><li><a class="index-entry-id" id="index-label-font"></a>
3150 <em class="dfn">label font</em> (default <samp class="file">cmtt10</samp>): for the labels on key points
3151 of the figure.
3152
3153 </li><li><a class="index-entry-id" id="index-slant-font"></a>
3154 <em class="dfn">slant font</em> (no default): for diagonal lines, which are otherwise
3155 simulated using horizontal and vertical rules.
3156 </li></ul>
3157
3158 <p>To change the default fonts, you must use <code class="code">special</code> commands in
3159 your Metafont source file, typically via commands like <code class="code">slantfont
3160 slantlj4</code>. There is no default slant font since no one printer is
3161 suitable as a default. You can make your own by copying one of the
3162 existing files, such as
3163 <samp class="file">.../fonts/source/public/misc/slantlj4.mf</samp> and then running
3164 <code class="command">mf</code> on it.
3165 </p>
3166 <p>For testing purposes, you may it useful to run <code class="code">mf-nowin rtest</code>
3167 (hit RETURN when it stops) to get a <samp class="file">gf</samp> file of a thorn glyph.
3168 Or use <code class="command">mf</code> instead of <code class="command">mf-nowin</code> to have the glyph(s)
3169 displayed on the screen. After that, <code class="code">gftodvi rtest.2602gf</code>
3170 should produce <samp class="file">rtest.dvi</samp>, which you process as usual.
3171 </p>
3172 <p>The program accepts the following option, as well as the standard
3173 &lsquo;<samp class="samp">-verbose</samp>&rsquo;, &lsquo;<samp class="samp">-help</samp>&rsquo;, and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
3174 </p>
3175 <dl class="table">
3176 <dt><a class="index-entry-id" id="index-overflow-label-offset"></a>
3177 <a class="index-entry-id" id="index-offset-for-overflow-labels"></a>
3178 <a id="index-_002doverflow_002dlabel_002doffset_003dpoints"></a><span>&lsquo;<samp class="samp">-overflow-label-offset=<var class="var">points</var></samp>&rsquo;<a class="copiable-link" href="#index-_002doverflow_002dlabel_002doffset_003dpoints"> &para;</a></span></dt>
3179 <dd><p>Typeset the so-called overflow labels, if any, <var class="var">points</var> TeX
3180 points from the right edge of the character bounding box. The default
3181 is a little over two inches (ten million scaled points, to be precise).
3182 Overflow equations are used to locate coordinates when their actual
3183 position is too crowded with other information.
3184 </p></dd>
3185 </dl>
3186
3187
3188 <hr>
3189 </div>
3190 <div class="section-level-extent" id="mft-invocation">
3191 <div class="nav-panel">
3192 <p>
3193 Previous: <a href="#gftodvi-invocation" accesskey="p" rel="prev">GFtoDVI: Character proofs of fonts</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont: Creating typeface families</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3194 </div>
3195 <h3 class="section" id="MFT_003a-Prettyprinting-Metafont-source"><span>6.6 MFT: Prettyprinting Metafont source<a class="copiable-link" href="#MFT_003a-Prettyprinting-Metafont-source"> &para;</a></span></h3>
3196
3197 <a class="index-entry-id" id="index-mft"></a>
3198 <a class="index-entry-id" id="index-Metafont-or-MetaPost-source_002c-prettyprinting"></a>
3199 <a class="index-entry-id" id="index-prettyprinting-Metafont-or-MetaPost-source"></a>
3200 <a class="index-entry-id" id="index-TeX_002c-creating-from-Metafont-or-MetaPost"></a>
3201
3202 <a class="index-entry-id" id="index-mftmac_002etex"></a>
3203 <p>MFT translates a Metafont or MetaPost program into a TeX document
3204 suitable for typesetting. Synopsis:
3205 </p>
3206 <div class="example">
3207 <pre class="example-preformatted">mft [<var class="var">option</var>]... <var class="var">sourcename</var>[.mf|.mp]
3208 </pre></div>
3209
3210 <p>MFT searches the usual places for <var class="var">sourcename</var> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file
3211 formats</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
3212 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
3213 the program. The output goes to the basename of <var class="var">sourcename</var> extended
3214 with <samp class="file">.tex</samp>, e.g., &lsquo;<samp class="samp">mft /wherever/foo.mf</samp>&rsquo; creates
3215 <samp class="file">./foo.tex</samp>.
3216 </p>
3217 <p>The output uses the TeX macros defined in the file
3218 <samp class="file">mftmac.tex</samp> (for Metafont) or <samp class="file">mptmac.tex</samp> (for MetaPost).
3219 </p>
3220 <p>Line breaks in the input are carried over into the output; moreover,
3221 blank spaces at the beginning of a line are converted to quads of
3222 indentation in the output. Thus, you have full control over the
3223 indentation and line breaks. Each line of input is translated
3224 independently of the others.
3225 </p>
3226 <p>Further control is allowed via comments:
3227 <a class="index-entry-id" id="index-comments_002c-MFT-control"></a>
3228 </p><ul class="itemize mark-bullet">
3229 <li>Metafont/MetaPost comments following a single &lsquo;<samp class="samp">%</samp>&rsquo; should be valid
3230 TeX input. But Metafont/MetaPost source material can be included
3231 within vertical bars in a comment; this will be translated by MFT as
3232 if it were regular code. For example, a Metafont comment like &lsquo;<samp class="samp">%
3233 |x2r| is the tip of the bowl</samp>&rsquo; will be translated into the TeX
3234 &lsquo;<samp class="samp">% $x_{2r}$ is the &hellip;</samp>&rsquo;, i.e., the &lsquo;<samp class="samp">x2r</samp>&rsquo; is treated as
3235 an identifier.
3236
3237 </li><li>&lsquo;<samp class="samp">%%</samp>&rsquo; indicates that the remainder of an input line should be copied
3238 verbatim to the output. This is typically used to introduce additional
3239 TeX material at the beginning or an MFT job, e.g. code to modify the
3240 standard layout or the formatting macros defined in <samp class="file">mftmac.tex</samp>,
3241 or to add a line saying &lsquo;<samp class="samp">%%\bye</samp>&rsquo; at the end of the job. (MFT
3242 doesn&rsquo;t add this automatically in order to allow processing several
3243 files produces by MFT in the same TeX job.)
3244
3245 </li><li>&lsquo;<samp class="samp">%%% <var class="var">token1</var> <var class="var">other-tokens</var></samp>&rsquo;
3246 introduces a change in MFT&rsquo;s formatting rules; all the <var class="var">other-tokens</var>
3247 will henceforth be translated according to the current conventions for
3248 <var class="var">token1</var>. The tokens must be symbolic (i.e., not
3249 numeric or string tokens). For example, the input line
3250 <div class="example">
3251 <pre class="example-preformatted">%%% addto fill draw filldraw
3252 </pre></div>
3253 <p>says to format the &lsquo;<samp class="samp">fill</samp>&rsquo;, &lsquo;<samp class="samp">draw</samp>&rsquo;, and &lsquo;<samp class="samp">filldraw</samp>&rsquo;
3254 operations of plain Metafont just like the primitive token &lsquo;<samp class="samp">addto</samp>&rsquo;,
3255 i.e., in boldface type. Without such reformatting commands, MFT would
3256 treat &lsquo;<samp class="samp">fill</samp>&rsquo; like an ordinary tag or variable name. In fact, you
3257 need a &lsquo;<samp class="samp">%%%</samp>&rsquo; command even to get parentheses to act like
3258 delimiters.
3259 </p>
3260 </li><li>&lsquo;<samp class="samp">%%%%</samp>&rsquo; introduces an MFT comment, i.e., MFT ignores the remainder
3261 of such a line.
3262
3263 </li><li>Five or more &lsquo;<samp class="samp">%</samp>&rsquo; signs should not be used.
3264 </li></ul>
3265
3266 <a class="index-entry-id" id="index-Knuth_002c-Donald-E_002e-1"></a>
3267 <p>(The above description was based on that in <samp class="file">mft.web</samp>, written by
3268 Donald Knuth.)
3269 </p>
3270 <p>The program accepts the following options, as well as the standard
3271 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
3272 </p><dl class="table">
3273 <dt><a class="index-entry-id" id="index-change-files_002c-and-MFT"></a>
3274 <a id="index-_002dchange_003dchfile"></a><span>&lsquo;<samp class="samp">-change=<var class="var">chfile</var>[.ch]</samp>&rsquo;<a class="copiable-link" href="#index-_002dchange_003dchfile"> &para;</a></span></dt>
3275 <dd><p>Apply the change file <var class="var">chfile</var> as with Tangle and Weave
3276 (see <a class="pxref" href="#WEB">WEB: Literate programming</a>).
3277 </p>
3278 </dd>
3279 <dt><a id="index-_002dmetapost"></a><span>&lsquo;<samp class="samp">-metapost</samp>&rsquo;<a class="copiable-link" href="#index-_002dmetapost"> &para;</a></span></dt>
3280 <dd><p>Force interpretation of the input as MetaPost; this is the default of
3281 the filename extension is &lsquo;<samp class="samp">.mp</samp>&rsquo;.
3282 </p>
3283 </dd>
3284 <dt><a class="index-entry-id" id="index-style-files"></a>
3285 <a class="index-entry-id" id="index-plain_002emft"></a>
3286 <a id="index-_002dstyle_003dmftfile"></a><span>&lsquo;<samp class="samp">-style=<var class="var">mftfile</var>[.mft]</samp>&rsquo;<a class="copiable-link" href="#index-_002dstyle_003dmftfile"> &para;</a></span></dt>
3287 <dd><p>Read <var class="var">mftfile</var> before anything else; a MFT style file typically
3288 contains only MFT directives as described above. The default style
3289 file is <samp class="file">plain.mft</samp> (for Metafont) or <samp class="file">mplain.mft</samp> (for
3290 MetaPost). MFT files are searched along the <code class="code">MFTINPUTS</code> path
3291 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>).
3292 </p>
3293 <a class="index-entry-id" id="index-cmbase_002emft"></a>
3294 <a class="index-entry-id" id="index-e_002emft"></a>
3295 <a class="index-entry-id" id="index-Computer-Modern-Typefaces_002c-production-of"></a>
3296 <p>Other examples of MFT style files are <samp class="file">cmbase.mft</samp>, which defines
3297 formatting rules for the macros defined in <samp class="file">cm.base</samp>, and
3298 <samp class="file">e.mft</samp>, which was used in the production of Knuth&rsquo;s Volume&nbsp;<!-- /@w -->E,
3299 <cite class="cite">Computer Modern Typefaces</cite>.
3300 </p>
3301 <a class="index-entry-id" id="index-MetaPost-source_002c-prettyprinting"></a>
3302 <p>Using an appropriate MFT style file, it is also possible to configure
3303 MFT for typesetting MetaPost sources. However, MFT does not search
3304 the usual places for MetaPost input files.
3305 </p></dd>
3306 </dl>
3307
3308 <p>If you use eight-bit characters in the input file, they are
3309 passed on verbatim to the TeX output file; it is up to you to
3310 configure TeX to print these properly.
3311 </p>
3312
3313 <hr>
3314 </div>
3315 </div>
3316 <div class="chapter-level-extent" id="MetaPost">
3317 <div class="nav-panel">
3318 <p>
3319 Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX: Bibliographies</a>, Previous: <a href="#Metafont" accesskey="p" rel="prev">Metafont: Creating typeface families</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3320 </div>
3321 <h2 class="chapter" id="MetaPost_003a-Generating-PostScript"><span>7 MetaPost: Generating PostScript<a class="copiable-link" href="#MetaPost_003a-Generating-PostScript"> &para;</a></span></h2>
3322
3323 <a class="index-entry-id" id="index-MetaPost"></a>
3324 <a class="index-entry-id" id="index-PostScript-meets-Metafont"></a>
3325 <a class="index-entry-id" id="index-Metafont-meets-PostScript"></a>
3326 <a class="index-entry-id" id="index-technical-illustrations_002c-creating"></a>
3327 <p>MetaPost is a picture-drawing language similar to Metafont
3328 (see <a class="pxref" href="#Metafont">Metafont: Creating typeface families</a>), but instead of outputting bitmaps in a &ldquo;font&rdquo;, it
3329 outputs PostScript commands. It&rsquo;s primarily intended for creating
3330 technical illustrations, but can also be used to create PostScript or
3331 OpenType fonts (<a class="url" href="https://ctan.org/pkg/metatype1">https://ctan.org/pkg/metatype1</a>).
3332 </p>
3333 <a class="index-entry-id" id="index-troff_002c-supported-in-MetaPost"></a>
3334 <p>MetaPost also provides for arbitrary integration of text and graphics in
3335 a natural way, using any typesetter (TeX and Troff are both
3336 supported) and a number of other subsidiary programs, described below.
3337 </p>
3338
3339
3340 <ul class="mini-toc">
3341 <li><a href="#mpost-invocation" accesskey="1"><code class="code">mpost</code> invocation</a></li>
3342 <li><a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a></li>
3343 <li><a href="#dvitomp-invocation" accesskey="3">DVItoMP: DVI to MPX conversion</a></li>
3344 </ul>
3345 <hr>
3346 <div class="section-level-extent" id="mpost-invocation">
3347 <div class="nav-panel">
3348 <p>
3349 Next: <a href="#Initial-MetaPost" accesskey="n" rel="next">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating PostScript</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3350 </div>
3351 <h3 class="section" id="mpost-invocation-1"><span>7.1 <code class="code">mpost</code> invocation<a class="copiable-link" href="#mpost-invocation-1"> &para;</a></span></h3>
3352
3353 <a class="index-entry-id" id="index-mpost"></a>
3354 <a class="index-entry-id" id="index-MetaPost-invocation"></a>
3355
3356 <a class="index-entry-id" id="index-mpman_002epdf"></a>
3357 <p>MetaPost (installed as <code class="code">mpost</code>) reads a series of pictures
3358 specified in the MetaPost programming language, and outputs
3359 corresponding PostScript code. This section merely describes the
3360 options available in the Web2c implementation. For a complete
3361 description of the MetaPost language, see AT&amp;T technical report
3362 CSTR-162, generally available in <samp class="file"><var class="var">texmf</var>/doc/metapost/</samp>,
3363 where <var class="var">texmf</var> is the root of TeX directory structure.
3364 The MetaPost home page: <a class="url" href="https://tug.org/metapost">https://tug.org/metapost</a>.
3365 </p>
3366 <a class="index-entry-id" id="index-mpgraph_002epdf"></a>
3367 <p>Also, a standard MetaPost package for drawing graphs is documented in
3368 AT&amp;T technical report CSTR-164, available as the file <samp class="file">mpgraph.ps</samp>,
3369 generally stored alongside <samp class="file">mpman.ps</samp>.
3370 </p>
3371 <p>MetaPost processes its command line in a way analogous to Metafont and
3372 TeX (see <a class="pxref" href="#tex-invocation"><code class="code">tex</code> invocation</a>).
3373 Synopses:
3374 </p>
3375 <div class="example">
3376 <pre class="example-preformatted">mpost [<var class="var">option</var>]... [<var class="var">mpname</var>[.mp]] [<var class="var">mp-commands</var>]
3377 mpost [<var class="var">option</var>]... \<var class="var">first-line</var>
3378 mpost [<var class="var">option</var>]... &amp;<var class="var">mem</var> <var class="var">args</var>
3379 </pre></div>
3380
3381 <a class="index-entry-id" id="index-_002emp"></a>
3382 <a class="index-entry-id" id="index-MetaPost-input-files"></a>
3383 <p>MetaPost searches the usual places for the main input file <var class="var">mpname</var>
3384 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>), extending
3385 <var class="var">mpname</var> with <samp class="file">.mp</samp> if necessary. To see all the relevant
3386 paths, set the environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo;
3387 before running the program.
3388 </p>
3389 <a class="index-entry-id" id="index-beginfig"></a>
3390 <a class="index-entry-id" id="index-_002ennn-PostScript-figures"></a>
3391 <a class="index-entry-id" id="index-_002etfm-output-1"></a>
3392 <a class="index-entry-id" id="index-mpout"></a>
3393 <a class="index-entry-id" id="index-TFM-files_002c-output-by-MetaPost"></a>
3394 <a class="index-entry-id" id="index-PostScript-output"></a>
3395 <p>MetaPost writes its PostScript output to a series of files
3396 <samp class="file"><var class="var">basempname</var>.<var class="var">nnn</var></samp> (or perhaps
3397 <samp class="file"><var class="var">basempname</var>.ps</samp>, very occasionally
3398 <samp class="file"><var class="var">basempname</var>.tfm</samp>), where <var class="var">nnn</var> are the figure numbers
3399 specified in the input, typically to the <code class="code">beginfig</code> macro, and
3400 <var class="var">basempname</var> is the basename of <var class="var">mpname</var>, or &lsquo;<samp class="samp">mpout</samp>&rsquo; if no
3401 input file was specified. MetaPost uses the &lsquo;<samp class="samp">.ps</samp>&rsquo; extension when
3402 the figure number is out of range, e.g., if you say <code class="code">beginfig(-1)</code>.
3403 </p>
3404 <p>You can use the output files as figures in a TeX document just as
3405 with any other PostScript figures. For example, with this TeX command:
3406 </p><div class="example">
3407 <pre class="example-preformatted">\special{psfile=&quot;<var class="var">filename</var>&quot;}
3408 </pre></div>
3409 <p>or by using <samp class="file">epsf.tex</samp> (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite class="cite">Dvips</cite>).
3410 </p>
3411 <a class="index-entry-id" id="index-btex-for-MetaPost-labels"></a>
3412 <a class="index-entry-id" id="index-etex-for-MetaPost-labels"></a>
3413 <p>The MetaPost construct
3414 </p><div class="example">
3415 <pre class="example-preformatted">btex ... <var class="var">tex-input</var> ... etex
3416 </pre></div>
3417 <p>generates a MetaPost picture expression corresponding to
3418 <var class="var">tex-input</var>.
3419 </p>
3420 <p>The construct
3421 </p><div class="example">
3422 <pre class="example-preformatted">verbatimtex ... <var class="var">tex-input</var> ... etex
3423 </pre></div>
3424 <p>simply passes the <var class="var">tex-input</var> through to
3425 TeX. For example, if you are using LaTeX, your MetaPost input file
3426 must start with a <code class="code">verbatimtex</code> block that gives the necessary
3427 <code class="code">\documentclass</code> (or <code class="code">\documentstyle</code>)
3428 <code class="code">\begin{document}</code> command. You will also need to set the
3429 environment variable <code class="code">TEX</code> to &lsquo;<samp class="samp">latex</samp>&rsquo;.
3430 </p>
3431 <p><var class="var">tex-input</var> need not be specifically TeX input; it could also be
3432 Troff. In that case, you will need the &lsquo;<samp class="samp">-m pictures</samp>&rsquo; Troff macro
3433 package (unfortunately absent from many Troff implementations), or an
3434 equivalent such as the &lsquo;<samp class="samp">-m pspic</samp>&rsquo; macros from GNU groff described
3435 in grops(1).
3436 </p>
3437 <a class="index-entry-id" id="index-PostScript-fonts_002c-and-Troff"></a>
3438 <a class="index-entry-id" id="index-Troff_002c-and-MetaPost"></a>
3439 <a class="index-entry-id" id="index-Computer-Modern-fonts_002c-and-Troff"></a>
3440 <p>Naturally, you must use fonts that are supported by the typesetter;
3441 specifically, you&rsquo;ll probably want to use standard PostScript fonts with
3442 Troff. And only the TeX system understands Computer Modern or other
3443 Metafont fonts; you can also use PostScript fonts with TeX, of course.
3444 </p>
3445 <a class="index-entry-id" id="index-mproof_002etex"></a>
3446 <a class="index-entry-id" id="index-downloading-of-fonts-for-MetaPost-labels"></a>
3447 <a class="index-entry-id" id="index-font-downloading-for-MetaPost-labels"></a>
3448 <p>MetaPost-generated PostScript figures which do use Computer Modern fonts
3449 for labels cannot be directly previewed or printed. Instead, you must
3450 include them in a TeX document and run the resulting DVI file through
3451 Dvips to arrange for the downloading of the required fonts (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts
3452 in figures</a> in <cite class="cite">Dvips</cite>). To help with this, the MetaPost
3453 distribution provides a small TeX file <samp class="file">mproof.tex</samp> which is
3454 typically called as:
3455 </p><div class="example">
3456 <pre class="example-preformatted">tex mproof <var class="var">mp-output-files</var>... ; dvips mproof -o
3457 </pre></div>
3458 <p>The resulting file <samp class="file">mproof.ps</samp> can then be printed or previewed.
3459 </p>
3460 <a class="index-entry-id" id="index-prologues_002c-and-EPSF-output"></a>
3461 <a class="index-entry-id" id="index-psfonts_002emap_002c-read-by-MetaPost"></a>
3462 <p>To generate EPSF files, set the internal MetaPost variable
3463 <code class="code">prologues</code> positive. To make the output files self-contained, use
3464 only standard PostScript fonts. MetaPost reads the same
3465 <samp class="file">psfonts.map</samp> file as Dvips, to determine PostScript fonts that
3466 need to be downloaded (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite class="cite">Dvips</cite>).
3467 </p>
3468 <a class="index-entry-id" id="index-PDF_002c-and-_002emps-files"></a>
3469 <a class="index-entry-id" id="index-_002emps-files-and-PDF"></a>
3470 <p>It is possible for pdfTeX to read MetaPost output directly; this is
3471 in contrast to general EPSF files, which have to be converted for use
3472 with PDF output. The easiest way is to name the MetaPost output files
3473 with the <code class="code">.mps</code> extension. Then the LaTeX
3474 <code class="code">\includegraphics</code> command, for example, will be able to read
3475 them, even when outputting PDF.
3476 </p>
3477 <a class="index-entry-id" id="index-security_002c-and-write"></a>
3478 <p>MetaPost can write output files, via the <code class="code">write</code> primitive; this
3479 opens a security hole. See <a class="xref" href="#tex-invocation"><code class="code">tex</code> invocation</a>.
3480 </p>
3481 <p>The program accepts the following options, as well as the standard
3482 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
3483 </p><dl class="table">
3484 <dt>&lsquo;<samp class="samp">-[no]-file-line-error</samp>&rsquo;</dt>
3485 <dt>&lsquo;<samp class="samp">-halt-on-error</samp>&rsquo;</dt>
3486 <dt>&lsquo;<samp class="samp">-ini</samp>&rsquo;</dt>
3487 <dt>&lsquo;<samp class="samp">-interaction=<var class="var">string</var></samp>&rsquo;</dt>
3488 <dt>&lsquo;<samp class="samp">-jobname=<var class="var">string</var></samp>&rsquo;</dt>
3489 <dt>&lsquo;<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>&rsquo;</dt>
3490 <dt>&lsquo;<samp class="samp">-[no]parse-first-line</samp>&rsquo;</dt>
3491 <dt>&lsquo;<samp class="samp">-output-directory</samp>&rsquo;</dt>
3492 <dt>&lsquo;<samp class="samp">-progname=<var class="var">string</var></samp>&rsquo;</dt>
3493 <dt>&lsquo;<samp class="samp">-recorder</samp>&rsquo;</dt>
3494 <dt>&lsquo;<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>&rsquo;</dt>
3495 <dt>&lsquo;<samp class="samp">-8bit</samp>&rsquo;</dt>
3496 <dd><p>These options are common to TeX, Metafont, and MetaPost.
3497 See <a class="xref" href="#Common-options">Common options</a>.
3498 </p>
3499 </dd>
3500 <dt><a id="index-_002ddebug"></a><span>&lsquo;<samp class="samp">-debug</samp>&rsquo;<a class="copiable-link" href="#index-_002ddebug"> &para;</a></span></dt>
3501 <dd><p>Print debugging information and leave temporary files in place.
3502 </p>
3503 </dd>
3504 <dt><a id="index-_002dmem"></a><span>&lsquo;<samp class="samp">-mem=<var class="var">MPFILE</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmem"> &para;</a></span></dt>
3505 <dd><p>Preload <var class="var">MPFILE</var> instead of via the program name of <code class="code">%&amp;</code> line.
3506 This is a MetaPost source file; MetaPost no longer has binary mem files.
3507 </p>
3508 </dd>
3509 <dt><a id="index-_002dnumbersystem"></a><span>&lsquo;<samp class="samp">-numbersystem=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dnumbersystem"> &para;</a></span></dt>
3510 <dd><p>Set number system mode where <var class="var">string</var> is one of:
3511 <code class="code">scaled double binary interval decimal</code>.
3512 </p>
3513 </dd>
3514 <dt><a id="index-_002drestricted"></a><span>&lsquo;<samp class="samp">-restricted</samp>&rsquo;<a class="copiable-link" href="#index-_002drestricted"> &para;</a></span></dt>
3515 <dd><p>Be secure: disable the <code class="code">tex</code>, <code class="code">makempx</code> and editor commands.
3516 </p>
3517 </dd>
3518 <dt><a id="index-_002ds"></a><span>&lsquo;<samp class="samp">-s <var class="var">internal</var>=<var class="var">value</var></samp>&rsquo;<a class="copiable-link" href="#index-_002ds"> &para;</a></span></dt>
3519 <dd><p>Set <var class="var">INTERNAL</var> to <var class="var">VALUE</var>, a string or integer.
3520 </p>
3521 </dd>
3522 <dt><a class="index-entry-id" id="index-_002dtroff"></a>
3523 <a class="index-entry-id" id="index-prologues"></a>
3524 <a id="index-_002dT"></a><span>&lsquo;<samp class="samp">-T</samp>&rsquo;<a class="copiable-link" href="#index-_002dT"> &para;</a></span></dt>
3525 <dt>&lsquo;<samp class="samp">-troff</samp>&rsquo;</dt>
3526 <dd><p>Set the <code class="code">prologues</code> internal variable to <code class="code">1</code>.
3527 </p>
3528 </dd>
3529 <dt><a id="index-_002dtex_003dtexprogram"></a><span>&lsquo;<samp class="samp">-tex=<var class="var">texprogram</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dtex_003dtexprogram"> &para;</a></span></dt>
3530 <dd><p>When this option is given, the program <var class="var">texprogram</var> is used to
3531 typeset the labels.
3532 </p>
3533 </dd>
3534 </dl>
3535
3536
3537 <hr>
3538 </div>
3539 <div class="section-level-extent" id="Initial-MetaPost">
3540 <div class="nav-panel">
3541 <p>
3542 Next: <a href="#dvitomp-invocation" accesskey="n" rel="next">DVItoMP: DVI to MPX conversion</a>, Previous: <a href="#mpost-invocation" accesskey="p" rel="prev"><code class="code">mpost</code> invocation</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating PostScript</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3543 </div>
3544 <h3 class="section" id="Initial-MetaPost-1"><span>7.2 Initial MetaPost<a class="copiable-link" href="#Initial-MetaPost-1"> &para;</a></span></h3>
3545
3546 <a class="index-entry-id" id="index-initial-MetaPost"></a>
3547 <a class="index-entry-id" id="index-MetaPost_002c-initial"></a>
3548
3549 <p>As of MetaPost 1.504 (TeX Live 2011), MetaPost no longer dumps
3550 <samp class="file">.mem</samp> files (see <a class="pxref" href="#Memory-dumps">Memory dumps</a>) and does not distinguish
3551 virgin and initial forms (see <a class="pxref" href="#Initial-and-virgin">Initial and virgin</a>). Instead, the
3552 &ldquo;initial&rdquo; file name is read in its source form&mdash;that is,
3553 <samp class="file">mpost.mp</samp> when the program is invoked as <code class="command">mpost</code>. This
3554 is considered to be &ldquo;preloading&rdquo; the source.
3555 </p>
3556 <p>For a list of options and other information, see <a class="ref" href="#mpost-invocation"><code class="code">mpost</code> invocation</a>.
3557 </p>
3558 <a class="index-entry-id" id="index-Metafont_002c-compatibility-in-MetaPost"></a>
3559 <a class="index-entry-id" id="index-plain-Metafont_002c-compatibility-in-MetaPost"></a>
3560 <a class="index-entry-id" id="index-MetaPost-and-plain-Metafont-compatibility"></a>
3561 <a class="index-entry-id" id="index-mfplain"></a>
3562 <p>MetaPost provides a format with all the features of plain Metafont,
3563 called <samp class="file">mfplain</samp>. You can use that in the same way; just run
3564 <code class="command">mfplain</code> instead of <code class="command">mpost</code>. This lets you directly
3565 process Metafont source files with MetaPost, producing character
3566 proofs (one file for each character) similar to those produced with
3567 Metafont in proof mode and GFtoDVI (see <a class="pxref" href="#gftodvi-invocation">GFtoDVI: Character proofs of fonts</a>).
3568 </p>
3569
3570 <hr>
3571 </div>
3572 <div class="section-level-extent" id="dvitomp-invocation">
3573 <div class="nav-panel">
3574 <p>
3575 Previous: <a href="#Initial-MetaPost" accesskey="p" rel="prev">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost: Generating PostScript</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3576 </div>
3577 <h3 class="section" id="DVItoMP_003a-DVI-to-MPX-conversion"><span>7.3 DVItoMP: DVI to MPX conversion<a class="copiable-link" href="#DVItoMP_003a-DVI-to-MPX-conversion"> &para;</a></span></h3>
3578
3579 <a class="index-entry-id" id="index-dvitomp"></a>
3580 <a class="index-entry-id" id="index-DVI-files_002c-converting-to-MPX"></a>
3581 <a class="index-entry-id" id="index-MPX-files_002c-converting-from-DVI-files"></a>
3582
3583 <p>DVItoMP converts DVI files into low-level MetaPost commands in a
3584 so-called MPX file. Synopsis:
3585 </p>
3586 <div class="example">
3587 <pre class="example-preformatted">dvitomp <var class="var">dvifile</var>[.dvi] [<var class="var">mpxfile</var>[.mpx]]
3588 </pre></div>
3589
3590 <p>If <var class="var">mpxfile</var> is not specified, the output goes to the basename of
3591 <var class="var">dvifile</var> extended with <samp class="file">.mpx</samp>, e.g., &lsquo;<samp class="samp">dvitomp
3592 /wherever/foo.dvi</samp>&rsquo; creates <samp class="file">./foo.mpx</samp>.
3593 </p>
3594 <a class="index-entry-id" id="index-color_002c-in-DVItoMP"></a>
3595 <p>DVItoMP supports Dvips-style color specials, such as &lsquo;<samp class="samp">color push
3596 <var class="var">name</var></samp>&rsquo; and &lsquo;<samp class="samp">color pop</samp>&rsquo;, outputting them as <code class="code">withcolor</code>
3597 MetaPost commands.
3598 </p>
3599 <p>The only options are &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>).
3600 </p>
3601
3602 <hr>
3603 </div>
3604 </div>
3605 <div class="chapter-level-extent" id="BibTeX">
3606 <div class="nav-panel">
3607 <p>
3608 Next: <a href="#WEB" accesskey="n" rel="next">WEB: Literate programming</a>, Previous: <a href="#MetaPost" accesskey="p" rel="prev">MetaPost: Generating PostScript</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3609 </div>
3610 <h2 class="chapter" id="BibTeX_003a-Bibliographies"><span>8 BibTeX: Bibliographies<a class="copiable-link" href="#BibTeX_003a-Bibliographies"> &para;</a></span></h2>
3611
3612 <a class="index-entry-id" id="index-bibliographies_002c-creating"></a>
3613 <a class="index-entry-id" id="index-BibTeX"></a>
3614
3615 <p>BibTeX automates much of the job of typesetting bibliographies, and
3616 makes bibliography entries reusable in many different contexts.
3617 </p>
3618
3619
3620 <ul class="mini-toc">
3621 <li><a href="#bibtex-invocation" accesskey="1">BibTeX invocation</a></li>
3622 <li><a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a></li>
3623 </ul>
3624 <hr>
3625 <div class="section-level-extent" id="bibtex-invocation">
3626 <div class="nav-panel">
3627 <p>
3628 Next: <a href="#Basic-BibTeX-style-files" accesskey="n" rel="next">Basic BibTeX style files</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX: Bibliographies</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3629 </div>
3630 <h3 class="section" id="BibTeX-invocation"><span>8.1 BibTeX invocation<a class="copiable-link" href="#BibTeX-invocation"> &para;</a></span></h3>
3631
3632 <a class="index-entry-id" id="index-bibtex"></a>
3633
3634 <a class="index-entry-id" id="index-_002ebbl-bibliography-files"></a>
3635 <a class="index-entry-id" id="index-_002eaux-cross_002dreference-files"></a>
3636 <a class="index-entry-id" id="index-_002ebib-bibliography-databases"></a>
3637 <p>BibTeX creates a printable bibliography (<samp class="file">.bbl</samp>) file from
3638 references in a <samp class="file">.aux</samp> file, generally written by TeX or
3639 LaTeX. The <samp class="file">.bbl</samp> file is then incorporated on a subsequent
3640 run. The basic bibliographic information comes from <samp class="file">.bib</samp> files,
3641 and a BibTeX style (<samp class="file">.bst</samp>) file controls the precise contents
3642 of the <samp class="file">.bbl</samp> file. Synopsis:
3643 </p>
3644 <div class="example">
3645 <pre class="example-preformatted">bibtex [<var class="var">option</var>]... <var class="var">auxfile</var>[.aux]
3646 </pre></div>
3647
3648 <a class="index-entry-id" id="index-_002eblg-BibTeX-log-file"></a>
3649 <a class="index-entry-id" id="index-log-file_002c-BibTeX"></a>
3650 <p>The output goes to the basename of <var class="var">auxfile</var> extended with
3651 <samp class="file">.bbl</samp>; for example, &lsquo;<samp class="samp">bibtex /wherever/foo.aux</samp>&rsquo; creates
3652 <samp class="file">./foo.bbl</samp>. BibTeX also writes a log file to the basename of
3653 <var class="var">auxfile</var> extended with &lsquo;<samp class="samp">.blg</samp>&rsquo;.
3654 </p>
3655 <a class="index-entry-id" id="index-_005cbibliography"></a>
3656 <a class="index-entry-id" id="index-_005cbibliographystyle"></a>
3657 <a class="index-entry-id" id="index-TEXBIB_002c-search-path-for-bib-files"></a>
3658 <a class="index-entry-id" id="index-BIBINPUTS_002c-search-path-for-bib-files"></a>
3659 <a class="index-entry-id" id="index-BSTINPUTS_002c-search-path-for-bst-files"></a>
3660 <p>The names of the <samp class="file">.bib</samp> and <samp class="file">.bst</samp> files are specified in the
3661 <samp class="file">.aux</samp> file as well, via the <samp class="file">\bibliography</samp> and
3662 <samp class="file">\bibliographystyle</samp> (La)TeX macros. BibTeX searches for
3663 <samp class="file">.bib</samp> files using the <code class="code">BIBINPUTS</code> and <code class="code">TEXBIB</code> paths,
3664 and for <samp class="file">.bst</samp> files using <code class="code">BSTINPUTS</code> (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file
3665 formats</a> in <cite class="cite">Kpathsea</cite>). It does no path searching for
3666 <samp class="file">.aux</samp> files.
3667 </p>
3668 <p>The program accepts the following options, as well as the standard
3669 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
3670 </p><dl class="table">
3671 <dt><a class="index-entry-id" id="index-terse-output"></a>
3672 <a class="index-entry-id" id="index-verbose-BibTeX-output_002c-suppressing"></a>
3673 <a id="index-_002dterse"></a><span>&lsquo;<samp class="samp">-terse</samp>&rsquo;<a class="copiable-link" href="#index-_002dterse"> &para;</a></span></dt>
3674 <dd><p>Suppress the program banner and progress reports normally output.
3675 </p>
3676 </dd>
3677 <dt><a class="index-entry-id" id="index-cross_002dreferenced-bibliography-items"></a>
3678 <a class="index-entry-id" id="index-bibliography-items_002c-cross_002dreferenced"></a>
3679 <a id="index-_002dmin_002dcrossrefs_003dn"></a><span>&lsquo;<samp class="samp">-min-crossrefs=<var class="var">n</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmin_002dcrossrefs_003dn"> &para;</a></span></dt>
3680 <dd><p>If at least <var class="var">n</var> (2 by default) bibliography entries refer to another
3681 entry <var class="var">e</var> via their <code class="code">crossref</code> field, include <var class="var">e</var> in the
3682 <code class="t">.bbl</code> file, even if it was not explicitly referenced in the <code class="t">.aux</code>
3683 file. For example, <var class="var">e</var> might be a conference proceedings as a whole,
3684 with the cross-referencing entries being individual articles published
3685 in the proceedings.
3686 </p>
3687 <p>If you want to avoid these automatic inclusions altogether, make
3688 <var class="var">n</var> a sufficiently large number, and be sure to remove any
3689 previous <code class="t">.aux</code> and <code class="t">.bbl</code> files. Otherwise the option may
3690 appear to have no effect, since BibTeX will have added the citation
3691 for <var class="var">e</var> to the <code class="t">.aux</code>, and nothing will remove it.
3692 </p>
3693 </dd>
3694 </dl>
3695
3696 <p>See also:
3697 </p><dl class="table">
3698 <dt><a id="index-btxdoc_002etex"></a><span><samp class="file">btxdoc.tex</samp><a class="copiable-link" href="#index-btxdoc_002etex"> &para;</a></span></dt>
3699 <dd><p>Basic LaTeXable documentation for general BibTeX users.
3700 </p>
3701 </dd>
3702 <dt><a class="index-entry-id" id="index-style-design_002c-for-BibTeX"></a>
3703 <a id="index-btxhak_002etex"></a><span><samp class="file">btxhak.tex</samp><a class="copiable-link" href="#index-btxhak_002etex"> &para;</a></span></dt>
3704 <dd><p>LaTeXable documentation for style designers.
3705 </p>
3706 </dd>
3707 <dt><a id="index-btxdoc_002ebib"></a><span><samp class="file">btxdoc.bib</samp><a class="copiable-link" href="#index-btxdoc_002ebib"> &para;</a></span></dt>
3708 <dd><p>BibTeX database file for the two above documents.
3709 </p>
3710 </dd>
3711 <dt><a id="index-xampl_002ebib"></a><span><samp class="file">xampl.bib</samp><a class="copiable-link" href="#index-xampl_002ebib"> &para;</a></span></dt>
3712 <dd><p>Example database file with all the standard entry types.
3713 </p>
3714 </dd>
3715 <dt><a class="index-entry-id" id="index-BibTeX-collection"></a>
3716 <a class="index-entry-id" id="index-TUGboat-bibliography"></a>
3717 <a class="index-entry-id" id="index-TeX_002c-bibliographies-for"></a>
3718 <a id="index-ftp_002emath_002eutah_002eedu"></a><span><samp class="file"><a class="url" href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></samp><a class="copiable-link" href="#index-ftp_002emath_002eutah_002eedu"> &para;</a></span></dt>
3719 <dd><p>A very large <samp class="file">.bib</samp> and <samp class="file">.bst</samp> collection, including
3720 references for all the standard TeX books and a complete bibliography
3721 for TUGboat.
3722 </p></dd>
3723 </dl>
3724
3725
3726 <hr>
3727 </div>
3728 <div class="section-level-extent" id="Basic-BibTeX-style-files">
3729 <div class="nav-panel">
3730 <p>
3731 Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">BibTeX invocation</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX: Bibliographies</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3732 </div>
3733 <h3 class="section" id="Basic-BibTeX-style-files-1"><span>8.2 Basic BibTeX style files<a class="copiable-link" href="#Basic-BibTeX-style-files-1"> &para;</a></span></h3>
3734
3735 <a class="index-entry-id" id="index-basic-BibTeX-style-files"></a>
3736 <a class="index-entry-id" id="index-BibTeX-style-files"></a>
3737
3738 <p>Here are descriptions of the four standard and four semi-standard basic
3739 BibTeX styles. <samp class="file"><var class="var">CTAN:</var>/biblio/bibtex</samp> contains these and
3740 many more (for CTAN info, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite class="cite">Kpathsea</cite>).
3741 </p>
3742 <dl class="table">
3743 <dt><a id="index-plain_002ebst"></a><span><code class="code">plain</code><a class="copiable-link" href="#index-plain_002ebst"> &para;</a></span></dt>
3744 <dd><p>Sorts entries alphabetically, with numeric labels. Generally formatted
3745 according to van Leunen&rsquo;s <cite class="cite">A Handbook for Scholars</cite>. The other
3746 style files listed here are based on <code class="code">plain</code>.
3747 </p>
3748 </dd>
3749 <dt><a id="index-abbrv_002ebst"></a><span><code class="code">abbrv</code><a class="copiable-link" href="#index-abbrv_002ebst"> &para;</a></span></dt>
3750 <dd><p>First names, month names, and journal names are abbreviated.
3751 </p>
3752 </dd>
3753 <dt><a id="index-acm_002ebst"></a><span><code class="code">acm</code><a class="copiable-link" href="#index-acm_002ebst"> &para;</a></span></dt>
3754 <dd><p>Names are printed in small caps.
3755 </p>
3756 </dd>
3757 <dt><a id="index-alpha_002ebst"></a><span><code class="code">alpha</code><a class="copiable-link" href="#index-alpha_002ebst"> &para;</a></span></dt>
3758 <dd><p>Alphanumeric labels, e.g., &lsquo;<samp class="samp">Knu66</samp>&rsquo;.
3759 </p>
3760 </dd>
3761 <dt><a id="index-apalike_002ebst"></a><span><code class="code">apalike</code><a class="copiable-link" href="#index-apalike_002ebst"> &para;</a></span></dt>
3762 <dd><p>No labels at all; instead, the year appears in parentheses after the author.
3763 Use this in conjunction with <samp class="file">apalike.tex</samp> (plain TeX) or
3764 <samp class="file">apalike.sty</samp> (LaTeX), which also changes the citations in the
3765 text to be &lsquo;<samp class="samp">(<var class="var">author</var>, <var class="var">year</var>)</samp>&rsquo;.
3766 </p>
3767 </dd>
3768 <dt><a id="index-ieeetr_002ebst"></a><span><code class="code">ieeetr</code><a class="copiable-link" href="#index-ieeetr_002ebst"> &para;</a></span></dt>
3769 <dd><p>Numeric labels, entries in citation order, <small class="sc">IEEE</small> abbreviations,
3770 article titles in quotes.
3771 </p>
3772 </dd>
3773 <dt><a id="index-siam_002ebst"></a><span><code class="code">siam</code><a class="copiable-link" href="#index-siam_002ebst"> &para;</a></span></dt>
3774 <dd><p>Numeric labels, alphabetic order, <cite class="cite">Math. Reviews</cite>
3775 abbreviations, names in small caps.
3776 </p>
3777 </dd>
3778 <dt><a id="index-unsrt_002ebst"></a><span><code class="code">unsrt</code><a class="copiable-link" href="#index-unsrt_002ebst"> &para;</a></span></dt>
3779 <dd><p>Lists entries in citation order, i.e., unsorted.
3780 </p>
3781 </dd>
3782 <dt><code class="code">btxbst.doc</code></dt>
3783 <dd><p>The template file and documentation for the standard styles.
3784 </p>
3785 </dd>
3786 </dl>
3787
3788
3789 <hr>
3790 </div>
3791 </div>
3792 <div class="chapter-level-extent" id="WEB">
3793 <div class="nav-panel">
3794 <p>
3795 Next: <a href="#DVI-utilities" accesskey="n" rel="next">DVI utilities</a>, Previous: <a href="#BibTeX" accesskey="p" rel="prev">BibTeX: Bibliographies</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3796 </div>
3797 <h2 class="chapter" id="WEB_003a-Literate-programming"><span>9 WEB: Literate programming<a class="copiable-link" href="#WEB_003a-Literate-programming"> &para;</a></span></h2>
3798
3799 <a class="index-entry-id" id="index-WEB"></a>
3800 <a class="index-entry-id" id="index-literate-programming"></a>
3801
3802 <p><em class="dfn">WEB</em> languages allow you to write a single source file that can
3803 produce both a compilable program and a well-formatted document
3804 describing the program in as much detail as you wish to prepare.
3805 Writing in this kind of dual-purpose language is called <em class="dfn">literate
3806 programming</em>. (The Usenet newsgroup <samp class="file">comp.programming.literate</samp>
3807 is devoted to this subject.)
3808 </p>
3809 <a class="index-entry-id" id="index-webman_002etex"></a>
3810 <a class="index-entry-id" id="index-Spiderweb"></a>
3811 <a class="index-entry-id" id="index-Cweb"></a>
3812 <a class="index-entry-id" id="index-CWEB"></a>
3813 <a class="index-entry-id" id="index-Awk_002c-WEB-for"></a>
3814 <a class="index-entry-id" id="index-Ada_002c-WEB-for"></a>
3815 <a class="index-entry-id" id="index-Troff_002c-WEB-for"></a>
3816 <p>WEB-like languages have been implemented with many pairs of base
3817 languages: Cweb provides C and Troff (see <a class="pxref" href="#References">References</a>); CWEB provides
3818 C and TeX (<samp class="file"><var class="var">CTAN:</var>/web/c_cpp/cweb</samp>); Spiderweb provides C,
3819 C++, Awk, Ada, many others, and TeX
3820 (<samp class="file"><var class="var">CTAN:</var>/web/spiderweb</samp>); and, of course, the original WEB
3821 provides Pascal and TeX, the implementation languages for the
3822 original TeX, Metafont, MetaPost, and related programs to come from
3823 the TeX project at Stanford.
3824 </p>
3825 <p>Knuth&rsquo;s original WEB language is documented in the file
3826 <samp class="file">webman.tex</samp>, available as a formatted pdf in the
3827 <code class="code">knuth-pdf</code> page (<a class="url" href="https://ctan.org/pkg/knuth-pdf">https://ctan.org/pkg/knuth-pdf</a>).
3828 </p>
3829
3830
3831 <ul class="mini-toc">
3832 <li><a href="#tangle-invocation" accesskey="1">Tangle: Translate WEB to Pascal</a></li>
3833 <li><a href="#weave-invocation" accesskey="2">Weave: Translate WEB to TeX</a></li>
3834 <li><a href="#pooltype-invocation" accesskey="3">Pooltype: Display WEB pool files</a></li>
3835 </ul>
3836 <hr>
3837 <div class="section-level-extent" id="tangle-invocation">
3838 <div class="nav-panel">
3839 <p>
3840 Next: <a href="#weave-invocation" accesskey="n" rel="next">Weave: Translate WEB to TeX</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3841 </div>
3842 <h3 class="section" id="Tangle_003a-Translate-WEB-to-Pascal"><span>9.1 Tangle: Translate WEB to Pascal<a class="copiable-link" href="#Tangle_003a-Translate-WEB-to-Pascal"> &para;</a></span></h3>
3843
3844 <a class="index-entry-id" id="index-tangle"></a>
3845 <a class="index-entry-id" id="index-Pascal_002c-creating-from-WEB"></a>
3846 <a class="index-entry-id" id="index-WEB-programs_002c-compiling"></a>
3847
3848 <p>Tangle creates a compilable Pascal program from a WEB source file
3849 (see <a class="pxref" href="#WEB">WEB: Literate programming</a>). Synopsis:
3850 </p>
3851 <div class="example">
3852 <pre class="example-preformatted">tangle [<var class="var">option</var>]... <var class="var">webfile</var>[.web] [<var class="var">changefile</var>[.ch]]
3853 </pre></div>
3854
3855 <a class="index-entry-id" id="index-change-files_002c-and-Tangle"></a>
3856 <p>The Pascal output is written to the basename of <var class="var">webfile</var> extended
3857 with &lsquo;<samp class="samp">.p</samp>&rsquo;; for example, &lsquo;<samp class="samp">tangle /wherever/foo.web</samp>&rsquo; creates
3858 <samp class="file">./foo.p</samp>. Tangle applies <var class="var">changefile</var> to <var class="var">webfile</var> before
3859 writing the output; by default, there is no change file.
3860 </p>
3861 <a class="index-entry-id" id="index-pool-file_002c-writing"></a>
3862 <a class="index-entry-id" id="index-string-pool_002c-writing"></a>
3863 <p>If the program makes use of the WEB string facility, Tangle writes the
3864 string pool to the basename of <var class="var">webfile</var> extended with &lsquo;<samp class="samp">.pool</samp>&rsquo;.
3865 </p>
3866 <p>The Pascal output is packed into lines of 72 characters or less, with
3867 the only concession to readability being the termination of lines at
3868 semicolons when this can be done conveniently.
3869 </p>
3870 <p>The program accepts the following options, as well as the standard
3871 &lsquo;<samp class="samp">--help</samp>&rsquo; and &lsquo;<samp class="samp">--version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
3872 </p>
3873 <dl class="table">
3874 <dt><a class="index-entry-id" id="index-identifier-length"></a>
3875 <a id="index-_002dlength_003dnumber"></a><span>&lsquo;<samp class="samp">-length=<var class="var">number</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dlength_003dnumber"> &para;</a></span></dt>
3876 <dd><p>The number of characters that are considered significant in an
3877 identifier. Whether underline characters are counted depends on the
3878 &lsquo;<samp class="samp">-underline</samp>&rsquo; option. The default value is 32, the original tangle
3879 used 7, but this proved too restrictive for use by Web2c.
3880 </p>
3881 </dd>
3882 <dt><a class="index-entry-id" id="index-_002dmixedcase"></a>
3883 <a class="index-entry-id" id="index-_002duppercase"></a>
3884 <a class="index-entry-id" id="index-identifier-case"></a>
3885 <a id="index-_002dlowercase"></a><span>&lsquo;<samp class="samp">-lowercase</samp>&rsquo;<a class="copiable-link" href="#index-_002dlowercase"> &para;</a></span></dt>
3886 <dt>&lsquo;<samp class="samp">-mixedcase</samp>&rsquo;</dt>
3887 <dt>&lsquo;<samp class="samp">-uppercase</samp>&rsquo;</dt>
3888 <dd><p>These options specify the case of identifiers in the output of tangle.
3889 If &lsquo;<samp class="samp">-uppercase</samp>&rsquo; (&lsquo;<samp class="samp">-lowercase</samp>&rsquo;) is specified, tangle will
3890 convert all identifiers to uppercase (lowercase). The default is
3891 &lsquo;<samp class="samp">-mixedcase</samp>&rsquo;, which specifies that the case will not be changed.
3892 </p>
3893 </dd>
3894 <dt><a class="index-entry-id" id="index-identifiers-with-underlines"></a>
3895 <a id="index-_002dunderline"></a><span>&lsquo;<samp class="samp">-underline</samp>&rsquo;<a class="copiable-link" href="#index-_002dunderline"> &para;</a></span></dt>
3896 <dd><p>When this option is given, tangle does not strip underline characters
3897 from identifiers.
3898 </p>
3899 </dd>
3900 <dt><a class="index-entry-id" id="index-_002dstrict"></a>
3901 <a class="index-entry-id" id="index-identifier-collisions"></a>
3902 <a id="index-_002dloose"></a><span>&lsquo;<samp class="samp">-loose</samp>&rsquo;<a class="copiable-link" href="#index-_002dloose"> &para;</a></span></dt>
3903 <dt>&lsquo;<samp class="samp">-strict</samp>&rsquo;</dt>
3904 <dd><p>These options specify how strict tangle must be when checking
3905 identifiers for equality. The default is &lsquo;<samp class="samp">-loose</samp>&rsquo;, which means
3906 that tangle will follow the rules set by the case-smashing and underline
3907 options above. If &lsquo;<samp class="samp">-strict</samp>&rsquo; is set, then identifiers will always
3908 be stripped of underlines and converted to uppercase before checking
3909 whether they collide.
3910 </p>
3911 </dd>
3912 </dl>
3913
3914 <hr>
3915 </div>
3916 <div class="section-level-extent" id="weave-invocation">
3917 <div class="nav-panel">
3918 <p>
3919 Next: <a href="#pooltype-invocation" accesskey="n" rel="next">Pooltype: Display WEB pool files</a>, Previous: <a href="#tangle-invocation" accesskey="p" rel="prev">Tangle: Translate WEB to Pascal</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3920 </div>
3921 <h3 class="section" id="Weave_003a-Translate-WEB-to-TeX"><span>9.2 Weave: Translate WEB to TeX<a class="copiable-link" href="#Weave_003a-Translate-WEB-to-TeX"> &para;</a></span></h3>
3922
3923 <a class="index-entry-id" id="index-weave"></a>
3924 <a class="index-entry-id" id="index-TeX_002c-creating-from-WEB"></a>
3925 <a class="index-entry-id" id="index-WEB-programs_002c-typesetting"></a>
3926 <a class="index-entry-id" id="index-prettyprinting-WEB-programs"></a>
3927
3928 <p>Weave creates a TeX document from a WEB source file (see <a class="pxref" href="#WEB">WEB: Literate programming</a>),
3929 assuming various macros defined in <samp class="file">webmac.tex</samp>. It takes care of
3930 typographic details such as page layout, indentation, and italicizing
3931 identifiers. It also automatically gathers and outputs extensive
3932 cross-reference information. Synopsis:
3933 </p>
3934 <div class="example">
3935 <pre class="example-preformatted">weave [<var class="var">option</var>]... <var class="var">webfile</var>[.web] [<var class="var">changefile</var>[.ch]]
3936 </pre></div>
3937
3938 <a class="index-entry-id" id="index-change-files_002c-and-Weave"></a>
3939 <p>The output is to the basename of <var class="var">webfile</var> extended with
3940 &lsquo;<samp class="samp">.tex</samp>&rsquo;; for example, &lsquo;<samp class="samp">weave /wherever/foo.web</samp>&rsquo; creates
3941 <samp class="file">./foo.tex</samp>. Weave applies <var class="var">changefile</var> to <var class="var">webfile</var>
3942 before writing the output; by default, there is no change file.
3943 </p>
3944 <p>The Web2c version of Weave accepts 8-bit characters as themselves.
3945 This can cause trouble with various internal WEB control codes, and
3946 should not be relied on.
3947 </p>
3948 <p>The program accepts the following option, as well as the standard
3949 &lsquo;<samp class="samp">-verbose</samp>&rsquo;, &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
3950 </p><dl class="table">
3951 <dt><a class="index-entry-id" id="index-cross_002dreferences_002c-omitting"></a>
3952 <a class="index-entry-id" id="index-CONTENTS_002etex"></a>
3953 <a class="index-entry-id" id="index-webmac_002etex"></a>
3954 <a id="index-_002dx"></a><span>&lsquo;<samp class="samp">-x</samp>&rsquo;<a class="copiable-link" href="#index-_002dx"> &para;</a></span></dt>
3955 <dd><p>Omit the cross-reference information: the index, the list of WEB module
3956 names, and the table of contents (an empty <samp class="file">CONTENTS.tex</samp> file will
3957 still be written when the Weave output file is processed by TeX using
3958 the default <samp class="file">webmac.tex</samp>, though).
3959 </p></dd>
3960 </dl>
3961
3962 <p>Conventionally, WEB programmers should define the TeX <code class="code">\title</code>
3963 macro at the beginning of the source file. Also, to get output of only
3964 changed modules, one can say <code class="code">\let\maybe=\iffalse</code> (usually as the
3965 first change in the change file).
3966 </p>
3967
3968 <hr>
3969 </div>
3970 <div class="section-level-extent" id="pooltype-invocation">
3971 <div class="nav-panel">
3972 <p>
3973 Previous: <a href="#weave-invocation" accesskey="p" rel="prev">Weave: Translate WEB to TeX</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB: Literate programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3974 </div>
3975 <h3 class="section" id="Pooltype_003a-Display-WEB-pool-files"><span>9.3 Pooltype: Display WEB pool files<a class="copiable-link" href="#Pooltype_003a-Display-WEB-pool-files"> &para;</a></span></h3>
3976
3977 <a class="index-entry-id" id="index-pooltype"></a>
3978 <a class="index-entry-id" id="index-type-programs_002c-pool"></a>
3979 <a class="index-entry-id" id="index-string-numbers_002c-displaying"></a>
3980 <a class="index-entry-id" id="index-WEB-pool-files_002c-displaying"></a>
3981
3982 <p>Pooltype shows the so-called <em class="dfn">string number</em> of each string in a WEB
3983 pool file (see <a class="pxref" href="#WEB">WEB: Literate programming</a>), as output by Tangle (see <a class="pxref" href="#tangle-invocation">Tangle: Translate WEB to Pascal</a>), including the first 256 strings corresponding to the
3984 possible input characters. Pooltype primarily serves as an example of
3985 WEB conventions to implementors of the TeX system. Synopsis:
3986 </p>
3987 <div class="example">
3988 <pre class="example-preformatted">pooltype [<var class="var">option</var>]... <var class="var">poolfile</var>[.pool]
3989 </pre></div>
3990
3991 <p>No path searching is done for <var class="var">poolfile</var>. Output is to standard
3992 output.
3993 </p>
3994 <p>The only options are &lsquo;<samp class="samp">--help</samp>&rsquo; and &lsquo;<samp class="samp">--version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>).
3995 </p>
3996 <p>As an example of the output, here is the (edited) output for <samp class="file">tex.pool</samp>:
3997 </p><div class="example">
3998 <pre class="example-preformatted">0: &quot;^^@&quot;
3999 1: &quot;^^A&quot;
4000 ...
4001 255: &quot;^^ff&quot;
4002 256: &quot;pool size&quot;
4003 ...
4004 1314: &quot;Using character substitution: &quot;
4005 (23617 characters in all.)
4006 </pre></div>
4007
4008 <a class="index-entry-id" id="index-representation-of-strings"></a>
4009 <a class="index-entry-id" id="index-string-representation"></a>
4010 <p>In Metafont and MetaPost, the first 256 characters are represented as
4011 single bytes (i.e., themselves), not in the &lsquo;<samp class="samp">^^</samp>&rsquo; notation. Thus,
4012 Pooltype shows the results after conversion for output.
4013 </p>
4014
4015 <hr>
4016 </div>
4017 </div>
4018 <div class="chapter-level-extent" id="DVI-utilities">
4019 <div class="nav-panel">
4020 <p>
4021 Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Previous: <a href="#WEB" accesskey="p" rel="prev">WEB: Literate programming</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4022 </div>
4023 <h2 class="chapter" id="DVI-utilities-1"><span>10 DVI utilities<a class="copiable-link" href="#DVI-utilities-1"> &para;</a></span></h2>
4024
4025 <a class="index-entry-id" id="index-DVI-utilities"></a>
4026
4027 <p>TeX outputs a file in <em class="dfn">DVI</em> (DeVice Independent) format as a
4028 compact representation of the original document. DVI files can be
4029 translated to meet the requirements of a real physical device, such as
4030 PostScript printers (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite class="cite">Dvips</cite>), PCL
4031 printers (see dvilj(1)), and X displays (see xdvi(1)). In fact, DVI
4032 translators are available for virtually all common devices: see
4033 <samp class="file"><var class="var">CTAN:</var>/dviware</samp> (for CTAN info, see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite class="cite">Kpathsea</cite>).
4034 </p>
4035 <a class="index-entry-id" id="index-dvitype_002eweb"></a>
4036 <a class="index-entry-id" id="index-DVI-format-definition"></a>
4037 <p>For the precise definition of the DVI file format, see (for example) the
4038 source file <samp class="file">web2c/dvitype.web</samp>.
4039 </p>
4040 <p>The DVI-processing programs in the Web2c distribution are not device
4041 drivers; they perform generic utility functions.
4042 </p>
4043
4044 <ul class="mini-toc">
4045 <li><a href="#dvicopy-invocation" accesskey="1">DVIcopy: Canonicalize virtual font references</a></li>
4046 <li><a href="#dvitype-invocation" accesskey="2">DVItype: Plain text transliteration of DVI files</a></li>
4047 </ul>
4048 <hr>
4049 <div class="section-level-extent" id="dvicopy-invocation">
4050 <div class="nav-panel">
4051 <p>
4052 Next: <a href="#dvitype-invocation" accesskey="n" rel="next">DVItype: Plain text transliteration of DVI files</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4053 </div>
4054 <h3 class="section" id="DVIcopy_003a-Canonicalize-virtual-font-references"><span>10.1 DVIcopy: Canonicalize virtual font references<a class="copiable-link" href="#DVIcopy_003a-Canonicalize-virtual-font-references"> &para;</a></span></h3>
4055
4056 <a class="index-entry-id" id="index-dvicopy"></a>
4057 <a class="index-entry-id" id="index-virtual-fonts_002c-expanding"></a>
4058
4059 <p>DVIcopy reads a DVI file, expands any references to virtual fonts
4060 (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite class="cite">Dvips</cite>) to base fonts, and writes the
4061 resulting DVI file. Thus you can use virtual fonts even if your DVI
4062 processor does not support them, by passing the documents through
4063 DVIcopy first. Synopsis:
4064 </p>
4065 <div class="example">
4066 <pre class="example-preformatted">dvicopy [<var class="var">option</var>]... [<var class="var">indvi</var>[.dvi] [<var class="var">outdvi</var>[.dvi]]]
4067 </pre></div>
4068
4069 <p>DVIcopy reads standard input if <var class="var">indvi</var> is not specified, and writes
4070 standard output if <var class="var">outdvi</var> is not specified.
4071 </p>
4072 <p>The program accepts the following options, as well as the standard
4073 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
4074 </p><dl class="table">
4075 <dt><a class="index-entry-id" id="index-magnification"></a>
4076 <a class="index-entry-id" id="index-_005cmag"></a>
4077 <a id="index-_002dmagnification_003dinteger"></a><span>&lsquo;<samp class="samp">-magnification=<var class="var">integer</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmagnification_003dinteger"> &para;</a></span></dt>
4078 <dd><p>Override existing magnification in <var class="var">indvi</var> with <var class="var">integer</var>; 1000
4079 specifies no magnification. This is equivalent to setting TeX&rsquo;s
4080 <code class="code">\mag</code> parameter.
4081 </p>
4082 </dd>
4083 <dt><a id="index-_002dmax_002dpages_003dn"></a><span>&lsquo;<samp class="samp">-max-pages=<var class="var">n</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmax_002dpages_003dn"> &para;</a></span></dt>
4084 <dd><p>Process <var class="var">n</var> pages; default is one million.
4085 </p>
4086 </dd>
4087 <dt><a class="index-entry-id" id="index-starting-page"></a>
4088 <a class="index-entry-id" id="index-page_002c-starting"></a>
4089 <a class="index-entry-id" id="index-_005ccountn"></a>
4090 <a id="index-_002dpage_002dstart_003dpage_002dspec"></a><span>&lsquo;<samp class="samp">-page-start=<var class="var">page-spec</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dpage_002dstart_003dpage_002dspec"> &para;</a></span></dt>
4091 <dd><p>Start at the first page matching <var class="var">page-spec</var>, which is one or more
4092 (signed) integers separated by periods, corresponding to TeX&rsquo;s
4093 <code class="code">\count0&hellip;9</code> parameters at <code class="code">\shipout</code> time; &lsquo;<samp class="samp">*</samp>&rsquo;
4094 matches anything. Examples: &lsquo;<samp class="samp">3</samp>&rsquo;, &lsquo;<samp class="samp">1.*.-4</samp>&rsquo;.
4095 </p></dd>
4096 </dl>
4097
4098
4099 <hr>
4100 </div>
4101 <div class="section-level-extent" id="dvitype-invocation">
4102 <div class="nav-panel">
4103 <p>
4104 Previous: <a href="#dvicopy-invocation" accesskey="p" rel="prev">DVIcopy: Canonicalize virtual font references</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4105 </div>
4106 <h3 class="section" id="DVItype_003a-Plain-text-transliteration-of-DVI-files"><span>10.2 DVItype: Plain text transliteration of DVI files<a class="copiable-link" href="#DVItype_003a-Plain-text-transliteration-of-DVI-files"> &para;</a></span></h3>
4107
4108 <a class="index-entry-id" id="index-dvitype-DVI-validation"></a>
4109 <a class="index-entry-id" id="index-conversion_002c-DVI-to-plain-text"></a>
4110 <a class="index-entry-id" id="index-plain-text_002c-converting-DVI-to"></a>
4111 <a class="index-entry-id" id="index-human_002dreadable-text_002c-converting-DVI-to"></a>
4112 <a class="index-entry-id" id="index-type-programs_002c-DVI"></a>
4113 <a class="index-entry-id" id="index-validation_002c-of-DVI-files"></a>
4114
4115 <p>DVItype translates a DeVice Independent (DVI) file (as output by TeX,
4116 for example) to a plain text file that humans can read. It also serves
4117 as a DVI-validating program, i.e., if DVItype can read a file, it&rsquo;s
4118 correct. Synopsis:
4119 </p>
4120 <div class="example">
4121 <pre class="example-preformatted">dvitype [<var class="var">option</var>]... <var class="var">dvifile</var>[.dvi]
4122 </pre></div>
4123
4124 <p>DVItype does not read any bitmap files, but it does read TFM files for
4125 fonts referenced in <var class="var">dvifile</var>. The usual places are searched
4126 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>). To see all the
4127 relevant paths, set the environment variable <code class="code">KPATHSEA_DEBUG</code> to
4128 &lsquo;<samp class="samp">-1</samp>&rsquo; before running the program.
4129 </p>
4130 <p>Output goes to standard output.
4131 </p>
4132 <p>The program accepts the following options, as well as the standard
4133 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
4134 </p><dl class="table">
4135 <dt><a id="index-_002ddpi_003dreal"></a><span>&lsquo;<samp class="samp">-dpi=<var class="var">real</var></samp>&rsquo;<a class="copiable-link" href="#index-_002ddpi_003dreal"> &para;</a></span></dt>
4136 <dd><p>Do pixel movement calculations at <var class="var">real</var> pixels per inch; default
4137 300.0.
4138 </p>
4139 </dd>
4140 <dt><a class="index-entry-id" id="index-magnification-1"></a>
4141 <a class="index-entry-id" id="index-_005cmag-1"></a>
4142 <a id="index-_002dmagnification_003dinteger-1"></a><span>&lsquo;<samp class="samp">-magnification=<var class="var">integer</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmagnification_003dinteger-1"> &para;</a></span></dt>
4143 <dd><p>Override existing magnification in <var class="var">indvi</var> with <var class="var">integer</var>; 1000
4144 specifies no magnification. This is equivalent to setting TeX&rsquo;s
4145 <code class="code">\mag</code> parameter.
4146 </p>
4147 </dd>
4148 <dt><a id="index-_002dmax_002dpages_003dn-1"></a><span>&lsquo;<samp class="samp">-max-pages=<var class="var">n</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dmax_002dpages_003dn-1"> &para;</a></span></dt>
4149 <dd><p>Process <var class="var">n</var> pages; default is one million.
4150 </p>
4151 </dd>
4152 <dt><a id="index-_002doutput_002dlevel_003dn"></a><span>&lsquo;<samp class="samp">-output-level=<var class="var">n</var></samp>&rsquo;<a class="copiable-link" href="#index-_002doutput_002dlevel_003dn"> &para;</a></span></dt>
4153 <dd><p>Verbosity level of output, from 0 to 4 (default 4):
4154 </p><ul class="itemize mark-bullet">
4155 <li>0: Global document information only.
4156 </li><li>1: Most DVI commands included, and typeset characters summarized.
4157 </li><li>2: Character and movement commands explicitly included.
4158 </li><li>3: DVI stack and current position calculations included.
4159 </li><li>4: Same information as level 3, but DVItype does random positioning
4160 in the file, reading the DVI postamble first.
4161 </li></ul>
4162
4163 </dd>
4164 <dt><a class="index-entry-id" id="index-starting-page-1"></a>
4165 <a class="index-entry-id" id="index-page_002c-starting-1"></a>
4166 <a class="index-entry-id" id="index-_005ccountn-1"></a>
4167 <a id="index-_002dpage_002dstart_003dpage_002dspec-1"></a><span>&lsquo;<samp class="samp">-page-start=<var class="var">page-spec</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dpage_002dstart_003dpage_002dspec-1"> &para;</a></span></dt>
4168 <dd><p>Start at the first page matching <var class="var">page-spec</var>, which is one or more
4169 (signed) integers separated by periods, corresponding to TeX&rsquo;s
4170 <code class="code">\count0&hellip;9</code> parameters at <code class="code">\shipout</code> time; &lsquo;<samp class="samp">*</samp>&rsquo;
4171 matches anything. Examples: &lsquo;<samp class="samp">1</samp>&rsquo;, &lsquo;<samp class="samp">5.*.-9</samp>&rsquo;.
4172 </p>
4173 </dd>
4174 <dt><a class="index-entry-id" id="index-opcodes_002c-showing-DVI"></a>
4175 <a class="index-entry-id" id="index-DVI-opcodes_002c-showing"></a>
4176 <a class="index-entry-id" id="index-debugging-DVI-utilities"></a>
4177 <a id="index-_002dshow_002dopcodes"></a><span>&lsquo;<samp class="samp">-show-opcodes</samp>&rsquo;<a class="copiable-link" href="#index-_002dshow_002dopcodes"> &para;</a></span></dt>
4178 <dd><p>Show numeric opcode values (in decimal) for DVI commands, in braces
4179 after the command name. This can help in debugging DVI utilities. We
4180 use decimal because in the DVI format documentation (in
4181 <samp class="file">dvitype.web</samp>, among others) the opcodes are shown in decimal.
4182 </p></dd>
4183 </dl>
4184
4185
4186
4187 <ul class="mini-toc">
4188 <li><a href="#dvitype-output-example" accesskey="1">DVItype output example</a></li>
4189 </ul>
4190 <hr>
4191 <div class="subsection-level-extent" id="dvitype-output-example">
4192 <div class="nav-panel">
4193 <p>
4194 Up: <a href="#dvitype-invocation" accesskey="u" rel="up">DVItype: Plain text transliteration of DVI files</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4195 </div>
4196 <h4 class="subsection" id="DVItype-output-example"><span>10.2.1 DVItype output example<a class="copiable-link" href="#DVItype-output-example"> &para;</a></span></h4>
4197
4198 <a class="index-entry-id" id="index-dvitype-output-example"></a>
4199 <p>As an example of the output from DVItype (see section above), here is
4200 its (abridged) translation of the <samp class="file">story.dvi</samp> resulting from
4201 running the example in <cite class="cite">The TeXbook</cite>, with
4202 &lsquo;<samp class="samp">-output-level=4</samp>&rsquo; and &lsquo;<samp class="samp">-show-opcodes</samp>&rsquo; on.
4203 </p>
4204 <div class="example">
4205 <pre class="example-preformatted">...
4206 Options selected:
4207 Starting page = *
4208 Maximum number of pages = 1000000
4209 Output level = 4 (the works)
4210 Resolution = 300.00000000 pixels per inch
4211 numerator/denominator=25400000/473628672
4212 magnification=1000; 0.00006334 pixels per DVI unit
4213 ' TeX output 1992.05.17:0844'
4214 Postamble starts at byte 564.
4215 maxv=43725786, maxh=30785863, maxstackdepth=3, totalpages=1
4216 Font 33: cmsl10---loaded at size 655360 DVI units
4217 Font 23: cmbx10---loaded at size 655360 DVI units
4218 Font 0: cmr10---loaded at size 655360 DVI units
4219
4220 42: beginning of page 1
4221 87: push {141}
4222 level 0:(h=0,v=0,w=0,x=0,y=0,z=0,hh=0,vv=0)
4223 88: down3 -917504 {159} v:=0-917504=-917504, vv:=-58
4224 92: pop {142}
4225 ...
4226 104: putrule {137} height 26214, width 30785863 (2x1950 pixels)
4227 113: down3 5185936 {159} v:=655360+5185936=5841296, vv:=370
4228 117: push {141}
4229 level 1:(h=0,v=5841296,w=0,x=0,y=0,z=0,hh=0,vv=370)
4230 118: right4 12265425 {146} h:=0+12265425=12265425, hh:=777
4231 [ ]
4232 123: fntdef1 23 {243}: cmbx10
4233 145: fntnum23 {194} current font is cmbx10
4234 146: setchar65 h:=12265425+569796=12835221, hh:=813
4235 147: w3 251220 {150} h:=12835221+251220=13086441, hh:=829
4236 151: setchar83 h:=13086441+418700=13505141, hh:=856
4237 ...
4238 164: setchar82 h:=17448202+565245=18013447, hh:=1142
4239 165: x0 -62805 {152} h:=18013447-62805=17950642, hh:=1138
4240 166: setchar89 h:=17950642+569796=18520438, hh:=1174
4241 [A SHORT STORY]
4242 167: pop {142}
4243 level 1:(h=0,v=5841296,w=0,x=0,y=0,z=0,hh=0,vv=370)
4244 ...
4245 550: pop {142}
4246 level 0:(h=0,v=42152922,w=0,x=0,y=0,z=0,hh=0,vv=2670)
4247 551: down3 1572864 {159} v:=42152922+1572864=43725786, vv:=2770
4248 555: push {141}
4249 level 0:(h=0,v=43725786,w=0,x=0,y=0,z=0,hh=0,vv=2770)
4250 556: right4 15229091 {146} h:=0+15229091=15229091, hh:=965
4251 561: setchar49 h:=15229091+327681=15556772, hh:=986
4252 [ 1]
4253 562: pop {142}
4254 level 0:(h=0,v=43725786,w=0,x=0,y=0,z=0,hh=0,vv=2770)
4255 563: eop {140}
4256 </pre></div>
4257
4258 <p>Explanation:
4259 </p>
4260 <ul class="itemize mark-bullet">
4261 <li>The DVItype options are recorded at the beginning, followed by
4262 global information about the document, including fonts used.
4263
4264 </li><li>Each DVI command is preceded by its byte position in the file
4265 (&lsquo;<samp class="samp">42:</samp>&rsquo;, &lsquo;<samp class="samp">87:</samp>&rsquo;, &hellip;), and (because of the
4266 &lsquo;<samp class="samp">-show-opcodes</samp>&rsquo;) followed by its decimal opcode value in braces
4267 (&lsquo;<samp class="samp">{141}</samp>&rsquo;, &lsquo;<samp class="samp">{142}</samp>&rsquo;, &hellip;).
4268
4269 </li><li>The &lsquo;<samp class="samp">level</samp>&rsquo; lines record information about the DVI stack; &lsquo;<samp class="samp">h</samp>&rsquo;
4270 and &lsquo;<samp class="samp">v</samp>&rsquo; define the current position in DVI units, while &lsquo;<samp class="samp">hh</samp>&rsquo;
4271 and &lsquo;<samp class="samp">vv</samp>&rsquo; are the same in pixels.
4272
4273 </li><li>Text sequences are summarized in brackets, as in &lsquo;<samp class="samp">[A SHORT
4274 STORY]</samp>&rsquo; and the &lsquo;<samp class="samp">[ 1]</samp>&rsquo;.
4275 </li></ul>
4276
4277
4278 <hr>
4279 </div>
4280 </div>
4281 </div>
4282 <div class="chapter-level-extent" id="Font-utilities">
4283 <div class="nav-panel">
4284 <p>
4285 Next: <a href="#Legalisms" accesskey="n" rel="next">Legalisms</a>, Previous: <a href="#DVI-utilities" accesskey="p" rel="prev">DVI utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4286 </div>
4287 <h2 class="chapter" id="Font-utilities-1"><span>11 Font utilities<a class="copiable-link" href="#Font-utilities-1"> &para;</a></span></h2>
4288
4289 <a class="index-entry-id" id="index-font-utilities"></a>
4290
4291 <p>The Web2c programs described here convert between various TeX-related
4292 font formats; the first section below briefly describes the
4293 formats. GFtoPK is the only one that is routinely used, as Metafont
4294 outputs GF format, but it&rsquo;s most efficient for device drivers to use PK.
4295 </p>
4296 <a class="index-entry-id" id="index-pktype_002eweb"></a>
4297 <a class="index-entry-id" id="index-gftype_002eweb"></a>
4298 <a class="index-entry-id" id="index-PK-format-definition"></a>
4299 <a class="index-entry-id" id="index-GF-format-definition"></a>
4300 <p>The precise definitions of the PK, GF, TFM, PL, VF, and VPL formats
4301 mentioned below are in the source files that read them;
4302 <samp class="file">pktype.web</samp>, <samp class="file">gftype.web</samp>, <samp class="file">tftopl.web</samp>, etc.
4303 </p>
4304
4305
4306 <ul class="mini-toc">
4307 <li><a href="#Font-file-formats" accesskey="1">Font file formats</a></li>
4308 <li><a href="#gftopk-invocation" accesskey="2">GFtoPK: Generic to packed font conversion</a></li>
4309 <li><a href="#pktogf-invocation" accesskey="3">PKtoGF: Packed to generic font conversion</a></li>
4310 <li><a href="#pktype-invocation" accesskey="4">PKtype: Plain text transliteration of packed fonts</a></li>
4311 <li><a href="#gftype-invocation" accesskey="5">GFtype: Plain text transliteration of generic fonts</a></li>
4312 <li><a href="#tftopl-invocation" accesskey="6">TFtoPL: TeX font metric to property list conversion</a></li>
4313 <li><a href="#pltotf-invocation" accesskey="7">PLtoTF: Property list to TeX font metric conversion</a></li>
4314 <li><a href="#vftovp-invocation" accesskey="8">VFtoVP: Virtual font to virtual property lists</a></li>
4315 <li><a href="#vptovf-invocation" accesskey="9">VPtoVF: Virtual property lists to virtual font</a></li>
4316 <li><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></li>
4317 </ul>
4318 <hr>
4319 <div class="section-level-extent" id="Font-file-formats">
4320 <div class="nav-panel">
4321 <p>
4322 Next: <a href="#gftopk-invocation" accesskey="n" rel="next">GFtoPK: Generic to packed font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4323 </div>
4324 <h3 class="section" id="Font-file-formats-1"><span>11.1 Font file formats<a class="copiable-link" href="#Font-file-formats-1"> &para;</a></span></h3>
4325
4326 <a class="index-entry-id" id="index-font-file-formats"></a>
4327 <a class="index-entry-id" id="index-file-formats-for-fonts"></a>
4328
4329 <p>For another perspective on this, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite class="cite">Dvips</cite>.
4330 </p>
4331 <p>Font files come in several varieties, with suffixes like:
4332 </p><div class="example">
4333 <pre class="example-preformatted">.tfm .*pk .*gf .*pxl<span class="r"> (obsolete)</span> .pl .mf .vf .vpl
4334 </pre></div>
4335 <p>Each represents a file format.
4336 </p>
4337 <a class="index-entry-id" id="index-TFM-files_002c-explained"></a>
4338 <p>A TFM (TeX font metric) file is a compact binary file that contains
4339 information about each character in a font, about combinations of
4340 characters within that font, and about the font as a whole. The font
4341 metric information contained in TFM files is device-independent units is
4342 used by TeX to do typesetting. Unlike the bitmap (raster) fonts
4343 described below, TFM font files contain no information about the shapes
4344 of characters. They describe rectangular areas and combinations
4345 thereof, but not what will eventually be printed in those areas.
4346 </p>
4347 <a class="index-entry-id" id="index-scaling-of-fonts"></a>
4348 <a class="index-entry-id" id="index-optical-font-scaling"></a>
4349 <a class="index-entry-id" id="index-geometric-font-scaling"></a>
4350 <a class="index-entry-id" id="index-PostScript_002c-and-font-scaling"></a>
4351 <p>Since TeX does scaling calculations, one TFM file serves for all
4352 magnifications of a given typeface. On the other hand, the best printed
4353 results are obtained when magnified (or reduced fonts) are not produced
4354 geometrically (as done by PostScript, for example) but rather optically,
4355 with each size a separate design (as done with Computer Modern and the
4356 EC fonts, for example); then a separate TFM file is needed for each
4357 size.
4358 </p>
4359 <a class="index-entry-id" id="index-DVI-files_002c-explained"></a>
4360 <p>At any rate, TeX produces a DVI (DeVice Independent) file from your
4361 source document. In order to print DVI files on real devices, you need
4362 font files defining digitized character shapes and other data. Then
4363 previewers and printer-driver programs can translate your DVI files into
4364 something usable by your monitor or printer. Bitmap fonts come with
4365 suffixes such as &lsquo;<samp class="samp">.600pk</samp>&rsquo; or &lsquo;<samp class="samp">.600gf</samp>&rsquo; or &lsquo;<samp class="samp">.3000pxl</samp>&rsquo;, where
4366 the &lsquo;<samp class="samp">600</samp>&rsquo; is the horizontal dots-per-inch resolution at which the
4367 font was produced, and the &lsquo;<samp class="samp">pk</samp>&rsquo; or &lsquo;<samp class="samp">gf</samp>&rsquo; or &lsquo;<samp class="samp">pxl</samp>&rsquo;
4368 indicates the font format. Outline fonts in PostScript Type 1 format
4369 have suffixes such as &lsquo;<samp class="samp">.pfa</samp>&rsquo; or &lsquo;<samp class="samp">.pfb</samp>&rsquo;.
4370 </p>
4371 <a class="index-entry-id" id="index-PXL-files_002c-explained"></a>
4372 <a class="index-entry-id" id="index-PK-files_002c-explained"></a>
4373 <a class="index-entry-id" id="index-GF-files_002c-explained"></a>
4374 <p>Fonts in pk (packed) format are in the tightly packed raster format that
4375 is pretty much the standard today. They take up less space than fonts
4376 in the gf (generic font) format that Metafont generates, and far less
4377 space than fonts in pxl format. Fonts in pxl format take up gross
4378 amounts of disk space and permit only 128 characters. They are
4379 obsolete.
4380 </p>
4381 <a class="index-entry-id" id="index-PL-files_002c-explained"></a>
4382 <p>Font files with the &lsquo;<samp class="samp">.pl</samp>&rsquo; (property list) suffix are the plain text
4383 (human-readable) analog of the binary &lsquo;<samp class="samp">.tfm</samp>&rsquo; files.
4384 The TFtoPL and PLtoTF programs convert between the two formats
4385 (see <a class="pxref" href="#tftopl-invocation">TFtoPL: TeX font metric to property list conversion</a> and <a class="ref" href="#pltotf-invocation">PLtoTF: Property list to TeX font metric conversion</a>).
4386 </p>
4387 <p>Font files with the &lsquo;<samp class="samp">.mf</samp>&rsquo; suffix are in Metafont source format.
4388 These are the files used by Metafont to generate rastered fonts for
4389 specific typefaces at specific magnifications for the specific
4390 resolution and type of mapping used by your device.
4391 </p>
4392 <a class="index-entry-id" id="index-virtual_002dfonts_002eknuth"></a>
4393 <a class="index-entry-id" id="index-virtualfonts_002etxt"></a>
4394 <p>The suffix &lsquo;<samp class="samp">.vf</samp>&rsquo; identifies &ldquo;virtual font&rdquo; files, for which
4395 &lsquo;<samp class="samp">.vpl</samp>&rsquo; is the human-readable analog. See See <a class="xref" href="#vftovp-invocation">VFtoVP: Virtual font to virtual property lists</a>,
4396 and <a class="ref" href="#vptovf-invocation">VPtoVF: Virtual property lists to virtual font</a>. For further discussion of virtual fonts,
4397 see <samp class="file"><var class="var">CTAN:</var>/doc/virtual-fonts.knuth</samp>,
4398 <samp class="file"><var class="var">CTAN:</var>/help/virtualfonts.txt</samp>, and <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite class="cite">Dvips</cite>.
4399 </p>
4400 <a class="index-entry-id" id="index-MacKay_002c-Pierre"></a>
4401 <a class="index-entry-id" id="index-Tachikawa_002c-Elizabeth"></a>
4402 <p>(This section is based on documentation in the original Unix TeX
4403 distribution by Pierre MacKay and Elizabeth Tachikawa.)
4404 </p>
4405
4406 <hr>
4407 </div>
4408 <div class="section-level-extent" id="gftopk-invocation">
4409 <div class="nav-panel">
4410 <p>
4411 Next: <a href="#pktogf-invocation" accesskey="n" rel="next">PKtoGF: Packed to generic font conversion</a>, Previous: <a href="#Font-file-formats" accesskey="p" rel="prev">Font file formats</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4412 </div>
4413 <h3 class="section" id="GFtoPK_003a-Generic-to-packed-font-conversion"><span>11.2 GFtoPK: Generic to packed font conversion<a class="copiable-link" href="#GFtoPK_003a-Generic-to-packed-font-conversion"> &para;</a></span></h3>
4414
4415 <a class="index-entry-id" id="index-gftopk"></a>
4416 <a class="index-entry-id" id="index-conversion_002c-GF-to-PK"></a>
4417 <a class="index-entry-id" id="index-PK_002c-converting-GF-to"></a>
4418 <a class="index-entry-id" id="index-GF_002c-converting-to-PK"></a>
4419
4420 <p>GFtoPK converts a generic font (GF) file output by, for example,
4421 Metafont (see <a class="pxref" href="#mf-invocation"><code class="code">mf</code> invocation</a>) to a packed font (PK) file. PK files
4422 are considerably smaller than the corresponding gf files, so they are
4423 generally the bitmap font format of choice. Some DVI-processing
4424 programs, notably Dvips, only support PK files and not GF files.
4425 Synopsis:
4426 </p>
4427 <div class="example">
4428 <pre class="example-preformatted">gftopk [<var class="var">option</var>]... <var class="var">gfname</var>.<var class="var">dpi</var>[gf] [<var class="var">pkfile</var>]
4429 </pre></div>
4430
4431 <p>The font <var class="var">gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
4432 lookup</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
4433 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
4434 the program.
4435 </p>
4436 <p>The suffix &lsquo;<samp class="samp">gf</samp>&rsquo; is supplied if not already present. This suffix is
4437 not an extension; no &lsquo;<samp class="samp">.</samp>&rsquo; precedes it: for instance,
4438 <samp class="file">cmr10.600gf</samp>.
4439 </p>
4440 <p>If <var class="var">pkfile</var> is not specified, the output is written to the basename
4441 of &lsquo;<samp class="samp"><var class="var">gfname</var>.<var class="var">dpi</var>pk</samp>&rsquo;, e.g., &lsquo;<samp class="samp">gftopk
4442 /wherever/cmr10.600gf</samp>&rsquo; creates <samp class="file">./cmr10.600pk</samp>.
4443 </p>
4444 <p>The only options are &lsquo;<samp class="samp">--verbose</samp>&rsquo;, &lsquo;<samp class="samp">--help</samp>&rsquo;, and
4445 &lsquo;<samp class="samp">--version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>).
4446 </p>
4447
4448 <hr>
4449 </div>
4450 <div class="section-level-extent" id="pktogf-invocation">
4451 <div class="nav-panel">
4452 <p>
4453 Next: <a href="#pktype-invocation" accesskey="n" rel="next">PKtype: Plain text transliteration of packed fonts</a>, Previous: <a href="#gftopk-invocation" accesskey="p" rel="prev">GFtoPK: Generic to packed font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4454 </div>
4455 <h3 class="section" id="PKtoGF_003a-Packed-to-generic-font-conversion"><span>11.3 PKtoGF: Packed to generic font conversion<a class="copiable-link" href="#PKtoGF_003a-Packed-to-generic-font-conversion"> &para;</a></span></h3>
4456
4457 <a class="index-entry-id" id="index-pktogf"></a>
4458 <a class="index-entry-id" id="index-conversion_002c-PK-to-GF"></a>
4459 <a class="index-entry-id" id="index-GF_002c-converting-PK-to"></a>
4460 <a class="index-entry-id" id="index-PK_002c-converting-to-GF"></a>
4461
4462 <p>PKtoGF converts a packed font (PK) file to a generic font (GF) file.
4463 Since PK format is much more compact than GF format, the most likely
4464 reason to do this is to run GFtype (see <a class="pxref" href="#gftype-invocation">GFtype: Plain text transliteration of generic fonts</a>) on the
4465 result, so you can see the bitmap images. Also, a few old utility
4466 programs do not support PK format. Synopsis:
4467 </p>
4468 <div class="example">
4469 <pre class="example-preformatted">pktogf [<var class="var">option</var>]... <var class="var">pkname</var>.<var class="var">dpi</var>[pk] [<var class="var">gffile</var>]
4470 </pre></div>
4471
4472 <p>The font <var class="var">pkname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
4473 lookup</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
4474 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
4475 the program.
4476 </p>
4477 <p>The suffix &lsquo;<samp class="samp">pk</samp>&rsquo; is supplied if not already present. This suffix is
4478 not an extension; no &lsquo;<samp class="samp">.</samp>&rsquo; precedes it: for instance,
4479 <samp class="file">cmr10.600pk</samp>.
4480 </p>
4481 <p>If <var class="var">gffile</var> is not specified, the output is written to the basename
4482 of &lsquo;<samp class="samp"><var class="var">pkname</var>.<var class="var">dpi</var>gf</samp>&rsquo;, e.g., &lsquo;<samp class="samp">pktogf
4483 /wherever/cmr10.600pk</samp>&rsquo; creates <samp class="file">./cmr10.600gf</samp>.
4484 </p>
4485 <p>The only options are &lsquo;<samp class="samp">--verbose</samp>&rsquo;, &lsquo;<samp class="samp">--help</samp>&rsquo;, and
4486 &lsquo;<samp class="samp">--version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>).
4487 </p>
4488
4489 <hr>
4490 </div>
4491 <div class="section-level-extent" id="pktype-invocation">
4492 <div class="nav-panel">
4493 <p>
4494 Next: <a href="#gftype-invocation" accesskey="n" rel="next">GFtype: Plain text transliteration of generic fonts</a>, Previous: <a href="#pktogf-invocation" accesskey="p" rel="prev">PKtoGF: Packed to generic font conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4495 </div>
4496 <h3 class="section" id="PKtype_003a-Plain-text-transliteration-of-packed-fonts"><span>11.4 PKtype: Plain text transliteration of packed fonts<a class="copiable-link" href="#PKtype_003a-Plain-text-transliteration-of-packed-fonts"> &para;</a></span></h3>
4497
4498 <a class="index-entry-id" id="index-pktype-PK-validation"></a>
4499 <a class="index-entry-id" id="index-conversion_002c-PK-to-plain-text"></a>
4500 <a class="index-entry-id" id="index-plain-text_002c-converting-PK-to"></a>
4501 <a class="index-entry-id" id="index-human_002dreadable-text_002c-converting-PK-to"></a>
4502 <a class="index-entry-id" id="index-type-programs_002c-PK"></a>
4503 <a class="index-entry-id" id="index-validation_002c-of-PK-files"></a>
4504
4505 <p>PKtype translates a packed font (PK) bitmap file (as output by GFtoPK,
4506 for example) to a plain text file that humans can read. It also serves
4507 as a PK-validating program, i.e., if PKtype can read a file, it&rsquo;s
4508 correct. Synopsis:
4509 </p>
4510 <div class="example">
4511 <pre class="example-preformatted">pktype <var class="var">pkname</var>.<var class="var">dpi</var>[pk]
4512 </pre></div>
4513
4514 <p>The font <var class="var">pkname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
4515 lookup</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
4516 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
4517 the program.
4518 </p>
4519 <p>The suffix &lsquo;<samp class="samp">pk</samp>&rsquo; is supplied if not already present. This suffix is
4520 not an extension; no &lsquo;<samp class="samp">.</samp>&rsquo; precedes it: for instance, <samp class="file">cmr10.600pk</samp>.
4521 </p>
4522 <p>The translation is written to standard output.
4523 </p>
4524 <p>The only options are &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo;
4525 (see <a class="pxref" href="#Common-options">Common options</a>).
4526 </p>
4527 <p>As an example of the output, here is the (abridged) translation of the
4528 letter &lsquo;K&rsquo; in &lsquo;<samp class="samp">cmr10</samp>&rsquo;, as rendered at 600<span class="dmn">dpi</span> with the mode
4529 &lsquo;<samp class="samp">ljfour</samp>&rsquo; from <samp class="file">modes.mf</samp> (<a class="url" href="https://ctan.org/pkg/modes">https://ctan.org/pkg/modes</a>).
4530 </p>
4531 <div class="example smallexample">
4532 <pre class="example-preformatted">955: Flag byte = 184 Character = 75 Packet length = 174
4533 Dynamic packing variable = 11
4534 TFM width = 815562 dx = 4259840
4535 Height = 57 Width = 57 X-offset = -3 Y-offset = 56
4536 [2]23(16)17(8)9(25)11(13)7(27)7(16)7(28)4(18)7(28)2(20)7(27)...
4537 ...
4538 (14)9(24)12(5)[2]23(13)21
4539 </pre></div>
4540
4541 <p>Explanation:
4542 </p>
4543 <dl class="table">
4544 <dt><a id="index-byte-position"></a><span>&lsquo;<samp class="samp">955</samp>&rsquo;<a class="copiable-link" href="#index-byte-position"> &para;</a></span></dt>
4545 <dd><p>The byte position in the file where this character starts.
4546 </p>
4547 </dd>
4548 <dt><a class="index-entry-id" id="index-dynamic-packing-variable"></a>
4549 <a id="index-flag-byte"></a><span>&lsquo;<samp class="samp">Flag byte</samp>&rsquo;<a class="copiable-link" href="#index-flag-byte"> &para;</a></span></dt>
4550 <dt>&lsquo;<samp class="samp">Dynamic packing variable</samp>&rsquo;</dt>
4551 <dd><p>Related to the packing for this character; see the source code.
4552 </p>
4553 </dd>
4554 <dt><a id="index-character-codes_002c-in-PKtype-output"></a><span>&lsquo;<samp class="samp">Character</samp>&rsquo;<a class="copiable-link" href="#index-character-codes_002c-in-PKtype-output"> &para;</a></span></dt>
4555 <dd><p>The character code, in decimal.
4556 </p>
4557 </dd>
4558 <dt><a id="index-packet-length"></a><span>&lsquo;<samp class="samp">Packet length</samp>&rsquo;<a class="copiable-link" href="#index-packet-length"> &para;</a></span></dt>
4559 <dd><p>The total length of this character definition, in bytes.
4560 </p>
4561 </dd>
4562 <dt><a class="index-entry-id" id="index-device_002dindependent-width"></a>
4563 <a class="index-entry-id" id="index-width_002c-device_002dindependent"></a>
4564 <a id="index-TFM-width-of-characters"></a><span>&lsquo;<samp class="samp">TFM width</samp>&rsquo;<a class="copiable-link" href="#index-TFM-width-of-characters"> &para;</a></span></dt>
4565 <dd><p>The device-independent (TFM) width of this character. It is 2^24
4566 times the ratio of the true width to the font&rsquo;s design size.
4567 </p>
4568 </dd>
4569 <dt><a class="index-entry-id" id="index-escapement_002c-horizontal"></a>
4570 <a class="index-entry-id" id="index-scaled-pixels"></a>
4571 <a class="index-entry-id" id="index-dx-horizontal-escapement"></a>
4572 <a id="index-horizontal-escapement"></a><span>&lsquo;<samp class="samp">dx</samp>&rsquo;<a class="copiable-link" href="#index-horizontal-escapement"> &para;</a></span></dt>
4573 <dd><p>The device-dependent width, in <em class="dfn">scaled pixels</em>, i.e., units of
4574 horizontal pixels times 2^16.
4575 </p>
4576 </dd>
4577 <dt><a class="index-entry-id" id="index-pixel-height"></a>
4578 <a class="index-entry-id" id="index-pixel-width"></a>
4579 <a class="index-entry-id" id="index-width_002c-in-pixels"></a>
4580 <a id="index-height_002c-in-pixels"></a><span>&lsquo;<samp class="samp">Height</samp>&rsquo;<a class="copiable-link" href="#index-height_002c-in-pixels"> &para;</a></span></dt>
4581 <dt>&lsquo;<samp class="samp">Width</samp>&rsquo;</dt>
4582 <dd><p>The bitmap height and width, in pixels.
4583 </p>
4584 </dd>
4585 <dt><a class="index-entry-id" id="index-y-offset"></a>
4586 <a class="index-entry-id" id="index-origin"></a>
4587 <a class="index-entry-id" id="index-reference-pixel"></a>
4588 <a class="index-entry-id" id="index-side-bearings"></a>
4589 <a class="index-entry-id" id="index-left-side-bearing"></a>
4590 <a class="index-entry-id" id="index-right-side-bearing"></a>
4591 <a id="index-x-offset"></a><span>&lsquo;<samp class="samp">X-offset</samp>&rsquo;<a class="copiable-link" href="#index-x-offset"> &para;</a></span></dt>
4592 <dt>&lsquo;<samp class="samp">Y-offset</samp>&rsquo;</dt>
4593 <dd><p>Horizontal and vertical offset from the upper left pixel to the
4594 reference (origin) pixel for this character, in pixels (right and down
4595 are positive). The <em class="dfn">reference pixel</em> is the pixel that occupies the
4596 unit square in Metafont; the Metafont reference point is the lower left
4597 hand corner of this pixel. Put another way, the x-offset is the negative
4598 of the left side bearing; the right side bearing is the horizontal
4599 escapement minus the bitmap width plus the x-offset.
4600 </p>
4601 </dd>
4602 <dt><a class="index-entry-id" id="index-repeated-rows"></a>
4603 <a id="index-run-length-encoded-bitmaps"></a><span>&lsquo;<samp class="samp">[2]23(16)&hellip;</samp>&rsquo;<a class="copiable-link" href="#index-run-length-encoded-bitmaps"> &para;</a></span></dt>
4604 <dd><p>Finally, run lengths of black pixels alternate with parenthesized run
4605 lengths of white pixels, and brackets indicate a repeated row.
4606 </p></dd>
4607 </dl>
4608
4609
4610 <hr>
4611 </div>
4612 <div class="section-level-extent" id="gftype-invocation">
4613 <div class="nav-panel">
4614 <p>
4615 Next: <a href="#tftopl-invocation" accesskey="n" rel="next">TFtoPL: TeX font metric to property list conversion</a>, Previous: <a href="#pktype-invocation" accesskey="p" rel="prev">PKtype: Plain text transliteration of packed fonts</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4616 </div>
4617 <h3 class="section" id="GFtype_003a-Plain-text-transliteration-of-generic-fonts"><span>11.5 GFtype: Plain text transliteration of generic fonts<a class="copiable-link" href="#GFtype_003a-Plain-text-transliteration-of-generic-fonts"> &para;</a></span></h3>
4618
4619 <a class="index-entry-id" id="index-gftype-GF-validation"></a>
4620 <a class="index-entry-id" id="index-conversion_002c-GF-to-plain-text"></a>
4621 <a class="index-entry-id" id="index-plain-text_002c-converting-GF-to"></a>
4622 <a class="index-entry-id" id="index-human_002dreadable-text_002c-converting-GF-to"></a>
4623 <a class="index-entry-id" id="index-type-programs_002c-GF"></a>
4624 <a class="index-entry-id" id="index-validation_002c-of-GF-files"></a>
4625
4626 <p>GFtype translates a generic font (GF) bitmap file (as output by
4627 Metafont, for example) to a plain text file that humans can read. It
4628 also serves as a GF-validating program, i.e., if GFtype can read a file,
4629 it&rsquo;s correct. Synopsis:
4630 </p>
4631 <div class="example">
4632 <pre class="example-preformatted">gftype [<var class="var">option</var>]... <var class="var">gfname</var>.<var class="var">dpi</var>[gf]
4633 </pre></div>
4634
4635 <p>The font <var class="var">gfname</var> is searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph
4636 lookup</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
4637 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
4638 the program.
4639 </p>
4640 <p>The suffix &lsquo;<samp class="samp">gf</samp>&rsquo; is supplied if not already present. This suffix is
4641 not an extension; no &lsquo;<samp class="samp">.</samp>&rsquo; precedes it: for instance, <samp class="file">cmr10.600gf</samp>.
4642 </p>
4643 <p>The translation is written to standard output.
4644 </p>
4645 <p>The program accepts the following options, as well as the standard
4646 &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
4647 </p><dl class="table">
4648 <dt><a id="index-_002dimages"></a><span>&lsquo;<samp class="samp">-images</samp>&rsquo;<a class="copiable-link" href="#index-_002dimages"> &para;</a></span></dt>
4649 <dd><p>Show the characters&rsquo; bitmaps using asterisks and spaces.
4650 </p>
4651 </dd>
4652 <dt><a id="index-_002dmnemonics"></a><span>&lsquo;<samp class="samp">-mnemonics</samp>&rsquo;<a class="copiable-link" href="#index-_002dmnemonics"> &para;</a></span></dt>
4653 <dd><p>Translate all commands in the GF file.
4654 </p></dd>
4655 </dl>
4656
4657 <p>As an example of the output, here is the (abridged) translation of the
4658 letter &lsquo;K&rsquo; in &lsquo;<samp class="samp">cmr10</samp>&rsquo;, as rendered at 600<span class="dmn">dpi</span> with the mode
4659 &lsquo;<samp class="samp">ljfour</samp>&rsquo; from <samp class="file">modes.mf</samp> (<a class="url" href="https://ctan.org/pkg/modes">https://ctan.org/pkg/modes</a>),
4660 with both &lsquo;<samp class="samp">-mnemonics</samp>&rsquo; and &lsquo;<samp class="samp">-images</samp>&rsquo; enabled.
4661 </p>
4662 <p>GFtype outputs the information about a character in two places: a main
4663 definition and a one-line summary at the end. We show both. Here is the
4664 main definition:
4665 </p>
4666 <div class="example">
4667 <pre class="example-preformatted">2033: beginning of char 75: 3&lt;=m&lt;=60 0&lt;=n&lt;=56
4668 (initially n=56) paint (0)24(12)20
4669 2043: newrow 0 (n=55) paint 24(12)20
4670 2047: newrow 0 (n=54) paint 24(12)20
4671 2051: newrow 0 (n=53) paint 24(12)20
4672 2055: newrow 7 (n=52) paint 10(21)13
4673 2059: newrow 8 (n=51) paint 8(23)9
4674 ...
4675 2249: newrow 8 (n=5) paint 8(23)11
4676 2253: newrow 7 (n=4) paint 10(22)12
4677 2257: newrow 0 (n=3) paint 24(11)22
4678 2261: newrow 0 (n=2) paint 24(11)22
4679 2265: newrow 0 (n=1) paint 24(11)22
4680 2269: newrow 0 (n=0) paint 24(11)22
4681 2273: eoc
4682 </pre><div class="group"><pre class="example-preformatted">.&lt;--This pixel's lower left corner is at (3,57) in METAFONT coordinates
4683 ************************ ********************
4684 ************************ ********************
4685 ************************ ********************
4686 ************************ ********************
4687 ********** *************
4688 ******** *********
4689 ...
4690 ******** ***********
4691 ********** ************
4692 ************************ **********************
4693 ************************ **********************
4694 ************************ **********************
4695 ************************ **********************
4696 .&lt;--This pixel's upper left corner is at (3,0) in METAFONT coordinates
4697 </pre></div></div>
4698
4699 <p>Explanation:
4700 </p>
4701 <dl class="table">
4702 <dt><a id="index-byte-position-1"></a><span>&lsquo;<samp class="samp">2033</samp>&rsquo;<a class="copiable-link" href="#index-byte-position-1"> &para;</a></span></dt>
4703 <dt>&lsquo;<samp class="samp">2043</samp>&rsquo;</dt>
4704 <dt>&lsquo;<samp class="samp">&hellip;</samp>&rsquo;</dt>
4705 <dd><p>The byte position in the file where each GF command starts.
4706 </p>
4707 </dd>
4708 <dt><a id="index-character-codes_002c-in-GFtype-output"></a><span>&lsquo;<samp class="samp">beginning of char 75</samp>&rsquo;<a class="copiable-link" href="#index-character-codes_002c-in-GFtype-output"> &para;</a></span></dt>
4709 <dd><p>The character code, in decimal.
4710 </p>
4711 </dd>
4712 <dt><a class="index-entry-id" id="index-right-side-bearing-1"></a>
4713 <a class="index-entry-id" id="index-side-bearings-1"></a>
4714 <a id="index-left-side-bearing-1"></a><span>&lsquo;<samp class="samp">3&lt;=m&lt;=60 0&lt;=n&lt;=56</samp>&rsquo;<a class="copiable-link" href="#index-left-side-bearing-1"> &para;</a></span></dt>
4715 <dd><p>The character&rsquo;s bitmap lies between 3 and 60 (inclusive) horizontally,
4716 and between 0 and 56 (inclusive) vertically. (<em class="math">m</em> is a column
4717 position and <em class="math">n</em> is a row position.) Thus, 3 is the left side
4718 bearing. The right side bearing is the horizontal escapement (given
4719 below) minus the maximum <em class="math">m</em>.
4720 </p>
4721 </dd>
4722 <dt><a id="index-run-length-encoded-bitmaps-1"></a><span>&lsquo;<samp class="samp">(initially n=56) paint (0)24(12)20</samp>&rsquo;<a class="copiable-link" href="#index-run-length-encoded-bitmaps-1"> &para;</a></span></dt>
4723 <dd><p>The first row of pixels: 0 white pixels, 24 black pixels, 12 white
4724 pixels, etc.
4725 </p>
4726 </dd>
4727 <dt><a id="index-newrow-GF-command"></a><span>&lsquo;<samp class="samp">newrow 0 (n=55) paint 24(12)20</samp>&rsquo;<a class="copiable-link" href="#index-newrow-GF-command"> &para;</a></span></dt>
4728 <dd><p>The second row of pixels, with zero leading white pixels on the row.
4729 </p>
4730 </dd>
4731 <dt><a id="index-eoc-GF-command"></a><span>&lsquo;<samp class="samp">eoc</samp>&rsquo;<a class="copiable-link" href="#index-eoc-GF-command"> &para;</a></span></dt>
4732 <dd><p>The end of the main character definition.
4733 </p>
4734 </dd>
4735 </dl>
4736
4737 <p>Here is the GF postamble information that GFtype outputs at the end:
4738 </p>
4739 <div class="example">
4740 <pre class="example-preformatted">Character 75: dx 4259840 (65), width 815562 (64.57289), loc 2033
4741 </pre></div>
4742
4743 <p>Explanation:
4744 </p>
4745 <dl class="table">
4746 <dt><a class="index-entry-id" id="index-escapement_002c-horizontal-1"></a>
4747 <a class="index-entry-id" id="index-vertical-escapement"></a>
4748 <a class="index-entry-id" id="index-escapement_002c-vertical"></a>
4749 <a class="index-entry-id" id="index-scaled-pixels-1"></a>
4750 <a class="index-entry-id" id="index-dx-horizontal-escapement-1"></a>
4751 <a class="index-entry-id" id="index-dy-vertical-escapement"></a>
4752 <a id="index-horizontal-escapement-1"></a><span>&lsquo;<samp class="samp">dx</samp>&rsquo;<a class="copiable-link" href="#index-horizontal-escapement-1"> &para;</a></span></dt>
4753 <dd><p>The device-dependent width, in <em class="dfn">scaled pixels</em>, i.e., units of
4754 horizontal pixels times 2^16. The &lsquo;<samp class="samp">(65)</samp>&rsquo; is simply the same number
4755 rounded. If the vertical escapement is nonzero, it would appear here as
4756 a &lsquo;<samp class="samp">dy</samp>&rsquo; value.
4757 </p>
4758 </dd>
4759 <dt><a class="index-entry-id" id="index-device_002dindependent-width-1"></a>
4760 <a class="index-entry-id" id="index-width_002c-device_002dindependent-1"></a>
4761 <a id="index-TFM-width-of-characters-1"></a><span>&lsquo;<samp class="samp">width</samp>&rsquo;<a class="copiable-link" href="#index-TFM-width-of-characters-1"> &para;</a></span></dt>
4762 <dd><p>The device-independent (TFM) width of this character. It is 2^24
4763 times the ratio of the true width to the font&rsquo;s design size. The
4764 &lsquo;<samp class="samp">64.57289</samp>&rsquo; is the same number converted to pixels.
4765 </p>
4766 </dd>
4767 <dt>&lsquo;<samp class="samp">loc</samp>&rsquo;</dt>
4768 <dd><p>The byte position in the file where this character starts.
4769 </p>
4770 </dd>
4771 </dl>
4772
4773
4774 <hr>
4775 </div>
4776 <div class="section-level-extent" id="tftopl-invocation">
4777 <div class="nav-panel">
4778 <p>
4779 Next: <a href="#pltotf-invocation" accesskey="n" rel="next">PLtoTF: Property list to TeX font metric conversion</a>, Previous: <a href="#gftype-invocation" accesskey="p" rel="prev">GFtype: Plain text transliteration of generic fonts</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4780 </div>
4781 <h3 class="section" id="TFtoPL_003a-TeX-font-metric-to-property-list-conversion"><span>11.6 TFtoPL: TeX font metric to property list conversion<a class="copiable-link" href="#TFtoPL_003a-TeX-font-metric-to-property-list-conversion"> &para;</a></span></h3>
4782
4783 <a class="index-entry-id" id="index-tftopl"></a>
4784 <a class="index-entry-id" id="index-conversion_002c-TFM-to-property-list"></a>
4785 <a class="index-entry-id" id="index-validation_002c-of-TFM-files"></a>
4786 <a class="index-entry-id" id="index-property-list_002c-converting-TFM-to"></a>
4787 <a class="index-entry-id" id="index-human_002dreadable-text_002c-converting-TFM-to"></a>
4788 <a class="index-entry-id" id="index-plain-text_002c-converting-TFM-to"></a>
4789
4790 <p>TFtoPL translates a TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric
4791 files</a> in <cite class="cite">Dvips</cite>) file (as output by Metafont, for example) to
4792 <em class="dfn">property list format</em> (a list of parenthesized items describing the
4793 font) that humans can edit or read. This program is mostly used by
4794 people debugging TeX implementations, writing font utilities, etc.
4795 Synopsis:
4796 </p>
4797 <div class="example">
4798 <pre class="example-preformatted">tftopl [<var class="var">option</var>]... <var class="var">tfmname</var>[.tfm] [<var class="var">plfile</var>[.pl]]
4799 </pre></div>
4800
4801 <p>The font <var class="var">tfmname</var> (extended with &lsquo;<samp class="samp">.tfm</samp>&rsquo; if necessary) is
4802 searched for in the usual places (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>). To see all the relevant paths, set the
4803 environment variable <code class="code">KPATHSEA_DEBUG</code> to &lsquo;<samp class="samp">-1</samp>&rsquo; before running
4804 the program.
4805 </p>
4806 <p>If <var class="var">plfile</var> (which is extended with &lsquo;<samp class="samp">.pl</samp>&rsquo; if necessary) is not
4807 specified, the property list file is written to standard output. The
4808 property list file can be converted back to TFM format by the companion
4809 program TFtoPL (see the next section).
4810 </p>
4811 <p>The program accepts the following option, as well as the standard
4812 &lsquo;<samp class="samp">-verbose</samp>&rsquo;, &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
4813 </p><dl class="table">
4814 <dt><a id="index-_002dcharcode_002dformat_003dtype"></a><span>&lsquo;<samp class="samp">-charcode-format=<var class="var">type</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dcharcode_002dformat_003dtype"> &para;</a></span></dt>
4815 <dd><p>Output character codes in the PL file according to <var class="var">type</var>: either
4816 &lsquo;<samp class="samp">octal</samp>&rsquo; or &lsquo;<samp class="samp">ascii</samp>&rsquo;. Default is &lsquo;<samp class="samp">ascii</samp>&rsquo; for letters and
4817 digits, octal for all other characters. Exception: if the font&rsquo;s coding
4818 scheme starts with &lsquo;<samp class="samp">TeX math sy</samp>&rsquo; or &lsquo;<samp class="samp">TeX math ex</samp>&rsquo;, all
4819 character codes are output in octal.
4820 </p>
4821 <p>In &lsquo;<samp class="samp">ascii</samp>&rsquo; format, character codes that correspond to graphic
4822 characters, except for left and right parentheses, are output as a
4823 &lsquo;<samp class="samp">C</samp>&rsquo; followed by the single character: &lsquo;<samp class="samp">C K</samp>&rsquo;, for example. In
4824 octal format, character codes are output as the letter &lsquo;<samp class="samp">O</samp>&rsquo; followed
4825 by octal digits, as in &lsquo;<samp class="samp">O 113</samp>&rsquo; for &lsquo;<samp class="samp">K</samp>&rsquo;.
4826 </p>
4827 <p>&lsquo;<samp class="samp">octal</samp>&rsquo; format is useful for symbol and other non-alphabetic fonts,
4828 where using ASCII characters for the character codes is merely
4829 confusing.
4830 </p></dd>
4831 </dl>
4832
4833 <a class="index-entry-id" id="index-property-list-format"></a>
4834 <p>As an example of the output, here is the (abridged) property list
4835 translation of <samp class="file">cmr10.tfm</samp>:
4836 </p>
4837 <div class="example">
4838 <pre class="example-preformatted">(FAMILY CMR)
4839 (FACE O 352)
4840 (CODINGSCHEME TEX TEXT)
4841 (DESIGNSIZE R 10.0)
4842 (COMMENT DESIGNSIZE IS IN POINTS)
4843 (COMMENT OTHER SIZES ARE MULTIPLES OF DESIGNSIZE)
4844 (CHECKSUM O 11374260171)
4845 (FONTDIMEN
4846 (SLANT R 0.0)
4847 (SPACE R 0.333334)
4848 (STRETCH R 0.166667)
4849 (SHRINK R 0.111112)
4850 (XHEIGHT R 0.430555)
4851 (QUAD R 1.000003)
4852 (EXTRASPACE R 0.111112)
4853 )
4854 (LIGTABLE
4855 ...
4856 (LABEL C f)
4857 (LIG C i O 14)
4858 (LIG C f O 13)
4859 (LIG C l O 15)
4860 (KRN O 47 R 0.077779)
4861 (KRN O 77 R 0.077779)
4862 (KRN O 41 R 0.077779)
4863 (KRN O 51 R 0.077779)
4864 (KRN O 135 R 0.077779)
4865 (STOP)
4866 ...
4867 )
4868 ...
4869 (CHARACTER C f
4870 (CHARWD R 0.305557)
4871 (CHARHT R 0.694445)
4872 (CHARIC R 0.077779)
4873 (COMMENT
4874 (LIG C i O 14)
4875 (LIG C f O 13)
4876 (LIG C l O 15)
4877 (KRN O 47 R 0.077779)
4878 (KRN O 77 R 0.077779)
4879 ...
4880 )
4881 )
4882 ...
4883 </pre></div>
4884
4885 <p>As you can see, the general format is a list of parenthesized
4886 <em class="dfn">properties</em>, nested where necessary.
4887 </p>
4888 <ul class="itemize mark-bullet">
4889 <li><a class="index-entry-id" id="index-FAMILY-property"></a>
4890 <a class="index-entry-id" id="index-FACE-property"></a>
4891 <a class="index-entry-id" id="index-headerbyte-information"></a>
4892 The first few items (<code class="code">FAMILY</code>, <code class="code">FACE</code>, and so on) are
4893 the so-called <em class="dfn">headerbyte</em> information from Metafont, giving general
4894 information about the font.
4895
4896 </li><li><a class="index-entry-id" id="index-FAMILY-property-1"></a>
4897 <a class="index-entry-id" id="index-_005cfontdimen"></a>
4898 The <code class="code">FONTDIMEN</code> property defines the TeX <code class="code">\fontdimen</code>
4899 values.
4900
4901 </li><li><a class="index-entry-id" id="index-LIGTABLE-property"></a>
4902 <a class="index-entry-id" id="index-LABEL-property"></a>
4903 <a class="index-entry-id" id="index-LIG-property"></a>
4904 <a class="index-entry-id" id="index-KRN-property"></a>
4905 <a class="index-entry-id" id="index-ligature-table_002c-in-TFM-files"></a>
4906 <a class="index-entry-id" id="index-kerning-table_002c-in-TFM-files"></a>
4907 <a class="index-entry-id" id="index-design_002dsize-units"></a>
4908 The <code class="code">LIGTABLE</code> property defines the ligature and kerning table.
4909 <code class="code">LIG</code> properties define ligatures: in the example above, an
4910 &lsquo;<samp class="samp">f</samp>&rsquo; (in the &lsquo;<samp class="samp">LABEL</samp>&rsquo;) followed by an &lsquo;<samp class="samp">i</samp>&rsquo; is a ligature,
4911 i.e., a typesetting program like TeX replaces those two consecutive
4912 characters by the character at position octal &rsquo;014 in the current
4913 font&mdash;presumably the &lsquo;fi&rsquo; ligature. <code class="code">KRN</code> properties define
4914 kerns: if an &lsquo;<samp class="samp">f</samp>&rsquo; is followed by character octal &rsquo;047 (an
4915 apostrophe), TeX inserts a small amount of space between them:
4916 0.077779 times the design size the font was loaded at (about
4917 three-quarters of a printer&rsquo;s point by default in this case, or .001
4918 inches).
4919
4920 </li><li><a class="index-entry-id" id="index-CHARACTER-property"></a>
4921 <a class="index-entry-id" id="index-CHARWD-property"></a>
4922 <a class="index-entry-id" id="index-CHARHT-property"></a>
4923 <a class="index-entry-id" id="index-CHARDP-property"></a>
4924 <a class="index-entry-id" id="index-CHARIC-property"></a>
4925 The <code class="code">CHARACTER</code> property defines the dimensions of a character: its
4926 width, height, depth, and italic correction, also in design-size units,
4927 as explained in the previous item. For our example &lsquo;f&rsquo;, the depth is
4928 zero, so that property is omitted. TFtoPL also inserts any kerns and
4929 ligatures for this character as a comment.
4930
4931 </li></ul>
4932
4933
4934 <hr>
4935 </div>
4936 <div class="section-level-extent" id="pltotf-invocation">
4937 <div class="nav-panel">
4938 <p>
4939 Next: <a href="#vftovp-invocation" accesskey="n" rel="next">VFtoVP: Virtual font to virtual property lists</a>, Previous: <a href="#tftopl-invocation" accesskey="p" rel="prev">TFtoPL: TeX font metric to property list conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4940 </div>
4941 <h3 class="section" id="PLtoTF_003a-Property-list-to-TeX-font-metric-conversion"><span>11.7 PLtoTF: Property list to TeX font metric conversion<a class="copiable-link" href="#PLtoTF_003a-Property-list-to-TeX-font-metric-conversion"> &para;</a></span></h3>
4942
4943 <a class="index-entry-id" id="index-pltotf"></a>
4944 <a class="index-entry-id" id="index-conversion_002c-property-list-to-TFM"></a>
4945 <a class="index-entry-id" id="index-TFM-files_002c-converting-property-lists-to"></a>
4946 <a class="index-entry-id" id="index-machine_002dreadable_002c-converting-property-lists-to"></a>
4947
4948 <p>PLtoTF translates a property list file (as output by TFtoPL, for
4949 example) to TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite class="cite">Dvips</cite>)
4950 format. It&rsquo;s much easier for both programs and humans to create the
4951 (plain text) property list files and let PLtoTF take care of creating
4952 the binary TFM equivalent than to output TFM files directly. Synopsis:
4953 </p>
4954 <div class="example">
4955 <pre class="example-preformatted">pltotf [<var class="var">option</var>]... <var class="var">plfile</var>[.pl] [<var class="var">tfmfile</var>[.tfm]]
4956 </pre></div>
4957
4958 <p>If <var class="var">tfmfile</var> (extended with &lsquo;<samp class="samp">.tfm</samp>&rsquo; if necessary) is
4959 not specified, the TFM file is written to the basename of
4960 &lsquo;<samp class="samp"><var class="var">plfile</var>.tfm</samp>&rsquo;, e.g., &lsquo;<samp class="samp">pltotf /wherever/cmr10.pl</samp>&rsquo; creates
4961 <samp class="file">./cmr10.tfm</samp>. (Since TFM files are binary, writing to standard
4962 output by default is undesirable.)
4963 </p>
4964 <p>The only options are &lsquo;<samp class="samp">-verbose</samp>&rsquo;, &lsquo;<samp class="samp">-help</samp>&rsquo;, and
4965 &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>).
4966 </p>
4967 <p>For an example of property list format, see the previous section.
4968 </p>
4969
4970 <hr>
4971 </div>
4972 <div class="section-level-extent" id="vftovp-invocation">
4973 <div class="nav-panel">
4974 <p>
4975 Next: <a href="#vptovf-invocation" accesskey="n" rel="next">VPtoVF: Virtual property lists to virtual font</a>, Previous: <a href="#pltotf-invocation" accesskey="p" rel="prev">PLtoTF: Property list to TeX font metric conversion</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4976 </div>
4977 <h3 class="section" id="VFtoVP_003a-Virtual-font-to-virtual-property-lists"><span>11.8 VFtoVP: Virtual font to virtual property lists<a class="copiable-link" href="#VFtoVP_003a-Virtual-font-to-virtual-property-lists"> &para;</a></span></h3>
4978
4979 <a class="index-entry-id" id="index-vftovp"></a>
4980 <a class="index-entry-id" id="index-conversion_002c-VF-to-VPL"></a>
4981 <a class="index-entry-id" id="index-validation_002c-of-VF-files"></a>
4982 <a class="index-entry-id" id="index-property-list_002c-converting-VF-to-virtual"></a>
4983 <a class="index-entry-id" id="index-human_002dreadable-text_002c-converting-VF-to"></a>
4984 <a class="index-entry-id" id="index-plain-text_002c-converting-VF-to"></a>
4985
4986 <p>VFtoVP translates a virtual font metric (VF, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual
4987 fonts</a> in <cite class="cite">Dvips</cite>) file and its accompanying TeX font metric (TFM,
4988 see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite class="cite">Dvips</cite>) file (as output by VPtoVF, for
4989 example) to <em class="dfn">virtual property list format</em> (a list of parenthesized
4990 items describing the virtual font) that humans can edit or read. This
4991 program is mostly used by people debugging virtual font utilities.
4992 Synopsis:
4993 </p>
4994 <div class="example">
4995 <pre class="example-preformatted">vftovp [<var class="var">option</var>]... <var class="var">vfname</var>[.vf] [<var class="var">tfmname</var>[.tfm] [<var class="var">vplfile</var>[.vpl]]]
4996 </pre></div>
4997
4998 <p>The fonts <var class="var">vfname</var> and <var class="var">tfmname</var> (extended with &lsquo;<samp class="samp">.vf</samp>&rsquo; and
4999 &lsquo;<samp class="samp">.tfm</samp>&rsquo; if necessary) are searched for in the usual places
5000 (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite class="cite">Kpathsea</cite>). To see all the
5001 relevant paths, set the environment variable <code class="code">KPATHSEA_DEBUG</code> to
5002 &lsquo;<samp class="samp">-1</samp>&rsquo; before running the program. If <var class="var">tfmname</var> is not
5003 specified, <var class="var">vfname</var> (without a trailing &lsquo;<samp class="samp">.vf</samp>&rsquo;) is used.
5004 </p>
5005 <p>If <var class="var">vplfile</var> (extended with &lsquo;<samp class="samp">.vpl</samp>&rsquo; if necessary) is
5006 not specified, the property list file is written to standard output.
5007 The property list file can be converted back to VF and TFM format by the
5008 companion program VFtoVP (see the next section).
5009 </p>
5010 <p>The program accepts the following option, as well as the standard
5011 &lsquo;<samp class="samp">-verbose</samp>&rsquo;, &lsquo;<samp class="samp">-help</samp>&rsquo; and &lsquo;<samp class="samp">-version</samp>&rsquo; (see <a class="pxref" href="#Common-options">Common options</a>):
5012 </p><dl class="table">
5013 <dt><a id="index-_002dcharcode_002dformat_003dtype-1"></a><span>&lsquo;<samp class="samp">-charcode-format=<var class="var">type</var></samp>&rsquo;<a class="copiable-link" href="#index-_002dcharcode_002dformat_003dtype-1"> &para;</a></span></dt>
5014 <dd><p>Output character codes in the PL file according to <var class="var">type</var>: either
5015 &lsquo;<samp class="samp">octal</samp>&rsquo; or &lsquo;<samp class="samp">ascii</samp>&rsquo;. Default is &lsquo;<samp class="samp">ascii</samp>&rsquo; for letters and
5016 digits, octal for all other characters. Exception: if the font&rsquo;s coding
5017 scheme starts with &lsquo;<samp class="samp">TeX math sy</samp>&rsquo; or &lsquo;<samp class="samp">TeX math ex</samp>&rsquo;, all
5018 character codes are output in octal.
5019 </p>
5020 <p>In &lsquo;<samp class="samp">ascii</samp>&rsquo; format, character codes that correspond to graphic
5021 characters, except for left and right parentheses, are output as a
5022 &lsquo;<samp class="samp">C</samp>&rsquo; followed by the single character: &lsquo;<samp class="samp">C K</samp>&rsquo;, for example. In
5023 octal format, character codes are output as the letter &lsquo;<samp class="samp">O</samp>&rsquo; followed
5024 by octal digits, as in &lsquo;<samp class="samp">O 113</samp>&rsquo; for &lsquo;<samp class="samp">K</samp>&rsquo;.
5025 </p>
5026 <p>&lsquo;<samp class="samp">octal</samp>&rsquo; format is useful for symbol and other non-alphabetic fonts,
5027 where using ASCII characters for the character codes is merely
5028 confusing.
5029 </p></dd>
5030 </dl>
5031
5032
5033 <hr>
5034 </div>
5035 <div class="section-level-extent" id="vptovf-invocation">
5036 <div class="nav-panel">
5037 <p>
5038 Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Font utilities available elsewhere</a>, Previous: <a href="#vftovp-invocation" accesskey="p" rel="prev">VFtoVP: Virtual font to virtual property lists</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
5039 </div>
5040 <h3 class="section" id="VPtoVF_003a-Virtual-property-lists-to-virtual-font"><span>11.9 VPtoVF: Virtual property lists to virtual font<a class="copiable-link" href="#VPtoVF_003a-Virtual-property-lists-to-virtual-font"> &para;</a></span></h3>
5041
5042 <a class="index-entry-id" id="index-vptovf"></a>
5043 <a class="index-entry-id" id="index-conversion_002c-property-list-to-VF"></a>
5044 <a class="index-entry-id" id="index-VF-files_002c-converting-property-lists-to"></a>
5045 <a class="index-entry-id" id="index-machine_002dreadable_002c-converting-property-lists-to-1"></a>
5046
5047 <p>VPtoVF translates a virtual property list file (as output by VFtoVP, for
5048 example) to virtual font (VF, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite class="cite">Dvips</cite>) and
5049 TeX font metric (TFM, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite class="cite">Dvips</cite>) files.
5050 It&rsquo;s much easier for both programs and humans to create the (plain text)
5051 property list files and let VPtoVF take care of creating the binary VF
5052 and TFM equivalents than to output them directly. Synopsis:
5053 </p>
5054 <div class="example">
5055 <pre class="example-preformatted">vptovf [<var class="var">option</var>]... <var class="var">vplfile</var>[.vpl] [<var class="var">vffile</var>[.vf] [<var class="var">tfmfile</var>[.tfm]]]
5056 </pre></div>
5057
5058 <p>If <var class="var">vffile</var> (extended with &lsquo;<samp class="samp">.vf</samp>&rsquo; if necessary) is not
5059 specified, the VF output is written to the basename of
5060 &lsquo;<samp class="samp"><var class="var">vplfile</var>.vf</samp>&rsquo;; similarly for <var class="var">tfmfile</var>. For example,
5061 &lsquo;<samp class="samp">vptovf /wherever/ptmr.vpl</samp>&rsquo; creates <samp class="file">./ptmr.vf</samp> and
5062 <samp class="file">./ptmr.tfm</samp>.
5063 </p>
5064 <p>The only options are &lsquo;<samp class="samp">-verbose</samp>&rsquo;, &lsquo;<samp class="samp">-help</samp>&rsquo;, and &lsquo;<samp class="samp">-version</samp>&rsquo;
5065 (see <a class="pxref" href="#Common-options">Common options</a>).
5066 </p>
5067
5068 <hr>
5069 </div>
5070 <div class="section-level-extent" id="Font-utilities-available-elsewhere">
5071 <div class="nav-panel">
5072 <p>
5073 Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">VPtoVF: Virtual property lists to virtual font</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
5074 </div>
5075 <h3 class="section" id="Font-utilities-available-elsewhere-1"><span>11.10 Font utilities available elsewhere<a class="copiable-link" href="#Font-utilities-available-elsewhere-1"> &para;</a></span></h3>
5076
5077 <a class="index-entry-id" id="index-font-utilities_002c-non_002dWeb2c"></a>
5078
5079 <p>The Web2c complement of font utilities merely implements a few basic
5080 conversions. Many other more sophisticated font utilities exist; most
5081 are in <samp class="file"><var class="var">CTAN:</var>/fonts/utilities</samp> (for CTAN info,
5082 see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite class="cite">Kpathsea</cite>). Here are some of the most
5083 commonly-requested items:
5084 </p>
5085 <ul class="itemize mark-bullet">
5086 <li><a class="index-entry-id" id="index-AFM-to-TFM-conversion"></a>
5087 <a class="index-entry-id" id="index-afm2tfm"></a>
5088 <a class="index-entry-id" id="index-afmtopl"></a>
5089 AFM (Adobe font metric) to TFM conversion: see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite class="cite">Dvips</cite>, and <samp class="file"><var class="var">CTAN:</var>/fonts/utilities/afmtopl</samp>.
5090
5091 </li><li><a class="index-entry-id" id="index-X-bitmap-fonts"></a>
5092 <a class="index-entry-id" id="index-BDF-and-GF-conversion"></a>
5093 BDF (the X bitmap format) conversion:
5094 <a class="url" href="ftp://ftp.tug.org/tex/bdf.tar.gz">ftp://ftp.tug.org/tex/bdf.tar.gz</a>.
5095
5096 </li><li><a class="index-entry-id" id="index-metatype1"></a>
5097 <a class="index-entry-id" id="index-Latin-Modern"></a>
5098 Creating fonts using MetaPost: MetaType1:
5099 <a class="url" href="https://ctan.org/pkg/metatype1">https://ctan.org/pkg/metatype1</a>. This was used to create the
5100 Latin Modern font family (<a class="url" href="https://ctan.org/pkg/lm">https://ctan.org/pkg/lm</a>), which
5101 extends Computer Modern to a larger repertoire of scripts.
5102
5103 </li><li><a class="index-entry-id" id="index-editing-of-bitmap-fonts"></a>
5104 <a class="index-entry-id" id="index-xbfe_002c-bitmap-font-editor"></a>
5105 <a class="index-entry-id" id="index-xfed_002c-bitmap-font-editor"></a>
5106 <a class="index-entry-id" id="index-xfedor_002c-bitmap-font-editor"></a>
5107 <a class="index-entry-id" id="index-gftopxl"></a>
5108 <a class="index-entry-id" id="index-chtopx"></a>
5109 <a class="index-entry-id" id="index-pxtoch"></a>
5110 Editing of bitmap fonts: Xbfe from the GNU font utilities mentioned
5111 below; the X BDF-editing programs <code class="code">xfed</code> and <code class="code">xfedor</code>;
5112 finally, if your fonts have only 128 characters, you can use the old
5113 <code class="code">gftopxl</code>, <code class="code">pxtoch</code>, and <code class="code">chtopx</code> programs from
5114 <a class="url" href="ftp://ftp.tug.org/tex/web">ftp://ftp.tug.org/tex/web</a>.
5115
5116 </li><li><a class="index-entry-id" id="index-fontforge"></a>
5117 <a class="index-entry-id" id="index-pfaedit"></a>
5118 Editing of outline fonts: FontForge,
5119 <a class="url" href="https://fontforge.sourceforge.net">https://fontforge.sourceforge.net</a>. This is a very elaborate
5120 program with support for many outline formats (Type&nbsp;1, OpenType,
5121 TrueType, &hellip;), and many advanced font editing features.
5122
5123 </li><li><a class="index-entry-id" id="index-PK-bitmaps-from-PostScript"></a>
5124 <a class="index-entry-id" id="index-PostScript-to-PK-bitmaps"></a>
5125 <a class="index-entry-id" id="index-gsftopk"></a>
5126 <a class="index-entry-id" id="index-ps2pk"></a>
5127 PK bitmaps from PostScript outline fonts: gsftopk from the &lsquo;<samp class="samp">xdvi</samp>&rsquo;
5128 distribution. Alternatively, <code class="code">ps2pk</code>, from
5129 <samp class="file"><var class="var">CTAN:</var>/fonts/utilities/ps2pk</samp>.
5130
5131 </li><li><a class="index-entry-id" id="index-Type-1-conversion"></a>
5132 <a class="index-entry-id" id="index-PFA-and-PFB-conversion"></a>
5133 <a class="index-entry-id" id="index-PostScript-Type-1-font-conversion"></a>
5134 PostScript Type 1 font format conversion (i.e., between PFA and PFB
5135 formats): <a class="url" href="https://www.lcdf.org/type">https://www.lcdf.org/type</a>.
5136
5137 </li><li><a class="index-entry-id" id="index-autotrace"></a>
5138 <a class="index-entry-id" id="index-potrace"></a>
5139 Tracing bitmaps to fitted outlines: Autotrace
5140 (<a class="url" href="http://autotrace.sourceforge.net">http://autotrace.sourceforge.net</a>), Potrace
5141 (<a class="url" href="http://potrace.sourceforge.net">http://potrace.sourceforge.net</a>). For Metafont fonts, either of
5142 the two programs <code class="code">mftrace</code>
5143 (<a class="url" href="http://www.xs4all.nl/~hanwen/mftrace">http://www.xs4all.nl/~hanwen/mftrace</a>) or <code class="code">textrace</code>
5144 (<a class="url" href="http://textrace.sourceforge.net">http://textrace.sourceforge.net</a>) make the job easier.
5145
5146 </li><li><a class="index-entry-id" id="index-virtual-font-creation"></a>
5147 <a class="index-entry-id" id="index-fontinst_002c-for-creating-virtual-fonts"></a>
5148 Virtual font creation: <a class="url" href="https://ctan.org/pkg/fontinst">https://ctan.org/pkg/fontinst</a>.
5149 </li></ul>
5150
5151
5152 <hr>
5153 </div>
5154 </div>
5155 <div class="appendix-level-extent" id="Legalisms">
5156 <div class="nav-panel">
5157 <p>
5158 Next: <a href="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Font-utilities" accesskey="p" rel="prev">Font utilities</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
5159 </div>
5160 <h2 class="appendix" id="Legalisms-1"><span>Appendix A Legalisms<a class="copiable-link" href="#Legalisms-1"> &para;</a></span></h2>
5161
5162 <a class="index-entry-id" id="index-legalisms"></a>
5163 <a class="index-entry-id" id="index-copyright-notices"></a>
5164 <a class="index-entry-id" id="index-permissions_002c-legal"></a>
5165
5166 <p>In general, each file has its own copyright notice stating the copying
5167 permissions for that file. Following is a summary.
5168 </p>
5169 <p>The Stanford TeX programs and Web2c system itself are in the public
5170 domain (<a class="url" href="https://tug.org/texlive/copying.html">https://tug.org/texlive/copying.html</a>). The sources may
5171 be copied verbatim, or used as the starting point of new software
5172 under different names; however, per the wishes of the authors, they
5173 should be modified only through a <samp class="file">.ch</samp> file, but this is in the
5174 nature of a development request rather than a legal requirement.
5175 </p>
5176 <p>MLTeX, pdfTeX, LuaTeX, XeTeX, and all the other derived
5177 engines have used various license terms for their additions to the
5178 base code, often the GPL (see <a class="url" href="https://www.gnu.org/licenses/#GPL">https://www.gnu.org/licenses/#GPL</a>)
5179 or (for example) the file <samp class="file">web2c/pdftexdir/COPYINGv2</samp>. They also
5180 mostly make use of additional libraries with their own (compatible)
5181 terms. Please see each program&rsquo;s sources.
5182 </p>
5183 <p>The Kpathsea library is covered by the GNU Lesser General Public
5184 License (see <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite class="cite">Kpathsea</cite>). Therefore, the
5185 <em class="emph">binaries</em> resulting from a standard Web2c compilation are also
5186 covered by the LGPL; so if you (re)distribute the binaries, you must
5187 also (offer to) distribute the complete source that went into those
5188 binaries. See <a class="url" href="https://gnu.org/licenses/#LGPL">https://gnu.org/licenses/#LGPL</a> or the file
5189 <samp class="file">kpathsea/COPYING.LESSERv2</samp>.
5190 </p>
5191 <hr>
5192 </div>
5193 <div class="appendix-level-extent" id="References">
5194 <div class="nav-panel">
5195 <p>
5196 Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Legalisms" accesskey="p" rel="prev">Legalisms</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
5197 </div>
5198 <h2 class="appendix" id="References-1"><span>Appendix B References<a class="copiable-link" href="#References-1"> &para;</a></span></h2>
5199
5200 <a class="index-entry-id" id="index-references"></a>
5201 <a class="index-entry-id" id="index-bibliography"></a>
5202
5203 <ol class="enumerate">
5204 <li> Kpathsea: See <a data-manual="kpathsea" href="https://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite class="cite">Kpathsea</cite>.
5205
5206 </li><li> Dvips and Afm2tfm: See <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite class="cite">Dvips</cite>.
5207
5208 </li><li> The TeX Users Group: <a class="url" href="https://tug.org">https://tug.org</a>. For an introduction
5209 to the TeX system, see <a class="url" href="https://tug.org/begin.html">https://tug.org/begin.html</a>.
5210
5211 </li><li> TUGboat, the principal journal for the TeX world:
5212 <a class="url" href="https://tug.org/TUGboat">https://tug.org/TUGboat</a>.
5213
5214 </li><li> TeX and computer typesetting in general:<br>
5215 <a class="url" href="https://ftp.math.utah.edu/pub/tex/bib/texbook1.bib">https://ftp.math.utah.edu/pub/tex/bib/texbook1.bib</a> and
5216 <samp class="file">texbook3.bib</samp>, among others.
5217
5218 </li><li> For a bibliography of formal articles and technical reports on the
5219 TeX project, see the books <cite class="cite">TeX: The Program</cite> or
5220 <cite class="cite">Metafont: The Program</cite> cited below.
5221
5222
5223 </li><li> [Bil87]
5224 Neenie Billawala.
5225 Write-white printing engines and tuning fonts with Metafont.
5226 <cite class="cite">TUGboat</cite>, 8(1):29&ndash;32, April 1987.
5227 <a class="url" href="https://tug.org/TUGboat/tb08-1/tb17billawala.pdf">https://tug.org/TUGboat/tb08-1/tb17billawala.pdf</a>.
5228
5229 </li><li> [Hob89]
5230 John D. Hobby.
5231 A Metafont-like system with PS output.
5232 <cite class="cite">TUGboat</cite>, 10(4):505&ndash;512, December 1989.
5233 <a class="url" href="https://tug.org/metapost">https://tug.org/metapost</a>.
5234
5235 </li><li> [Hob92]
5236 John D. Hobby.
5237 A User&rsquo;s Manual for MetaPost.
5238 Technical Report CSTR-162, AT&amp;T Bell Laboratories, 1992.
5239
5240 </li><li> [Hob93]
5241 John D. Hobby.
5242 Drawing Graphs with MetaPost.
5243 Technical Report CSTR-164, AT&amp;T Bell Laboratories, 1993.
5244
5245 </li><li> [HS91]
5246 Samuel P. Harbison and Guy L. Steele Jr.
5247 <cite class="cite">C&mdash;A Reference Manual</cite>.
5248 Prentice-Hall, Upper Saddle River, NJ 07458, USA, third edition, 1991.
5249 An authoritative reference to the C programming language, and a good
5250 companion to Kernighan and Ritchie.
5251
5252 </li><li> [KL93]
5253 Donald E. Knuth and Silvio Levy.
5254 <cite class="cite">The CWEB System of Structured Documentation, Version 3.0</cite>.
5255 Addison-Wesley, Reading, MA, USA, 1993.
5256 <a class="url" href="https://ctan.org/pkg/cweb">https://ctan.org/pkg/cweb</a>.
5257
5258 </li><li> [Knu84]
5259 Donald E. Knuth.
5260 A torture test for TeX.
5261 Report No. STAN-CS-84-1027, Stanford University, Department of Computer
5262 Science, 1984.
5263
5264 </li><li> [Knu86a]
5265 Donald E. Knuth.
5266 A Torture Test for METAFONT.
5267 Report No. STAN-CS-86-1095, Stanford University, Department of Computer
5268 Science, 1986.
5269
5270 </li><li> [Knu86b]
5271 Donald E. Knuth.
5272 <cite class="cite">The TeXbook</cite>, volume A of <cite class="cite">Computers and Typesetting</cite>.
5273 Addison-Wesley, Reading, MA, USA, 1986.
5274
5275 </li><li> [Knu86c]
5276 Donald E. Knuth.
5277 <cite class="cite">TeX: The Program</cite>, volume B of <cite class="cite">Computers and Typesetting</cite>.
5278 Addison-Wesley, Reading, MA, USA, 1986.
5279
5280 </li><li> [Knu86d]
5281 Donald E. Knuth.
5282 <cite class="cite">The METAFONTbook</cite>, volume C of <cite class="cite">Computers and Typesetting</cite>.
5283 Addison-Wesley, Reading, MA, USA, 1986.
5284
5285 </li><li> [Knu86e]
5286 Donald E. Knuth.
5287 <cite class="cite">METAFONT: The Program</cite>, volume D of <cite class="cite">Computers and
5288 Typesetting</cite>.
5289 Addison-Wesley, Reading, MA, USA, 1986.
5290
5291 </li><li> [Knu86f]
5292 Donald E. Knuth.
5293 <cite class="cite">Computer Modern Typefaces</cite>, volume E of <cite class="cite">Computers and
5294 Typesetting</cite>.
5295 Addison-Wesley, Reading, MA, USA, 1986.
5296
5297 </li><li> [Knu89]
5298 Donald E. Knuth.
5299 The errors of TeX.
5300 <cite class="cite">Software&mdash;Practice and Experience</cite>, 19(7):607&ndash;681, July
5301 1989.
5302 This is an updated version of Knuth:1988:ET.
5303
5304 </li><li> [Knu90]
5305 Donald Knuth.
5306 Virtual Fonts: More Fun for Grand Wizards.
5307 <cite class="cite">TUGboat</cite>, 11(1):13&ndash;23, April 1990.
5308 <a class="url" href="https://tug.org/TUGboat/tb11-1/tb27knut.pdf">https://tug.org/TUGboat/tb11-1/tb27knut.pdf</a>.
5309
5310 </li><li> [Knu92]
5311 Donald E. Knuth.
5312 <cite class="cite">Literate Programming</cite>.
5313 CSLI Lecture Notes Number 27. Stanford University Center for the Study of
5314 Language and Information, Stanford, CA, USA, 1992.
5315
5316 </li><li> [Lam94]
5317 Leslie Lamport.
5318 <cite class="cite">LaTeX: A Document Preparation System: User&rsquo;s Guide and Reference
5319 Manual</cite>.
5320 Addison-Wesley, Reading, MA, USA, second edition, 1994.
5321 Reprinted with corrections, 1996.
5322
5323 </li><li> [Lia83]
5324 Franklin Mark Liang.
5325 Word hy-phen-a-tion by com-put-er.
5326 Technical Report STAN-CS-83-977, Stanford University, August 1983.
5327 <a class="url" href="https://tug.org/docs/liang/liang-thesis.pdf">https://tug.org/docs/liang/liang-thesis.pdf</a>.
5328
5329 </li><li> [Mac91]
5330 Pierre A. MacKay.
5331 Looking at the pixels: Quality control for 300 dpi laser printer fonts,
5332 especially Metafonts.
5333 In Robert A. Morris and Jacques Andre, editors, <cite class="cite">Raster Imaging and
5334 Digital Typography II&mdash;Papers from the second RIDT meeting, held in
5335 Boston, Oct. 14&ndash;16, 1991</cite>, pages 205&ndash;215, New York, 1991. Cambridge
5336 University Press.
5337
5338
5339 </li></ol>
5340
5341
5342 <hr>
5343 </div>
5344 <div class="unnumbered-level-extent" id="Index">
5345 <div class="nav-panel">
5346 <p>
5347 Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a href="#Top" accesskey="u" rel="up">Web2c</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
5348 </div>
5349 <h2 class="unnumbered" id="Index-1"><span>Index<a class="copiable-link" href="#Index-1"> &para;</a></span></h2>
5350
5351 <div class="printindex cp-printindex">
5352 <table class="cp-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a>
5353 &nbsp;
5354 <a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>.</b></a>
5355 &nbsp;
5356 <a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>&quot;</b></a>
5357 &nbsp;
5358 <a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>\</b></a>
5359 &nbsp;
5360 <a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>#</b></a>
5361 &nbsp;
5362 <a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>%</b></a>
5363 &nbsp;
5364 <a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>^</b></a>
5365 &nbsp;
5366 <a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>~</b></a>
5367 &nbsp;
5368 <a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>$</b></a>
5369 &nbsp;
5370 <a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>2</b></a>
5371 &nbsp;
5372 <a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>3</b></a>
5373 &nbsp;
5374 <a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>6</b></a>
5375 &nbsp;
5376 <a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a>
5377 &nbsp;
5378 <br>
5379 <a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
5380 &nbsp;
5381 <a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
5382 &nbsp;
5383 <a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
5384 &nbsp;
5385 <a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
5386 &nbsp;
5387 <a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
5388 &nbsp;
5389 <a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
5390 &nbsp;
5391 <a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
5392 &nbsp;
5393 <a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
5394 &nbsp;
5395 <a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
5396 &nbsp;
5397 <a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a>
5398 &nbsp;
5399 <a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a>
5400 &nbsp;
5401 <a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
5402 &nbsp;
5403 <a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
5404 &nbsp;
5405 <a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
5406 &nbsp;
5407 <a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
5408 &nbsp;
5409 <a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
5410 &nbsp;
5411 <a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
5412 &nbsp;
5413 <a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
5414 &nbsp;
5415 <a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
5416 &nbsp;
5417 <a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
5418 &nbsp;
5419 <a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a>
5420 &nbsp;
5421 <a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a>
5422 &nbsp;
5423 <a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
5424 &nbsp;
5425 <a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a>
5426 &nbsp;
5427 <a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a>
5428 &nbsp;
5429 </td></tr></table>
5430 <table class="cp-entries-printindex">
5431 <tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
5432 <tr><td colspan="3"><hr></td></tr>
5433 <tr><th id="Index_cp_symbol-1">-</th></tr>
5434 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-starting-a-filename"><code>- <span class="r">starting a filename</span></code></a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
5435 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-starts-option-names"><code>- <span class="r">starts option names</span></code></a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
5436 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002d-starts-option-names"><code>-- <span class="r">starts option names</span></code></a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
5437 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002ddisable_002ddump_002dshare-configure-option"><code>--disable-dump-share configure <span class="r">option</span></code></a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5438 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002ddisable_002dmf_002dnowin"><code>--disable-mf-nowin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5439 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002damigawin"><code>--enable-amigawin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5440 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002depsfwin"><code>--enable-epsfwin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5441 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dhp2627win"><code>--enable-hp2627win</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5442 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dipc-configure-option"><code>--enable-ipc configure <span class="r">option</span></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5443 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dmftalkwin"><code>--enable-mftalkwin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5444 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dnext"><code>--enable-next</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5445 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dregiswin"><code>--enable-regiswin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5446 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dsuntoolswin"><code>--enable-suntoolswin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5447 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dtektronixwin"><code>--enable-tektronixwin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5448 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002denable_002dunitermwin"><code>--enable-unitermwin</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5449 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp-common-option"><code>--help <span class="r">common option</span></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5450 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dverbose-common-option"><code>--verbose <span class="r">common option</span></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5451 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dversion-common-option"><code>--version <span class="r">common option</span></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5452 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwith_002deditor_003dcmd"><code>--with-editor=<var class="var">cmd</var></code></a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
5453 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwith_002dmf_002dx_002dtoolkit"><code>--with-mf-x-toolkit</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5454 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwith_002dx"><code>--with-x</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5455 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d8bit"><code>-8bit</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5456 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dbase_003dbase"><code>-base=<var class="var">base</var></code></a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5457 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dbase_003ddumpname"><code>-base=<var class="var">dumpname</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5458 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dchange_003dchfile"><code>-change=<var class="var">chfile</var></code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5459 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dcharcode_002dformat_003dtype"><code>-charcode-format=<var class="var">type</var></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5460 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dcharcode_002dformat_003dtype-1"><code>-charcode-format=<var class="var">type</var></code></a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
5461 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dcnf_002dline"><code>-cnf-line</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5462 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dD-compiler-options"><code>-D <span class="r">compiler options</span></code></a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5463 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ddebug"><code>-debug</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5464 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ddisable_002dwrite18"><code>-disable-write18</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5465 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ddpi_003dreal"><code>-dpi=<var class="var">real</var></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5466 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002denable_002dwrite18"><code>-enable-write18</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5467 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002denc"><code>-enc</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5468 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dfile_002dline_002derror"><code>-file-line-error</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5469 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dfile_002dline_002derror_002dstyle"><code>-file-line-error-style</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5470 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dfmt_003ddumpname"><code>-fmt=<var class="var">dumpname</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5471 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dfmt_003dfmt"><code>-fmt=<var class="var">fmt</var></code></a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5472 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dgeometry_002c-supported-with-Xt"><code>-geometry<span class="r">, supported with Xt</span></code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5473 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dhalt_002don_002derror"><code>-halt-on-error</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5474 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dimages"><code>-images</code></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5475 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dini"><code>-ini</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5476 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dini-1"><code>-ini</code></a></td><td class="printindex-index-section"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr>
5477 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dinteraction_003dstring"><code>-interaction=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5478 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dipc"><code>-ipc</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5479 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dipc_002dstart"><code>-ipc-start</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5480 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002djobname_003dstring"><code>-jobname=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5481 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dkpathsea_002ddebug_003dnumber"><code>-kpathsea-debug=<var class="var">number</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5482 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dlength_003dnumber"><code>-length=<var class="var">number</var></code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5483 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dloose"><code>-loose</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5484 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dlowercase"><code>-lowercase</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5485 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmagnification_003dinteger"><code>-magnification=<var class="var">integer</var></code></a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5486 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmagnification_003dinteger-1"><code>-magnification=<var class="var">integer</var></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5487 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmax_002dpages_003dn"><code>-max-pages=<var class="var">n</var></code></a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5488 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmax_002dpages_003dn-1"><code>-max-pages=<var class="var">n</var></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5489 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmem"><code>-mem</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5490 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmem_003ddumpname"><code>-mem=<var class="var">dumpname</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5491 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmetapost"><code>-metapost</code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5492 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmin_002dcrossrefs_003dn"><code>-min-crossrefs=<var class="var">n</var></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5493 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmixedcase"><code>-mixedcase</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5494 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmktex_003dfiletype"><code>-mktex=<var class="var">filetype</var></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5495 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmktex_003dfiletype-1"><code>-mktex=<var class="var">filetype</var></code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5496 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmltex"><code>-mltex</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5497 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dmnemonics"><code>-mnemonics</code></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5498 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dno_002dfile_002dline_002derror"><code>-no-file-line-error</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5499 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dno_002dmktex_003dfiletype"><code>-no-mktex=<var class="var">filetype</var></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5500 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dno_002dmktex_003dfiletype-1"><code>-no-mktex=<var class="var">filetype</var></code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5501 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dno_002dparse_002dfirst_002dline"><code>-no-parse-first-line</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5502 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dno_002dshell_002descape"><code>-no-shell-escape</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5503 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dnumbersystem"><code>-numbersystem</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5504 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002doutput_002dcomment_003dstring"><code>-output-comment=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5505 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002doutput_002ddirectory"><code>-output-directory</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5506 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002doutput_002ddirectory-1"><code>-output-directory</code></a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
5507 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002doutput_002dlevel_003dn"><code>-output-level=<var class="var">n</var></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5508 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002doverflow_002dlabel_002doffset_003dpoints"><code>-overflow-label-offset=<var class="var">points</var></code></a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
5509 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dpage_002dstart_003dpage_002dspec"><code>-page-start=<var class="var">page-spec</var></code></a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5510 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dpage_002dstart_003dpage_002dspec-1"><code>-page-start=<var class="var">page-spec</var></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5511 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dparse_002dfirst_002dline"><code>-parse-first-line</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5512 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dprogname_003dstring"><code>-progname=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5513 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dprogname_003dstring-1"><code>-progname=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5514 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002drecorder"><code>-recorder</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5515 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002drestricted"><code>-restricted</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5516 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ds"><code>-s</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5517 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dshell_002descape"><code>-shell-escape</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5518 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dshell_002drestricted"><code>-shell-restricted</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5519 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dshow_002dopcodes"><code>-show-opcodes</code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5520 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dstrict"><code>-strict</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5521 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dstyle_003dmftfile"><code>-style=<var class="var">mftfile</var></code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5522 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dT"><code>-T</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5523 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dterse"><code>-terse</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5524 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dtex_003dtexprogram"><code>-tex=<var class="var">texprogram</var></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5525 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dtranslate_002dfile_003dtcxfile"><code>-translate-file=<var class="var">tcxfile</var></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5526 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dtroff"><code>-troff</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5527 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dunderline"><code>-underline</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5528 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002duppercase"><code>-uppercase</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5529 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dx"><code>-x</code></a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
5530 <tr><td colspan="3"><hr></td></tr>
5531 <tr><th id="Index_cp_symbol-2">.</th></tr>
5532 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002e_002c-used-for-output"><code>.<span class="r">, used for output</span></code></a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
5533 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002e2602gf"><code>.2602gf</code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5534 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eaux-cross_002dreference-files"><code>.aux <span class="r">cross-reference files</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5535 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebase"><code>.base</code></a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5536 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebbl-bibliography-files"><code>.bbl <span class="r">bibliography files</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5537 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebib-bibliography-databases"><code>.bib <span class="r">bibliography databases</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5538 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eblg-BibTeX-log-file"><code>.blg <span class="r">BibTeX log file</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5539 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002efmt"><code>.fmt</code></a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
5540 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emf"><code>.mf</code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5541 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emp"><code>.mp</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5542 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emps-files-and-PDF"><code class="code">.mps</code> files and PDF</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5543 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ennn-PostScript-figures"><code>.<var class="var">nnn</var> <span class="r">PostScript figures</span></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5544 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ennngf-generic-fonts"><code>.<var class="var">nnn</var>gf <span class="r">generic fonts</span></code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5545 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etcx-character-translation-files"><code>.tcx <span class="r">character translation files</span></code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5546 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etcx-character-translation-files-1"><code>.tcx <span class="r">character translation files</span></code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5547 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etex"><code>.tex</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5548 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etfm-output"><code>.tfm <span class="r">output</span></code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5549 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etfm-output-1"><code>.tfm <span class="r">output</span></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5550 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eXdefaults"><code>.Xdefaults</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5551 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eXresources"><code>.Xresources</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5552 <tr><td colspan="3"><hr></td></tr>
5553 <tr><th id="Index_cp_symbol-3">&quot;</th></tr>
5554 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0022-character_002c-ignored-in-filenames"><code class="code">&quot;</code> character, ignored in filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
5555 <tr><td colspan="3"><hr></td></tr>
5556 <tr><th id="Index_cp_symbol-4">\</th></tr>
5557 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cbibliography"><code>\bibliography</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5558 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cbibliographystyle"><code>\bibliographystyle</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5559 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005ccharsubdef-and-MLTeX"><code>\charsubdef <span class="r">and MLTeX</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr>
5560 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005ccountn"><code>\count<var class="var">n</var></code></a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5561 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005ccountn-1"><code>\count<var class="var">n</var></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5562 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cfont-and-dynamic-generation"><code>\font <span class="r">and dynamic generation</span></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5563 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cfontdimen"><code>\fontdimen</code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5564 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cimmediate_005cwrite18"><code>\immediate\write18</code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5565 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cinput-braced-_0028grouped_0029-filename"><code class="code">\input</code> braced (grouped) filename</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-braced-filename">\input braced filename</a></td></tr>
5566 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cinput-filename-caveats"><code class="code">\input</code> filename caveats</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5567 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cinput-filenames"><code>\input <span class="r">filenames</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
5568 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cinput-quoted-filename"><code class="code">\input</code> quoted filename</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-quoted-filename">\input quoted filename</a></td></tr>
5569 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cinput_002c-and-pipes"><code>\input<span class="r">, and pipes</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5570 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cmag"><code>\mag</code></a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5571 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cmag-1"><code>\mag</code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5572 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005copenin_002c-and-pipes"><code>\openin<span class="r">, and pipes</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5573 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005copenout-and-security"><code>\openout <span class="r">and security</span></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5574 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005copenout_002c-and-pipes"><code>\openout<span class="r">, and pipes</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5575 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005coutput-routine_002c-and-_005cwrite"><code>\output <span class="r">routine, and <code class="code">\write</code></span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5576 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cpdfshellescape"><code>\pdfshellescape</code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5577 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cstring_002c-and-_005cinput-filenames"><code>\string<span class="r">, and <code class="code">\input filenames</code></span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5578 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005ctracingcharsubdef-and-MLTeX"><code>\tracingcharsubdef <span class="r">and MLTeX</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></td></tr>
5579 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005ctracinglostchars-and-MLTeX"><code>\tracinglostchars <span class="r">and MLTeX</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></td></tr>
5580 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cwrite18-shell-escape-extension"><code>\write18 <span class="r">shell escape extension</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5581 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cwrite18_002c-output-location-for"><code>\write18<span class="r">, output location for</span></code></a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
5582 <tr><td colspan="3"><hr></td></tr>
5583 <tr><th id="Index_cp_symbol-5">#</th></tr>
5584 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0023define-options">&lsquo;<samp class="samp">#define</samp>&rsquo; options</a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5585 <tr><td colspan="3"><hr></td></tr>
5586 <tr><th id="Index_cp_symbol-6">%</th></tr>
5587 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_0026-magic-number"><code>%&amp; <span class="r">magic number</span></code></a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5588 <tr><td colspan="3"><hr></td></tr>
5589 <tr><th id="Index_cp_symbol-7">^</th></tr>
5590 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005e_005e-notation_002c-avoiding"><code>^^ <span class="r">notation, avoiding</span></code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5591 <tr><td colspan="3"><hr></td></tr>
5592 <tr><th id="Index_cp_symbol-8">~</th></tr>
5593 <tr><td></td><td class="printindex-index-entry"><a href="#index-_007e-expansion-in-filenames"><code>~ <span class="r">expansion in filenames</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5594 <tr><td colspan="3"><hr></td></tr>
5595 <tr><th id="Index_cp_symbol-9">$</th></tr>
5596 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0024-expansion-in-filenames"><code>$ <span class="r">expansion in filenames</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5597 <tr><td colspan="3"><hr></td></tr>
5598 <tr><th id="Index_cp_symbol-10">2</th></tr>
5599 <tr><td></td><td class="printindex-index-entry"><a href="#index-2602gf"><code>2602gf</code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5600 <tr><td colspan="3"><hr></td></tr>
5601 <tr><th id="Index_cp_symbol-11">3</th></tr>
5602 <tr><td></td><td class="printindex-index-entry"><a href="#index-32_002dbit-architecture">32-bit architecture</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5603 <tr><td colspan="3"><hr></td></tr>
5604 <tr><th id="Index_cp_symbol-12">6</th></tr>
5605 <tr><td></td><td class="printindex-index-entry"><a href="#index-64_002dbit-architecture">64-bit architecture</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5606 <tr><td colspan="3"><hr></td></tr>
5607 <tr><th id="Index_cp_symbol-13">8</th></tr>
5608 <tr><td></td><td class="printindex-index-entry"><a href="#index-8-bit-clean">8 bit clean</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5609 <tr><td></td><td class="printindex-index-entry"><a href="#index-8-bit-clean-output_002c-specifying"><code>8 bit clean output, specifying</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5610 <tr><td></td><td class="printindex-index-entry"><a href="#index-8_002dbit-characters">8-bit characters</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5611 <tr><td colspan="3"><hr></td></tr>
5612 <tr><th id="Index_cp_letter-A">A</th></tr>
5613 <tr><td></td><td class="printindex-index-entry"><a href="#index-abbrv_002ebst"><code>abbrv.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5614 <tr><td></td><td class="printindex-index-entry"><a href="#index-accented-character">accented character</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5615 <tr><td></td><td class="printindex-index-entry"><a href="#index-accents_002c-hyphenating-words-with">accents, hyphenating words with</a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
5616 <tr><td></td><td class="printindex-index-entry"><a href="#index-acknowledgements">acknowledgements</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5617 <tr><td></td><td class="printindex-index-entry"><a href="#index-acm_002ebst"><code>acm.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5618 <tr><td></td><td class="printindex-index-entry"><a href="#index-Ada_002c-WEB-for">Ada, WEB for</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
5619 <tr><td></td><td class="printindex-index-entry"><a href="#index-additional-Make-targets">additional Make targets</a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5620 <tr><td></td><td class="printindex-index-entry"><a href="#index-AFM-to-TFM-conversion">AFM to TFM conversion</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5621 <tr><td></td><td class="printindex-index-entry"><a href="#index-afm2tfm"><code>afm2tfm</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5622 <tr><td></td><td class="printindex-index-entry"><a href="#index-afmtopl"><code>afmtopl</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5623 <tr><td></td><td class="printindex-index-entry"><a href="#index-Aleph">Aleph</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5624 <tr><td></td><td class="printindex-index-entry"><a href="#index-aliases-for-fonts">aliases for fonts</a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
5625 <tr><td></td><td class="printindex-index-entry"><a href="#index-alpha_002ebst"><code>alpha.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5626 <tr><td></td><td class="printindex-index-entry"><a href="#index-American-Mathematical-Society_002c-typesetting-system">American Mathematical Society, typesetting system</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5627 <tr><td></td><td class="printindex-index-entry"><a href="#index-amiga"><code>amiga</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5628 <tr><td></td><td class="printindex-index-entry"><a href="#index-AMSTeX">AMSTeX</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5629 <tr><td></td><td class="printindex-index-entry"><a href="#index-apalike_002ebst"><code>apalike.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5630 <tr><td></td><td class="printindex-index-entry"><a href="#index-architecture-dependencies">architecture dependencies</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5631 <tr><td></td><td class="printindex-index-entry"><a href="#index-array-limit_002c-fixed">array limit, fixed</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5632 <tr><td></td><td class="printindex-index-entry"><a href="#index-array-sizes">array sizes</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5633 <tr><td></td><td class="printindex-index-entry"><a href="#index-assembly-language-routines">assembly language routines</a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5634 <tr><td></td><td class="printindex-index-entry"><a href="#index-autotrace"><code>autotrace</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5635 <tr><td></td><td class="printindex-index-entry"><a href="#index-Awk_002c-WEB-for">Awk, WEB for</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
5636 <tr><td colspan="3"><hr></td></tr>
5637 <tr><th id="Index_cp_letter-B">B</th></tr>
5638 <tr><td></td><td class="printindex-index-entry"><a href="#index-base-file_002c-determining">base file, determining</a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5639 <tr><td></td><td class="printindex-index-entry"><a href="#index-base-files">base files</a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5640 <tr><td></td><td class="printindex-index-entry"><a href="#index-base-files_002c-need-mode-definitions">base files, need mode definitions</a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
5641 <tr><td></td><td class="printindex-index-entry"><a href="#index-base-files_002c-plain-only">base files, plain only</a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5642 <tr><td></td><td class="printindex-index-entry"><a href="#index-base-files_002c-sharing">base files, sharing</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5643 <tr><td></td><td class="printindex-index-entry"><a href="#index-bases-Make-target"><code>bases <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5644 <tr><td></td><td class="printindex-index-entry"><a href="#index-basic-BibTeX-style-files">basic BibTeX style files</a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5645 <tr><td></td><td class="printindex-index-entry"><a href="#index-basic-fonts-and-macros">basic fonts and macros</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5646 <tr><td></td><td class="printindex-index-entry"><a href="#index-batch-languages">batch languages</a></td><td class="printindex-index-section"><a href="#TeX">TeX</a></td></tr>
5647 <tr><td></td><td class="printindex-index-entry"><a href="#index-BDF-and-GF-conversion">BDF and GF conversion</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5648 <tr><td></td><td class="printindex-index-entry"><a href="#index-beamer_002c-package"><code>beamer<span class="r">, package</span></code></a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5649 <tr><td></td><td class="printindex-index-entry"><a href="#index-beginfig"><code>beginfig</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5650 <tr><td></td><td class="printindex-index-entry"><a href="#index-Berry_002c-Karl">Berry, Karl</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5651 <tr><td></td><td class="printindex-index-entry"><a href="#index-BIBINPUTS_002c-search-path-for-bib-files"><code>BIBINPUTS<span class="r">, search path for bib files</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5652 <tr><td></td><td class="printindex-index-entry"><a href="#index-bibliographies_002c-creating">bibliographies, creating</a></td><td class="printindex-index-section"><a href="#BibTeX">BibTeX</a></td></tr>
5653 <tr><td></td><td class="printindex-index-entry"><a href="#index-bibliography">bibliography</a></td><td class="printindex-index-section"><a href="#References">References</a></td></tr>
5654 <tr><td></td><td class="printindex-index-entry"><a href="#index-bibliography-items_002c-cross_002dreferenced">bibliography items, cross-referenced</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5655 <tr><td></td><td class="printindex-index-entry"><a href="#index-bibtex"><code>bibtex</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5656 <tr><td></td><td class="printindex-index-entry"><a href="#index-BibTeX">BibTeX</a></td><td class="printindex-index-section"><a href="#BibTeX">BibTeX</a></td></tr>
5657 <tr><td></td><td class="printindex-index-entry"><a href="#index-BibTeX-collection">BibTeX collection</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5658 <tr><td></td><td class="printindex-index-entry"><a href="#index-BibTeX-style-files">BibTeX style files</a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5659 <tr><td></td><td class="printindex-index-entry"><a href="#index-BigEndian-machines">BigEndian machines</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5660 <tr><td></td><td class="printindex-index-entry"><a href="#index-binaries_002c-linking">binaries, linking</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5661 <tr><td></td><td class="printindex-index-entry"><a href="#index-blank-lines_002c-in-TCX-files">blank lines, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5662 <tr><td></td><td class="printindex-index-entry"><a href="#index-boxes_002c-memory-for">boxes, memory for</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5663 <tr><td></td><td class="printindex-index-entry"><a href="#index-braced-filename-for-_005cinput">braced filename for <code class="code">\input</code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-braced-filename">\input braced filename</a></td></tr>
5664 <tr><td></td><td class="printindex-index-entry"><a href="#index-breakpoints_002c-memory-for">breakpoints, memory for</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5665 <tr><td></td><td class="printindex-index-entry"><a href="#index-Breitenlohner_002c-Peter">Breitenlohner, Peter</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5666 <tr><td></td><td class="printindex-index-entry"><a href="#index-BSTINPUTS_002c-search-path-for-bst-files"><code>BSTINPUTS<span class="r">, search path for bst files</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5667 <tr><td></td><td class="printindex-index-entry"><a href="#index-btex-for-MetaPost-labels"><code>btex <span class="r">for MetaPost labels</span></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5668 <tr><td></td><td class="printindex-index-entry"><a href="#index-btxdoc_002ebib"><code>btxdoc.bib</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5669 <tr><td></td><td class="printindex-index-entry"><a href="#index-btxdoc_002etex"><code>btxdoc.tex</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5670 <tr><td></td><td class="printindex-index-entry"><a href="#index-btxhak_002etex"><code>btxhak.tex</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5671 <tr><td></td><td class="printindex-index-entry"><a href="#index-byte-position">byte position</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5672 <tr><td></td><td class="printindex-index-entry"><a href="#index-byte-position-1">byte position</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5673 <tr><td></td><td class="printindex-index-entry"><a href="#index-byte-swapping">byte swapping</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5674 <tr><td colspan="3"><hr></td></tr>
5675 <tr><th id="Index_cp_letter-C">C</th></tr>
5676 <tr><td></td><td class="printindex-index-entry"><a href="#index-c_002dsources-Makefile-target"><code>c-sources <span class="r">Makefile target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5677 <tr><td></td><td class="printindex-index-entry"><a href="#index-caveats-for-_005cinput-filenames">caveats for <code class="code">\input</code> filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5678 <tr><td></td><td class="printindex-index-entry"><a href="#index-change-files_002c-and-MFT">change files, and MFT</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5679 <tr><td></td><td class="printindex-index-entry"><a href="#index-change-files_002c-and-Tangle">change files, and Tangle</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5680 <tr><td></td><td class="printindex-index-entry"><a href="#index-change-files_002c-and-Weave">change files, and Weave</a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
5681 <tr><td></td><td class="printindex-index-entry"><a href="#index-changing-error-messages-style">changing error messages style</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5682 <tr><td></td><td class="printindex-index-entry"><a href="#index-character-codes_002c-in-GFtype-output">character codes, in GFtype output</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5683 <tr><td></td><td class="printindex-index-entry"><a href="#index-character-codes_002c-in-PKtype-output">character codes, in PKtype output</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5684 <tr><td></td><td class="printindex-index-entry"><a href="#index-character-codes_002c-in-TCX-files">character codes, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5685 <tr><td></td><td class="printindex-index-entry"><a href="#index-character-proofs-of-fonts">character proofs of fonts</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
5686 <tr><td></td><td class="printindex-index-entry"><a href="#index-CHARACTER-property"><code>CHARACTER <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5687 <tr><td></td><td class="printindex-index-entry"><a href="#index-character-translation-files">character translation files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5688 <tr><td></td><td class="printindex-index-entry"><a href="#index-CHARDP-property"><code>CHARDP <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5689 <tr><td></td><td class="printindex-index-entry"><a href="#index-CHARHT-property"><code>CHARHT <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5690 <tr><td></td><td class="printindex-index-entry"><a href="#index-CHARIC-property"><code>CHARIC <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5691 <tr><td></td><td class="printindex-index-entry"><a href="#index-CHARWD-property"><code>CHARWD <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5692 <tr><td></td><td class="printindex-index-entry"><a href="#index-chtopx"><code>chtopx</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5693 <tr><td></td><td class="printindex-index-entry"><a href="#index-class-name-for-Metafont">class name for Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5694 <tr><td></td><td class="printindex-index-entry"><a href="#index-cm_002ebase"><code>cm.base</code></a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5695 <tr><td></td><td class="printindex-index-entry"><a href="#index-cmbase_002emf"><code>cmbase.mf</code></a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5696 <tr><td></td><td class="printindex-index-entry"><a href="#index-cmbase_002emft"><code>cmbase.mft</code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5697 <tr><td></td><td class="printindex-index-entry"><a href="#index-cmmf_002ebase-not-recommended"><code>cmmf.base <span class="r">not recommended</span></code></a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5698 <tr><td></td><td class="printindex-index-entry"><a href="#index-color_002c-in-DVItoMP">color, in DVItoMP</a></td><td class="printindex-index-section"><a href="#dvitomp-invocation">dvitomp invocation</a></td></tr>
5699 <tr><td></td><td class="printindex-index-entry"><a href="#index-COM1_002e_002e0_002c-reserved-filename-on-Windows"><code>COM1<span class="r"><code class="code">..0</code>, reserved filename on Windows</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5700 <tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-TCX-files">comments, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5701 <tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-MFT-control">comments, MFT control</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5702 <tr><td></td><td class="printindex-index-entry"><a href="#index-common-options">common options</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5703 <tr><td></td><td class="printindex-index-entry"><a href="#index-commonalities">commonalities</a></td><td class="printindex-index-section"><a href="#Commonalities">Commonalities</a></td></tr>
5704 <tr><td></td><td class="printindex-index-entry"><a href="#index-compilation">compilation</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5705 <tr><td></td><td class="printindex-index-entry"><a href="#index-compile_002dtime-options">compile-time options</a></td><td class="printindex-index-section"><a href="#configure-options">configure options</a></td></tr>
5706 <tr><td></td><td class="printindex-index-entry"><a href="#index-compile_002dtime-options-1">compile-time options</a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5707 <tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern-fonts_002c-and-Troff">Computer Modern fonts, and Troff</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5708 <tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern-macros">Computer Modern macros</a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5709 <tr><td></td><td class="printindex-index-entry"><a href="#index-Computer-Modern-Typefaces_002c-production-of"><cite class="cite">Computer Modern Typefaces</cite>, production of</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5710 <tr><td></td><td class="printindex-index-entry"><a href="#index-CON_002c-reserved-filename-on-Windows"><code>CON<span class="r">, reserved filename on Windows</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5711 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration">configuration</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5712 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-reading">configuration file reading</a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
5713 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file-values">configuration file values</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5714 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration_002c-compile_002dtime">configuration, compile-time</a></td><td class="printindex-index-section"><a href="#configure-options">configure options</a></td></tr>
5715 <tr><td></td><td class="printindex-index-entry"><a href="#index-configure-_002d_002dwith_002f_002d_002denable-options"><code>configure --with/--enable <span class="r">options</span></code></a></td><td class="printindex-index-section"><a href="#configure-options">configure options</a></td></tr>
5716 <tr><td></td><td class="printindex-index-entry"><a href="#index-CONTENTS_002etex"><code>CONTENTS.tex</code></a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
5717 <tr><td></td><td class="printindex-index-entry"><a href="#index-ConTeXt">ConTeXt</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5718 <tr><td></td><td class="printindex-index-entry"><a href="#index-conventions-for-options_002c">conventions for options,</a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
5719 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-DVI-to-plain-text">conversion, DVI to plain text</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5720 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-GF-to-PK">conversion, GF to PK</a></td><td class="printindex-index-section"><a href="#gftopk-invocation">gftopk invocation</a></td></tr>
5721 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-GF-to-plain-text">conversion, GF to plain text</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5722 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-PK-to-GF">conversion, PK to GF</a></td><td class="printindex-index-section"><a href="#pktogf-invocation">pktogf invocation</a></td></tr>
5723 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-PK-to-plain-text">conversion, PK to plain text</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5724 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-property-list-to-TFM">conversion, property list to TFM</a></td><td class="printindex-index-section"><a href="#pltotf-invocation">pltotf invocation</a></td></tr>
5725 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-property-list-to-VF">conversion, property list to VF</a></td><td class="printindex-index-section"><a href="#vptovf-invocation">vptovf invocation</a></td></tr>
5726 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-TFM-to-property-list">conversion, TFM to property list</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5727 <tr><td></td><td class="printindex-index-entry"><a href="#index-conversion_002c-VF-to-VPL">conversion, VF to VPL</a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
5728 <tr><td></td><td class="printindex-index-entry"><a href="#index-copyright-notices">copyright notices</a></td><td class="printindex-index-section"><a href="#Legalisms">Legalisms</a></td></tr>
5729 <tr><td></td><td class="printindex-index-entry"><a href="#index-Cork-encoding-and-ISO-input">Cork encoding and ISO input</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5730 <tr><td></td><td class="printindex-index-entry"><a href="#index-creating-memory-dumps">creating memory dumps</a></td><td class="printindex-index-section"><a href="#Creating-memory-dumps">Creating memory dumps</a></td></tr>
5731 <tr><td></td><td class="printindex-index-entry"><a href="#index-cross_002dengine-functionality">cross-engine functionality</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5732 <tr><td></td><td class="printindex-index-entry"><a href="#index-cross_002dreferenced-bibliography-items">cross-referenced bibliography items</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5733 <tr><td></td><td class="printindex-index-entry"><a href="#index-cross_002dreferences_002c-omitting">cross-references, omitting</a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
5734 <tr><td></td><td class="printindex-index-entry"><a href="#index-current-directory_002c-used-for-output">current directory, used for output</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
5735 <tr><td></td><td class="printindex-index-entry"><a href="#index-Curtis_002c-Pavel">Curtis, Pavel</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5736 <tr><td></td><td class="printindex-index-entry"><a href="#index-Cweb">Cweb</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
5737 <tr><td></td><td class="printindex-index-entry"><a href="#index-CWEB">CWEB</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
5738 <tr><td colspan="3"><hr></td></tr>
5739 <tr><th id="Index_cp_letter-D">D</th></tr>
5740 <tr><td></td><td class="printindex-index-entry"><a href="#index-date-and-time_002c-in-memory-dumps">date and time, in memory dumps</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5741 <tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-DVI-utilities">debugging DVI utilities</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5742 <tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-flags_002c-specifying">debugging flags, specifying</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5743 <tr><td></td><td class="printindex-index-entry"><a href="#index-decimal-character-codes_002c-in-TCX-files">decimal character codes, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5744 <tr><td></td><td class="printindex-index-entry"><a href="#index-dependencies_002c-hardware">dependencies, hardware</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5745 <tr><td></td><td class="printindex-index-entry"><a href="#index-design_002dsize-units">design-size units</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5746 <tr><td></td><td class="printindex-index-entry"><a href="#index-device-definitions_002c-for-Metafont">device definitions, for Metafont</a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
5747 <tr><td></td><td class="printindex-index-entry"><a href="#index-device_002dindependent-width">device-independent width</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5748 <tr><td></td><td class="printindex-index-entry"><a href="#index-device_002dindependent-width-1">device-independent width</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5749 <tr><td></td><td class="printindex-index-entry"><a href="#index-directory-structure">directory structure</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5750 <tr><td></td><td class="printindex-index-entry"><a href="#index-DISPLAY"><code>DISPLAY</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5751 <tr><td></td><td class="printindex-index-entry"><a href="#index-DISPLAY-1"><code>DISPLAY</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5752 <tr><td></td><td class="printindex-index-entry"><a href="#index-dot-files_002c-written-by-TeX-programs">dot files, written by TeX programs</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5753 <tr><td></td><td class="printindex-index-entry"><a href="#index-double-quote-character_002c-ignored-in-filenames">double quote character, ignored in filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
5754 <tr><td></td><td class="printindex-index-entry"><a href="#index-downloading-of-fonts-for-MetaPost-labels">downloading of fonts for MetaPost labels</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5755 <tr><td></td><td class="printindex-index-entry"><a href="#index-DrawingServant"><code>DrawingServant</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5756 <tr><td></td><td class="printindex-index-entry"><a href="#index-dump-file">dump file</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5757 <tr><td></td><td class="printindex-index-entry"><a href="#index-dumping-memory">dumping memory</a></td><td class="printindex-index-section"><a href="#Memory-dumps">Memory dumps</a></td></tr>
5758 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-comment_002c-specifying">DVI comment, specifying</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5759 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-files_002c-converting-to-MPX">DVI files, converting to MPX</a></td><td class="printindex-index-section"><a href="#dvitomp-invocation">dvitomp invocation</a></td></tr>
5760 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-files_002c-explained">DVI files, explained</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
5761 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-format-definition">DVI format definition</a></td><td class="printindex-index-section"><a href="#DVI-utilities">DVI utilities</a></td></tr>
5762 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-opcodes_002c-showing">DVI opcodes, showing</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5763 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVI-utilities">DVI utilities</a></td><td class="printindex-index-section"><a href="#DVI-utilities">DVI utilities</a></td></tr>
5764 <tr><td></td><td class="printindex-index-entry"><a href="#index-dvicopy"><code>dvicopy</code></a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5765 <tr><td></td><td class="printindex-index-entry"><a href="#index-dvitomp"><code>dvitomp</code></a></td><td class="printindex-index-section"><a href="#dvitomp-invocation">dvitomp invocation</a></td></tr>
5766 <tr><td></td><td class="printindex-index-entry"><a href="#index-dvitype-DVI-validation"><code>dvitype <span class="r">DVI validation</span></code></a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5767 <tr><td></td><td class="printindex-index-entry"><a href="#index-dvitype-output-example">dvitype output example</a></td><td class="printindex-index-section"><a href="#dvitype-output-example">dvitype output example</a></td></tr>
5768 <tr><td></td><td class="printindex-index-entry"><a href="#index-dvitype_002eweb"><code>dvitype.web</code></a></td><td class="printindex-index-section"><a href="#DVI-utilities">DVI utilities</a></td></tr>
5769 <tr><td></td><td class="printindex-index-entry"><a href="#index-dx-horizontal-escapement">dx <span class="r">horizontal escapement</span></a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5770 <tr><td></td><td class="printindex-index-entry"><a href="#index-dx-horizontal-escapement-1">dx <span class="r">horizontal escapement</span></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5771 <tr><td></td><td class="printindex-index-entry"><a href="#index-dy-vertical-escapement">dy <span class="r">vertical escapement</span></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5772 <tr><td></td><td class="printindex-index-entry"><a href="#index-dynamic-array-allocation">dynamic array allocation</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5773 <tr><td></td><td class="printindex-index-entry"><a href="#index-dynamic-Metafont-mode-definitions-with-smode">dynamic Metafont mode definitions with <code class="code">smode</code></a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
5774 <tr><td></td><td class="printindex-index-entry"><a href="#index-dynamic-packing-variable">dynamic packing variable</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5775 <tr><td colspan="3"><hr></td></tr>
5776 <tr><th id="Index_cp_letter-E">E</th></tr>
5777 <tr><td></td><td class="printindex-index-entry"><a href="#index-e-response-at-error-prompt"><code>e <span class="r">response at error prompt</span></code></a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
5778 <tr><td></td><td class="printindex-index-entry"><a href="#index-e_002dcircumflex">e-circumflex</a></td><td class="printindex-index-section"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr>
5779 <tr><td></td><td class="printindex-index-entry"><a href="#index-e_002dTeX">e-TeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5780 <tr><td></td><td class="printindex-index-entry"><a href="#index-e_002emft"><code>e.mft</code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5781 <tr><td></td><td class="printindex-index-entry"><a href="#index-EC-fonts">EC fonts</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5782 <tr><td></td><td class="printindex-index-entry"><a href="#index-editing-of-bitmap-fonts">editing of bitmap fonts</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5783 <tr><td></td><td class="printindex-index-entry"><a href="#index-editor-invoked-at-error">editor invoked at error</a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
5784 <tr><td></td><td class="printindex-index-entry"><a href="#index-eight_002dbit-characters-in-filenames">eight-bit characters in filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5785 <tr><td></td><td class="printindex-index-entry"><a href="#index-empty_002etcx"><code>empty.tcx</code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5786 <tr><td></td><td class="printindex-index-entry"><a href="#index-endian-dependencies">endian dependencies</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5787 <tr><td></td><td class="printindex-index-entry"><a href="#index-eoc-GF-command"><code>eoc <span class="r">GF command</span></code></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5788 <tr><td></td><td class="printindex-index-entry"><a href="#index-Eplain">Eplain</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5789 <tr><td></td><td class="printindex-index-entry"><a href="#index-epsf"><code>epsf</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5790 <tr><td></td><td class="printindex-index-entry"><a href="#index-epTeX">epTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5791 <tr><td></td><td class="printindex-index-entry"><a href="#index-errors_002c-editor-invoked-at">errors, editor invoked at</a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
5792 <tr><td></td><td class="printindex-index-entry"><a href="#index-escapement_002c-horizontal">escapement, horizontal</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5793 <tr><td></td><td class="printindex-index-entry"><a href="#index-escapement_002c-horizontal-1">escapement, horizontal</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5794 <tr><td></td><td class="printindex-index-entry"><a href="#index-escapement_002c-vertical">escapement, vertical</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5795 <tr><td></td><td class="printindex-index-entry"><a href="#index-etex-for-MetaPost-labels"><code>etex <span class="r">for MetaPost labels</span></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5796 <tr><td></td><td class="printindex-index-entry"><a href="#index-etex-is-pdfTeX"><code>etex <span class="r">is pdfTeX</span></code></a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5797 <tr><td></td><td class="printindex-index-entry"><a href="#index-eupTeX">eupTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5798 <tr><td></td><td class="printindex-index-entry"><a href="#index-executables_002c-shared-initial-and-virgin">executables, shared initial and virgin</a></td><td class="printindex-index-section"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr>
5799 <tr><td></td><td class="printindex-index-entry"><a href="#index-exit-status_002c-of-shell-escape">exit status, of shell escape</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
5800 <tr><td></td><td class="printindex-index-entry"><a href="#index-expand_005fdepth"><code>expand_depth</code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5801 <tr><td></td><td class="printindex-index-entry"><a href="#index-expanded-plain-format">expanded plain format</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5802 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion-limit_002c-recursive">expansion limit, recursive</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5803 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-and-_005cinput-filenames">expansion, and <code class="code">\input</code> filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5804 <tr><td></td><td class="printindex-index-entry"><a href="#index-extensions-to-TeX">extensions to TeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5805 <tr><td></td><td class="printindex-index-entry"><a href="#index-extra_005fmem_005fbot"><code>extra_mem_bot</code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5806 <tr><td colspan="3"><hr></td></tr>
5807 <tr><th id="Index_cp_letter-F">F</th></tr>
5808 <tr><td></td><td class="printindex-index-entry"><a href="#index-FACE-property"><code>FACE <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5809 <tr><td></td><td class="printindex-index-entry"><a href="#index-FAMILY-property"><code>FAMILY <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5810 <tr><td></td><td class="printindex-index-entry"><a href="#index-FAMILY-property-1"><code>FAMILY <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5811 <tr><td></td><td class="printindex-index-entry"><a href="#index-Ferguson_002c-Michael">Ferguson, Michael</a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
5812 <tr><td></td><td class="printindex-index-entry"><a href="#index-file-formats-for-fonts">file formats for fonts</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
5813 <tr><td></td><td class="printindex-index-entry"><a href="#index-file-recorder">file recorder</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5814 <tr><td></td><td class="printindex-index-entry"><a href="#index-filename-conventions_002c-in-input-files">filename conventions, in input files</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
5815 <tr><td></td><td class="printindex-index-entry"><a href="#index-filenames-starting-with-_002d">filenames starting with &lsquo;<samp class="samp">-</samp>&rsquo;</a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
5816 <tr><td></td><td class="printindex-index-entry"><a href="#index-first-line-of-the-main-input-file">first line of the main input file</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5817 <tr><td></td><td class="printindex-index-entry"><a href="#index-fixed_002dpoint-arithmetic">fixed-point arithmetic</a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5818 <tr><td></td><td class="printindex-index-entry"><a href="#index-FIXPT"><code>FIXPT</code></a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5819 <tr><td></td><td class="printindex-index-entry"><a href="#index-flag-byte">flag byte</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5820 <tr><td></td><td class="printindex-index-entry"><a href="#index-floating_002dpoint-arithmetic">floating-point arithmetic</a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5821 <tr><td></td><td class="printindex-index-entry"><a href="#index-floating_002dpoint-values">floating-point values</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5822 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmt-file_002c-determining">fmt file, determining</a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5823 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmt-files">fmt files</a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
5824 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmt-files_002c-sharing">fmt files, sharing</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5825 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmts-Make-target"><code>fmts <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5826 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-aliases">font aliases</a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
5827 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-character-code_002c-translating">font character code, translating</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5828 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-design">font design</a></td><td class="printindex-index-section"><a href="#Metafont">Metafont</a></td></tr>
5829 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-downloading-for-MetaPost-labels">font downloading for MetaPost labels</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
5830 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-file-formats">font file formats</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
5831 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-proofs">font proofs</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
5832 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-utilities">font utilities</a></td><td class="printindex-index-section"><a href="#Font-utilities">Font utilities</a></td></tr>
5833 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-utilities_002c-non_002dWeb2c">font utilities, non-Web2c</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5834 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontforge"><code>fontforge</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5835 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontinst_002c-for-creating-virtual-fonts"><code>fontinst<span class="r">, for creating virtual fonts</span></code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5836 <tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-basic">fonts, basic</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5837 <tr><td></td><td class="printindex-index-entry"><a href="#index-format-files">format files</a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
5838 <tr><td></td><td class="printindex-index-entry"><a href="#index-formats-for-TeX">formats for TeX</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5839 <tr><td></td><td class="printindex-index-entry"><a href="#index-formats-Make-target"><code>formats <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5840 <tr><td></td><td class="printindex-index-entry"><a href="#index-fraction-routines">fraction routines</a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5841 <tr><td></td><td class="printindex-index-entry"><a href="#index-Free-Software-Foundation-documentation-system">Free Software Foundation documentation system</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5842 <tr><td></td><td class="printindex-index-entry"><a href="#index-freedom-of-Web2c">freedom of Web2c</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5843 <tr><td></td><td class="printindex-index-entry"><a href="#index-ftp_002emath_002eutah_002eedu"><code>ftp.math.utah.edu</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5844 <tr><td colspan="3"><hr></td></tr>
5845 <tr><th id="Index_cp_letter-G">G</th></tr>
5846 <tr><td></td><td class="printindex-index-entry"><a href="#index-generating-source-specials">generating source specials</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
5847 <tr><td></td><td class="printindex-index-entry"><a href="#index-geometric-designs">geometric designs</a></td><td class="printindex-index-section"><a href="#Metafont">Metafont</a></td></tr>
5848 <tr><td></td><td class="printindex-index-entry"><a href="#index-geometric-font-scaling">geometric font scaling</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
5849 <tr><td></td><td class="printindex-index-entry"><a href="#index-geometry-for-Metafont">geometry for Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5850 <tr><td></td><td class="printindex-index-entry"><a href="#index-getopt_005flong_005fonly"><code>getopt_long_only</code></a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
5851 <tr><td></td><td class="printindex-index-entry"><a href="#index-GF-files_002c-explained">GF files, explained</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
5852 <tr><td></td><td class="printindex-index-entry"><a href="#index-GF-files_002c-output-by-Metafont">GF files, output by Metafont</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5853 <tr><td></td><td class="printindex-index-entry"><a href="#index-GF-format-definition">GF format definition</a></td><td class="printindex-index-section"><a href="#Font-utilities">Font utilities</a></td></tr>
5854 <tr><td></td><td class="printindex-index-entry"><a href="#index-GF-output">GF output</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5855 <tr><td></td><td class="printindex-index-entry"><a href="#index-GF_002c-converting-PK-to">GF, converting PK to</a></td><td class="printindex-index-section"><a href="#pktogf-invocation">pktogf invocation</a></td></tr>
5856 <tr><td></td><td class="printindex-index-entry"><a href="#index-GF_002c-converting-to-PK">GF, converting to PK</a></td><td class="printindex-index-section"><a href="#gftopk-invocation">gftopk invocation</a></td></tr>
5857 <tr><td></td><td class="printindex-index-entry"><a href="#index-gftodvi"><code>gftodvi</code></a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
5858 <tr><td></td><td class="printindex-index-entry"><a href="#index-gftopk"><code>gftopk</code></a></td><td class="printindex-index-section"><a href="#gftopk-invocation">gftopk invocation</a></td></tr>
5859 <tr><td></td><td class="printindex-index-entry"><a href="#index-gftopxl"><code>gftopxl</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5860 <tr><td></td><td class="printindex-index-entry"><a href="#index-gftype-GF-validation"><code>gftype <span class="r">GF validation</span></code></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5861 <tr><td></td><td class="printindex-index-entry"><a href="#index-gftype_002eweb"><code>gftype.web</code></a></td><td class="printindex-index-section"><a href="#Font-utilities">Font utilities</a></td></tr>
5862 <tr><td></td><td class="printindex-index-entry"><a href="#index-glue-ratio-representations">glue ratio representations</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5863 <tr><td></td><td class="printindex-index-entry"><a href="#index-glue_002c-memory-for">glue, memory for</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5864 <tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-substitutions">glyph substitutions</a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
5865 <tr><td></td><td class="printindex-index-entry"><a href="#index-gray-font">gray font</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
5866 <tr><td></td><td class="printindex-index-entry"><a href="#index-group_002ddelimited-filename-for-_005cinput">group-delimited filename for <code class="code">\input</code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-braced-filename">\input braced filename</a></td></tr>
5867 <tr><td></td><td class="printindex-index-entry"><a href="#index-Gruff_002c-Billy-Goat">Gruff, Billy Goat</a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
5868 <tr><td></td><td class="printindex-index-entry"><a href="#index-gsftopk"><code>gsftopk</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5869 <tr><td colspan="3"><hr></td></tr>
5870 <tr><th id="Index_cp_letter-H">H</th></tr>
5871 <tr><td></td><td class="printindex-index-entry"><a href="#index-Harbison_002c-Samuel-P_002e">Harbison, Samuel P.</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5872 <tr><td></td><td class="printindex-index-entry"><a href="#index-hardware-and-memory-dumps">hardware and memory dumps</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5873 <tr><td></td><td class="printindex-index-entry"><a href="#index-headerbyte-information"><code>headerbyte <span class="r">information</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5874 <tr><td></td><td class="printindex-index-entry"><a href="#index-height_002c-in-pixels">height, in pixels</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5875 <tr><td></td><td class="printindex-index-entry"><a href="#index-help_002c-online">help, online</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5876 <tr><td></td><td class="printindex-index-entry"><a href="#index-Herberts_002c-Mathias">Herberts, Mathias</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5877 <tr><td></td><td class="printindex-index-entry"><a href="#index-hex-character-codes_002c-in-TCX-files">hex character codes, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5878 <tr><td></td><td class="printindex-index-entry"><a href="#index-HINT-_0028Hint-Is-Not-TeX_0029">HINT (Hint Is Not TeX)</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5879 <tr><td></td><td class="printindex-index-entry"><a href="#index-history">history</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5880 <tr><td></td><td class="printindex-index-entry"><a href="#index-hiTeX">hiTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5881 <tr><td></td><td class="printindex-index-entry"><a href="#index-Hobby_002c-John">Hobby, John</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5882 <tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-escapement">horizontal escapement</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5883 <tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-escapement-1">horizontal escapement</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5884 <tr><td></td><td class="printindex-index-entry"><a href="#index-hp2627"><code>hp2627</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5885 <tr><td></td><td class="printindex-index-entry"><a href="#index-human-languages_002c-supported-in-TeX">human languages, supported in TeX</a></td><td class="printindex-index-section"><a href="#Languages-and-hyphenation">Languages and hyphenation</a></td></tr>
5886 <tr><td></td><td class="printindex-index-entry"><a href="#index-human_002dreadable-text_002c-converting-DVI-to">human-readable text, converting DVI to</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5887 <tr><td></td><td class="printindex-index-entry"><a href="#index-human_002dreadable-text_002c-converting-GF-to">human-readable text, converting GF to</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5888 <tr><td></td><td class="printindex-index-entry"><a href="#index-human_002dreadable-text_002c-converting-PK-to">human-readable text, converting PK to</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5889 <tr><td></td><td class="printindex-index-entry"><a href="#index-human_002dreadable-text_002c-converting-TFM-to">human-readable text, converting TFM to</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5890 <tr><td></td><td class="printindex-index-entry"><a href="#index-human_002dreadable-text_002c-converting-VF-to">human-readable text, converting VF to</a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
5891 <tr><td></td><td class="printindex-index-entry"><a href="#index-hypertext">hypertext</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5892 <tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-and-languages">hyphenation and languages</a></td><td class="printindex-index-section"><a href="#Languages-and-hyphenation">Languages and hyphenation</a></td></tr>
5893 <tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-patterns_002c-creating">hyphenation patterns, creating</a></td><td class="printindex-index-section"><a href="#patgen-invocation">patgen invocation</a></td></tr>
5894 <tr><td colspan="3"><hr></td></tr>
5895 <tr><th id="Index_cp_letter-I">I</th></tr>
5896 <tr><td></td><td class="printindex-index-entry"><a href="#index-ice-cream">ice cream</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5897 <tr><td></td><td class="printindex-index-entry"><a href="#index-identifier-case">identifier case</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5898 <tr><td></td><td class="printindex-index-entry"><a href="#index-identifier-collisions">identifier collisions</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5899 <tr><td></td><td class="printindex-index-entry"><a href="#index-identifier-length">identifier length</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5900 <tr><td></td><td class="printindex-index-entry"><a href="#index-identifiers-with-underlines">identifiers with underlines</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
5901 <tr><td></td><td class="printindex-index-entry"><a href="#index-ieeetr_002ebst"><code>ieeetr.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
5902 <tr><td></td><td class="printindex-index-entry"><a href="#index-il1_002dt1_002etcx"><code>il1-t1.tcx</code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5903 <tr><td></td><td class="printindex-index-entry"><a href="#index-il2_002dt1_002etcx"><code>il2-t1.tcx</code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5904 <tr><td></td><td class="printindex-index-entry"><a href="#index-Info-format">Info format</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5905 <tr><td></td><td class="printindex-index-entry"><a href="#index-initial-form_002c-enabling">initial form, enabling</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5906 <tr><td></td><td class="printindex-index-entry"><a href="#index-initial-Metafont">initial Metafont</a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5907 <tr><td></td><td class="printindex-index-entry"><a href="#index-initial-MetaPost">initial MetaPost</a></td><td class="printindex-index-section"><a href="#Initial-MetaPost">Initial MetaPost</a></td></tr>
5908 <tr><td></td><td class="printindex-index-entry"><a href="#index-initial-programs">initial programs</a></td><td class="printindex-index-section"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr>
5909 <tr><td></td><td class="printindex-index-entry"><a href="#index-initial-TeX">initial TeX</a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
5910 <tr><td></td><td class="printindex-index-entry"><a href="#index-initializations_002c-lengthy">initializations, lengthy</a></td><td class="printindex-index-section"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr>
5911 <tr><td></td><td class="printindex-index-entry"><a href="#index-input-filenames">input filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
5912 <tr><td></td><td class="printindex-index-entry"><a href="#index-input-from-the-output-directory">input from the output directory</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
5913 <tr><td></td><td class="printindex-index-entry"><a href="#index-install_002dbases-Make-target"><code>install-bases <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5914 <tr><td></td><td class="printindex-index-entry"><a href="#index-install_002dfmts-Make-target"><code>install-fmts <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5915 <tr><td></td><td class="printindex-index-entry"><a href="#index-install_002dformats-Make-target"><code>install-formats <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5916 <tr><td></td><td class="printindex-index-entry"><a href="#index-install_002dmems-Make-target"><code>install-mems <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5917 <tr><td></td><td class="printindex-index-entry"><a href="#index-installation">installation</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5918 <tr><td></td><td class="printindex-index-entry"><a href="#index-interaction-between-TCX-files-and-_002d8bit_002e">interaction between TCX files and &lsquo;<samp class="samp">-8bit</samp>&rsquo;.</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5919 <tr><td></td><td class="printindex-index-entry"><a href="#index-interaction-mode">interaction mode</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5920 <tr><td></td><td class="printindex-index-entry"><a href="#index-international-characters">international characters</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5921 <tr><td></td><td class="printindex-index-entry"><a href="#index-introduction">introduction</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5922 <tr><td></td><td class="printindex-index-entry"><a href="#index-IPC">IPC</a></td><td class="printindex-index-section"><a href="#IPC-and-TeX">IPC and TeX</a></td></tr>
5923 <tr><td></td><td class="printindex-index-entry"><a href="#index-IPC_005fDEBUG"><code>IPC_DEBUG</code></a></td><td class="printindex-index-section"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr>
5924 <tr><td></td><td class="printindex-index-entry"><a href="#index-IPC_005fDEBUG-1"><code>IPC_DEBUG</code></a></td><td class="printindex-index-section"><a href="#IPC-and-TeX">IPC and TeX</a></td></tr>
5925 <tr><td colspan="3"><hr></td></tr>
5926 <tr><th id="Index_cp_letter-J">J</th></tr>
5927 <tr><td></td><td class="printindex-index-entry"><a href="#index-job-name">job name</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5928 <tr><td colspan="3"><hr></td></tr>
5929 <tr><th id="Index_cp_letter-K">K</th></tr>
5930 <tr><td></td><td class="printindex-index-entry"><a href="#index-kerning-table_002c-in-TFM-files">kerning table, in TFM files</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5931 <tr><td></td><td class="printindex-index-entry"><a href="#index-keyboard-character-code_002c-translating">keyboard character code, translating</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
5932 <tr><td></td><td class="printindex-index-entry"><a href="#index-Knuth_002c-Donald-E_002e">Knuth, Donald E.</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5933 <tr><td></td><td class="printindex-index-entry"><a href="#index-Knuth_002c-Donald-E_002e-1">Knuth, Donald E.</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5934 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPATHSEA_005fDEBUG"><code>KPATHSEA_DEBUG</code></a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5935 <tr><td></td><td class="printindex-index-entry"><a href="#index-KRN-property"><code>KRN <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5936 <tr><td colspan="3"><hr></td></tr>
5937 <tr><th id="Index_cp_letter-L">L</th></tr>
5938 <tr><td></td><td class="printindex-index-entry"><a href="#index-label-font">label font</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
5939 <tr><td></td><td class="printindex-index-entry"><a href="#index-LABEL-property"><code>LABEL <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5940 <tr><td></td><td class="printindex-index-entry"><a href="#index-language-support-in-TeX">language support in TeX</a></td><td class="printindex-index-section"><a href="#Languages-and-hyphenation">Languages and hyphenation</a></td></tr>
5941 <tr><td></td><td class="printindex-index-entry"><a href="#index-languages_002c-hyphenation-rules-for">languages, hyphenation rules for</a></td><td class="printindex-index-section"><a href="#patgen-invocation">patgen invocation</a></td></tr>
5942 <tr><td></td><td class="printindex-index-entry"><a href="#index-LaTeX">LaTeX</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5943 <tr><td></td><td class="printindex-index-entry"><a href="#index-LaTeX-testing">LaTeX testing</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5944 <tr><td></td><td class="printindex-index-entry"><a href="#index-latex_002ddev"><code class="command">latex-dev</code></a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5945 <tr><td></td><td class="printindex-index-entry"><a href="#index-Latin-Modern">Latin Modern</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
5946 <tr><td></td><td class="printindex-index-entry"><a href="#index-left-side-bearing">left side bearing</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
5947 <tr><td></td><td class="printindex-index-entry"><a href="#index-left-side-bearing-1">left side bearing</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
5948 <tr><td></td><td class="printindex-index-entry"><a href="#index-legalisms">legalisms</a></td><td class="printindex-index-section"><a href="#Legalisms">Legalisms</a></td></tr>
5949 <tr><td></td><td class="printindex-index-entry"><a href="#index-libsigsegv-library"><code>libsigsegv <span class="r">library</span></code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5950 <tr><td></td><td class="printindex-index-entry"><a href="#index-licensing-terms">licensing terms</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5951 <tr><td></td><td class="printindex-index-entry"><a href="#index-LIG-property"><code>LIG <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5952 <tr><td></td><td class="printindex-index-entry"><a href="#index-ligature-table_002c-in-TFM-files">ligature table, in TFM files</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5953 <tr><td></td><td class="printindex-index-entry"><a href="#index-LIGTABLE-property"><code>LIGTABLE <span class="r">property</span></code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
5954 <tr><td></td><td class="printindex-index-entry"><a href="#index-linking-binaries">linking binaries</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
5955 <tr><td></td><td class="printindex-index-entry"><a href="#index-links-to-binaries">links to binaries</a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5956 <tr><td></td><td class="printindex-index-entry"><a href="#index-literate-programming">literate programming</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
5957 <tr><td></td><td class="printindex-index-entry"><a href="#index-LittleEndian-machines">LittleEndian machines</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5958 <tr><td></td><td class="printindex-index-entry"><a href="#index-location-of-texmf_002ecnf-in-TeX-Live">location of <samp class="file">texmf.cnf</samp> in TeX Live</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5959 <tr><td></td><td class="printindex-index-entry"><a href="#index-log-file_002c-BibTeX">log file, BibTeX</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
5960 <tr><td></td><td class="printindex-index-entry"><a href="#index-long-data-type_002c-size-of"><code class="code">long</code> data type, size of</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5961 <tr><td></td><td class="printindex-index-entry"><a href="#index-ltx_002dtalk_002c-package"><code>ltx-talk<span class="r">, package</span></code></a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5962 <tr><td></td><td class="printindex-index-entry"><a href="#index-Lua">Lua</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5963 <tr><td></td><td class="printindex-index-entry"><a href="#index-Lua_002c-and-unportable-memory-dumps">Lua, and unportable memory dumps</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5964 <tr><td></td><td class="printindex-index-entry"><a href="#index-LuaTeX">LuaTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
5965 <tr><td colspan="3"><hr></td></tr>
5966 <tr><th id="Index_cp_letter-M">M</th></tr>
5967 <tr><td></td><td class="printindex-index-entry"><a href="#index-machine-dependencies">machine dependencies</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5968 <tr><td></td><td class="printindex-index-entry"><a href="#index-machine_002dreadable_002c-converting-property-lists-to">machine-readable, converting property lists to</a></td><td class="printindex-index-section"><a href="#pltotf-invocation">pltotf invocation</a></td></tr>
5969 <tr><td></td><td class="printindex-index-entry"><a href="#index-machine_002dreadable_002c-converting-property-lists-to-1">machine-readable, converting property lists to</a></td><td class="printindex-index-section"><a href="#vptovf-invocation">vptovf invocation</a></td></tr>
5970 <tr><td></td><td class="printindex-index-entry"><a href="#index-MacKay_002c-Pierre">MacKay, Pierre</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
5971 <tr><td></td><td class="printindex-index-entry"><a href="#index-macro-packages_002c-major-TeX">macro packages, major TeX</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5972 <tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-basic">macros, basic</a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
5973 <tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-predefining-in-memory-dumps">macros, predefining in memory dumps</a></td><td class="printindex-index-section"><a href="#Memory-dumps">Memory dumps</a></td></tr>
5974 <tr><td></td><td class="printindex-index-entry"><a href="#index-magnification">magnification</a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
5975 <tr><td></td><td class="printindex-index-entry"><a href="#index-magnification-1">magnification</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
5976 <tr><td></td><td class="printindex-index-entry"><a href="#index-main_005fmemory"><code>main_memory</code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
5977 <tr><td></td><td class="printindex-index-entry"><a href="#index-Make-targets_002c-additional">Make targets, additional</a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5978 <tr><td></td><td class="printindex-index-entry"><a href="#index-Martin_002c-Rick">Martin, Rick</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5979 <tr><td></td><td class="printindex-index-entry"><a href="#index-Mathematical-Reviews">Mathematical Reviews</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
5980 <tr><td></td><td class="printindex-index-entry"><a href="#index-mathematical-typesetting">mathematical typesetting</a></td><td class="printindex-index-section"><a href="#TeX">TeX</a></td></tr>
5981 <tr><td></td><td class="printindex-index-entry"><a href="#index-memory-dump-to-use_002c-determining">memory dump to use, determining</a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
5982 <tr><td></td><td class="printindex-index-entry"><a href="#index-memory-dumps">memory dumps</a></td><td class="printindex-index-section"><a href="#Memory-dumps">Memory dumps</a></td></tr>
5983 <tr><td></td><td class="printindex-index-entry"><a href="#index-memory-dumps-and-hardware">memory dumps and hardware</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5984 <tr><td></td><td class="printindex-index-entry"><a href="#index-memory-dumps_002c-contain-date-and-time">memory dumps, contain date and time</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
5985 <tr><td></td><td class="printindex-index-entry"><a href="#index-memory-dumps_002c-creating">memory dumps, creating</a></td><td class="printindex-index-section"><a href="#Creating-memory-dumps">Creating memory dumps</a></td></tr>
5986 <tr><td></td><td class="printindex-index-entry"><a href="#index-mems-Make-target"><code>mems <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
5987 <tr><td></td><td class="printindex-index-entry"><a href="#index-meta-characters-in-filenames">meta characters in filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
5988 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont">Metafont</a></td><td class="printindex-index-section"><a href="#Metafont">Metafont</a></td></tr>
5989 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-geometry">Metafont geometry</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5990 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-graphics">Metafont graphics</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5991 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-input-files">Metafont input files</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5992 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-invocation">Metafont invocation</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
5993 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-meets-PostScript">Metafont meets PostScript</a></td><td class="printindex-index-section"><a href="#MetaPost">MetaPost</a></td></tr>
5994 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-online-support_002c-new-devices">Metafont online support, new devices</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5995 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-or-MetaPost-source_002c-prettyprinting">Metafont or MetaPost source, prettyprinting</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
5996 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-without-online-graphics">Metafont without online graphics</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
5997 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont_002c-compatibility-in-MetaPost">Metafont, compatibility in MetaPost</a></td><td class="printindex-index-section"><a href="#Initial-MetaPost">Initial MetaPost</a></td></tr>
5998 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont_002c-initial">Metafont, initial</a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
5999 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont_002c-MetaPost_002c-and-TeX">Metafont, MetaPost, and TeX</a></td><td class="printindex-index-section"><a href="#Three-programs">Three programs</a></td></tr>
6000 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost">MetaPost</a></td><td class="printindex-index-section"><a href="#MetaPost">MetaPost</a></td></tr>
6001 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost-and-plain-Metafont-compatibility">MetaPost and plain Metafont compatibility</a></td><td class="printindex-index-section"><a href="#Initial-MetaPost">Initial MetaPost</a></td></tr>
6002 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost-input-files">MetaPost input files</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6003 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost-invocation">MetaPost invocation</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6004 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost-source_002c-prettyprinting">MetaPost source, prettyprinting</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6005 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost_002c-initial">MetaPost, initial</a></td><td class="printindex-index-section"><a href="#Initial-MetaPost">Initial MetaPost</a></td></tr>
6006 <tr><td></td><td class="printindex-index-entry"><a href="#index-MetaPost_002c-TeX_002c-and-Metafont">MetaPost, TeX, and Metafont</a></td><td class="printindex-index-section"><a href="#Three-programs">Three programs</a></td></tr>
6007 <tr><td></td><td class="printindex-index-entry"><a href="#index-metatype1"><code>metatype1</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6008 <tr><td></td><td class="printindex-index-entry"><a href="#index-mf"><code>mf</code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6009 <tr><td></td><td class="printindex-index-entry"><a href="#index-mf_002ebase"><code>mf.base</code></a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
6010 <tr><td></td><td class="printindex-index-entry"><a href="#index-MFEDIT"><code>MFEDIT</code></a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
6011 <tr><td></td><td class="printindex-index-entry"><a href="#index-mfplain"><code>mfplain</code></a></td><td class="printindex-index-section"><a href="#Initial-MetaPost">Initial MetaPost</a></td></tr>
6012 <tr><td></td><td class="printindex-index-entry"><a href="#index-mfput"><code>mfput</code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6013 <tr><td></td><td class="printindex-index-entry"><a href="#index-mft"><code>mft</code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6014 <tr><td></td><td class="printindex-index-entry"><a href="#index-mftalk"><code>mftalk</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6015 <tr><td></td><td class="printindex-index-entry"><a href="#index-MFTERM"><code>MFTERM</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6016 <tr><td></td><td class="printindex-index-entry"><a href="#index-mftmac_002etex"><code>mftmac.tex</code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6017 <tr><td></td><td class="printindex-index-entry"><a href="#index-micro_002dtypography">micro-typography</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6018 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktexmf_002c-disabling"><code>mktexmf<span class="r">, disabling</span></code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6019 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktextfm_002c-disabling"><code>mktextfm<span class="r">, disabling</span></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6020 <tr><td></td><td class="printindex-index-entry"><a href="#index-mltex"><code>mltex</code></a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
6021 <tr><td></td><td class="printindex-index-entry"><a href="#index-MLTeX_002c-enabling">MLTeX, enabling</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6022 <tr><td></td><td class="printindex-index-entry"><a href="#index-mode-needed-to-run-Metafont">mode needed to run Metafont</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6023 <tr><td></td><td class="printindex-index-entry"><a href="#index-mode_005fdef"><code>mode_def</code></a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6024 <tr><td></td><td class="printindex-index-entry"><a href="#index-mode_005fsetup"><code>mode_setup</code></a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6025 <tr><td></td><td class="printindex-index-entry"><a href="#index-modes-file-needed-for-Metafont">modes file needed for Metafont</a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6026 <tr><td></td><td class="printindex-index-entry"><a href="#index-modes_002emf-recommended-modes-file"><code>modes.mf <span class="r">recommended modes file</span></code></a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6027 <tr><td></td><td class="printindex-index-entry"><a href="#index-modifying-texmf_002ecnf-in-TeX-Live">modifying <samp class="file">texmf.cnf</samp> in TeX Live</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6028 <tr><td></td><td class="printindex-index-entry"><a href="#index-Morgan_002c-Tim">Morgan, Tim</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6029 <tr><td></td><td class="printindex-index-entry"><a href="#index-Morris_002c-Bob">Morris, Bob</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6030 <tr><td></td><td class="printindex-index-entry"><a href="#index-MPEDIT"><code>MPEDIT</code></a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
6031 <tr><td></td><td class="printindex-index-entry"><a href="#index-mpgraph_002epdf"><code>mpgraph.pdf</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6032 <tr><td></td><td class="printindex-index-entry"><a href="#index-mpman_002epdf"><code>mpman.pdf</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6033 <tr><td></td><td class="printindex-index-entry"><a href="#index-mpost"><code>mpost</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6034 <tr><td></td><td class="printindex-index-entry"><a href="#index-mpost_002c-reason-for-name-change"><code>mpost<span class="r">, reason for name change</span></code></a></td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
6035 <tr><td></td><td class="printindex-index-entry"><a href="#index-mpout"><code>mpout</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6036 <tr><td></td><td class="printindex-index-entry"><a href="#index-mproof_002etex"><code>mproof.tex</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6037 <tr><td></td><td class="printindex-index-entry"><a href="#index-mptrap-Make-target"><code>mptrap <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
6038 <tr><td></td><td class="printindex-index-entry"><a href="#index-mptrap-test">mptrap test</a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6039 <tr><td></td><td class="printindex-index-entry"><a href="#index-mptrap_002ereadme"><code>mptrap.readme</code></a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6040 <tr><td></td><td class="printindex-index-entry"><a href="#index-MPX-files_002c-converting-from-DVI-files">MPX files, converting from DVI files</a></td><td class="printindex-index-section"><a href="#dvitomp-invocation">dvitomp invocation</a></td></tr>
6041 <tr><td></td><td class="printindex-index-entry"><a href="#index-Multi_002dlingual-TeX">Multi-lingual TeX</a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
6042 <tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-spaces_002c-and-_005cinput-filenames">multiple spaces, and <code class="code">\input</code> filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
6043 <tr><td colspan="3"><hr></td></tr>
6044 <tr><th id="Index_cp_letter-N">N</th></tr>
6045 <tr><td></td><td class="printindex-index-entry"><a href="#index-N-tilde">N tilde</a></td><td class="printindex-index-section"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr>
6046 <tr><td></td><td class="printindex-index-entry"><a href="#index-new-graphics-support-for-Metafont">new graphics support for Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6047 <tr><td></td><td class="printindex-index-entry"><a href="#index-newrow-GF-command"><code>newrow <span class="r">GF command</span></code></a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6048 <tr><td></td><td class="printindex-index-entry"><a href="#index-next"><code>next</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6049 <tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dUnix-system_002c-compiling-on">non-Unix system, compiling on</a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
6050 <tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dwindows_002dcapable-Metafont">non-windows-capable Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6051 <tr><td></td><td class="printindex-index-entry"><a href="#index-NUL-bytes_002c-not-allowed-in-filenames">NUL bytes, not allowed in filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
6052 <tr><td></td><td class="printindex-index-entry"><a href="#index-NUL_002c-reserved-filename-on-Windows"><code>NUL<span class="r">, reserved filename on Windows</span></code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
6053 <tr><td colspan="3"><hr></td></tr>
6054 <tr><th id="Index_cp_letter-O">O</th></tr>
6055 <tr><td></td><td class="printindex-index-entry"><a href="#index-octal-character-codes_002c-in-TCX-files">octal character codes, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6056 <tr><td></td><td class="printindex-index-entry"><a href="#index-offset-for-overflow-labels">offset for overflow labels</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
6057 <tr><td></td><td class="printindex-index-entry"><a href="#index-Omega">Omega</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6058 <tr><td></td><td class="printindex-index-entry"><a href="#index-online-Metafont-graphics">online Metafont graphics</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6059 <tr><td></td><td class="printindex-index-entry"><a href="#index-opcodes_002c-showing-DVI">opcodes, showing DVI</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
6060 <tr><td></td><td class="printindex-index-entry"><a href="#index-OpenType-support">OpenType support</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6061 <tr><td></td><td class="printindex-index-entry"><a href="#index-optical-font-scaling">optical font scaling</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6062 <tr><td></td><td class="printindex-index-entry"><a href="#index-option-conventions">option conventions</a></td><td class="printindex-index-section"><a href="#Option-conventions">Option conventions</a></td></tr>
6063 <tr><td></td><td class="printindex-index-entry"><a href="#index-origin">origin</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6064 <tr><td></td><td class="printindex-index-entry"><a href="#index-output-directory_002c-specifying">output directory, specifying</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6065 <tr><td></td><td class="printindex-index-entry"><a href="#index-output-directory_002c-specifying-1">output directory, specifying</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6066 <tr><td></td><td class="printindex-index-entry"><a href="#index-output-file-location">output file location</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6067 <tr><td></td><td class="printindex-index-entry"><a href="#index-output-files_002c-written-by-TeX-programs">output files, written by TeX programs</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6068 <tr><td></td><td class="printindex-index-entry"><a href="#index-output_005fcomment-for-DVI-files"><code>output_comment <span class="r">for DVI files</span></code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6069 <tr><td></td><td class="printindex-index-entry"><a href="#index-overflow-label-offset">overflow label offset</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
6070 <tr><td></td><td class="printindex-index-entry"><a href="#index-overflow_002c-of-runtime-stack">overflow, of runtime stack</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6071 <tr><td colspan="3"><hr></td></tr>
6072 <tr><th id="Index_cp_letter-P">P</th></tr>
6073 <tr><td></td><td class="printindex-index-entry"><a href="#index-packet-length">packet length</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6074 <tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-starting">page, starting</a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
6075 <tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-starting-1">page, starting</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
6076 <tr><td></td><td class="printindex-index-entry"><a href="#index-parsing-the-first-line">parsing the first line</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6077 <tr><td></td><td class="printindex-index-entry"><a href="#index-Pascal_002c-creating-from-WEB">Pascal, creating from WEB</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
6078 <tr><td></td><td class="printindex-index-entry"><a href="#index-patgen"><code>patgen</code></a></td><td class="printindex-index-section"><a href="#patgen-invocation">patgen invocation</a></td></tr>
6079 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-searching">path searching</a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
6080 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-searching-debugging">path searching debugging</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6081 <tr><td></td><td class="printindex-index-entry"><a href="#index-PDF">PDF</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6082 <tr><td></td><td class="printindex-index-entry"><a href="#index-PDF_002c-and-_002emps-files">PDF, and <code class="code">.mps</code> files</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6083 <tr><td></td><td class="printindex-index-entry"><a href="#index-pdfTeX">pdfTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6084 <tr><td></td><td class="printindex-index-entry"><a href="#index-permissions_002c-legal">permissions, legal</a></td><td class="printindex-index-section"><a href="#Legalisms">Legalisms</a></td></tr>
6085 <tr><td></td><td class="printindex-index-entry"><a href="#index-PFA-and-PFB-conversion">PFA and PFB conversion</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6086 <tr><td></td><td class="printindex-index-entry"><a href="#index-pfaedit"><code>pfaedit</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6087 <tr><td></td><td class="printindex-index-entry"><a href="#index-PiCTeX_002c-increasing-memory-for">PiCTeX, increasing memory for</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6088 <tr><td></td><td class="printindex-index-entry"><a href="#index-pid_002c-used-in-recorder-filename">pid, used in recorder filename</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6089 <tr><td></td><td class="printindex-index-entry"><a href="#index-pipes_002c-reading-and-writing">pipes, reading and writing</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6090 <tr><td></td><td class="printindex-index-entry"><a href="#index-pixel-height">pixel height</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6091 <tr><td></td><td class="printindex-index-entry"><a href="#index-pixel-width">pixel width</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6092 <tr><td></td><td class="printindex-index-entry"><a href="#index-PK-bitmaps-from-PostScript">PK bitmaps from PostScript</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6093 <tr><td></td><td class="printindex-index-entry"><a href="#index-PK-files_002c-explained">PK files, explained</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6094 <tr><td></td><td class="printindex-index-entry"><a href="#index-PK-files_002c-not-output-by-Metafont">PK files, not output by Metafont</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6095 <tr><td></td><td class="printindex-index-entry"><a href="#index-PK-format-definition">PK format definition</a></td><td class="printindex-index-section"><a href="#Font-utilities">Font utilities</a></td></tr>
6096 <tr><td></td><td class="printindex-index-entry"><a href="#index-PK_002c-converting-GF-to">PK, converting GF to</a></td><td class="printindex-index-section"><a href="#gftopk-invocation">gftopk invocation</a></td></tr>
6097 <tr><td></td><td class="printindex-index-entry"><a href="#index-PK_002c-converting-to-GF">PK, converting to GF</a></td><td class="printindex-index-section"><a href="#pktogf-invocation">pktogf invocation</a></td></tr>
6098 <tr><td></td><td class="printindex-index-entry"><a href="#index-pktogf"><code>pktogf</code></a></td><td class="printindex-index-section"><a href="#pktogf-invocation">pktogf invocation</a></td></tr>
6099 <tr><td></td><td class="printindex-index-entry"><a href="#index-pktype-PK-validation"><code>pktype <span class="r">PK validation</span></code></a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6100 <tr><td></td><td class="printindex-index-entry"><a href="#index-pktype_002eweb"><code>pktype.web</code></a></td><td class="printindex-index-section"><a href="#Font-utilities">Font utilities</a></td></tr>
6101 <tr><td></td><td class="printindex-index-entry"><a href="#index-PL-files_002c-explained">PL files, explained</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6102 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain-Metafont_002c-compatibility-in-MetaPost">plain Metafont, compatibility in MetaPost</a></td><td class="printindex-index-section"><a href="#Initial-MetaPost">Initial MetaPost</a></td></tr>
6103 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text_002c-converting-DVI-to">plain text, converting DVI to</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
6104 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text_002c-converting-GF-to">plain text, converting GF to</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6105 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text_002c-converting-PK-to">plain text, converting PK to</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6106 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text_002c-converting-TFM-to">plain text, converting TFM to</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
6107 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text_002c-converting-VF-to">plain text, converting VF to</a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
6108 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain_002ebase"><code>plain.base</code></a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
6109 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain_002ebst"><code>plain.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
6110 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain_002efmt"><code>plain.fmt</code></a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
6111 <tr><td></td><td class="printindex-index-entry"><a href="#index-plain_002emft"><code>plain.mft</code></a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6112 <tr><td></td><td class="printindex-index-entry"><a href="#index-pltotf"><code>pltotf</code></a></td><td class="printindex-index-section"><a href="#pltotf-invocation">pltotf invocation</a></td></tr>
6113 <tr><td></td><td class="printindex-index-entry"><a href="#index-pool-file_002c-writing">pool file, writing</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
6114 <tr><td></td><td class="printindex-index-entry"><a href="#index-Poole_002c-Simon">Poole, Simon</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6115 <tr><td></td><td class="printindex-index-entry"><a href="#index-pooltype"><code>pooltype</code></a></td><td class="printindex-index-section"><a href="#pooltype-invocation">pooltype invocation</a></td></tr>
6116 <tr><td></td><td class="printindex-index-entry"><a href="#index-portable-filenames">portable filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
6117 <tr><td></td><td class="printindex-index-entry"><a href="#index-portable-memory-dumps">portable memory dumps</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
6118 <tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-fonts_002c-and-Troff">PostScript fonts, and Troff</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6119 <tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-meets-Metafont">PostScript meets Metafont</a></td><td class="printindex-index-section"><a href="#MetaPost">MetaPost</a></td></tr>
6120 <tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-output">PostScript output</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6121 <tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-to-PK-bitmaps">PostScript to PK bitmaps</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6122 <tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript-Type-1-font-conversion">PostScript Type 1 font conversion</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6123 <tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript_002c-and-font-scaling">PostScript, and font scaling</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6124 <tr><td></td><td class="printindex-index-entry"><a href="#index-potrace"><code>potrace</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6125 <tr><td></td><td class="printindex-index-entry"><a href="#index-predefined-macros-and-memory-dumps">predefined macros and memory dumps</a></td><td class="printindex-index-section"><a href="#Memory-dumps">Memory dumps</a></td></tr>
6126 <tr><td></td><td class="printindex-index-entry"><a href="#index-prettyprinting-Metafont-or-MetaPost-source">prettyprinting Metafont or MetaPost source</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6127 <tr><td></td><td class="printindex-index-entry"><a href="#index-prettyprinting-WEB-programs">prettyprinting WEB programs</a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
6128 <tr><td></td><td class="printindex-index-entry"><a href="#index-primitives_002c-new">primitives, new</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6129 <tr><td></td><td class="printindex-index-entry"><a href="#index-printable-characters_002c-specifying">printable characters, specifying</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6130 <tr><td></td><td class="printindex-index-entry"><a href="#index-printer-characteristics_002c-for-Metafont">printer characteristics, for Metafont</a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6131 <tr><td></td><td class="printindex-index-entry"><a href="#index-production-use">production use</a></td><td class="printindex-index-section"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr>
6132 <tr><td></td><td class="printindex-index-entry"><a href="#index-program-name_002c-determines-memory-dump">program name, determines memory dump</a></td><td class="printindex-index-section"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr>
6133 <tr><td></td><td class="printindex-index-entry"><a href="#index-program-names_002c-special">program names, special</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6134 <tr><td></td><td class="printindex-index-entry"><a href="#index-program-names_002c-special-1">program names, special</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6135 <tr><td></td><td class="printindex-index-entry"><a href="#index-program-names_002c-special-2">program names, special</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6136 <tr><td></td><td class="printindex-index-entry"><a href="#index-prologues"><code>prologues</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6137 <tr><td></td><td class="printindex-index-entry"><a href="#index-prologues_002c-and-EPSF-output"><code>prologues<span class="r">, and EPSF output</span></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6138 <tr><td></td><td class="printindex-index-entry"><a href="#index-proof-mode"><code>proof <span class="r">mode</span></code></a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6139 <tr><td></td><td class="printindex-index-entry"><a href="#index-proof-sheets_002c-of-fonts">proof sheets, of fonts</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
6140 <tr><td></td><td class="printindex-index-entry"><a href="#index-property-list-format">property list format</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
6141 <tr><td></td><td class="printindex-index-entry"><a href="#index-property-list_002c-converting-TFM-to">property list, converting TFM to</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
6142 <tr><td></td><td class="printindex-index-entry"><a href="#index-property-list_002c-converting-VF-to-virtual">property list, converting VF to virtual</a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
6143 <tr><td></td><td class="printindex-index-entry"><a href="#index-ps2pk"><code>ps2pk</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6144 <tr><td></td><td class="printindex-index-entry"><a href="#index-psfonts_002emap_002c-read-by-MetaPost"><code>psfonts.map<span class="r">, read by MetaPost</span></code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6145 <tr><td></td><td class="printindex-index-entry"><a href="#index-pTeX">pTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6146 <tr><td></td><td class="printindex-index-entry"><a href="#index-PXL-files_002c-explained">PXL files, explained</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6147 <tr><td></td><td class="printindex-index-entry"><a href="#index-pxtoch"><code>pxtoch</code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6148 <tr><td colspan="3"><hr></td></tr>
6149 <tr><th id="Index_cp_letter-Q">Q</th></tr>
6150 <tr><td></td><td class="printindex-index-entry"><a href="#index-quoted-filename-for-_005cinput">quoted filename for <code class="code">\input</code></a></td><td class="printindex-index-section"><a href="#g_t_005cinput-quoted-filename">\input quoted filename</a></td></tr>
6151 <tr><td colspan="3"><hr></td></tr>
6152 <tr><th id="Index_cp_letter-R">R</th></tr>
6153 <tr><td></td><td class="printindex-index-entry"><a href="#index-Raichle_002c-Bernd">Raichle, Bernd</a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
6154 <tr><td></td><td class="printindex-index-entry"><a href="#index-reading-from-the-output-directory">reading from the output directory</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6155 <tr><td></td><td class="printindex-index-entry"><a href="#index-reading_002c-additional">reading, additional</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6156 <tr><td></td><td class="printindex-index-entry"><a href="#index-readonly-directory_002c-running-TeX-in">readonly directory, running TeX in</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6157 <tr><td></td><td class="printindex-index-entry"><a href="#index-readonly-directory_002c-running-TeX-in-1">readonly directory, running TeX in</a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6158 <tr><td></td><td class="printindex-index-entry"><a href="#index-reallocation-of-arrays">reallocation of arrays</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6159 <tr><td></td><td class="printindex-index-entry"><a href="#index-recursive-expansion-limit">recursive expansion limit</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6160 <tr><td></td><td class="printindex-index-entry"><a href="#index-redefined-character-substitutions">redefined character substitutions</a></td><td class="printindex-index-section"><a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></td></tr>
6161 <tr><td></td><td class="printindex-index-entry"><a href="#index-reference-pixel">reference pixel</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6162 <tr><td></td><td class="printindex-index-entry"><a href="#index-references">references</a></td><td class="printindex-index-section"><a href="#References">References</a></td></tr>
6163 <tr><td></td><td class="printindex-index-entry"><a href="#index-regis"><code>regis</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6164 <tr><td></td><td class="printindex-index-entry"><a href="#index-Regis-graphics-support">Regis graphics support</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6165 <tr><td></td><td class="printindex-index-entry"><a href="#index-regression-testing">regression testing</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6166 <tr><td></td><td class="printindex-index-entry"><a href="#index-repeated-rows">repeated rows</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6167 <tr><td></td><td class="printindex-index-entry"><a href="#index-representation-of-strings">representation of strings</a></td><td class="printindex-index-section"><a href="#pooltype-invocation">pooltype invocation</a></td></tr>
6168 <tr><td></td><td class="printindex-index-entry"><a href="#index-restricted-shell-escapes">restricted shell escapes</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6169 <tr><td></td><td class="printindex-index-entry"><a href="#index-right-side-bearing">right side bearing</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6170 <tr><td></td><td class="printindex-index-entry"><a href="#index-right-side-bearing-1">right side bearing</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6171 <tr><td></td><td class="printindex-index-entry"><a href="#index-Rokicki_002c-Tomas">Rokicki, Tomas</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6172 <tr><td></td><td class="printindex-index-entry"><a href="#index-run-length-encoded-bitmaps">run length encoded bitmaps</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6173 <tr><td></td><td class="printindex-index-entry"><a href="#index-run-length-encoded-bitmaps-1">run length encoded bitmaps</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6174 <tr><td></td><td class="printindex-index-entry"><a href="#index-runtime-options">runtime options</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6175 <tr><td></td><td class="printindex-index-entry"><a href="#index-runtime-stack-overflow">runtime stack overflow</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6176 <tr><td colspan="3"><hr></td></tr>
6177 <tr><th id="Index_cp_letter-S">S</th></tr>
6178 <tr><td></td><td class="printindex-index-entry"><a href="#index-scaled-pixels">scaled pixels</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6179 <tr><td></td><td class="printindex-index-entry"><a href="#index-scaled-pixels-1">scaled pixels</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6180 <tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-of-fonts">scaling of fonts</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6181 <tr><td></td><td class="printindex-index-entry"><a href="#index-security_002c-and-_005copenout">security, and <code class="code">\openout</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6182 <tr><td></td><td class="printindex-index-entry"><a href="#index-security_002c-and-output-files">security, and output files</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6183 <tr><td></td><td class="printindex-index-entry"><a href="#index-security_002c-and-shell-escapes">security, and shell escapes</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6184 <tr><td></td><td class="printindex-index-entry"><a href="#index-security_002c-and-write">security, and <code class="code">write</code></a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6185 <tr><td></td><td class="printindex-index-entry"><a href="#index-segmentation-fault">segmentation fault</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6186 <tr><td></td><td class="printindex-index-entry"><a href="#index-shapes">shapes</a></td><td class="printindex-index-section"><a href="#Metafont">Metafont</a></td></tr>
6187 <tr><td></td><td class="printindex-index-entry"><a href="#index-sharing-memory-dumps">sharing memory dumps</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
6188 <tr><td></td><td class="printindex-index-entry"><a href="#index-shell-commands-in-TeX">shell commands in TeX</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6189 <tr><td></td><td class="printindex-index-entry"><a href="#index-shell_005fescape-enabling-in-TeX"><code>shell_escape <span class="r">enabling in TeX</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6190 <tr><td></td><td class="printindex-index-entry"><a href="#index-shell_005fescape_005fcommands"><code>shell_escape_commands</code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6191 <tr><td></td><td class="printindex-index-entry"><a href="#index-siam_002ebst"><code>siam.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
6192 <tr><td></td><td class="printindex-index-entry"><a href="#index-side-bearings">side bearings</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6193 <tr><td></td><td class="printindex-index-entry"><a href="#index-side-bearings-1">side bearings</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6194 <tr><td></td><td class="printindex-index-entry"><a href="#index-SIGSEGV"><code>SIGSEGV</code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6195 <tr><td></td><td class="printindex-index-entry"><a href="#index-slant-font">slant font</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
6196 <tr><td></td><td class="printindex-index-entry"><a href="#index-slides_002c-package"><code>slides<span class="r">, package</span></code></a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
6197 <tr><td></td><td class="printindex-index-entry"><a href="#index-slides_002c-producing">slides, producing</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
6198 <tr><td></td><td class="printindex-index-entry"><a href="#index-SliTeX">SliTeX</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
6199 <tr><td></td><td class="printindex-index-entry"><a href="#index-small-Metafont-memory-and-modes">small Metafont memory and modes</a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6200 <tr><td></td><td class="printindex-index-entry"><a href="#index-smode-and-dynamic-Metafont-mode-definition"><code>smode <span class="r">and dynamic Metafont mode definition</span></code></a></td><td class="printindex-index-section"><a href="#Modes">Modes</a></td></tr>
6201 <tr><td></td><td class="printindex-index-entry"><a href="#index-sockets">sockets</a></td><td class="printindex-index-section"><a href="#IPC-and-TeX">IPC and TeX</a></td></tr>
6202 <tr><td></td><td class="printindex-index-entry"><a href="#index-space_002dterminated-filenames">space-terminated filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
6203 <tr><td></td><td class="printindex-index-entry"><a href="#index-Spiderweb">Spiderweb</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
6204 <tr><td></td><td class="printindex-index-entry"><a href="#index-Stallman_002c-Richard">Stallman, Richard</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6205 <tr><td></td><td class="printindex-index-entry"><a href="#index-starting-page">starting page</a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
6206 <tr><td></td><td class="printindex-index-entry"><a href="#index-starting-page-1">starting page</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
6207 <tr><td></td><td class="printindex-index-entry"><a href="#index-Steele-Jr_002e_002c-Guy-L_002e">Steele Jr., Guy L.</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
6208 <tr><td></td><td class="printindex-index-entry"><a href="#index-stopping-at-the-first-error">stopping at the first error</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6209 <tr><td></td><td class="printindex-index-entry"><a href="#index-strategy_002c-overall">strategy, overall</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6210 <tr><td></td><td class="printindex-index-entry"><a href="#index-string-numbers_002c-displaying">string numbers, displaying</a></td><td class="printindex-index-section"><a href="#pooltype-invocation">pooltype invocation</a></td></tr>
6211 <tr><td></td><td class="printindex-index-entry"><a href="#index-string-pool_002c-writing">string pool, writing</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
6212 <tr><td></td><td class="printindex-index-entry"><a href="#index-string-representation">string representation</a></td><td class="printindex-index-section"><a href="#pooltype-invocation">pooltype invocation</a></td></tr>
6213 <tr><td></td><td class="printindex-index-entry"><a href="#index-style-design_002c-for-BibTeX">style design, for BibTeX</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6214 <tr><td></td><td class="printindex-index-entry"><a href="#index-style-files">style files</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6215 <tr><td></td><td class="printindex-index-entry"><a href="#index-substitutions-of-font-glyphs">substitutions of font glyphs</a></td><td class="printindex-index-section"><a href="#MLTeX">MLTeX</a></td></tr>
6216 <tr><td></td><td class="printindex-index-entry"><a href="#index-sun"><code>sun</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6217 <tr><td></td><td class="printindex-index-entry"><a href="#index-sun_002dgfx_002ec"><code>sun-gfx.c</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6218 <tr><td></td><td class="printindex-index-entry"><a href="#index-Suntools">Suntools</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6219 <tr><td></td><td class="printindex-index-entry"><a href="#index-SunView">SunView</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6220 <tr><td></td><td class="printindex-index-entry"><a href="#index-swap-space_002c-as-array-limit">swap space, as array limit</a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6221 <tr><td></td><td class="printindex-index-entry"><a href="#index-swapping-bytes">swapping bytes</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
6222 <tr><td></td><td class="printindex-index-entry"><a href="#index-syntax-of-TCX-files">syntax of TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6223 <tr><td></td><td class="printindex-index-entry"><a href="#index-system-C-library-function"><code>system <span class="r">C library function</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6224 <tr><td></td><td class="printindex-index-entry"><a href="#index-system-command">system command</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6225 <tr><td></td><td class="printindex-index-entry"><a href="#index-system-fonts_002c-using">system fonts, using</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6226 <tr><td colspan="3"><hr></td></tr>
6227 <tr><th id="Index_cp_letter-T">T</th></tr>
6228 <tr><td></td><td class="printindex-index-entry"><a href="#index-T1-encoding-and-ISO-input">T1 encoding and ISO input</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6229 <tr><td></td><td class="printindex-index-entry"><a href="#index-tabs_002c-and-_005cinput-filenames">tabs, and <code class="code">\input</code> filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
6230 <tr><td></td><td class="printindex-index-entry"><a href="#index-Tachikawa_002c-Elizabeth">Tachikawa, Elizabeth</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6231 <tr><td></td><td class="printindex-index-entry"><a href="#index-tangle"><code>tangle</code></a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
6232 <tr><td></td><td class="printindex-index-entry"><a href="#index-targets_002c-additional-Make">targets, additional Make</a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
6233 <tr><td></td><td class="printindex-index-entry"><a href="#index-TCX-character-translation-files"><code>TCX <span class="r">character translation files</span></code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6234 <tr><td></td><td class="printindex-index-entry"><a href="#index-technical-illustrations_002c-creating">technical illustrations, creating</a></td><td class="printindex-index-section"><a href="#MetaPost">MetaPost</a></td></tr>
6235 <tr><td></td><td class="printindex-index-entry"><a href="#index-tek"><code>tek</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6236 <tr><td></td><td class="printindex-index-entry"><a href="#index-Tektronix">Tektronix</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6237 <tr><td></td><td class="printindex-index-entry"><a href="#index-Tektronix-4014">Tektronix 4014</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6238 <tr><td></td><td class="printindex-index-entry"><a href="#index-TERM"><code>TERM</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6239 <tr><td></td><td class="printindex-index-entry"><a href="#index-terminator-for-filenames">terminator for filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
6240 <tr><td></td><td class="printindex-index-entry"><a href="#index-terse-output">terse output</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6241 <tr><td></td><td class="printindex-index-entry"><a href="#index-testing-LaTeX">testing LaTeX</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
6242 <tr><td></td><td class="printindex-index-entry"><a href="#index-teTeX-distribution">teTeX distribution</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6243 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex"><code>tex</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6244 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-bibliographies-for">TeX, bibliographies for</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6245 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-creating-from-Metafont-or-MetaPost">TeX, creating from Metafont or MetaPost</a></td><td class="printindex-index-section"><a href="#mft-invocation">mft invocation</a></td></tr>
6246 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-creating-from-WEB">TeX, creating from WEB</a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
6247 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-description-of">TeX, description of</a></td><td class="printindex-index-section"><a href="#TeX">TeX</a></td></tr>
6248 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-extensions-to">TeX, extensions to</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6249 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-format-packages-for">TeX, format packages for</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
6250 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-initial">TeX, initial</a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
6251 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-input-files-found">TeX, input files found</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6252 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-invocation">TeX, invocation</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6253 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-Metafont_002c-and-MetaPost">TeX, Metafont, and MetaPost</a></td><td class="printindex-index-section"><a href="#Three-programs">Three programs</a></td></tr>
6254 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX_002c-Web2c-implementation-of">TeX, Web2c implementation of</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6255 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002efmt"><code>tex.fmt</code></a></td><td class="printindex-index-section"><a href="#Initial-TeX">Initial TeX</a></td></tr>
6256 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXBIB_002c-search-path-for-bib-files"><code>TEXBIB<span class="r">, search path for bib files</span></code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6257 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXEDIT"><code>TEXEDIT</code></a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
6258 <tr><td></td><td class="printindex-index-entry"><a href="#index-texfonts_002emap"><code>texfonts.map</code></a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
6259 <tr><td></td><td class="printindex-index-entry"><a href="#index-Texinfo">Texinfo</a></td><td class="printindex-index-section"><a href="#Formats">Formats</a></td></tr>
6260 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_005fcasefold_005fsearch"><code>texmf_casefold_search</code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6261 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMF_005fOUTPUT_005fDIRECTORY"><code>TEXMF_OUTPUT_DIRECTORY</code></a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6262 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf"><code>texmf.cnf</code></a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
6263 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf-1"><code>texmf.cnf</code></a></td><td class="printindex-index-section"><a href="#Runtime-options">Runtime options</a></td></tr>
6264 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf-for-editors"><code>texmf.cnf <span class="r">for editors</span></code></a></td><td class="printindex-index-section"><a href="#Editor-invocation">Editor invocation</a></td></tr>
6265 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf-for-shell-escapes"><code>texmf.cnf <span class="r">for shell escapes</span></code></a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6266 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmfmp_002ec"><code>texmfmp.c</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6267 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFOUTPUT_002c-used-if-_002e-unwritable"><code>TEXMFOUTPUT<span class="r">, used if &lsquo;<samp class="samp">.</samp>&rsquo; unwritable</span></code></a></td><td class="printindex-index-section"><a href="#Output-file-location">Output file location</a></td></tr>
6268 <tr><td></td><td class="printindex-index-entry"><a href="#index-texput"><code>texput</code></a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6269 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFM-files_002c-converting-property-lists-to">TFM files, converting property lists to</a></td><td class="printindex-index-section"><a href="#pltotf-invocation">pltotf invocation</a></td></tr>
6270 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFM-files_002c-explained">TFM files, explained</a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6271 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFM-files_002c-output-by-Metafont">TFM files, output by Metafont</a></td><td class="printindex-index-section"><a href="#mf-invocation">mf invocation</a></td></tr>
6272 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFM-files_002c-output-by-MetaPost">TFM files, output by MetaPost</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6273 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFM-width-of-characters">TFM width of characters</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6274 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFM-width-of-characters-1">TFM width of characters</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6275 <tr><td></td><td class="printindex-index-entry"><a href="#index-tftopl"><code>tftopl</code></a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
6276 <tr><td></td><td class="printindex-index-entry"><a href="#index-three-programs">three programs</a></td><td class="printindex-index-section"><a href="#Three-programs">Three programs</a></td></tr>
6277 <tr><td></td><td class="printindex-index-entry"><a href="#index-time-and-date_002c-in-memory-dumps">time and date, in memory dumps</a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
6278 <tr><td></td><td class="printindex-index-entry"><a href="#index-title-font">title font</a></td><td class="printindex-index-section"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr>
6279 <tr><td></td><td class="printindex-index-entry"><a href="#index-tl_002dcheck_002dfmtshare"><code>tl-check-fmtshare</code></a></td><td class="printindex-index-section"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr>
6280 <tr><td></td><td class="printindex-index-entry"><a href="#index-tokenization_002c-and-_005cinput-filenames">tokenization, and <code class="code">\input</code> filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filename-caveats">\input filename caveats</a></td></tr>
6281 <tr><td></td><td class="printindex-index-entry"><a href="#index-toolkits_002c-X">toolkits, X</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6282 <tr><td></td><td class="printindex-index-entry"><a href="#index-torture-tests">torture tests</a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6283 <tr><td></td><td class="printindex-index-entry"><a href="#index-translation-file-for-TeX_002c-specifying">translation file for TeX, specifying</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6284 <tr><td></td><td class="printindex-index-entry"><a href="#index-translation-from-WEB-to-C">translation from WEB to C</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6285 <tr><td></td><td class="printindex-index-entry"><a href="#index-trap-Make-target"><code>trap <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
6286 <tr><td></td><td class="printindex-index-entry"><a href="#index-trap-test">trap test</a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6287 <tr><td></td><td class="printindex-index-entry"><a href="#index-trapman_002etex"><code>trapman.tex</code></a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6288 <tr><td></td><td class="printindex-index-entry"><a href="#index-Trickey_002c-Howard">Trickey, Howard</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6289 <tr><td></td><td class="printindex-index-entry"><a href="#index-trip-Make-target"><code>trip <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
6290 <tr><td></td><td class="printindex-index-entry"><a href="#index-trip-test">trip test</a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6291 <tr><td></td><td class="printindex-index-entry"><a href="#index-tripman_002etex"><code>tripman.tex</code></a></td><td class="printindex-index-section"><a href="#Triptrap">Triptrap</a></td></tr>
6292 <tr><td></td><td class="printindex-index-entry"><a href="#index-triptrap-Make-target"><code>triptrap <span class="r">Make target</span></code></a></td><td class="printindex-index-section"><a href="#Additional-targets">Additional targets</a></td></tr>
6293 <tr><td></td><td class="printindex-index-entry"><a href="#index-Troff_002c-and-MetaPost">Troff, and MetaPost</a></td><td class="printindex-index-section"><a href="#mpost-invocation">mpost invocation</a></td></tr>
6294 <tr><td></td><td class="printindex-index-entry"><a href="#index-troff_002c-supported-in-MetaPost"><code>troff<span class="r">, supported in MetaPost</span></code></a></td><td class="printindex-index-section"><a href="#MetaPost">MetaPost</a></td></tr>
6295 <tr><td></td><td class="printindex-index-entry"><a href="#index-Troff_002c-WEB-for">Troff, WEB for</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
6296 <tr><td></td><td class="printindex-index-entry"><a href="#index-Trojan-horses-and-TeX-programs">Trojan horses and TeX programs</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6297 <tr><td></td><td class="printindex-index-entry"><a href="#index-TrueType-support">TrueType support</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6298 <tr><td></td><td class="printindex-index-entry"><a href="#index-TUGboat-bibliography">TUGboat bibliography</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6299 <tr><td></td><td class="printindex-index-entry"><a href="#index-Type-1-conversion">Type 1 conversion</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6300 <tr><td></td><td class="printindex-index-entry"><a href="#index-type-design_002c-personal">type design, personal</a></td><td class="printindex-index-section"><a href="#Initial-Metafont">Initial Metafont</a></td></tr>
6301 <tr><td></td><td class="printindex-index-entry"><a href="#index-type-programs_002c-DVI">type programs, DVI</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
6302 <tr><td></td><td class="printindex-index-entry"><a href="#index-type-programs_002c-GF">type programs, GF</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6303 <tr><td></td><td class="printindex-index-entry"><a href="#index-type-programs_002c-PK">type programs, PK</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6304 <tr><td></td><td class="printindex-index-entry"><a href="#index-type-programs_002c-pool">type programs, pool</a></td><td class="printindex-index-section"><a href="#pooltype-invocation">pooltype invocation</a></td></tr>
6305 <tr><td></td><td class="printindex-index-entry"><a href="#index-typeface-families">typeface families</a></td><td class="printindex-index-section"><a href="#Metafont">Metafont</a></td></tr>
6306 <tr><td></td><td class="printindex-index-entry"><a href="#index-typesetting">typesetting</a></td><td class="printindex-index-section"><a href="#TeX">TeX</a></td></tr>
6307 <tr><td colspan="3"><hr></td></tr>
6308 <tr><th id="Index_cp_letter-U">U</th></tr>
6309 <tr><td></td><td class="printindex-index-entry"><a href="#index-Unicode">Unicode</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6310 <tr><td></td><td class="printindex-index-entry"><a href="#index-Unicode-input">Unicode input</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6311 <tr><td></td><td class="printindex-index-entry"><a href="#index-Unicode-input_002c-native">Unicode input, native</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6312 <tr><td></td><td class="printindex-index-entry"><a href="#index-uniterm"><code>uniterm</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6313 <tr><td></td><td class="printindex-index-entry"><a href="#index-unsrt_002ebst"><code>unsrt.bst</code></a></td><td class="printindex-index-section"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr>
6314 <tr><td></td><td class="printindex-index-entry"><a href="#index-upTeX">upTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6315 <tr><td></td><td class="printindex-index-entry"><a href="#index-UTF_002d8-input">UTF-8 input</a></td><td class="printindex-index-section"><a href="#tex-invocation">tex invocation</a></td></tr>
6316 <tr><td></td><td class="printindex-index-entry"><a href="#index-UTF_002d8-input_002c-native">UTF-8 input, native</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6317 <tr><td colspan="3"><hr></td></tr>
6318 <tr><th id="Index_cp_letter-V">V</th></tr>
6319 <tr><td></td><td class="printindex-index-entry"><a href="#index-validation_002c-of-DVI-files">validation, of DVI files</a></td><td class="printindex-index-section"><a href="#dvitype-invocation">dvitype invocation</a></td></tr>
6320 <tr><td></td><td class="printindex-index-entry"><a href="#index-validation_002c-of-GF-files">validation, of GF files</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6321 <tr><td></td><td class="printindex-index-entry"><a href="#index-validation_002c-of-PK-files">validation, of PK files</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6322 <tr><td></td><td class="printindex-index-entry"><a href="#index-validation_002c-of-TFM-files">validation, of TFM files</a></td><td class="printindex-index-section"><a href="#tftopl-invocation">tftopl invocation</a></td></tr>
6323 <tr><td></td><td class="printindex-index-entry"><a href="#index-validation_002c-of-VF-files">validation, of VF files</a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
6324 <tr><td></td><td class="printindex-index-entry"><a href="#index-verbose-BibTeX-output_002c-suppressing">verbose BibTeX output, suppressing</a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6325 <tr><td></td><td class="printindex-index-entry"><a href="#index-verbosity_002c-enabling">verbosity, enabling</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6326 <tr><td></td><td class="printindex-index-entry"><a href="#index-version-number_002c-finding">version number, finding</a></td><td class="printindex-index-section"><a href="#Common-options">Common options</a></td></tr>
6327 <tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-escapement">vertical escapement</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6328 <tr><td></td><td class="printindex-index-entry"><a href="#index-VF-files_002c-converting-property-lists-to">VF files, converting property lists to</a></td><td class="printindex-index-section"><a href="#vptovf-invocation">vptovf invocation</a></td></tr>
6329 <tr><td></td><td class="printindex-index-entry"><a href="#index-vftovp"><code>vftovp</code></a></td><td class="printindex-index-section"><a href="#vftovp-invocation">vftovp invocation</a></td></tr>
6330 <tr><td></td><td class="printindex-index-entry"><a href="#index-virgin-programs">virgin programs</a></td><td class="printindex-index-section"><a href="#Initial-and-virgin">Initial and virgin</a></td></tr>
6331 <tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-font-creation">virtual font creation</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6332 <tr><td></td><td class="printindex-index-entry"><a href="#index-virtual-fonts_002c-expanding">virtual fonts, expanding</a></td><td class="printindex-index-section"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr>
6333 <tr><td></td><td class="printindex-index-entry"><a href="#index-virtual_002dfonts_002eknuth"><code>virtual-fonts.knuth</code></a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6334 <tr><td></td><td class="printindex-index-entry"><a href="#index-virtualfonts_002etxt"><code>virtualfonts.txt</code></a></td><td class="printindex-index-section"><a href="#Font-file-formats">Font file formats</a></td></tr>
6335 <tr><td></td><td class="printindex-index-entry"><a href="#index-vptovf"><code>vptovf</code></a></td><td class="printindex-index-section"><a href="#vptovf-invocation">vptovf invocation</a></td></tr>
6336 <tr><td colspan="3"><hr></td></tr>
6337 <tr><th id="Index_cp_letter-W">W</th></tr>
6338 <tr><td></td><td class="printindex-index-entry"><a href="#index-weave"><code>weave</code></a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
6339 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEB">WEB</a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
6340 <tr><td></td><td class="printindex-index-entry"><a href="#index-web-environments_002c-and-security">web environments, and security</a></td><td class="printindex-index-section"><a href="#Shell-escapes">Shell escapes</a></td></tr>
6341 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEB-pool-files_002c-displaying">WEB pool files, displaying</a></td><td class="printindex-index-section"><a href="#pooltype-invocation">pooltype invocation</a></td></tr>
6342 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEB-programs_002c-compiling">WEB programs, compiling</a></td><td class="printindex-index-section"><a href="#tangle-invocation">tangle invocation</a></td></tr>
6343 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEB-programs_002c-typesetting">WEB programs, typesetting</a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
6344 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEB2C_002c-search-path-for-TCX-files"><code>WEB2C<span class="r">, search path for TCX files</span></code></a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6345 <tr><td></td><td class="printindex-index-entry"><a href="#index-Weber_002c-Olaf">Weber, Olaf</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
6346 <tr><td></td><td class="printindex-index-entry"><a href="#index-webmac_002etex"><code>webmac.tex</code></a></td><td class="printindex-index-section"><a href="#weave-invocation">weave invocation</a></td></tr>
6347 <tr><td></td><td class="printindex-index-entry"><a href="#index-webman_002etex"><code>webman.tex</code></a></td><td class="printindex-index-section"><a href="#WEB">WEB</a></td></tr>
6348 <tr><td></td><td class="printindex-index-entry"><a href="#index-whitespace_002dterminated-filenames">whitespace-terminated filenames</a></td><td class="printindex-index-section"><a href="#g_t_005cinput-filenames">\input filenames</a></td></tr>
6349 <tr><td></td><td class="printindex-index-entry"><a href="#index-whitespace_002c-in-TCX-files">whitespace, in TCX files</a></td><td class="printindex-index-section"><a href="#TCX-files">TCX files</a></td></tr>
6350 <tr><td></td><td class="printindex-index-entry"><a href="#index-width_002c-device_002dindependent">width, device-independent</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6351 <tr><td></td><td class="printindex-index-entry"><a href="#index-width_002c-device_002dindependent-1">width, device-independent</a></td><td class="printindex-index-section"><a href="#gftype-invocation">gftype invocation</a></td></tr>
6352 <tr><td></td><td class="printindex-index-entry"><a href="#index-width_002c-in-pixels">width, in pixels</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6353 <tr><td></td><td class="printindex-index-entry"><a href="#index-win32win"><code>win32win</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6354 <tr><td></td><td class="printindex-index-entry"><a href="#index-word-processor_002c-not">word processor, not</a></td><td class="printindex-index-section"><a href="#TeX">TeX</a></td></tr>
6355 <tr><td></td><td class="printindex-index-entry"><a href="#index-writing-memory-dumps">writing memory dumps</a></td><td class="printindex-index-section"><a href="#Creating-memory-dumps">Creating memory dumps</a></td></tr>
6356 <tr><td colspan="3"><hr></td></tr>
6357 <tr><th id="Index_cp_letter-X">X</th></tr>
6358 <tr><td></td><td class="printindex-index-entry"><a href="#index-X-bitmap-fonts">X bitmap fonts</a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6359 <tr><td></td><td class="printindex-index-entry"><a href="#index-X-class-name-for-Metafont">X class name for Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6360 <tr><td></td><td class="printindex-index-entry"><a href="#index-x-offset">x offset</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6361 <tr><td></td><td class="printindex-index-entry"><a href="#index-X-resources">X resources</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6362 <tr><td></td><td class="printindex-index-entry"><a href="#index-X-server_002c-and-Metafont">X server, and Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6363 <tr><td></td><td class="printindex-index-entry"><a href="#index-X-toolkits-and-Metafont">X toolkits and Metafont</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6364 <tr><td></td><td class="printindex-index-entry"><a href="#index-xampl_002ebib"><code>xampl.bib</code></a></td><td class="printindex-index-section"><a href="#bibtex-invocation">bibtex invocation</a></td></tr>
6365 <tr><td></td><td class="printindex-index-entry"><a href="#index-xbfe_002c-bitmap-font-editor"><code>xbfe<span class="r">, bitmap font editor</span></code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6366 <tr><td></td><td class="printindex-index-entry"><a href="#index-XeTeX">XeTeX</a></td><td class="printindex-index-section"><a href="#TeX-extensions">TeX extensions</a></td></tr>
6367 <tr><td></td><td class="printindex-index-entry"><a href="#index-xfed_002c-bitmap-font-editor"><code>xfed<span class="r">, bitmap font editor</span></code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6368 <tr><td></td><td class="printindex-index-entry"><a href="#index-xfedor_002c-bitmap-font-editor"><code>xfedor<span class="r">, bitmap font editor</span></code></a></td><td class="printindex-index-section"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr>
6369 <tr><td></td><td class="printindex-index-entry"><a href="#index-Xlib"><code>Xlib</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6370 <tr><td></td><td class="printindex-index-entry"><a href="#index-Xlib-support">Xlib support</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6371 <tr><td></td><td class="printindex-index-entry"><a href="#index-Xt"><code>Xt</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6372 <tr><td></td><td class="printindex-index-entry"><a href="#index-Xt-support">Xt support</a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6373 <tr><td></td><td class="printindex-index-entry"><a href="#index-xterm"><code>xterm</code></a></td><td class="printindex-index-section"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr>
6374 <tr><td colspan="3"><hr></td></tr>
6375 <tr><th id="Index_cp_letter-Y">Y</th></tr>
6376 <tr><td></td><td class="printindex-index-entry"><a href="#index-y-offset">y offset</a></td><td class="printindex-index-section"><a href="#pktype-invocation">pktype invocation</a></td></tr>
6377 <tr><td colspan="3"><hr></td></tr>
6378 </table>
6379 <table class="cp-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a>
6380 &nbsp;
6381 <a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>.</b></a>
6382 &nbsp;
6383 <a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>&quot;</b></a>
6384 &nbsp;
6385 <a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>\</b></a>
6386 &nbsp;
6387 <a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>#</b></a>
6388 &nbsp;
6389 <a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>%</b></a>
6390 &nbsp;
6391 <a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>^</b></a>
6392 &nbsp;
6393 <a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>~</b></a>
6394 &nbsp;
6395 <a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>$</b></a>
6396 &nbsp;
6397 <a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>2</b></a>
6398 &nbsp;
6399 <a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>3</b></a>
6400 &nbsp;
6401 <a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>6</b></a>
6402 &nbsp;
6403 <a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a>
6404 &nbsp;
6405 <br>
6406 <a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
6407 &nbsp;
6408 <a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
6409 &nbsp;
6410 <a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
6411 &nbsp;
6412 <a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
6413 &nbsp;
6414 <a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
6415 &nbsp;
6416 <a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
6417 &nbsp;
6418 <a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
6419 &nbsp;
6420 <a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
6421 &nbsp;
6422 <a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
6423 &nbsp;
6424 <a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a>
6425 &nbsp;
6426 <a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a>
6427 &nbsp;
6428 <a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
6429 &nbsp;
6430 <a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
6431 &nbsp;
6432 <a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
6433 &nbsp;
6434 <a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
6435 &nbsp;
6436 <a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
6437 &nbsp;
6438 <a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
6439 &nbsp;
6440 <a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
6441 &nbsp;
6442 <a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
6443 &nbsp;
6444 <a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
6445 &nbsp;
6446 <a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a>
6447 &nbsp;
6448 <a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a>
6449 &nbsp;
6450 <a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
6451 &nbsp;
6452 <a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a>
6453 &nbsp;
6454 <a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a>
6455 &nbsp;
6456 </td></tr></table>
6457 </div>
6458
6459 </div>
6460 </div>
6461
6462
6463
6464 </body>
6465 </html>