| 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> [<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"> ¶</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 "some name"</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> [<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"> ¶</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 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—“free” 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 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> [<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"> ¶</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> [<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"> ¶</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 ‘<samp class="samp">--with</samp>’ and |
| 372 |
‘<samp class="samp">--enable</samp>’ <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 |
‘<samp class="samp">configure --help</samp>’. 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>‘<samp class="samp">--disable-dump-share</samp>’</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>‘<samp class="samp">--without-maketexmf-default</samp>’</dt> |
| 390 |
<dt>‘<samp class="samp">--without-maketexpk-default</samp>’</dt> |
| 391 |
<dt>‘<samp class="samp">--without-maketextfm-default</samp>’</dt> |
| 392 |
<dt>‘<samp class="samp">--with-maketextex-default</samp>’</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>‘<samp class="samp">--enable-shared</samp>’</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>‘<samp class="samp">--with-editor=<var class="var">cmd</var></samp>’</dt> |
| 403 |
<dd><p>Change the default editor invoked by the ‘<samp class="samp">e</samp>’ interactive command. |
| 404 |
See <a class="xref" href="#Editor-invocation">Editor invocation</a>. |
| 405 |
</p> |
| 406 |
</dd> |
| 407 |
<dt>‘<samp class="samp">--with-epsfwin</samp>’</dt> |
| 408 |
<dt>‘<samp class="samp">--with-hp2627win</samp>’</dt> |
| 409 |
<dt>‘<samp class="samp">--with-mftalkwin</samp>’</dt> |
| 410 |
<dt>‘<samp class="samp">--with-nextwin</samp>’</dt> |
| 411 |
<dt>‘<samp class="samp">--with-regiswin</samp>’</dt> |
| 412 |
<dt>‘<samp class="samp">--with-suntoolswin</samp>’</dt> |
| 413 |
<dt>‘<samp class="samp">--with-tektronixwin</samp>’</dt> |
| 414 |
<dt>‘<samp class="samp">--with-unitermwin</samp>’</dt> |
| 415 |
<dt>‘<samp class="samp">--with-x</samp>’</dt> |
| 416 |
<dt>‘<samp class="samp">--with-x-toolkit=KIT</samp>’</dt> |
| 417 |
<dt>‘<samp class="samp">--with-x11win</samp>’</dt> |
| 418 |
<dt>‘<samp class="samp">--with-x11</samp>’</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>‘<samp class="samp">--x-includes=<var class="var">dir</var></samp>’</dt> |
| 424 |
<dt>‘<samp class="samp">--x-libraries=<var class="var">dir</var></samp>’</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> [<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"> ¶</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 (‘<samp class="samp">-D<var class="var">name</var></samp>’ in this case), the |
| 449 |
simplest thing to do is: |
| 450 |
</p><div class="example"> |
| 451 |
<pre class="example-preformatted">make XCFLAGS="<var class="var">ccoptions</var>" |
| 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>‘<samp class="samp">-DFIXPT</samp>’<a class="copiable-link" href="#index-FIXPT"> ¶</a></span></dt> |
| 464 |
<dt>‘<samp class="samp">-DNO_MF_ASM</samp>’</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 |
‘<samp class="samp">NO_MF_ASM</samp>’ is defined), and floating-point routines are used |
| 469 |
otherwise. |
| 470 |
</p> |
| 471 |
</dd> |
| 472 |
<dt><a id="index-IPC_005fDEBUG"></a><span>‘<samp class="samp">-DIPC_DEBUG</samp>’<a class="copiable-link" href="#index-IPC_005fDEBUG"> ¶</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> [<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"> ¶</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>‘<samp class="samp">c-sources</samp>’<a class="copiable-link" href="#index-c_002dsources-Makefile-target"> ¶</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>‘<samp class="samp">formats</samp>’<a class="copiable-link" href="#index-formats-Make-target"> ¶</a></span></dt> |
| 505 |
<dt>‘<samp class="samp">install-formats</samp>’</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>‘<samp class="samp">fmts</samp>’<a class="copiable-link" href="#index-fmts-Make-target"> ¶</a></span></dt> |
| 515 |
<dt>‘<samp class="samp">install-fmts</samp>’</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>‘<samp class="samp">bases</samp>’<a class="copiable-link" href="#index-bases-Make-target"> ¶</a></span></dt> |
| 521 |
<dt>‘<samp class="samp">install-bases</samp>’</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>‘<samp class="samp">mems</samp>’<a class="copiable-link" href="#index-mems-Make-target"> ¶</a></span></dt> |
| 528 |
<dt>‘<samp class="samp">install-mems</samp>’</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>‘<samp class="samp">triptrap</samp>’<a class="copiable-link" href="#index-triptrap-Make-target"> ¶</a></span></dt> |
| 536 |
<dt>‘<samp class="samp">trip</samp>’</dt> |
| 537 |
<dt>‘<samp class="samp">trap</samp>’</dt> |
| 538 |
<dt>‘<samp class="samp">mptrap</samp>’</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> [<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"> ¶</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 |
‘<samp class="samp">make triptrap</samp>’. This runs the trip, trap, and mptrap “torture |
| 566 |
tests”. 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’ 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>‘<samp class="samp">down4</samp>’, ‘<samp class="samp">right4</samp>’, and ‘<samp class="samp">y4</samp>’ 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 >&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 ‘<samp class="samp">make check</samp>’. 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> [<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"> ¶</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> [<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"> ¶</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 ‘<samp class="samp">-</samp>’ or ‘<samp class="samp">--</samp>’ 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 ‘<samp class="samp">=</samp>’ 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 ‘<samp class="samp">--</samp>’. |
| 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 |
‘<samp class="samp">foo</samp>’, ‘<samp class="samp">bar</samp>’, and ‘<samp class="samp">verbose</samp>’; gives the value ‘<samp class="samp">baz</samp>’ |
| 670 |
to the ‘<samp class="samp">abc</samp>’ option, and the value ‘<samp class="samp">xyz</samp>’ to the ‘<samp class="samp">quux</samp>’ |
| 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> [<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"> ¶</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 ‘<samp class="samp">--help</samp>’ and |
| 689 |
‘<samp class="samp">--version</samp>’ options, and several programs accept |
| 690 |
‘<samp class="samp">--verbose</samp>’. 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>‘<samp class="samp">--help</samp>’<a class="copiable-link" href="#index-_002d_002dhelp-common-option"> ¶</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>‘<samp class="samp">--verbose</samp>’<a class="copiable-link" href="#index-_002d_002dverbose-common-option"> ¶</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>‘<samp class="samp">--version</samp>’<a class="copiable-link" href="#index-_002d_002dversion-common-option"> ¶</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>‘<samp class="samp">-cnf-line=<var class="var">str</var></samp>’<a class="copiable-link" href="#index-_002dcnf_002dline"> ¶</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>‘<samp class="samp">-file-line-error</samp>’<a class="copiable-link" href="#index-_002dno_002dfile_002dline_002derror"> ¶</a></span></dt> |
| 724 |
<dd><a class="index-entry-id" id="index-_002dfile_002dline_002derror"></a> |
| 725 |
</dd> |
| 726 |
<dt>‘<samp class="samp">-no-file-line-error</samp>’</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 ‘<samp class="samp">-file-line-error-style</samp>’. |
| 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>‘<samp class="samp">-fmt=<var class="var">dumpname</var></samp>’<a class="copiable-link" href="#index-_002dfmt_003ddumpname"> ¶</a></span></dt> |
| 737 |
<dt>‘<samp class="samp">-base=<var class="var">dumpname</var></samp>’</dt> |
| 738 |
<dt>‘<samp class="samp">-mem=<var class="var">dumpname</var></samp>’</dt> |
| 739 |
<dd><p>Use <var class="var">dumpname</var> instead of the program name or a ‘<samp class="samp">%&</samp>’ line to |
| 740 |
determine the name of the memory dump file read (‘<samp class="samp">fmt</samp>’ for TeX, |
| 741 |
‘<samp class="samp">base</samp>’ for Metafont, ‘<samp class="samp">mem</samp>’ 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 |
‘<samp class="samp">-progname</samp>’ 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>‘<samp class="samp">-halt-on-error</samp>’<a class="copiable-link" href="#index-_002dhalt_002don_002derror"> ¶</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>‘<samp class="samp">-ini</samp>’<a class="copiable-link" href="#index-_002dini"> ¶</a></span></dt> |
| 754 |
<dd><p>Enable the “initial” 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>‘<samp class="samp">-interaction=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002dinteraction_003dstring"> ¶</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 ‘<samp class="samp">batchmode</samp>’, ‘<samp class="samp">nonstopmode</samp>’, ‘<samp class="samp">scrollmode</samp>’, or |
| 762 |
‘<samp class="samp">errorstopmode</samp>’. |
| 763 |
</p> |
| 764 |
</dd> |
| 765 |
<dt><a class="index-entry-id" id="index-job-name"></a> |
| 766 |
<a id="index-_002djobname_003dstring"></a><span>‘<samp class="samp">-jobname=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002djobname_003dstring"> ¶</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>‘<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>’<a class="copiable-link" href="#index-_002dkpathsea_002ddebug_003dnumber"> ¶</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 ‘<samp class="samp">-1</samp>’, |
| 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>‘<samp class="samp">-output-directory=<var class="var">dirname</var></samp>’<a class="copiable-link" href="#index-_002doutput_002ddirectory"> ¶</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>‘<samp class="samp">-parse-first-line</samp>’<a class="copiable-link" href="#index-_002dno_002dparse_002dfirst_002dline"> ¶</a></span></dt> |
| 792 |
<dd><a class="index-entry-id" id="index-_002dparse_002dfirst_002dline"></a> |
| 793 |
</dd> |
| 794 |
<dt>‘<samp class="samp">-no-parse-first-line</samp>’</dt> |
| 795 |
<dd><p>Check or disable checking whether the first line of the main input |
| 796 |
file starts with ‘<samp class="samp">%&</samp>’, 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>‘<samp class="samp">-progname=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002dprogname_003dstring"> ¶</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>‘<samp class="samp">-recorder</samp>’<a class="copiable-link" href="#index-_002drecorder"> ¶</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 ‘<samp class="samp">.fls</samp>’. For |
| 814 |
Aleph, this option is always on, and the file has extension ‘<samp class="samp">.ofl</samp>’. |
| 815 |
</p> |
| 816 |
<a class="index-entry-id" id="index-pid_002c-used-in-recorder-filename"></a> |
| 817 |
<p>Ordinarily, the ‘<samp class="samp">.fls</samp>’ file is written to the same location as |
| 818 |
the ‘<samp class="samp">.log</samp>’ 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 ‘<samp class="samp">**</samp>’ prompt), the ‘<samp class="samp">.fls</samp>’ 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>‘<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>’<a class="copiable-link" href="#index-_002dtranslate_002dfile_003dtcxfile"> ¶</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 ‘<samp class="samp">%& -translate-file=<var class="var">tcxfile</var></samp>’. |
| 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>‘<samp class="samp">-8bit</samp>’<a class="copiable-link" href="#index-_002d8bit"> ¶</a></span></dt> |
| 841 |
<dd><p>This option specifies that by default all characters should be |
| 842 |
considered printable. If ‘<samp class="samp">-translate-file</samp>’ 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> [<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"> ¶</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…</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, ‘<samp class="samp">Times-Roman</samp>’ for ‘<samp class="samp">ptmr8r.tfm</samp>’. |
| 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> [<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"> ¶</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 ‘<samp class="samp">tex /tmp/foo</samp>’, 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 ‘<samp class="samp">.tex</samp>’, 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: ‘<samp class="samp">-output-directory</samp>’ option<a class="copiable-link" href="#Override-1_003a-_002doutput_002ddirectory-option"> ¶</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 ‘<samp class="samp">-output-directory</samp>’ 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"> ¶</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 ‘<samp class="samp">-output-directory</samp>’ 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 ‘<samp class="samp">-output-directory</samp>’ 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"> ¶</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 ‘<samp class="samp">-output-directory</samp>’ 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’t |
| 964 |
generate an error until TeX tries to write the log file:<br> ‘<samp class="samp">! |
| 965 |
I can't write on file `texput.log'.</samp>’. |
| 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> [<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"> ¶</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> [<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"> ¶</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>‘<samp class="samp">main_memory</samp>’<a class="copiable-link" href="#index-main_005fmemory"> ¶</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>‘<samp class="samp">extra_mem_bot</samp>’<a class="copiable-link" href="#index-extra_005fmem_005fbot"> ¶</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 “large” 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>‘<samp class="samp">expand_depth</samp>’<a class="copiable-link" href="#index-expand_005fdepth"> ¶</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’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’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>‘<samp class="samp">texmf_casefold_search</samp>’<a class="copiable-link" href="#index-texmf_005fcasefold_005fsearch"> ¶</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’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> [<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"> ¶</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 ‘<samp class="samp">-ini</samp>’ 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 ‘<samp class="samp">%&ini</samp>’; |
| 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> [<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"> ¶</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> [<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"> ¶</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>(‘<samp class="samp">.fmt</samp>’) See <a class="xref" href="#Initial-TeX">Initial TeX</a>. |
| 1187 |
</p> |
| 1188 |
</dd> |
| 1189 |
<dt>Metafont</dt> |
| 1190 |
<dd><p>(‘<samp class="samp">.base</samp>’) 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 ‘<samp class="samp">.mem</samp>’, |
| 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> [<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"> ¶</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 ‘<samp class="samp">&</samp>’, the |
| 1223 |
program uses the remainder of that argument as the memory dump name. |
| 1224 |
For example, running ‘<samp class="samp">tex \&super</samp>’ reads <samp class="file">super.fmt</samp>. The |
| 1225 |
backslash merely protects the ‘<samp class="samp">&</samp>’ against interpretation by the |
| 1226 |
shell; quotes could also be used. TeX must see only the ‘<samp class="samp">&</samp>’. |
| 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 ‘<samp class="samp">-fmt</samp>’ resp. ‘<samp class="samp">-base</samp>’ 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 ‘<samp class="samp">-progname</samp>’ 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 ‘<samp class="samp">**</samp>’ prompt) is |
| 1239 |
<code class="code">%&<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">%&-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">%&<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 ‘<samp class="samp">latex foo</samp>’, <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> [<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"> ¶</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 ‘<samp class="samp">--disable-dump-share</samp>’ 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’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’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 ‘<samp class="samp">--disable-dump-share</samp>’, 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, …) 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’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’t know what endianness your machine is, and you’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&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 ("LittleEndian\n"); |
| 1358 |
else if (u.c[sizeof (long) - 1] == 1) |
| 1359 |
printf ("BigEndian\n"); |
| 1360 |
else |
| 1361 |
printf ("unknownEndian"); |
| 1362 |
|
| 1363 |
exit (u.c[sizeof (long) - 1] == 1); |
| 1364 |
} |
| 1365 |
</pre></div> |
| 1366 |
|
| 1367 |
<p>You can add <code class="code">printf("long %d\n", 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> [<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"> ¶</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 ‘<samp class="samp">--with-editor=<var class="var">cmd</var></samp>’ 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 ‘<samp class="samp">--with-editor</samp>’ 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, ‘<samp class="samp">%d</samp>’ is replaced by the line number of the error, |
| 1403 |
and ‘<samp class="samp">%s</samp>’ 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> [<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"> ¶</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 ‘<samp class="samp">;</samp>’ 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’s conditions), |
| 1437 |
Web2c also supports specifying the filename in double quotes |
| 1438 |
(<code class="code">"some name"</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">"</code>) characters are ignored within the |
| 1447 |
filename; there is no way to read files whose names contain a <code class="code">"</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 ‘<samp class="samp">a</samp>’–‘<samp class="samp">z</samp>’, ‘<samp class="samp">0</samp>’–‘<samp class="samp">9</samp>’, and at most one |
| 1452 |
‘<samp class="samp">.</samp>’. 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 "some name"</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> [<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 "some name"</code><a class="copiable-link" href="#g_t_005cinput-quoted-filename_003a-_005cinput-_0022some-name_0022"> ¶</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 |
‘<samp class="samp">"</samp>’ characters surround the entire filename: |
| 1477 |
</p><div class="example"> |
| 1478 |
<pre class="example-preformatted">\input "filename with spaces" |
| 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" "with" "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{"a b"} % 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 "some name"</code></a>, Up: <a href="#g_t_005cinput-filenames" accesskey="u" rel="up"><code class="code">\input</code> filenames</a> [<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"> ¶</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 1 (begin group), and it is matched with the |
| 1520 |
next character of catcode 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">"</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> [<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"> ¶</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 ‘<samp class="samp">~</samp>’ 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 ‘<samp class="samp">CON</samp>’, |
| 1564 |
‘<samp class="samp">NUL</samp>’, ‘<samp class="samp">COM1</samp>’, ‘<samp class="samp">con.tex</samp>’, 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 ‘<samp class="samp">~</samp>’ and ‘<samp class="samp">$</samp>’ |
| 1571 |
expansion on <var class="var">name</var>, on all platforms, unlike Knuth’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 ‘<samp class="samp">foo</samp>’ and read that file, extended with ‘<samp class="samp">.bar</samp>’, in |
| 1580 |
user ‘<samp class="samp">jsmith</samp>’’s home directory. You can also use braces in the |
| 1581 |
variable expansion, as in ‘<samp class="samp">${foo}bar</samp>’, if you want to follow |
| 1582 |
the variable name with a letter, numeral, or ‘<samp class="samp">_</samp>’. |
| 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 |
…), the characters ‘<samp class="samp">~</samp>’ and ‘<samp class="samp">$</samp>’ 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> [<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"> ¶</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 |
“word processor”: 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> [<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"> ¶</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>]... &<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 ‘<samp class="samp">**</samp>’ prompt, and then processes the |
| 1664 |
result as normal TeX input, including expansion. |
| 1665 |
</p> |
| 1666 |
<p>The most common invocation is ‘<samp class="samp">tex somefile</samp>’, which reads |
| 1667 |
‘<samp class="samp">somefile.tex</samp>’, 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 |
‘<samp class="samp">-1</samp>’ 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 ‘<samp class="samp">**</samp>’. Whatever input is given in response to |
| 1690 |
‘<samp class="samp">**</samp>’ 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’s normal macro expansion. As a result, a |
| 1696 |
‘<samp class="samp">~</samp>’ character is normally not usable within a filename, since by |
| 1697 |
default ‘<samp class="samp">~</samp>’ is defined (in plain TeX, LaTeX, etc.) to be |
| 1698 |
an active character that expands into several primitive tokens that |
| 1699 |
can’t be part of a filename. As a special case in Web2c, a ‘<samp class="samp">~</samp>’ |
| 1700 |
<em class="emph">beginning</em> a filename refers to a user’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 ‘<samp class="samp">~</samp>’ character rather than the expansion of ‘<samp class="samp">~</samp>’. |
| 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>‘<samp class="samp">tex foo</samp>’ executes ‘<samp class="samp">\input foo</samp>’. |
| 1709 |
|
| 1710 |
</li><li>‘<samp class="samp">tex foo bar</samp>’ executes ‘<samp class="samp">\input foo bar</samp>’, which inputs |
| 1711 |
<samp class="file">foo.tex</samp> and then typesets ‘<samp class="samp">bar</samp>’. |
| 1712 |
|
| 1713 |
</li><li>‘<samp class="samp">tex \\end</samp>’ executes ‘<samp class="samp">\end</samp>’; 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>‘<samp class="samp">tex</samp>’ with no arguments prints a ‘<samp class="samp">**</samp>’ prompt. |
| 1718 |
Entering ‘<samp class="samp">foo bar</samp>’ at the ‘<samp class="samp">**</samp>’ prompt again executes |
| 1719 |
‘<samp class="samp">\input foo</samp>’ and typesets ‘<samp class="samp">bar</samp>’. |
| 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 ‘<samp class="samp">texput</samp>’ 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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (see <a class="pxref" href="#Common-options">Common options</a>): |
| 1736 |
</p> |
| 1737 |
<dl class="table"> |
| 1738 |
<dt>‘<samp class="samp">-enc</samp>’</dt> |
| 1739 |
<dt>‘<samp class="samp">-[no]-file-line-error</samp>’</dt> |
| 1740 |
<dt>‘<samp class="samp">-fmt=<var class="var">fmtname</var></samp>’</dt> |
| 1741 |
<dt>‘<samp class="samp">-halt-on-error</samp>’</dt> |
| 1742 |
<dt>‘<samp class="samp">-ini</samp>’</dt> |
| 1743 |
<dt>‘<samp class="samp">-interaction=<var class="var">string</var></samp>’</dt> |
| 1744 |
<dt>‘<samp class="samp">-ipc</samp>’</dt> |
| 1745 |
<dt>‘<samp class="samp">-ipc-start</samp>’</dt> |
| 1746 |
<dt>‘<samp class="samp">-jobname=<var class="var">string</var></samp>’</dt> |
| 1747 |
<dt>‘<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>’</dt> |
| 1748 |
<dt>‘<samp class="samp">-[no]parse-first-line</samp>’</dt> |
| 1749 |
<dt>‘<samp class="samp">-output-directory</samp>’</dt> |
| 1750 |
<dt>‘<samp class="samp">-progname=<var class="var">string</var></samp>’</dt> |
| 1751 |
<dt>‘<samp class="samp">-recorder</samp>’</dt> |
| 1752 |
<dt>‘<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>’</dt> |
| 1753 |
<dt>‘<samp class="samp">-8bit</samp>’</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>‘<samp class="samp">-enc</samp>’<a class="copiable-link" href="#index-_002denc"> ¶</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>‘<samp class="samp">-ipc</samp>’<a class="copiable-link" href="#index-_002dipc"> ¶</a></span></dt> |
| 1770 |
<dt>‘<samp class="samp">-ipc-start</samp>’</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 ‘<samp class="samp">-ipc-start</samp>’, 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 ‘<samp class="samp">--enable-ipc</samp>’ 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>‘<samp class="samp">-mktex=<var class="var">filetype</var></samp>’<a class="copiable-link" href="#index-_002dmktex_003dfiletype"> ¶</a></span></dt> |
| 1781 |
<dt>‘<samp class="samp">-no-mktex=<var class="var">filetype</var></samp>’</dt> |
| 1782 |
<dd><p>Turn on or off the ‘<samp class="samp">mktex</samp>’ script associated with <var class="var">filetype</var>. |
| 1783 |
For TeX proper, <var class="var">filetype</var> can only be ‘<samp class="samp">tex</samp>’ and |
| 1784 |
‘<samp class="samp">tfm</samp>’, but for pdfTeX and LuaTeX, it can also be ‘<samp class="samp">pk</samp>’. |
| 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>‘<samp class="samp">-mltex</samp>’<a class="copiable-link" href="#index-_002dmltex"> ¶</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>‘<samp class="samp">-output-comment=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002doutput_002dcomment_003dstring"> ¶</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 ‘<samp class="samp">output_comment</samp>’. |
| 1804 |
</p> |
| 1805 |
</dd> |
| 1806 |
<dt><a id="index-_002dshell_002drestricted"></a><span>‘<samp class="samp">-shell-escape</samp>’<a class="copiable-link" href="#index-_002dshell_002drestricted"> ¶</a></span></dt> |
| 1807 |
<dd><a class="index-entry-id" id="index-_002dshell_002descape"></a> |
| 1808 |
</dd> |
| 1809 |
<dt>‘<samp class="samp">-no-shell-escape</samp>’</dt> |
| 1810 |
<dd><a class="index-entry-id" id="index-_002dno_002dshell_002descape"></a> |
| 1811 |
</dd> |
| 1812 |
<dt>‘<samp class="samp">-shell-restricted</samp>’</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>‘<samp class="samp">-enable-write18</samp>’<a class="copiable-link" href="#index-_002ddisable_002dwrite18"> ¶</a></span></dt> |
| 1819 |
<dd><a class="index-entry-id" id="index-_002denable_002dwrite18"></a> |
| 1820 |
</dd> |
| 1821 |
<dt>‘<samp class="samp">-disable-write18</samp>’</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>‘<samp class="samp">-src-specials</samp>’<a class="copiable-link" href="#index-generating-source-specials"> ¶</a></span></dt> |
| 1828 |
<dt>‘<samp class="samp">-src-specials=<var class="var">string</var></samp>’</dt> |
| 1829 |
<dd><p>This option makes TeX output specific source information using |
| 1830 |
‘<samp class="samp">\special</samp>’ commands in the DVI file. These ‘<samp class="samp">\special</samp>’ track |
| 1831 |
the current filename and line number. |
| 1832 |
</p> |
| 1833 |
<p>Using the first form of this option, the ‘<samp class="samp">\special</samp>’ 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: ‘<samp class="samp">cr</samp>’, |
| 1838 |
‘<samp class="samp">display</samp>’, ‘<samp class="samp">hbox</samp>’, ‘<samp class="samp">math</samp>’, ‘<samp class="samp">par</samp>’, ‘<samp class="samp">parend</samp>’, |
| 1839 |
‘<samp class="samp">vbox</samp>’. You can use this list to specify where you want TeX to |
| 1840 |
output such commands. For example, ‘<samp class="samp">-src-specials=cr,math</samp>’ 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 ‘<samp class="samp">\special</samp>’ 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’t count |
| 1853 |
on it. |
| 1854 |
</p> |
| 1855 |
<p>Redefining ‘<samp class="samp">\special</samp>’ will not affect the functioning of this |
| 1856 |
option. The commands inserted into the token stream are |
| 1857 |
hard-coded to always use the ‘<samp class="samp">\special</samp>’ 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>: ‘<samp class="samp">a</samp>’ (for |
| 1893 |
“any”, the default for <code class="code">openin_any</code>), ‘<samp class="samp">r</samp>’ (for |
| 1894 |
“restricted”), or ‘<samp class="samp">p</samp>’ (for “paranoid”, 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> [<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"> ¶</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 ‘<samp class="samp">tex -ini</samp>’. It |
| 1918 |
does lengthy initializations avoided by the “virgin” (<code class="code">vir</code>) |
| 1919 |
form, so as to be capable of dumping ‘<samp class="samp">.fmt</samp>’ 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 ‘<samp class="samp">plain.fmt</samp>’, also known as |
| 1930 |
‘<samp class="samp">tex.fmt</samp>’ (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> [<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"> ¶</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"> ¶</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 ‘LaTeX 2.09’, 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 |
“emphasize”, instead of specific typesetting instructions, such as |
| 1978 |
“use the 10<span class="dmn">pt</span> Computer Modern italic font”. 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"> ¶</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"> ¶</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"> ¶</a></span></dt> |
| 2006 |
<dd><p>An “expanded plain” 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"> ¶</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"> ¶</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’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"> ¶</a></span></dt> |
| 2038 |
<dd><p>An obsolete LaTeX 2.09 format for making slides. In core |
| 2039 |
LaTeX2e, it is replaced by the ‘<samp class="samp">slides</samp>’ document class. As of |
| 2040 |
2025, the ‘<samp class="samp">ltx-talk</samp>’ 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 ‘<samp class="samp">beamer</samp>’ 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> [<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"> ¶</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> [<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"> ¶</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 ‘<samp class="samp">-mltex</samp>’ 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> [<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"> ¶</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">"65</code> for hex, <code class="t">101</code> for decimal. |
| 2141 |
</p> |
| 2142 |
<p>MLTeX’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 ‘e’ 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 ‘e’ 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> [<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"> ¶</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 ‘<samp class="samp">\charsubdef</samp>’, 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> [<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"> ¶</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’s original ideas for |
| 2234 |
the use of the ‘<samp class="samp">xchr</samp>’ and ‘<samp class="samp">xord</samp>’ 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’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">%& -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 ‘<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>’. |
| 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. 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’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—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 |
⇒ terminal etc. output with 8-bit chars |
| 2296 |
latex --translate-file=empty.tcx somefile8.tex |
| 2297 |
⇒ 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 ‘<samp class="samp">%</samp>’ 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 ‘<samp class="samp">0</samp>’, |
| 2324 |
hexadecimal with a leading ‘<samp class="samp">0x</samp>’, 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’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 “printable”, i.e., printed as-is in diagnostics and the |
| 2339 |
log file rather than in ‘<samp class="samp">^^</samp>’ 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–127) will yield unpredictable results. Additionally you shouldn’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 ‘<samp class="samp">-8bit</samp>’ option, all characters are |
| 2358 |
considered printable by default. If you specify both the ‘<samp class="samp">-8bit</samp>’ |
| 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 ‘<samp class="samp">-ini</samp>’, you control the defaults seen |
| 2365 |
by anyone who uses the resulting dump file. |
| 2366 |
</p> |
| 2367 |
<p>When loading a dump, if the ‘<samp class="samp">-8bit</samp>’ 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> [<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"> ¶</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 ‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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> [<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"> ¶</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 ‘<samp class="samp">t</samp>’ or |
| 2437 |
‘<samp class="samp">y</samp>’ and ‘<samp class="samp">1</samp>’. |
| 2438 |
|
| 2439 |
</li><li>Restricted shell escapes are allowed if <code class="code">shell_escape</code> is set to |
| 2440 |
‘<samp class="samp">p</samp>’. 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 "hello, world"} |
| 2451 |
</pre></div> |
| 2452 |
|
| 2453 |
<a class="index-entry-id" id="index-_005coutput-routine_002c-and-_005cwrite"></a> |
| 2454 |
<p>From TeX’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 ‘<samp class="samp">\output</samp>’ 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">"</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 ‘<samp class="samp">|</samp>’. 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 “paranoid” 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> [<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"> ¶</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 ‘<samp class="samp">--enable-ipc</samp>’ 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 ‘<samp class="samp">make |
| 2540 |
XCFLAGS=-DIPC_DEBUG</samp>’), 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> [<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"> ¶</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’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"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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> [<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"> ¶</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> [<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"> ¶</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>]... &<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 ‘<samp class="samp">-1</samp>’ |
| 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 ‘<samp class="samp">mfput</samp>’ 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—<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 “magstep”, 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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (see <a class="pxref" href="#Common-options">Common options</a>): |
| 2787 |
</p><dl class="table"> |
| 2788 |
<dt>‘<samp class="samp">-[no]-file-line-error</samp>’</dt> |
| 2789 |
<dt>‘<samp class="samp">-fmt=<var class="var">fmtname</var></samp>’</dt> |
| 2790 |
<dt>‘<samp class="samp">-halt-on-error</samp>’</dt> |
| 2791 |
<dt>‘<samp class="samp">-ini</samp>’</dt> |
| 2792 |
<dt>‘<samp class="samp">-interaction=<var class="var">string</var></samp>’</dt> |
| 2793 |
<dt>‘<samp class="samp">-jobname=<var class="var">string</var></samp>’</dt> |
| 2794 |
<dt>‘<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>’</dt> |
| 2795 |
<dt>‘<samp class="samp">-[no]parse-first-line</samp>’</dt> |
| 2796 |
<dt>‘<samp class="samp">-output-directory</samp>’</dt> |
| 2797 |
<dt>‘<samp class="samp">-progname=<var class="var">string</var></samp>’</dt> |
| 2798 |
<dt>‘<samp class="samp">-recorder</samp>’</dt> |
| 2799 |
<dt>‘<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>’</dt> |
| 2800 |
<dt>‘<samp class="samp">-8bit</samp>’</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>‘<samp class="samp">-mktex=<var class="var">filetype</var></samp>’<a class="copiable-link" href="#index-_002dmktex_003dfiletype-1"> ¶</a></span></dt> |
| 2807 |
<dt>‘<samp class="samp">-no-mktex=<var class="var">filetype</var></samp>’</dt> |
| 2808 |
<dd><p>Turn on or off the ‘<samp class="samp">mktex</samp>’ script associated with <var class="var">filetype</var>. |
| 2809 |
The only value that makes sense for <var class="var">filetype</var> is ‘<samp class="samp">mf</samp>’. |
| 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> [<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"> ¶</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 “initial” form of Metafont, which does lengthy |
| 2829 |
initializations avoided by the “virgin” (<code class="code">vir</code>) form, so as to |
| 2830 |
be capable of dumping ‘<samp class="samp">.base</samp>’ 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 |
‘<samp class="samp">plain.base</samp>’, also known as ‘<samp class="samp">mf.base</samp>’ (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> [<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"> ¶</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’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’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:="newmode.mf"; 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> [<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"> ¶</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 ‘<samp class="samp">:0</samp>’), |
| 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"> ¶</a></span></dt> |
| 2977 |
<dd><a class="index-entry-id" id="index-_002d_002denable_002damigawin"></a> |
| 2978 |
<p>(‘<samp class="samp">--enable-amigawin</samp>’) 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"> ¶</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>(‘<samp class="samp">--enable-epsfwin</samp>’) 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"> ¶</a></span></dt> |
| 2993 |
<dd><a class="index-entry-id" id="index-_002d_002denable_002dhp2627win"></a> |
| 2994 |
<p>(‘<samp class="samp">--enable-hp2627win</samp>’) 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"> ¶</a></span></dt> |
| 2998 |
<dd><a class="index-entry-id" id="index-_002d_002denable_002dmftalkwin"></a> |
| 2999 |
<p>(‘<samp class="samp">--enable-mftalkwin</samp>’) 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"> ¶</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>(‘<samp class="samp">--enable-nextwin</samp>’) 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"> ¶</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>(‘<samp class="samp">--enable-regiswin</samp>’) 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"> ¶</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>(‘<samp class="samp">--enable-suntoolswin</samp>’) 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"> ¶</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>(‘<samp class="samp">--enable-tektronixwin</samp>’) 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"> ¶</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>(‘<samp class="samp">--enable-unitermwin</samp>’) Uniterm, Simon Poole’s emulator of a smart |
| 3037 |
Tektronix 4014 terminal. This may work with regular Tektronix terminals |
| 3038 |
as well; it’s faster than the driver ‘<samp class="samp">--enable-tektronixwin</samp>’ 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"> ¶</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"> ¶</a></span></dt> |
| 3048 |
<dd><a class="index-entry-id" id="index-_002d_002dwith_002dx"></a> |
| 3049 |
<p>‘<samp class="samp">--with-x</samp>’ 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 ‘<samp class="samp">--disable-mf-nowin</samp>’ 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., ‘<samp class="samp">-geometry</samp>’) |
| 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’re using the Xt support, all the usual X toolkit |
| 3079 |
resources are supported. If you’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> [<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"> ¶</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 ‘<samp class="samp">-1</samp>’ before running |
| 3124 |
the program. |
| 3125 |
</p> |
| 3126 |
<p>The suffix ‘<samp class="samp">gf</samp>’ is supplied if not already present. This suffix is |
| 3127 |
not an extension, no ‘<samp class="samp">.</samp>’ 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., ‘<samp class="samp">gftodvi /wherever/foo.600gf</samp>’ 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 |
‘<samp class="samp">-verbose</samp>’, ‘<samp class="samp">-help</samp>’, and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-overflow-label-offset=<var class="var">points</var></samp>’<a class="copiable-link" href="#index-_002doverflow_002dlabel_002doffset_003dpoints"> ¶</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> [<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"> ¶</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 ‘<samp class="samp">-1</samp>’ 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., ‘<samp class="samp">mft /wherever/foo.mf</samp>’ 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 ‘<samp class="samp">%</samp>’ 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 ‘<samp class="samp">% |
| 3233 |
|x2r| is the tip of the bowl</samp>’ will be translated into the TeX |
| 3234 |
‘<samp class="samp">% $x_{2r}$ is the …</samp>’, i.e., the ‘<samp class="samp">x2r</samp>’ is treated as |
| 3235 |
an identifier. |
| 3236 |
|
| 3237 |
</li><li>‘<samp class="samp">%%</samp>’ 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 ‘<samp class="samp">%%\bye</samp>’ at the end of the job. (MFT |
| 3242 |
doesn’t add this automatically in order to allow processing several |
| 3243 |
files produces by MFT in the same TeX job.) |
| 3244 |
|
| 3245 |
</li><li>‘<samp class="samp">%%% <var class="var">token1</var> <var class="var">other-tokens</var></samp>’ |
| 3246 |
introduces a change in MFT’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 ‘<samp class="samp">fill</samp>’, ‘<samp class="samp">draw</samp>’, and ‘<samp class="samp">filldraw</samp>’ |
| 3254 |
operations of plain Metafont just like the primitive token ‘<samp class="samp">addto</samp>’, |
| 3255 |
i.e., in boldface type. Without such reformatting commands, MFT would |
| 3256 |
treat ‘<samp class="samp">fill</samp>’ like an ordinary tag or variable name. In fact, you |
| 3257 |
need a ‘<samp class="samp">%%%</samp>’ command even to get parentheses to act like |
| 3258 |
delimiters. |
| 3259 |
</p> |
| 3260 |
</li><li>‘<samp class="samp">%%%%</samp>’ introduces an MFT comment, i.e., MFT ignores the remainder |
| 3261 |
of such a line. |
| 3262 |
|
| 3263 |
</li><li>Five or more ‘<samp class="samp">%</samp>’ 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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-change=<var class="var">chfile</var>[.ch]</samp>’<a class="copiable-link" href="#index-_002dchange_003dchfile"> ¶</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>‘<samp class="samp">-metapost</samp>’<a class="copiable-link" href="#index-_002dmetapost"> ¶</a></span></dt> |
| 3280 |
<dd><p>Force interpretation of the input as MetaPost; this is the default of |
| 3281 |
the filename extension is ‘<samp class="samp">.mp</samp>’. |
| 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>‘<samp class="samp">-style=<var class="var">mftfile</var>[.mft]</samp>’<a class="copiable-link" href="#index-_002dstyle_003dmftfile"> ¶</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’s Volume <!-- /@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> [<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"> ¶</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 “font”, it |
| 3329 |
outputs PostScript commands. It’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> [<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"> ¶</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&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&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>]... &<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 ‘<samp class="samp">-1</samp>’ |
| 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 ‘<samp class="samp">mpout</samp>’ if no |
| 3401 |
input file was specified. MetaPost uses the ‘<samp class="samp">.ps</samp>’ 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="<var class="var">filename</var>"} |
| 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 ‘<samp class="samp">latex</samp>’. |
| 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 ‘<samp class="samp">-m pictures</samp>’ Troff macro |
| 3433 |
package (unfortunately absent from many Troff implementations), or an |
| 3434 |
equivalent such as the ‘<samp class="samp">-m pspic</samp>’ 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’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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (see <a class="pxref" href="#Common-options">Common options</a>): |
| 3483 |
</p><dl class="table"> |
| 3484 |
<dt>‘<samp class="samp">-[no]-file-line-error</samp>’</dt> |
| 3485 |
<dt>‘<samp class="samp">-halt-on-error</samp>’</dt> |
| 3486 |
<dt>‘<samp class="samp">-ini</samp>’</dt> |
| 3487 |
<dt>‘<samp class="samp">-interaction=<var class="var">string</var></samp>’</dt> |
| 3488 |
<dt>‘<samp class="samp">-jobname=<var class="var">string</var></samp>’</dt> |
| 3489 |
<dt>‘<samp class="samp">-kpathsea-debug=<var class="var">number</var></samp>’</dt> |
| 3490 |
<dt>‘<samp class="samp">-[no]parse-first-line</samp>’</dt> |
| 3491 |
<dt>‘<samp class="samp">-output-directory</samp>’</dt> |
| 3492 |
<dt>‘<samp class="samp">-progname=<var class="var">string</var></samp>’</dt> |
| 3493 |
<dt>‘<samp class="samp">-recorder</samp>’</dt> |
| 3494 |
<dt>‘<samp class="samp">-translate-file=<var class="var">tcxfile</var></samp>’</dt> |
| 3495 |
<dt>‘<samp class="samp">-8bit</samp>’</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>‘<samp class="samp">-debug</samp>’<a class="copiable-link" href="#index-_002ddebug"> ¶</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>‘<samp class="samp">-mem=<var class="var">MPFILE</var></samp>’<a class="copiable-link" href="#index-_002dmem"> ¶</a></span></dt> |
| 3505 |
<dd><p>Preload <var class="var">MPFILE</var> instead of via the program name of <code class="code">%&</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>‘<samp class="samp">-numbersystem=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002dnumbersystem"> ¶</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>‘<samp class="samp">-restricted</samp>’<a class="copiable-link" href="#index-_002drestricted"> ¶</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>‘<samp class="samp">-s <var class="var">internal</var>=<var class="var">value</var></samp>’<a class="copiable-link" href="#index-_002ds"> ¶</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>‘<samp class="samp">-T</samp>’<a class="copiable-link" href="#index-_002dT"> ¶</a></span></dt> |
| 3525 |
<dt>‘<samp class="samp">-troff</samp>’</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>‘<samp class="samp">-tex=<var class="var">texprogram</var></samp>’<a class="copiable-link" href="#index-_002dtex_003dtexprogram"> ¶</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> [<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"> ¶</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 |
“initial” file name is read in its source form—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 “preloading” 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> [<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"> ¶</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., ‘<samp class="samp">dvitomp |
| 3592 |
/wherever/foo.dvi</samp>’ 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 ‘<samp class="samp">color push |
| 3596 |
<var class="var">name</var></samp>’ and ‘<samp class="samp">color pop</samp>’, outputting them as <code class="code">withcolor</code> |
| 3597 |
MetaPost commands. |
| 3598 |
</p> |
| 3599 |
<p>The only options are ‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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> [<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"> ¶</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> [<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"> ¶</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, ‘<samp class="samp">bibtex /wherever/foo.aux</samp>’ 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 ‘<samp class="samp">.blg</samp>’. |
| 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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-terse</samp>’<a class="copiable-link" href="#index-_002dterse"> ¶</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>‘<samp class="samp">-min-crossrefs=<var class="var">n</var></samp>’<a class="copiable-link" href="#index-_002dmin_002dcrossrefs_003dn"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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> [<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"> ¶</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"> ¶</a></span></dt> |
| 3744 |
<dd><p>Sorts entries alphabetically, with numeric labels. Generally formatted |
| 3745 |
according to van Leunen’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"> ¶</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"> ¶</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"> ¶</a></span></dt> |
| 3758 |
<dd><p>Alphanumeric labels, e.g., ‘<samp class="samp">Knu66</samp>’. |
| 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"> ¶</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 ‘<samp class="samp">(<var class="var">author</var>, <var class="var">year</var>)</samp>’. |
| 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"> ¶</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"> ¶</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"> ¶</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> [<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"> ¶</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’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> [<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"> ¶</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 ‘<samp class="samp">.p</samp>’; for example, ‘<samp class="samp">tangle /wherever/foo.web</samp>’ 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 ‘<samp class="samp">.pool</samp>’. |
| 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 |
‘<samp class="samp">--help</samp>’ and ‘<samp class="samp">--version</samp>’ (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>‘<samp class="samp">-length=<var class="var">number</var></samp>’<a class="copiable-link" href="#index-_002dlength_003dnumber"> ¶</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 |
‘<samp class="samp">-underline</samp>’ 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>‘<samp class="samp">-lowercase</samp>’<a class="copiable-link" href="#index-_002dlowercase"> ¶</a></span></dt> |
| 3886 |
<dt>‘<samp class="samp">-mixedcase</samp>’</dt> |
| 3887 |
<dt>‘<samp class="samp">-uppercase</samp>’</dt> |
| 3888 |
<dd><p>These options specify the case of identifiers in the output of tangle. |
| 3889 |
If ‘<samp class="samp">-uppercase</samp>’ (‘<samp class="samp">-lowercase</samp>’) is specified, tangle will |
| 3890 |
convert all identifiers to uppercase (lowercase). The default is |
| 3891 |
‘<samp class="samp">-mixedcase</samp>’, 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>‘<samp class="samp">-underline</samp>’<a class="copiable-link" href="#index-_002dunderline"> ¶</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>‘<samp class="samp">-loose</samp>’<a class="copiable-link" href="#index-_002dloose"> ¶</a></span></dt> |
| 3903 |
<dt>‘<samp class="samp">-strict</samp>’</dt> |
| 3904 |
<dd><p>These options specify how strict tangle must be when checking |
| 3905 |
identifiers for equality. The default is ‘<samp class="samp">-loose</samp>’, which means |
| 3906 |
that tangle will follow the rules set by the case-smashing and underline |
| 3907 |
options above. If ‘<samp class="samp">-strict</samp>’ 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> [<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"> ¶</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 |
‘<samp class="samp">.tex</samp>’; for example, ‘<samp class="samp">weave /wherever/foo.web</samp>’ 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 |
‘<samp class="samp">-verbose</samp>’, ‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-x</samp>’<a class="copiable-link" href="#index-_002dx"> ¶</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> [<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"> ¶</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 ‘<samp class="samp">--help</samp>’ and ‘<samp class="samp">--version</samp>’ (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: "^^@" |
| 3999 |
1: "^^A" |
| 4000 |
... |
| 4001 |
255: "^^ff" |
| 4002 |
256: "pool size" |
| 4003 |
... |
| 4004 |
1314: "Using character substitution: " |
| 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 ‘<samp class="samp">^^</samp>’ 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> [<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"> ¶</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> [<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"> ¶</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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-magnification=<var class="var">integer</var></samp>’<a class="copiable-link" href="#index-_002dmagnification_003dinteger"> ¶</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’s |
| 4080 |
<code class="code">\mag</code> parameter. |
| 4081 |
</p> |
| 4082 |
</dd> |
| 4083 |
<dt><a id="index-_002dmax_002dpages_003dn"></a><span>‘<samp class="samp">-max-pages=<var class="var">n</var></samp>’<a class="copiable-link" href="#index-_002dmax_002dpages_003dn"> ¶</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>‘<samp class="samp">-page-start=<var class="var">page-spec</var></samp>’<a class="copiable-link" href="#index-_002dpage_002dstart_003dpage_002dspec"> ¶</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’s |
| 4093 |
<code class="code">\count0…9</code> parameters at <code class="code">\shipout</code> time; ‘<samp class="samp">*</samp>’ |
| 4094 |
matches anything. Examples: ‘<samp class="samp">3</samp>’, ‘<samp class="samp">1.*.-4</samp>’. |
| 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> [<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"> ¶</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’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 |
‘<samp class="samp">-1</samp>’ 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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (see <a class="pxref" href="#Common-options">Common options</a>): |
| 4134 |
</p><dl class="table"> |
| 4135 |
<dt><a id="index-_002ddpi_003dreal"></a><span>‘<samp class="samp">-dpi=<var class="var">real</var></samp>’<a class="copiable-link" href="#index-_002ddpi_003dreal"> ¶</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>‘<samp class="samp">-magnification=<var class="var">integer</var></samp>’<a class="copiable-link" href="#index-_002dmagnification_003dinteger-1"> ¶</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’s |
| 4145 |
<code class="code">\mag</code> parameter. |
| 4146 |
</p> |
| 4147 |
</dd> |
| 4148 |
<dt><a id="index-_002dmax_002dpages_003dn-1"></a><span>‘<samp class="samp">-max-pages=<var class="var">n</var></samp>’<a class="copiable-link" href="#index-_002dmax_002dpages_003dn-1"> ¶</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>‘<samp class="samp">-output-level=<var class="var">n</var></samp>’<a class="copiable-link" href="#index-_002doutput_002dlevel_003dn"> ¶</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>‘<samp class="samp">-page-start=<var class="var">page-spec</var></samp>’<a class="copiable-link" href="#index-_002dpage_002dstart_003dpage_002dspec-1"> ¶</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’s |
| 4170 |
<code class="code">\count0…9</code> parameters at <code class="code">\shipout</code> time; ‘<samp class="samp">*</samp>’ |
| 4171 |
matches anything. Examples: ‘<samp class="samp">1</samp>’, ‘<samp class="samp">5.*.-9</samp>’. |
| 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>‘<samp class="samp">-show-opcodes</samp>’<a class="copiable-link" href="#index-_002dshow_002dopcodes"> ¶</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> [<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"> ¶</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 |
‘<samp class="samp">-output-level=4</samp>’ and ‘<samp class="samp">-show-opcodes</samp>’ 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 |
(‘<samp class="samp">42:</samp>’, ‘<samp class="samp">87:</samp>’, …), and (because of the |
| 4266 |
‘<samp class="samp">-show-opcodes</samp>’) followed by its decimal opcode value in braces |
| 4267 |
(‘<samp class="samp">{141}</samp>’, ‘<samp class="samp">{142}</samp>’, …). |
| 4268 |
|
| 4269 |
</li><li>The ‘<samp class="samp">level</samp>’ lines record information about the DVI stack; ‘<samp class="samp">h</samp>’ |
| 4270 |
and ‘<samp class="samp">v</samp>’ define the current position in DVI units, while ‘<samp class="samp">hh</samp>’ |
| 4271 |
and ‘<samp class="samp">vv</samp>’ are the same in pixels. |
| 4272 |
|
| 4273 |
</li><li>Text sequences are summarized in brackets, as in ‘<samp class="samp">[A SHORT |
| 4274 |
STORY]</samp>’ and the ‘<samp class="samp">[ 1]</samp>’. |
| 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> [<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"> ¶</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’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> [<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"> ¶</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 ‘<samp class="samp">.600pk</samp>’ or ‘<samp class="samp">.600gf</samp>’ or ‘<samp class="samp">.3000pxl</samp>’, where |
| 4366 |
the ‘<samp class="samp">600</samp>’ is the horizontal dots-per-inch resolution at which the |
| 4367 |
font was produced, and the ‘<samp class="samp">pk</samp>’ or ‘<samp class="samp">gf</samp>’ or ‘<samp class="samp">pxl</samp>’ |
| 4368 |
indicates the font format. Outline fonts in PostScript Type 1 format |
| 4369 |
have suffixes such as ‘<samp class="samp">.pfa</samp>’ or ‘<samp class="samp">.pfb</samp>’. |
| 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 ‘<samp class="samp">.pl</samp>’ (property list) suffix are the plain text |
| 4383 |
(human-readable) analog of the binary ‘<samp class="samp">.tfm</samp>’ 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 ‘<samp class="samp">.mf</samp>’ 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 ‘<samp class="samp">.vf</samp>’ identifies “virtual font” files, for which |
| 4395 |
‘<samp class="samp">.vpl</samp>’ 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> [<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"> ¶</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 ‘<samp class="samp">-1</samp>’ before running |
| 4434 |
the program. |
| 4435 |
</p> |
| 4436 |
<p>The suffix ‘<samp class="samp">gf</samp>’ is supplied if not already present. This suffix is |
| 4437 |
not an extension; no ‘<samp class="samp">.</samp>’ 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 ‘<samp class="samp"><var class="var">gfname</var>.<var class="var">dpi</var>pk</samp>’, e.g., ‘<samp class="samp">gftopk |
| 4442 |
/wherever/cmr10.600gf</samp>’ creates <samp class="file">./cmr10.600pk</samp>. |
| 4443 |
</p> |
| 4444 |
<p>The only options are ‘<samp class="samp">--verbose</samp>’, ‘<samp class="samp">--help</samp>’, and |
| 4445 |
‘<samp class="samp">--version</samp>’ (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> [<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"> ¶</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 ‘<samp class="samp">-1</samp>’ before running |
| 4475 |
the program. |
| 4476 |
</p> |
| 4477 |
<p>The suffix ‘<samp class="samp">pk</samp>’ is supplied if not already present. This suffix is |
| 4478 |
not an extension; no ‘<samp class="samp">.</samp>’ 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 ‘<samp class="samp"><var class="var">pkname</var>.<var class="var">dpi</var>gf</samp>’, e.g., ‘<samp class="samp">pktogf |
| 4483 |
/wherever/cmr10.600pk</samp>’ creates <samp class="file">./cmr10.600gf</samp>. |
| 4484 |
</p> |
| 4485 |
<p>The only options are ‘<samp class="samp">--verbose</samp>’, ‘<samp class="samp">--help</samp>’, and |
| 4486 |
‘<samp class="samp">--version</samp>’ (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> [<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"> ¶</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’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 ‘<samp class="samp">-1</samp>’ before running |
| 4517 |
the program. |
| 4518 |
</p> |
| 4519 |
<p>The suffix ‘<samp class="samp">pk</samp>’ is supplied if not already present. This suffix is |
| 4520 |
not an extension; no ‘<samp class="samp">.</samp>’ 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 ‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ |
| 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 ‘K’ in ‘<samp class="samp">cmr10</samp>’, as rendered at 600<span class="dmn">dpi</span> with the mode |
| 4529 |
‘<samp class="samp">ljfour</samp>’ 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>‘<samp class="samp">955</samp>’<a class="copiable-link" href="#index-byte-position"> ¶</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>‘<samp class="samp">Flag byte</samp>’<a class="copiable-link" href="#index-flag-byte"> ¶</a></span></dt> |
| 4550 |
<dt>‘<samp class="samp">Dynamic packing variable</samp>’</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>‘<samp class="samp">Character</samp>’<a class="copiable-link" href="#index-character-codes_002c-in-PKtype-output"> ¶</a></span></dt> |
| 4555 |
<dd><p>The character code, in decimal. |
| 4556 |
</p> |
| 4557 |
</dd> |
| 4558 |
<dt><a id="index-packet-length"></a><span>‘<samp class="samp">Packet length</samp>’<a class="copiable-link" href="#index-packet-length"> ¶</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>‘<samp class="samp">TFM width</samp>’<a class="copiable-link" href="#index-TFM-width-of-characters"> ¶</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’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>‘<samp class="samp">dx</samp>’<a class="copiable-link" href="#index-horizontal-escapement"> ¶</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>‘<samp class="samp">Height</samp>’<a class="copiable-link" href="#index-height_002c-in-pixels"> ¶</a></span></dt> |
| 4581 |
<dt>‘<samp class="samp">Width</samp>’</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>‘<samp class="samp">X-offset</samp>’<a class="copiable-link" href="#index-x-offset"> ¶</a></span></dt> |
| 4592 |
<dt>‘<samp class="samp">Y-offset</samp>’</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>‘<samp class="samp">[2]23(16)…</samp>’<a class="copiable-link" href="#index-run-length-encoded-bitmaps"> ¶</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> [<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"> ¶</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’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 ‘<samp class="samp">-1</samp>’ before running |
| 4638 |
the program. |
| 4639 |
</p> |
| 4640 |
<p>The suffix ‘<samp class="samp">gf</samp>’ is supplied if not already present. This suffix is |
| 4641 |
not an extension; no ‘<samp class="samp">.</samp>’ 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 |
‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (see <a class="pxref" href="#Common-options">Common options</a>): |
| 4647 |
</p><dl class="table"> |
| 4648 |
<dt><a id="index-_002dimages"></a><span>‘<samp class="samp">-images</samp>’<a class="copiable-link" href="#index-_002dimages"> ¶</a></span></dt> |
| 4649 |
<dd><p>Show the characters’ bitmaps using asterisks and spaces. |
| 4650 |
</p> |
| 4651 |
</dd> |
| 4652 |
<dt><a id="index-_002dmnemonics"></a><span>‘<samp class="samp">-mnemonics</samp>’<a class="copiable-link" href="#index-_002dmnemonics"> ¶</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 ‘K’ in ‘<samp class="samp">cmr10</samp>’, as rendered at 600<span class="dmn">dpi</span> with the mode |
| 4659 |
‘<samp class="samp">ljfour</samp>’ 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 ‘<samp class="samp">-mnemonics</samp>’ and ‘<samp class="samp">-images</samp>’ 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<=m<=60 0<=n<=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">.<--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 |
.<--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>‘<samp class="samp">2033</samp>’<a class="copiable-link" href="#index-byte-position-1"> ¶</a></span></dt> |
| 4703 |
<dt>‘<samp class="samp">2043</samp>’</dt> |
| 4704 |
<dt>‘<samp class="samp">…</samp>’</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>‘<samp class="samp">beginning of char 75</samp>’<a class="copiable-link" href="#index-character-codes_002c-in-GFtype-output"> ¶</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>‘<samp class="samp">3<=m<=60 0<=n<=56</samp>’<a class="copiable-link" href="#index-left-side-bearing-1"> ¶</a></span></dt> |
| 4715 |
<dd><p>The character’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>‘<samp class="samp">(initially n=56) paint (0)24(12)20</samp>’<a class="copiable-link" href="#index-run-length-encoded-bitmaps-1"> ¶</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>‘<samp class="samp">newrow 0 (n=55) paint 24(12)20</samp>’<a class="copiable-link" href="#index-newrow-GF-command"> ¶</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>‘<samp class="samp">eoc</samp>’<a class="copiable-link" href="#index-eoc-GF-command"> ¶</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>‘<samp class="samp">dx</samp>’<a class="copiable-link" href="#index-horizontal-escapement-1"> ¶</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 ‘<samp class="samp">(65)</samp>’ is simply the same number |
| 4755 |
rounded. If the vertical escapement is nonzero, it would appear here as |
| 4756 |
a ‘<samp class="samp">dy</samp>’ 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>‘<samp class="samp">width</samp>’<a class="copiable-link" href="#index-TFM-width-of-characters-1"> ¶</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’s design size. The |
| 4764 |
‘<samp class="samp">64.57289</samp>’ is the same number converted to pixels. |
| 4765 |
</p> |
| 4766 |
</dd> |
| 4767 |
<dt>‘<samp class="samp">loc</samp>’</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> [<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"> ¶</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 ‘<samp class="samp">.tfm</samp>’ 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 ‘<samp class="samp">-1</samp>’ before running |
| 4804 |
the program. |
| 4805 |
</p> |
| 4806 |
<p>If <var class="var">plfile</var> (which is extended with ‘<samp class="samp">.pl</samp>’ 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 |
‘<samp class="samp">-verbose</samp>’, ‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-charcode-format=<var class="var">type</var></samp>’<a class="copiable-link" href="#index-_002dcharcode_002dformat_003dtype"> ¶</a></span></dt> |
| 4815 |
<dd><p>Output character codes in the PL file according to <var class="var">type</var>: either |
| 4816 |
‘<samp class="samp">octal</samp>’ or ‘<samp class="samp">ascii</samp>’. Default is ‘<samp class="samp">ascii</samp>’ for letters and |
| 4817 |
digits, octal for all other characters. Exception: if the font’s coding |
| 4818 |
scheme starts with ‘<samp class="samp">TeX math sy</samp>’ or ‘<samp class="samp">TeX math ex</samp>’, all |
| 4819 |
character codes are output in octal. |
| 4820 |
</p> |
| 4821 |
<p>In ‘<samp class="samp">ascii</samp>’ format, character codes that correspond to graphic |
| 4822 |
characters, except for left and right parentheses, are output as a |
| 4823 |
‘<samp class="samp">C</samp>’ followed by the single character: ‘<samp class="samp">C K</samp>’, for example. In |
| 4824 |
octal format, character codes are output as the letter ‘<samp class="samp">O</samp>’ followed |
| 4825 |
by octal digits, as in ‘<samp class="samp">O 113</samp>’ for ‘<samp class="samp">K</samp>’. |
| 4826 |
</p> |
| 4827 |
<p>‘<samp class="samp">octal</samp>’ 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 |
‘<samp class="samp">f</samp>’ (in the ‘<samp class="samp">LABEL</samp>’) followed by an ‘<samp class="samp">i</samp>’ is a ligature, |
| 4911 |
i.e., a typesetting program like TeX replaces those two consecutive |
| 4912 |
characters by the character at position octal ’014 in the current |
| 4913 |
font—presumably the ‘fi’ ligature. <code class="code">KRN</code> properties define |
| 4914 |
kerns: if an ‘<samp class="samp">f</samp>’ is followed by character octal ’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’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 ‘f’, 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> [<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"> ¶</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’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 ‘<samp class="samp">.tfm</samp>’ if necessary) is |
| 4959 |
not specified, the TFM file is written to the basename of |
| 4960 |
‘<samp class="samp"><var class="var">plfile</var>.tfm</samp>’, e.g., ‘<samp class="samp">pltotf /wherever/cmr10.pl</samp>’ 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 ‘<samp class="samp">-verbose</samp>’, ‘<samp class="samp">-help</samp>’, and |
| 4965 |
‘<samp class="samp">-version</samp>’ (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> [<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"> ¶</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 ‘<samp class="samp">.vf</samp>’ and |
| 4999 |
‘<samp class="samp">.tfm</samp>’ 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 |
‘<samp class="samp">-1</samp>’ before running the program. If <var class="var">tfmname</var> is not |
| 5003 |
specified, <var class="var">vfname</var> (without a trailing ‘<samp class="samp">.vf</samp>’) is used. |
| 5004 |
</p> |
| 5005 |
<p>If <var class="var">vplfile</var> (extended with ‘<samp class="samp">.vpl</samp>’ 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 |
‘<samp class="samp">-verbose</samp>’, ‘<samp class="samp">-help</samp>’ and ‘<samp class="samp">-version</samp>’ (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>‘<samp class="samp">-charcode-format=<var class="var">type</var></samp>’<a class="copiable-link" href="#index-_002dcharcode_002dformat_003dtype-1"> ¶</a></span></dt> |
| 5014 |
<dd><p>Output character codes in the PL file according to <var class="var">type</var>: either |
| 5015 |
‘<samp class="samp">octal</samp>’ or ‘<samp class="samp">ascii</samp>’. Default is ‘<samp class="samp">ascii</samp>’ for letters and |
| 5016 |
digits, octal for all other characters. Exception: if the font’s coding |
| 5017 |
scheme starts with ‘<samp class="samp">TeX math sy</samp>’ or ‘<samp class="samp">TeX math ex</samp>’, all |
| 5018 |
character codes are output in octal. |
| 5019 |
</p> |
| 5020 |
<p>In ‘<samp class="samp">ascii</samp>’ format, character codes that correspond to graphic |
| 5021 |
characters, except for left and right parentheses, are output as a |
| 5022 |
‘<samp class="samp">C</samp>’ followed by the single character: ‘<samp class="samp">C K</samp>’, for example. In |
| 5023 |
octal format, character codes are output as the letter ‘<samp class="samp">O</samp>’ followed |
| 5024 |
by octal digits, as in ‘<samp class="samp">O 113</samp>’ for ‘<samp class="samp">K</samp>’. |
| 5025 |
</p> |
| 5026 |
<p>‘<samp class="samp">octal</samp>’ 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> [<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"> ¶</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’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 ‘<samp class="samp">.vf</samp>’ if necessary) is not |
| 5059 |
specified, the VF output is written to the basename of |
| 5060 |
‘<samp class="samp"><var class="var">vplfile</var>.vf</samp>’; similarly for <var class="var">tfmfile</var>. For example, |
| 5061 |
‘<samp class="samp">vptovf /wherever/ptmr.vpl</samp>’ creates <samp class="file">./ptmr.vf</samp> and |
| 5062 |
<samp class="file">./ptmr.tfm</samp>. |
| 5063 |
</p> |
| 5064 |
<p>The only options are ‘<samp class="samp">-verbose</samp>’, ‘<samp class="samp">-help</samp>’, and ‘<samp class="samp">-version</samp>’ |
| 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> [<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"> ¶</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 1, OpenType, |
| 5121 |
TrueType, …), 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 ‘<samp class="samp">xdvi</samp>’ |
| 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> [<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"> ¶</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’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> [<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"> ¶</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–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–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’s Manual for MetaPost. |
| 5238 |
Technical Report CSTR-162, AT&T Bell Laboratories, 1992. |
| 5239 |
|
| 5240 |
</li><li> [Hob93] |
| 5241 |
John D. Hobby. |
| 5242 |
Drawing Graphs with MetaPost. |
| 5243 |
Technical Report CSTR-164, AT&T Bell Laboratories, 1993. |
| 5244 |
|
| 5245 |
</li><li> [HS91] |
| 5246 |
Samuel P. Harbison and Guy L. Steele Jr. |
| 5247 |
<cite class="cite">C—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—Practice and Experience</cite>, 19(7):607–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–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’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—Papers from the second RIDT meeting, held in |
| 5335 |
Boston, Oct. 14–16, 1991</cite>, pages 205–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> [<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"> ¶</a></span></h2> |
| 5350 |
|
| 5351 |
<div class="printindex cp-printindex"> |
| 5352 |
<table class="cp-letters-header-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a> |
| 5353 |
|
| 5354 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>.</b></a> |
| 5355 |
|
| 5356 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>"</b></a> |
| 5357 |
|
| 5358 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>\</b></a> |
| 5359 |
|
| 5360 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>#</b></a> |
| 5361 |
|
| 5362 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>%</b></a> |
| 5363 |
|
| 5364 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>^</b></a> |
| 5365 |
|
| 5366 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>~</b></a> |
| 5367 |
|
| 5368 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>$</b></a> |
| 5369 |
|
| 5370 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>2</b></a> |
| 5371 |
|
| 5372 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>3</b></a> |
| 5373 |
|
| 5374 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>6</b></a> |
| 5375 |
|
| 5376 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a> |
| 5377 |
|
| 5378 |
<br> |
| 5379 |
<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a> |
| 5380 |
|
| 5381 |
<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a> |
| 5382 |
|
| 5383 |
<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a> |
| 5384 |
|
| 5385 |
<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a> |
| 5386 |
|
| 5387 |
<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a> |
| 5388 |
|
| 5389 |
<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a> |
| 5390 |
|
| 5391 |
<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a> |
| 5392 |
|
| 5393 |
<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a> |
| 5394 |
|
| 5395 |
<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a> |
| 5396 |
|
| 5397 |
<a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a> |
| 5398 |
|
| 5399 |
<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a> |
| 5400 |
|
| 5401 |
<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a> |
| 5402 |
|
| 5403 |
<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a> |
| 5404 |
|
| 5405 |
<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a> |
| 5406 |
|
| 5407 |
<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a> |
| 5408 |
|
| 5409 |
<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a> |
| 5410 |
|
| 5411 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a> |
| 5412 |
|
| 5413 |
<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a> |
| 5414 |
|
| 5415 |
<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a> |
| 5416 |
|
| 5417 |
<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a> |
| 5418 |
|
| 5419 |
<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a> |
| 5420 |
|
| 5421 |
<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a> |
| 5422 |
|
| 5423 |
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a> |
| 5424 |
|
| 5425 |
<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a> |
| 5426 |
|
| 5427 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a> |
| 5428 |
|
| 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">"</th></tr> |
| 5554 |
<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022-character_002c-ignored-in-filenames"><code class="code">"</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">‘<samp class="samp">#define</samp>’ 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>%& <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 ‘<samp class="samp">-</samp>’</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 ‘<samp class="samp">-8bit</samp>’.</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 ‘<samp class="samp">.</samp>’ 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: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a> |
| 6380 |
|
| 6381 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>.</b></a> |
| 6382 |
|
| 6383 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>"</b></a> |
| 6384 |
|
| 6385 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>\</b></a> |
| 6386 |
|
| 6387 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>#</b></a> |
| 6388 |
|
| 6389 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>%</b></a> |
| 6390 |
|
| 6391 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>^</b></a> |
| 6392 |
|
| 6393 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>~</b></a> |
| 6394 |
|
| 6395 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>$</b></a> |
| 6396 |
|
| 6397 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>2</b></a> |
| 6398 |
|
| 6399 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>3</b></a> |
| 6400 |
|
| 6401 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>6</b></a> |
| 6402 |
|
| 6403 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a> |
| 6404 |
|
| 6405 |
<br> |
| 6406 |
<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a> |
| 6407 |
|
| 6408 |
<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a> |
| 6409 |
|
| 6410 |
<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a> |
| 6411 |
|
| 6412 |
<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a> |
| 6413 |
|
| 6414 |
<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a> |
| 6415 |
|
| 6416 |
<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a> |
| 6417 |
|
| 6418 |
<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a> |
| 6419 |
|
| 6420 |
<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a> |
| 6421 |
|
| 6422 |
<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a> |
| 6423 |
|
| 6424 |
<a class="summary-letter-printindex" href="#Index_cp_letter-J"><b>J</b></a> |
| 6425 |
|
| 6426 |
<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a> |
| 6427 |
|
| 6428 |
<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a> |
| 6429 |
|
| 6430 |
<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a> |
| 6431 |
|
| 6432 |
<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a> |
| 6433 |
|
| 6434 |
<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a> |
| 6435 |
|
| 6436 |
<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a> |
| 6437 |
|
| 6438 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a> |
| 6439 |
|
| 6440 |
<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a> |
| 6441 |
|
| 6442 |
<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a> |
| 6443 |
|
| 6444 |
<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a> |
| 6445 |
|
| 6446 |
<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a> |
| 6447 |
|
| 6448 |
<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a> |
| 6449 |
|
| 6450 |
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a> |
| 6451 |
|
| 6452 |
<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a> |
| 6453 |
|
| 6454 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Y"><b>Y</b></a> |
| 6455 |
|
| 6456 |
</td></tr></table> |
| 6457 |
</div> |
| 6458 |
|
| 6459 |
</div> |
| 6460 |
</div> |
| 6461 |
|
| 6462 |
|
| 6463 |
|
| 6464 |
</body> |
| 6465 |
</html> |