Debian Codegraph @

texmf-dist/doc/kpathsea/kpathsea.html

raw
1 <!DOCTYPE html>
2 <html>
3 <!-- Created by GNU Texinfo 7.2, https://www.gnu.org/software/texinfo/ -->
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6 <!-- This file documents the Kpathsea library for path searching.
7
8 Copyright © 1996-2026 Karl Berry & Olaf Weber.
9
10 Permission is granted to make and distribute verbatim copies of this
11 manual provided the copyright notice and this permission notice are
12 preserved on all copies.
13
14
15 Permission is granted to copy and distribute modified versions of this
16 manual under the conditions for verbatim copying, provided that the
17 entire resulting derived work is distributed under the terms of a
18 permission notice identical to this one.
19
20 Permission is granted to copy and distribute translations of this manual
21 into another language, under the above conditions for modified versions,
22 except that this permission notice may be stated in a translation
23 approved by the TeX Users Group. -->
24 <title>Kpathsea: A library for path searching</title>
25
26 <meta name="description" content="Kpathsea: A library for path searching">
27 <meta name="keywords" content="Kpathsea: A library for path searching">
28 <meta name="resource-type" content="document">
29 <meta name="distribution" content="global">
30 <meta name="Generator" content="makeinfo">
31 <meta name="viewport" content="width=device-width,initial-scale=1">
32
33 <link href="#Top" rel="start" title="Top">
34 <link href="#Index" rel="index" title="Index">
35 <link href="#SEC_Contents" rel="contents" title="Table of Contents">
36 <link href="http://tug.org/texinfohtml" rel="up" title="(dir)">
37 <link href="#Introduction" rel="next" title="Introduction">
38 <style type="text/css">
39 <!--
40 a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
41 a.summary-letter-printindex {text-decoration: none}
42 div.example {margin-left: 3.2em}
43 span.r {font-family: initial; font-weight: normal; font-style: normal}
44 span:hover a.copiable-link {visibility: visible}
45 td.printindex-index-entry {vertical-align: top}
46 td.printindex-index-section {vertical-align: top; padding-left: 1em}
47 th.entries-header-printindex {text-align:left}
48 th.sections-header-printindex {text-align:left; padding-left: 1em}
49 ul.mark-bullet {list-style-type: disc}
50 ul.toc-numbered-mark {list-style: none}
51 -->
52 </style>
53
54
55 </head>
56
57 <body lang="en">
58
59
60
61
62
63
64
65
66
67
68
69 <div class="top-level-extent" id="Top">
70 <div class="nav-panel">
71 <p>
72 Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
73 </div>
74 <h1 class="top" id="Kpathsea-library"><span>Kpathsea library<a class="copiable-link" href="#Kpathsea-library"> &para;</a></span></h1>
75
76 <p>This manual documents the Kpathsea library for path searching. It
77 corresponds to version 6.4.2/dev, released in
78 January 2026.
79 </p>
80
81
82 <div class="region-contents" id="SEC_Contents">
83 <h2 class="contents-heading">Table of Contents</h2>
84
85 <div class="contents">
86
87 <ul class="toc-numbered-mark">
88 <li><a id="toc-Introduction" href="#Introduction">1 Introduction</a>
89 <ul class="toc-numbered-mark">
90 <li><a id="toc-History" href="#History">1.1 History</a></li>
91 </ul></li>
92 <li><a id="toc-unixtex_002eftp_003a-Obtaining-TeX" href="#unixtex_002eftp">2 <samp class="file">unixtex.ftp</samp>: Obtaining TeX</a></li>
93 <li><a id="toc-Security" href="#Security">3 Security</a>
94 <ul class="toc-numbered-mark">
95 <li><a id="toc-Global-font-cache-and-security" href="#Global-font-cache-and-security">3.1 Global font cache and security</a></li>
96 </ul></li>
97 <li><a id="toc-TeX-directory-structure" href="#TeX-directory-structure">4 TeX directory structure</a></li>
98 <li><a id="toc-Path-searching" href="#Path-searching">5 Path searching</a>
99 <ul class="toc-numbered-mark">
100 <li><a id="toc-Searching-overview" href="#Searching-overview">5.1 Searching overview</a></li>
101 <li><a id="toc-Path-sources" href="#Path-sources">5.2 Path sources</a>
102 <ul class="toc-numbered-mark">
103 <li><a id="toc-Config-files" href="#Config-files">5.2.1 Config files</a></li>
104 </ul></li>
105 <li><a id="toc-Path-expansion" href="#Path-expansion">5.3 Path expansion</a>
106 <ul class="toc-numbered-mark">
107 <li><a id="toc-Default-expansion" href="#Default-expansion">5.3.1 Default expansion</a></li>
108 <li><a id="toc-Variable-expansion" href="#Variable-expansion">5.3.2 Variable expansion</a></li>
109 <li><a id="toc-Tilde-expansion" href="#Tilde-expansion">5.3.3 Tilde expansion</a></li>
110 <li><a id="toc-Brace-expansion" href="#Brace-expansion">5.3.4 Brace expansion</a></li>
111 <li><a id="toc-KPSE_005fDOT-expansion" href="#KPSE_005fDOT-expansion">5.3.5 <code class="code">KPSE_DOT</code> expansion</a></li>
112 <li><a id="toc-Subdirectory-expansion" href="#Subdirectory-expansion">5.3.6 Subdirectory expansion</a></li>
113 </ul></li>
114 <li><a id="toc-Casefolding-search" href="#Casefolding-search">5.4 Casefolding search</a>
115 <ul class="toc-numbered-mark">
116 <li><a id="toc-Casefolding-rationale" href="#Casefolding-rationale">5.4.1 Casefolding rationale</a></li>
117 <li><a id="toc-Casefolding-examples" href="#Casefolding-examples">5.4.2 Casefolding examples</a></li>
118 </ul></li>
119 <li><a id="toc-Filename-database-_0028ls_002dR_0029" href="#Filename-database">5.5 Filename database (<code class="code">ls-R</code>)</a>
120 <ul class="toc-numbered-mark">
121 <li><a id="toc-ls_002dR" href="#ls_002dR">5.5.1 <samp class="file">ls-R</samp></a></li>
122 <li><a id="toc-Filename-aliases" href="#Filename-aliases">5.5.2 Filename aliases</a></li>
123 <li><a id="toc-Database-format" href="#Database-format">5.5.3 Database format</a></li>
124 </ul></li>
125 <li><a id="toc-kpsewhich_003a-Standalone-path-searching" href="#Invoking-kpsewhich">5.6 <code class="code">kpsewhich</code>: Standalone path searching</a>
126 <ul class="toc-numbered-mark">
127 <li><a id="toc-kpsewhich-examples" href="#kpsewhich-examples">5.6.1 <code class="code">kpsewhich</code> examples</a></li>
128 <li><a id="toc-Path-searching-options" href="#Path-searching-options">5.6.2 Path searching options</a></li>
129 <li><a id="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.6.3 Specially-recognized files for <code class="command">kpsewhich</code></a></li>
130 <li><a id="toc-Auxiliary-tasks" href="#Auxiliary-tasks">5.6.4 Auxiliary tasks</a></li>
131 <li><a id="toc-Standard-options" href="#Standard-options">5.6.5 Standard options</a></li>
132 </ul></li>
133 </ul></li>
134 <li><a id="toc-TeX-support" href="#TeX-support">6 TeX support</a>
135 <ul class="toc-numbered-mark">
136 <li><a id="toc-Supported-file-formats" href="#Supported-file-formats">6.1 Supported file formats</a></li>
137 <li><a id="toc-File-lookup" href="#File-lookup">6.2 File lookup</a></li>
138 <li><a id="toc-Glyph-lookup" href="#Glyph-lookup">6.3 Glyph lookup</a>
139 <ul class="toc-numbered-mark">
140 <li><a id="toc-Basic-glyph-lookup" href="#Basic-glyph-lookup">6.3.1 Basic glyph lookup</a></li>
141 <li><a id="toc-Fontmap" href="#Fontmap">6.3.2 Fontmap</a></li>
142 <li><a id="toc-Fallback-font" href="#Fallback-font">6.3.3 Fallback font</a></li>
143 </ul></li>
144 <li><a id="toc-Suppressing-warnings" href="#Suppressing-warnings">6.4 Suppressing warnings</a></li>
145 <li><a id="toc-mktex-scripts" href="#mktex-scripts">6.5 <samp class="file">mktex</samp> scripts</a>
146 <ul class="toc-numbered-mark">
147 <li><a id="toc-mktex-configuration" href="#mktex-configuration">6.5.1 <samp class="file">mktex</samp> configuration</a></li>
148 <li><a id="toc-mktex-script-names" href="#mktex-script-names">6.5.2 <samp class="file">mktex</samp> script names</a></li>
149 <li><a id="toc-mktex-script-arguments" href="#mktex-script-arguments">6.5.3 <samp class="file">mktex</samp> script arguments</a></li>
150 </ul></li>
151 </ul></li>
152 <li><a id="toc-Programming" href="#Programming">7 Programming</a>
153 <ul class="toc-numbered-mark">
154 <li><a id="toc-Programming-overview" href="#Programming-overview">7.1 Programming overview</a></li>
155 <li><a id="toc-Calling-sequence" href="#Calling-sequence">7.2 Calling sequence</a></li>
156 <li><a id="toc-Safe-filenames" href="#Safe-filenames">7.3 Safe filenames</a></li>
157 <li><a id="toc-Program_002dspecific-files" href="#Program_002dspecific-files">7.4 Program-specific files</a></li>
158 <li><a id="toc-Programming-with-config-files" href="#Programming-with-config-files">7.5 Programming with config files</a></li>
159 </ul></li>
160 <li><a id="toc-Reporting-bugs" href="#Reporting-bugs">8 Reporting bugs</a>
161 <ul class="toc-numbered-mark">
162 <li><a id="toc-Bug-checklist" href="#Bug-checklist">8.1 Bug checklist</a></li>
163 <li><a id="toc-Mailing-lists" href="#Mailing-lists">8.2 Mailing lists</a></li>
164 <li><a id="toc-Debugging" href="#Debugging">8.3 Debugging</a></li>
165 <li><a id="toc-Logging" href="#Logging">8.4 Logging</a></li>
166 <li><a id="toc-Common-problems" href="#Common-problems">8.5 Common problems</a>
167 <ul class="toc-numbered-mark">
168 <li><a id="toc-Unable-to-find-files" href="#Unable-to-find-files">8.5.1 Unable to find files</a></li>
169 <li><a id="toc-Slow-path-searching" href="#Slow-path-searching">8.5.2 Slow path searching</a></li>
170 <li><a id="toc-Unable-to-generate-fonts" href="#Unable-to-generate-fonts">8.5.3 Unable to generate fonts</a></li>
171 <li><a id="toc-TeX-or-Metafont-failing" href="#TeX-or-Metafont-failing">8.5.4 TeX or Metafont failing</a></li>
172 </ul></li>
173 </ul></li>
174 <li><a id="toc-Index" href="#Index" rel="index">Index</a></li>
175 </ul>
176 </div>
177 </div>
178 <hr>
179 <div class="chapter-level-extent" id="Introduction">
180 <div class="nav-panel">
181 <p>
182 Next: <a href="#unixtex_002eftp" accesskey="n" rel="next"><samp class="file">unixtex.ftp</samp>: Obtaining TeX</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Kpathsea library</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
183 </div>
184 <h2 class="chapter" id="Introduction-1"><span>1 Introduction<a class="copiable-link" href="#Introduction-1"> &para;</a></span></h2>
185
186 <a class="index-entry-id" id="index-introduction"></a>
187 <a class="index-entry-id" id="index-fundamental-purpose-of-Kpathsea"></a>
188
189 <p>This manual corresponds to version 6.4.2/dev of the Kpathsea
190 library, released in January 2026.
191 </p>
192 <p>The library&rsquo;s fundamental purpose is to return a filename from a list of
193 directories specified by the user, similar to what shells do when
194 looking up program names to execute.
195 </p>
196 <a class="index-entry-id" id="index-programs-using-the-library"></a>
197 <p>The following software, all of which is maintained in parallel, uses
198 this library:
199 </p>
200 <ul class="itemize mark-bullet">
201 <li>Dviljk (see the &lsquo;<samp class="samp">dvilj</samp>&rsquo; man page)
202 </li><li>Dvipsk (see <cite class="cite"><a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Dvips: A DVI driver</a></cite>)
203 </li><li>GNU font utilities (see <cite class="cite"><a data-manual="fontu" href="fontu.html#Top">GNU font utilities</a></cite>)
204 </li><li>Web2c (see <cite class="cite"><a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Top">Web2c: A TeX implementation</a></cite>)
205 </li><li>Xdvik (see the &lsquo;<samp class="samp">xdvi</samp>&rsquo; man page)
206 </li></ul>
207
208 <p>Other software that we do not maintain also uses it.
209 </p>
210 <p>Kpathsea is now maintained as part of the TeX Live distribution
211 (<a class="url" href="https://tug.org/texlive">https://tug.org/texlive</a>), which includes several more
212 Kpathsea-using programs. For information on configuration, building,
213 installing, and more, see <cite class="cite"><a data-manual="tlbuild" href="https://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>.
214 </p>
215 <a class="index-entry-id" id="index-interface_002c-not-frozen"></a>
216 <a class="index-entry-id" id="index-comments_002c-making"></a>
217 <a class="index-entry-id" id="index-suggestions_002c-making"></a>
218 <p>The library is still actively maintained. If you have comments or
219 suggestions, please send along (see <a class="pxref" href="#Reporting-bugs">Reporting bugs</a>).
220 </p>
221 <a class="index-entry-id" id="index-conditions-for-use"></a>
222 <a class="index-entry-id" id="index-license-for-using-the-library"></a>
223 <a class="index-entry-id" id="index-GNU-General-Public-License"></a>
224 <p>The Kpathsea library is distributed under the GNU Library General
225 Public License (LGPL), version&nbsp;2.1 or (at your option) any later
226 version. In short, this means if you write a program using the
227 library, you must (offer to) distribute the source to the library,
228 along with any changes you have made, and allow anyone to modify the
229 library source and distribute their modifications. It does not mean
230 you have to distribute the source to your program using the library,
231 although we hope you will. See accompanying files for the text of the
232 GNU licenses, or <a class="url" href="https://gnu.org/licenses">https://gnu.org/licenses</a>.
233 </p>
234 <a class="index-entry-id" id="index-TeX-Users-Group"></a>
235 <p>If you know enough about TeX to be reading this manual, then you (or
236 your institution) should consider joining the TeX Users Group (if
237 you&rsquo;re already a member, thanks!). TUG produces the periodical
238 <cite class="cite">TUGboat</cite>, sponsors an annual meeting and publishes the
239 proceedings, and arranges courses on TeX for all levels of users
240 throughout the world. See <a class="url" href="https://tug.org">https://tug.org</a> for information.
241 </p>
242
243
244 <ul class="mini-toc">
245 <li><a href="#History" accesskey="1">History</a></li>
246 </ul>
247 <hr>
248 <div class="section-level-extent" id="History">
249 <div class="nav-panel">
250 <p>
251 Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
252 </div>
253 <h3 class="section" id="History-1"><span>1.1 History<a class="copiable-link" href="#History-1"> &para;</a></span></h3>
254
255 <a class="index-entry-id" id="index-history-of-Kpathsea"></a>
256
257 <a class="index-entry-id" id="index-Knuth_002c-Donald-E_002e"></a>
258 <p>This section is for those people who are curious about how the library
259 came about. If you like to read historical accounts of software, we
260 urge you to seek out the GNU Autoconf manual and the &ldquo;Errors of
261 TeX&rdquo; paper by Don Knuth, published in his book <cite class="cite">Digital
262 Typography</cite>, among other places.
263 </p>
264 <a class="index-entry-id" id="index-Morgan_002c-Tim"></a>
265 <a class="index-entry-id" id="index-Rokicki_002c-Tom"></a>
266 <a class="index-entry-id" id="index-Berry_002c-Karl"></a>
267 <a class="index-entry-id" id="index-VAX-11_002f750"></a>
268 <a class="index-entry-id" id="index-Sun-2"></a>
269 <a class="index-entry-id" id="index-pxp-Pascal-preprocessor"></a>
270 <a class="index-entry-id" id="index-pc-Pascal-compiler"></a>
271 <p>[Karl writes.] My first ChangeLog entry for Web2c seems to be
272 February 1990, but I may have done some work before then. In any
273 case, Tim Morgan and I were jointly maintaining it for a time. (I
274 should mention here that Tim had made Web2c into a real distribution
275 long before I had ever used it or even heard of it, and Tom Rokicki
276 did the original implementation. When I started, I was using
277 <code class="code">pxp</code> and <code class="code">pc</code> on VAX 11/750&rsquo;s and the hot new Sun 2
278 machines.)
279 </p>
280 <p>It must have been later in 1990 and 1991 that I started working on
281 <cite class="cite">TeX for the Impatient</cite>. Dvips, Xdvi, Web2c, and the GNU
282 fontutils (which I was also writing at the time) all used different
283 environment variables, and, more importantly, had different bugs in
284 their path searching. This became extremely painful, as I was stressing
285 everything to the limit working on the book. I also desperately wanted
286 to implement subdirectory searching, since I couldn&rsquo;t stand putting
287 everything in one big directory, and also couldn&rsquo;t stand having to
288 explicitly specify <samp class="file">cm</samp>, <samp class="file">pandora</samp>, &hellip; in a path.
289 </p>
290 <a class="index-entry-id" id="index-Vojta_002c-Paul"></a>
291 <p>In the first incarnation, I just hacked separately on each
292 program&mdash;that was the original subdirectory searching code in both
293 Xdvi and Dvips. That is, I tried to go with the flow in each program,
294 rather than changing the program&rsquo;s calling sequences to conform to new
295 routines.
296 </p>
297 <p>Then, as bugs inevitably appeared, I found I was fixing the same thing
298 three times (Web2c and fontutils were already sharing code, since I
299 maintained both of those&mdash;there was no Dvipsk or Xdvik or Dviljk at
300 this point). After a while, I finally started sharing source files.
301 They weren&rsquo;t yet a library, though. I just kept things up to date
302 with shell scripts. (I was developing on a 386 running ISC 2.2 at the
303 time, and so didn&rsquo;t have symbolic links. An awful experience.)
304 </p>
305 <a class="index-entry-id" id="index-MacKenzie_002c-David"></a>
306 <p>The ChangeLogs for Xdvik and Dvipsk record initial releases of those
307 distributions in May and June 1992. I think it was because I was tired
308 of the different configuration strategies of each program, not so much
309 because of the path searching. Autoconf was being developed by David
310 MacKenzie and others, and I was adapting it to TeX and friends.
311 </p>
312 <a class="index-entry-id" id="index-zuhn_002c-david"></a>
313 <p>I started to make a separate library that other programs could link with
314 on my birthday in April 1993, according to the ChangeLog. I don&rsquo;t
315 remember exactly why I finally took the time to make it a separate
316 library; a conversation with david zuhn initiated it. Just seemed
317 like it was time.
318 </p>
319 <a class="index-entry-id" id="index-Walsh_002c-Norman"></a>
320 <a class="index-entry-id" id="index-Neumann_002c-Gustaf"></a>
321 <p>Dviljk got started in March 1994 after I bought a Laserjet 4. (Kpathsea
322 work got suspended while Norm Walsh and I, with Gustaf Neumann&rsquo;s help,
323 implemented a way for TeX to get at all those neat builtin LJ4 fonts
324 &hellip; such a treat to have something to typeset in besides Palatino!)
325 </p>
326 <p>By spring of 1995, I had implemented just about all the path-searching
327 features in Kpathsea that I plan to, driven beyond my initial goals by
328 Thomas Esser and others. I then started to integrate Web2c with
329 Kpathsea. After the release of a stable Web2c, I hope to be able to stop
330 development, and turn most of my attention back to making fonts for GNU.
331 (Always assuming Micros**t hasn&rsquo;t completely obliterated Unix by then,
332 or that software patents haven&rsquo;t stopped software development by anybody
333 smaller than a company with a million-dollar-a-year legal budget. Which
334 is actually what I think is likely to happen, but that&rsquo;s another
335 story&hellip;)
336 </p>
337 <a class="index-entry-id" id="index-Weber_002c-Olaf"></a>
338 <p>[Olaf writes.] At the end of 1997, Unix is still alive and kicking,
339 individuals still develop software, and Web2c development still
340 continues. Karl had been looking for some time for someone to take up
341 part of the burden, and I volunteered.
342 </p>
343 <a class="index-entry-id" id="index-Hoekwater_002c-Taco"></a>
344 <a class="index-entry-id" id="index-Breitenlohner_002c-Peter"></a>
345 <p>[Karl writes again.] Indeed, time goes on. As of 2006 or so, Olaf&rsquo;s
346 available time for Kpathsea was reduced, and I started taking overall
347 care of it again, although I did not do any significant new
348 development. In 2009, Taco Hoekwater implemented a major
349 rearrangement to make the library suitable for use within the MetaPost
350 library (see <a class="pxref" href="#Programming-overview">Programming overview</a>). Also, for some years now,
351 Peter Breitenlohner has made many improvements to the infrastructure
352 and kept it up-to-date with respect to the overall TeX Live build,
353 where Kpathsea is now maintained.
354 </p>
355
356
357 <hr>
358 </div>
359 </div>
360 <div class="chapter-level-extent" id="unixtex_002eftp">
361 <div class="nav-panel">
362 <p>
363 Next: <a href="#Security" accesskey="n" rel="next">Security</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
364 </div>
365 <h2 class="chapter" id="unixtex_002eftp_003a-Obtaining-TeX"><span>2 <samp class="file">unixtex.ftp</samp>: Obtaining TeX<a class="copiable-link" href="#unixtex_002eftp_003a-Obtaining-TeX"> &para;</a></span></h2>
366
367 <a class="index-entry-id" id="index-obtaining-TeX"></a>
368 <a class="index-entry-id" id="index-retrieving-TeX"></a>
369
370 <a class="index-entry-id" id="index-unixtex_002eftp"></a>
371 <a class="index-entry-id" id="index-tug_002eorg"></a>
372 <a class="index-entry-id" id="index-www_002etug_002eorg"></a>
373 <a class="index-entry-id" id="index-ftp_002etug_002eorg"></a>
374 <p>This
375 is <a class="uref" href="ftp://tug.org/tex/unixtex.ftp">ftp://tug.org/tex/unixtex.ftp</a>, a.k.a.
376 <a class="uref" href="https://tug.org/unixtex.ftp">https://tug.org/unixtex.ftp</a>, last updated 29 February 2020.
377 Email <a class="email" href="mailto:[email protected]">[email protected]</a> with comments or questions.
378 </p>
379 <p>The principal free TeX distribution for Unix-like systems is TeX
380 Live, on the web at <a class="url" href="http://tug.org/texlive">http://tug.org/texlive</a>. The pages there
381 describe many ways to acquire and/or build TeX, over the Internet
382 or on physical media, both the sources and precompiled binaries for
383 many systems, either standalone or as part of various operating system
384 distributions.
385 </p>
386 <p>Web2c, Kpathsea, Dvips, and Dviljk, among others, are no longer
387 released as a separate packages. Their sources are now maintained as
388 part of TeX Live.
389 </p>
390 <a class="index-entry-id" id="index-ftp_002ecs_002estanford_002eedu"></a>
391 <a class="index-entry-id" id="index-tex_002eweb"></a>
392 <a class="index-entry-id" id="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by"></a>
393 <p>The host <code class="t">ftp.cs.stanford.edu</code> is the original source for the files
394 for which Donald Knuth is directly responsible: <samp class="file">tex.web</samp>,
395 <samp class="file">plain.tex</samp>, etc. However, unless you want to undertake the
396 project of building your TeX system from scratch, it is more
397 reliable and less work to retrieve these files as part of a larger
398 package.
399 </p>
400 <p>In any case, the Stanford ftp site is not the canonical source for
401 anything except what was created as part of Knuth&rsquo;s original TeX,
402 so do not rely on any other files available there being up-to-date.
403 The best place to check for up-to-date files is CTAN (the
404 Comprehensive TeX Archive Network), <a class="url" href="https://ctan.org">https://ctan.org</a>.
405 </p>
406
407
408 <hr>
409 </div>
410 <div class="chapter-level-extent" id="Security">
411 <div class="nav-panel">
412 <p>
413 Next: <a href="#TeX-directory-structure" accesskey="n" rel="next">TeX directory structure</a>, Previous: <a href="#unixtex_002eftp" accesskey="p" rel="prev"><samp class="file">unixtex.ftp</samp>: Obtaining TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
414 </div>
415 <h2 class="chapter" id="Security-1"><span>3 Security<a class="copiable-link" href="#Security-1"> &para;</a></span></h2>
416
417 <a class="index-entry-id" id="index-security-considerations"></a>
418
419 <p>None of the programs in the TeX system require any special system
420 privileges, so there&rsquo;s no first-level security concern of people gaining
421 illegitimate root access.
422 </p>
423 <p>Thus, the general goal of our security measures is to make an
424 untrusted TeX document safe to execute, in the sense of no document
425 being able to change the system or user configuration, or transmit
426 information to an attacker. Here are some of the steps that have been
427 taken to make the TeX system safe in this regard:
428 </p>
429 <ul class="itemize mark-bullet">
430 <li><a class="index-entry-id" id="index-trojan-horse-attack"></a>
431 <a class="index-entry-id" id="index-_002eprofile_002c-_0028un_0029writable-by-TeX"></a>
432 <a class="index-entry-id" id="index-_005copenout"></a>
433 A TeX document can write to arbitrary files via <code class="code">\openout</code>,
434 e.g., <samp class="file">~/.profile</samp>, and thus an unwitting user who runs TeX on
435 an untrusted document is vulnerable to a trojan horse attack. This
436 loophole is closed by default, but you can be permissive if you so
437 desire in <samp class="file">texmf.cnf</samp>; see the variable <code class="code">openout_any</code>.
438 See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite class="cite">Web2c</cite>. MetaPost has the same issue
439 (Metafont cannot write arbitrary files).
440
441 </li><li><a class="index-entry-id" id="index-shell-commands_002c-security"></a>
442 Dvips, Xdvi, TeX, and others can execute shell commands. By
443 default, only a handful of commands that are believed to be safe, to
444 the best of our ability to check, are allowed. For the list, see the
445 <code class="code">shell_escape_commands</code> variable in <samp class="file">texmf.cnf</samp>
446 (see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Shell-escapes">Shell escapes</a> in <cite class="cite">Web2c</cite>). For more information, e.g.,
447 to disable this completely, see the &lsquo;<samp class="samp">-R</samp>&rsquo; option in <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Option-details">Option
448 details</a> in <cite class="cite">Dvips</cite>, the xdvi man page, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex
449 invocation</a> in <cite class="cite">Web2c</cite>, respectively.
450
451 </li><li><a class="index-entry-id" id="index-LuaTeX-and-security"></a>
452 <a class="index-entry-id" id="index-kpse-mode-of-LuaTeX"></a>
453 <a class="index-entry-id" id="index-ConTeXt-and-_0028no_0029-security"></a>
454 LuaTeX is a special case. Since Lua is a general-purpose
455 programming language, it has all the usual functionality for writing
456 files, executing shell commands, opening network connections, and
457 plenty more. When LuaTeX is used in its so-called &ldquo;kpse&rdquo; mode,
458 as with LuaLaTeX, we have nevertheless done our best to also make
459 it safe to execute by default, by disabling or restricting the various
460 problematic Lua features. See <a class="xref" href="#Safe-filenames">Safe filenames</a>, for a bit more about
461 this. (When LuaTeX is run in non-kpse mode, as with ConTeXt
462 MkIV, everything is allowed; thus, untrusted documents should not be
463 processed.)
464
465 </li><li><a class="index-entry-id" id="index-crashes-of-TeX-and-security"></a>
466 There are some well-known ways to crash TeX, using arithmetic
467 overflow, which Knuth deliberately left unchecked, and other nefarious
468 constructs; some are listed at
469 <a class="url" href="https://tug.org/texmfbug/nobug.html">https://tug.org/texmfbug/nobug.html</a>. While disturbing, TeX
470 has no special system access and so these crashes don&rsquo;t present a
471 security risk.
472
473 </li><li>One more issue is the desire for a globally writable font cache
474 directory; see the section below for this (<a class="ref" href="#Global-font-cache-and-security">Global font cache and security</a>).
475
476 </li></ul>
477
478
479 <ul class="mini-toc">
480 <li><a href="#Global-font-cache-and-security" accesskey="1">Global font cache and security</a></li>
481 </ul>
482 <hr>
483 <div class="section-level-extent" id="Global-font-cache-and-security">
484 <div class="nav-panel">
485 <p>
486 Up: <a href="#Security" accesskey="u" rel="up">Security</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
487 </div>
488 <h3 class="section" id="Global-font-cache-and-security-1"><span>3.1 Global font cache and security<a class="copiable-link" href="#Global-font-cache-and-security-1"> &para;</a></span></h3>
489
490 <a class="index-entry-id" id="index-local-cache-of-fonts"></a>
491 <a class="index-entry-id" id="index-cache-of-fonts_002c-local"></a>
492 <p>It&rsquo;s useful to make arbitrary fonts on user demand with <code class="code">mktexpk</code>
493 and friends. Where do these files get installed? By default, the
494 <code class="code">mktexpk</code> distributed with Kpathsea assumes a world-writable
495 <samp class="file">/var/tmp</samp> directory; this is a simple and convenient approach,
496 but it does not suit all situations, because it means that a local
497 cache of fonts is created on every user&rsquo;s system.
498 </p>
499 <a class="index-entry-id" id="index-globally-writable-directories"></a>
500 <p>To avoid this duplication, many people consider a shared, globally
501 writable font tree desirable, in spite of the potential security
502 problems. To do this you should change the value of <code class="code">VARTEXFONTS</code>
503 in <samp class="file">texmf.cnf</samp> to refer to some globally known directory.
504 See <a class="xref" href="#mktex-configuration"><samp class="file">mktex</samp> configuration</a>.
505 </p>
506 <a class="index-entry-id" id="index-append_002donly-directories-and-mktexpk"></a>
507 <p>The first restriction you can apply is to make newly-created directories
508 under <samp class="file">texmf</samp> be append-only with an option in <samp class="file">mktex.cnf</samp>.
509 See <a class="xref" href="#mktex-configuration"><samp class="file">mktex</samp> configuration</a>.
510 </p>
511 <a class="index-entry-id" id="index-group_002dwritable-directories"></a>
512 <a class="index-entry-id" id="index-setgid-scripts"></a>
513 <p>Another approach is to establish a group (or user) for TeX files,
514 make the <samp class="file">texmf</samp> tree writable only to that group (or user), and
515 make <code class="code">mktexpk</code> et al. setgid to that group (or setuid to that
516 user). Then users must invoke the scripts to install things. (If
517 you&rsquo;re worried about the likelihood of security holes in scripts, you
518 could write a C wrapper to exec the script.)
519 </p>
520 <a class="index-entry-id" id="index-file-permissions"></a>
521 <a class="index-entry-id" id="index-permissions_002c-file"></a>
522 <p>The <samp class="file">mktex&hellip;</samp> scripts install files with the same read and
523 write permissions as the directory they are installed in. The
524 executable, sgid, suid, and sticky bits are always cleared.
525 </p>
526 <a class="index-entry-id" id="index-directory-permissions"></a>
527 <a class="index-entry-id" id="index-permissions_002c-directory"></a>
528 <p>Any directories created by the <samp class="file">mktex&hellip;</samp> scripts have the
529 same permissions as their parent directory, unless the
530 <code class="code">appendonlydir</code> feature is used, in which case the sticky bit is
531 always set.
532 </p>
533 <p>Nowadays, with bitmap files rarely used, and with individual systems
534 being so much more powerful, this is less of an issue than in the
535 past. But the question still comes up occasionally.
536 </p>
537
538 <hr>
539 </div>
540 </div>
541 <div class="chapter-level-extent" id="TeX-directory-structure">
542 <div class="nav-panel">
543 <p>
544 Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Security" accesskey="p" rel="prev">Security</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
545 </div>
546 <h2 class="chapter" id="TeX-directory-structure-1"><span>4 TeX directory structure<a class="copiable-link" href="#TeX-directory-structure-1"> &para;</a></span></h2>
547
548 <a class="index-entry-id" id="index-TEXMF"></a>
549 <a class="index-entry-id" id="index-TeX-directory-structure"></a>
550 <a class="index-entry-id" id="index-directory-structure_002c-for-TeX-files"></a>
551 <a class="index-entry-id" id="index-skeleton-TeX-directory"></a>
552 <a class="index-entry-id" id="index-TDS"></a>
553
554 <p>This section describes the default installation hierarchy of the
555 distribution. It conforms to both the GNU coding standards and the
556 TeX directory structure (TDS) standard. For rationale and further
557 explanation, please see those documents. The GNU document is
558 available from <a class="url" href="https://gnu.org/prep/standards">https://gnu.org/prep/standards</a>. The TDS
559 document is available from <a class="url" href="https://ctan.org/pkg/tds">https://ctan.org/pkg/tds</a>
560 (see <a class="pxref" href="#unixtex_002eftp"><samp class="file">unixtex.ftp</samp>: Obtaining TeX</a>).
561 </p>
562 <p>In short, here is a skeleton of the default directory structure,
563 extracted from the TDS document:
564 </p>
565 <div class="example">
566 <pre class="example-preformatted"><var class="var">prefix</var>/ <span class="r">installation root (<samp class="file">/usr/local</samp> by default)</span>
567 bin/ <span class="r">executables</span>
568 man/ <span class="r">man pages</span>
569 include/ <span class="r">C header files</span>
570 info/ <span class="r">GNU info files</span>
571 lib/ <span class="r">libraries (<samp class="file">libkpathsea.*</samp>)</span>
572 share/ <span class="r">architecture-independent files</span>
573 texmf/ <span class="r">TDS root</span>
574 bibtex/ <span class="r">BibTeX input files</span>
575 bib/ <span class="r">BibTeX databases</span>
576 base/ <span class="r">base distribution (e.g., &lsquo;<samp class="samp">xampl.bib</samp>&rsquo;)</span>
577 misc/ <span class="r">single-file databases</span>
578 <var class="var">pkg</var>/ <span class="r">name of a package</span>
579 bst/ <span class="r">BibTeX style files</span>
580 base/ <span class="r">base distribution (e.g., &lsquo;<samp class="samp">plain.bst</samp>&rsquo;, &lsquo;<samp class="samp">acm.bst</samp>&rsquo;)</span>
581 misc/ <span class="r">single-file styles</span>
582 <var class="var">pkg</var>/ <span class="r">name of a package</span>
583 doc/ <span class="r">additional documentation</span>
584 dvips/ <span class="r">&lsquo;<samp class="samp">.pro</samp>&rsquo;, &lsquo;<samp class="samp">.ps</samp>&rsquo;, &lsquo;<samp class="samp">psfonts.map</samp>&rsquo;</span>
585 fonts/ <span class="r">font-related files</span>
586 <var class="var">type</var>/ <span class="r">file type (e.g., &lsquo;<samp class="samp">tfm</samp>&rsquo;, &lsquo;<samp class="samp">pk</samp>&rsquo;)</span>
587 <var class="var">mode</var>/ <span class="r">type of output device (types &lsquo;<samp class="samp">pk</samp>&rsquo; and &lsquo;<samp class="samp">gf</samp>&rsquo; only)</span>
588 <var class="var">supplier</var>/ <span class="r">name of a font supplier (e.g., &lsquo;<samp class="samp">public</samp>&rsquo;)</span>
589 <var class="var">typeface</var>/ <span class="r">name of a typeface (e.g., &lsquo;<samp class="samp">cm</samp>&rsquo;)</span>
590 dpi<var class="var">nnn</var>/ <span class="r">font resolution (types &lsquo;<samp class="samp">pk</samp>&rsquo; and &lsquo;<samp class="samp">gf</samp>&rsquo; only)</span>
591 metafont/ <span class="r">Metafont (non-font) input files</span>
592 base/ <span class="r">base distribution (e.g., &lsquo;<samp class="samp">plain.mf</samp>&rsquo;)</span>
593 misc/ <span class="r">single-file packages (e.g., &lsquo;<samp class="samp">modes.mf</samp>&rsquo;)</span>
594 <var class="var">pkg</var>/ <span class="r">name of a package (e.g., &lsquo;<samp class="samp">mfpic</samp>&rsquo;)</span>
595 metapost/ <span class="r">MetaPost input files</span>
596 base/ <span class="r">base distribution (e.g., &lsquo;<samp class="samp">plain.mp</samp>&rsquo;)</span>
597 misc/ <span class="r">single-file packages</span>
598 <var class="var">pkg</var>/ <span class="r">name of a package</span>
599 support/ <span class="r">support files for MetaPost-related utilities (e.g., &lsquo;<samp class="samp">trfonts.map</samp>&rsquo;)</span>
600 mft/ <span class="r">&lsquo;<samp class="samp">MFT</samp>&rsquo; inputs (e.g., &lsquo;<samp class="samp">plain.mft</samp>&rsquo;)</span>
601 tex/ <span class="r">TeX input files</span>
602 <var class="var">format</var>/ <span class="r">name of a format (e.g., &lsquo;<samp class="samp">plain</samp>&rsquo;)</span>
603 base/ <span class="r">base distribution for <var class="var">format</var> (e.g., &lsquo;<samp class="samp">plain.tex</samp>&rsquo;)</span>
604 misc/ <span class="r">single-file packages (e.g., &lsquo;<samp class="samp">webmac.tex</samp>&rsquo;)</span>
605 local/ <span class="r">local additions to or local configuration files for <var class="var">format</var></span>
606 <var class="var">pkg</var>/ <span class="r">name of a package (e.g., &lsquo;<samp class="samp">graphics</samp>&rsquo;, &lsquo;<samp class="samp">mfnfss</samp>&rsquo;)</span>
607 generic/ <span class="r">format-independent packages</span>
608 hyphen/ <span class="r">hyphenation patterns (e.g., &lsquo;<samp class="samp">hyphen.tex</samp>&rsquo;)</span>
609 images/ <span class="r">image input files (e.g., Encapsulated PostScript)</span>
610 misc/ <span class="r">single-file format-independent packages (e.g., &lsquo;<samp class="samp">null.tex</samp>&rsquo;).</span>
611 <var class="var">pkg</var>/ <span class="r">name of a package (e.g., &lsquo;<samp class="samp">babel</samp>&rsquo;)</span>
612 web2c/ <span class="r">implementation-dependent files (<samp class="file">.pool</samp>, <samp class="file">.fmt</samp>, <samp class="file">texmf.cnf</samp>, etc.)</span>
613 </pre></div>
614
615 <p>Some concrete examples for most file types:
616 </p>
617 <div class="example">
618 <pre class="example-preformatted">/usr/local/bin/tex
619 /usr/local/man/man1/xdvi.1
620 /usr/local/info/kpathsea.info
621 /usr/local/lib/libkpathsea.a
622 /usr/local/share/texmf/bibtex/bst/base/plain.bst
623 /usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmr10.600pk
624 /usr/local/share/texmf/fonts/source/public/pandora/pnr10.mf
625 /usr/local/share/texmf/fonts/tfm/public/cm/cmr10.tfm
626 /usr/local/share/texmf/fonts/type1/adobe/utopia/putr.pfa
627 /usr/local/share/texmf/metafont/base/plain.mf
628 /usr/local/share/texmf/metapost/base/plain.mp
629 /usr/local/share/texmf/tex/plain/base/plain.tex
630 /usr/local/share/texmf/tex/generic/hyphen/hyphen.tex
631 /usr/local/share/texmf/web2c/tex.pool
632 /usr/local/share/texmf/web2c/tex.fmt
633 /usr/local/share/texmf/web2c/texmf.cnf
634 </pre></div>
635
636
637 <hr>
638 </div>
639 <div class="chapter-level-extent" id="Path-searching">
640 <div class="nav-panel">
641 <p>
642 Next: <a href="#TeX-support" accesskey="n" rel="next">TeX support</a>, Previous: <a href="#TeX-directory-structure" accesskey="p" rel="prev">TeX directory structure</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
643 </div>
644 <h2 class="chapter" id="Path-searching-1"><span>5 Path searching<a class="copiable-link" href="#Path-searching-1"> &para;</a></span></h2>
645
646 <a class="index-entry-id" id="index-path-searching"></a>
647
648 <p>This chapter describes the generic path searching mechanism Kpathsea
649 provides. For information about searching for particular file types
650 (e.g., TeX fonts), see the next chapter.
651 </p>
652 <a class="index-entry-id" id="index-translations_002c-of-path-searching-description"></a>
653 <p>This section, with minor differences, has been translated into several
654 other languages (Chinese, Spanish, Russian, Japanese, French, German,
655 &hellip;) as part of the TeX Live guide; see
656 <a class="url" href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a> for links.
657 </p>
658
659
660 <ul class="mini-toc">
661 <li><a href="#Searching-overview" accesskey="1">Searching overview</a></li>
662 <li><a href="#Path-sources" accesskey="2">Path sources</a></li>
663 <li><a href="#Path-expansion" accesskey="3">Path expansion</a></li>
664 <li><a href="#Casefolding-search" accesskey="4">Casefolding search</a></li>
665 <li><a href="#Filename-database" accesskey="5">Filename database (<code class="code">ls-R</code>)</a></li>
666 <li><a href="#Invoking-kpsewhich" accesskey="6"><code class="code">kpsewhich</code>: Standalone path searching</a></li>
667 </ul>
668 <hr>
669 <div class="section-level-extent" id="Searching-overview">
670 <div class="nav-panel">
671 <p>
672 Next: <a href="#Path-sources" accesskey="n" rel="next">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
673 </div>
674 <h3 class="section" id="Searching-overview-1"><span>5.1 Searching overview<a class="copiable-link" href="#Searching-overview-1"> &para;</a></span></h3>
675
676 <a class="index-entry-id" id="index-searching-overview"></a>
677 <a class="index-entry-id" id="index-path-searching_002c-overview"></a>
678 <a class="index-entry-id" id="index-overview-of-path-searching"></a>
679
680 <a class="index-entry-id" id="index-search-path_002c-defined"></a>
681 <p>A <em class="dfn">search path</em> is a colon-separated list of <em class="dfn">path elements</em>,
682 which are directory names with a few extra frills. A search path can
683 come from (a combination of) many sources; see below. To look up a file
684 &lsquo;<samp class="samp">foo</samp>&rsquo; along a path &lsquo;<samp class="samp">.:/dir</samp>&rsquo;, Kpathsea checks each element of
685 the path in turn: first <samp class="file">./foo</samp>, then <samp class="file">/dir/foo</samp>, returning
686 the first match (or possibly all matches).
687 </p>
688 <a class="index-entry-id" id="index-magic-characters"></a>
689 <a class="index-entry-id" id="index-_003a-may-not-be-_003a"></a>
690 <a class="index-entry-id" id="index-_002f-may-not-be-_002f"></a>
691 <p>The &ldquo;colon&rdquo; and &ldquo;slash&rdquo; mentioned here aren&rsquo;t necessarily &lsquo;<samp class="samp">:</samp>&rsquo;
692 and &lsquo;<samp class="samp">/</samp>&rsquo; on non-Unix systems. Kpathsea tries to adapt to other
693 operating systems&rsquo; conventions.
694 </p>
695 <a class="index-entry-id" id="index-database-search"></a>
696 <a class="index-entry-id" id="index-searching-the-database"></a>
697 <p>To check a particular path element <var class="var">e</var>, Kpathsea first sees if a
698 prebuilt database (see <a class="pxref" href="#Filename-database">Filename database (<code class="code">ls-R</code>)</a>) applies to <var class="var">e</var>, i.e.,
699 if the database is in a directory that is a prefix of <var class="var">e</var>. If so,
700 the path specification is matched against the contents of the database.
701 </p>
702 <a class="index-entry-id" id="index-floating-directories"></a>
703 <a class="index-entry-id" id="index-filesystem-search"></a>
704 <a class="index-entry-id" id="index-disk-search"></a>
705 <a class="index-entry-id" id="index-searching-the-disk"></a>
706 <p>If the database does not exist, or does not apply to this path element,
707 or contains no matches, the filesystem is searched (if this was not
708 forbidden by the specification with &lsquo;<samp class="samp">!!</samp>&rsquo; and if the file being
709 searched for must exist). Kpathsea constructs the list of directories
710 that correspond to this path element, and then checks in each for the
711 file being searched for. (To help speed future lookups of files in the
712 same directory, the directory in which a file is found is floated to the
713 top of the directory list.)
714 </p>
715 <a class="index-entry-id" id="index-must-exist"></a>
716 <a class="index-entry-id" id="index-VF-files_002c-not-found"></a>
717 <a class="index-entry-id" id="index-cmr10_002evf"></a>
718 <a class="index-entry-id" id="index-_005copenin"></a>
719 <p>The &ldquo;file must exist&rdquo; condition comes into play with VF files and
720 input files read by the TeX &lsquo;<samp class="samp">\openin</samp>&rsquo; command. These files
721 might very well not exist (consider <samp class="file">cmr10.vf</samp>), and so it would
722 be wrong to search the disk for them. Therefore, if you fail to
723 update <samp class="file">ls-R</samp> when you install a new VF file, it will not be
724 found.
725 </p>
726 <p>Each path element is checked in turn: first the database, then the
727 disk. If a match is found, the search stops and the result is
728 returned (unless the search explicitly requested all matches). This
729 avoids possibly-expensive processing of path specifications that are
730 never needed on a particular run.
731 </p>
732 <p>On Unix-like systems, if no match is found by any of the above, and
733 the path element allows checking the filesystem (per the above), a
734 final check is made for a case-insensitive match. Thus, looking for a
735 name like &lsquo;<samp class="samp">./FooBar.TeX</samp>&rsquo; will match a file &lsquo;<samp class="samp">./foobar.tex</samp>&rsquo;,
736 and vice versa. This is not done on Windows. See <a class="xref" href="#Casefolding-search">Casefolding search</a>.
737 </p>
738 <a class="index-entry-id" id="index-expansion_002c-path-element"></a>
739 <p>Although the simplest and most common path element is a directory name,
740 Kpathsea supports additional features in search paths: layered default
741 values, environment variable names, config file values, users&rsquo; home
742 directories, and recursive subdirectory searching. Thus, we say that
743 Kpathsea <em class="dfn">expands</em> a path element, meaning transforming all the
744 magic specifications into the basic directory name or names. This
745 process is described in the sections below. It happens in the same
746 order as the sections.
747 </p>
748 <a class="index-entry-id" id="index-absolute-filenames"></a>
749 <a class="index-entry-id" id="index-relative-filenames"></a>
750 <a class="index-entry-id" id="index-explicitly-relative-filenames"></a>
751 <a class="index-entry-id" id="index-filenames_002c-absolute-or-explicitly-relative"></a>
752 <p>Exception to all of the above: If the filename being searched for is
753 absolute or explicitly relative, i.e., starts with &lsquo;<samp class="samp">/</samp>&rsquo; or &lsquo;<samp class="samp">./</samp>&rsquo;
754 or &lsquo;<samp class="samp">../</samp>&rsquo;, Kpathsea simply checks if that file exists, with a
755 fallback to a casefolding match if needed and enabled, as described above.
756 </p>
757 <a class="index-entry-id" id="index-permission-denied"></a>
758 <a class="index-entry-id" id="index-unreadable-files"></a>
759 <a class="index-entry-id" id="index-access-warnings"></a>
760 <a class="index-entry-id" id="index-warnings_002c-file-access"></a>
761 <a class="index-entry-id" id="index-lost_002bfound-directory"></a>
762 <a class="index-entry-id" id="index-TEX_005fHUSH"></a>
763 <p>Ordinarily, if Kpathsea tries to access a file or directory that
764 cannot be read, it gives a warning. This is so you will be alerted to
765 directories or files that accidentally lack any read permission (for
766 example, a <samp class="file">lost+found</samp> directory). If you prefer not to see
767 these warnings, include the value &lsquo;<samp class="samp">readable</samp>&rsquo; in the
768 <code class="code">TEX_HUSH</code> environment variable or config file value.
769 </p>
770 <p>This generic path searching algorithm is implemented in
771 <samp class="file">kpathsea/pathsearch.c</samp>. It is employed by a higher-level
772 algorithm when searching for a file of a particular type (see <a class="pxref" href="#File-lookup">File lookup</a>, and <a class="ref" href="#Glyph-lookup">Glyph lookup</a>).
773 </p>
774
775 <hr>
776 </div>
777 <div class="section-level-extent" id="Path-sources">
778 <div class="nav-panel">
779 <p>
780 Next: <a href="#Path-expansion" accesskey="n" rel="next">Path expansion</a>, Previous: <a href="#Searching-overview" accesskey="p" rel="prev">Searching overview</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
781 </div>
782 <h3 class="section" id="Path-sources-1"><span>5.2 Path sources<a class="copiable-link" href="#Path-sources-1"> &para;</a></span></h3>
783
784 <a class="index-entry-id" id="index-path-sources"></a>
785 <a class="index-entry-id" id="index-sources-for-search-paths"></a>
786
787 <p>A search path or other configuration value can come from many sources.
788 In the order in which Kpathsea looks for them:
789 </p>
790 <ol class="enumerate">
791 <li> <a class="index-entry-id" id="index-_002d_002dcnf_002dline_002c-source-for-path"></a>
792 A command-line option such as <code class="code">--cnf-line</code>, available in
793 <samp class="file">kpsewhich</samp> and most TeX engines. See <a class="xref" href="#Path-searching-options">Path searching options</a>.
794
795 <a class="index-entry-id" id="index-environment-variable_002c-source-for-path"></a>
796 <p>A user-set environment variable, e.g., <code class="code">TEXINPUTS</code>.
797 Environment variables with an underscore and the program name appended
798 override; for example, <code class="code">TEXINPUTS_latex</code> overrides <code class="code">TEXINPUTS</code>
799 if the program being run is named &lsquo;<samp class="samp">latex</samp>&rsquo;.
800 </p>
801 </li><li> A program-specific configuration file, e.g., an &lsquo;<samp class="samp">S /a:/b</samp>&rsquo; line in
802 Dvips&rsquo; <samp class="file">config.ps</samp> (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite class="cite">Dvips</cite>).
803
804 </li><li> <a class="index-entry-id" id="index-configuration-file_002c-source-for-path"></a>
805 <a class="index-entry-id" id="index-Kpathsea-config-file_002c-source-for-path"></a>
806 <a class="index-entry-id" id="index-texmf_002ecnf_002c-source-for-path"></a>
807 A line in a Kpathsea configuration file <samp class="file">texmf.cnf</samp>, e.g.,
808 &lsquo;<samp class="samp">TEXINPUTS=/c:/d</samp>&rsquo; (see below).
809
810 </li><li> <a class="index-entry-id" id="index-compilation-value_002c-source-for-path"></a>
811 The compile-time default (specified in <samp class="file">kpathsea/paths.h</samp>).
812 </li></ol>
813
814 <p>You can see each of these values for a given search path by using the
815 debugging options (see <a class="pxref" href="#Debugging">Debugging</a>).
816 </p>
817 <p>These sources may be combined via default expansion (see <a class="pxref" href="#Default-expansion">Default expansion</a>).
818 </p>
819
820
821 <ul class="mini-toc">
822 <li><a href="#Config-files" accesskey="1">Config files</a></li>
823 </ul>
824 <hr>
825 <div class="subsection-level-extent" id="Config-files">
826 <div class="nav-panel">
827 <p>
828 Up: <a href="#Path-sources" accesskey="u" rel="up">Path sources</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
829 </div>
830 <h4 class="subsection" id="Config-files-1"><span>5.2.1 Config files<a class="copiable-link" href="#Config-files-1"> &para;</a></span></h4>
831
832 <a class="index-entry-id" id="index-config-files"></a>
833 <a class="index-entry-id" id="index-texmf_002ecnf_002c-definition-for"></a>
834
835 <a class="index-entry-id" id="index-runtime-configuration-files"></a>
836 <a class="index-entry-id" id="index-TEXMFCNF"></a>
837 <p>As mentioned above, Kpathsea reads <em class="dfn">runtime configuration files</em>
838 named <samp class="file">texmf.cnf</samp> for search path and other definitions. The
839 search path used to look for these configuration files is named
840 <code class="code">TEXMFCNF</code>, and is constructed in the usual way, as described
841 above, except that configuration files cannot be used to define the
842 path, naturally; also, an <samp class="file">ls-R</samp> database is not used to search for
843 them.
844 </p>
845 <p>Kpathsea reads <em class="emph">all</em> <samp class="file">texmf.cnf</samp> files in the search path, not
846 just the first one found; definitions in earlier files override those in
847 later files. Thus, if the search path is &lsquo;<samp class="samp">.:$TEXMF</samp>&rsquo;, values from
848 <samp class="file">./texmf.cnf</samp> override those from <samp class="file">$TEXMF/texmf.cnf</samp>.
849 </p>
850 <a class="index-entry-id" id="index-KPATHSEA_005fWARNING"></a>
851 <a class="index-entry-id" id="index-warning_002c-about-missing-texmf_002ecnf"></a>
852 <a class="index-entry-id" id="index-texmf_002ecnf-missing_002c-warning-about"></a>
853 <p>If Kpathsea cannot find any <samp class="file">texmf.cnf</samp> file, it reports a
854 warning including all the directories it checked. If you don&rsquo;t want
855 to see this warning, set the environment variable
856 <code class="env">KPATHSEA_WARNING</code> to the single character &lsquo;<samp class="samp">0</samp>&rsquo; (zero, not
857 oh).
858 </p>
859 <p>While (or instead of) reading this description, you may find it helpful
860 to look at the distributed <samp class="file">texmf.cnf</samp>, which uses or at least
861 mentions most features. The format of <samp class="file">texmf.cnf</samp> files follows:
862 </p>
863 <ul class="itemize mark-bullet">
864 <li><a class="index-entry-id" id="index-comments_002c-in-texmf_002ecnf"></a>
865 Comments start with &lsquo;<samp class="samp">%</samp>&rsquo; or &lsquo;<samp class="samp">#</samp>&rsquo;, either at the beginning of a
866 line or preceded by whitespace, and continue to the end of the line.
867 That is, similar to most shells, a comment character in the &ldquo;middle&rdquo;
868 of a value does not start a comment. Examples:
869
870 <div class="example">
871 <pre class="example-preformatted">% this is a comment
872 var = a%b % but the value of var will be &quot;a%b&quot;
873 </pre></div>
874
875 </li><li><a class="index-entry-id" id="index-blank-lines_002c-in-texmf_002ecnf"></a>
876 Blank lines are ignored.
877
878 </li><li><a class="index-entry-id" id="index-backslash_002dnewline"></a>
879 <a class="index-entry-id" id="index-continuation-character"></a>
880 <a class="index-entry-id" id="index-whitespace_002c-not-ignored-on-continuation-lines"></a>
881 <a class="index-entry-id" id="index-_005c_002c-line-continuation-in-texmf_002ecnf"></a>
882 A &lsquo;<samp class="samp">\</samp>&rsquo; at the end of a line acts as a continuation character, i.e.,
883 the next line is appended. Whitespace at the beginning of continuation
884 lines is not ignored.
885
886 </li><li>Each remaining line will look like:
887
888 <div class="example">
889 <pre class="example-preformatted"><var class="var">variable</var> <span class="r">[</span>. <var class="var">progname</var><span class="r">]</span> <span class="r">[</span>=<span class="r">]</span> <var class="var">value</var>
890 </pre></div>
891
892 <p>where the &lsquo;<samp class="samp">=</samp>&rsquo; and surrounding whitespace is optional.
893 </p>
894 </li><li><a class="index-entry-id" id="index-identifiers_002c-characters-valid-in"></a>
895 The <var class="var">variable</var> name may contain any character other than whitespace,
896 &lsquo;<samp class="samp">=</samp>&rsquo;, or &lsquo;<samp class="samp">.</samp>&rsquo;, but sticking to &lsquo;<samp class="samp">A-Za-z_</samp>&rsquo; is safest.
897
898 </li><li><a class="index-entry-id" id="index-_002eprogname-qualifier-in-texmf_002ecnf"></a>
899 If &lsquo;<samp class="samp">.<var class="var">progname</var></samp>&rsquo; is present (preceding spaces are
900 ignored), the definition only applies if the program that is running
901 is named (i.e., the last component of <code class="code">argv[0]</code> is)
902 <var class="var">progname</var> or <samp class="file"><var class="var">progname</var>.{exe,bat,cmd,...}</samp>. Most
903 notably, this allows different flavors of TeX to have different
904 search paths. The <var class="var">progname</var> value is used literally, without
905 variable or other expansions.
906
907 </li><li><a class="index-entry-id" id="index-right_002dhand-side-of-variable-assignments"></a>
908 Considered as strings, <var class="var">value</var> may contain any character.
909 However, in practice most <samp class="file">texmf.cnf</samp> values are related to path
910 expansion, and since various special characters are used in expansion,
911 such as braces and commas, they cannot be used in directory names.
912
913 <p>The &lsquo;<samp class="samp">$<var class="var">var</var>.<var class="var">prog</var></samp>&rsquo; feature is not available on the
914 right-hand side; instead, you must use an additional variable (see
915 below for example).
916 </p>
917 <a class="index-entry-id" id="index-_003b-translated-to-_003a-in-texmf_002ecnf"></a>
918 <p>A &lsquo;<samp class="samp">;</samp>&rsquo; in <var class="var">value</var> is translated to &lsquo;<samp class="samp">:</samp>&rsquo; if running under
919 Unix, in order to have a single <samp class="file">texmf.cnf</samp> that can support both
920 Unix and Windows systems. This translation happens with any value, not
921 just search paths, but fortunately in practice &lsquo;<samp class="samp">;</samp>&rsquo; is not needed
922 in other values.
923 </p>
924 </li><li>All definitions are read before anything is expanded, so you can
925 use variables before they are defined (like Make, unlike most other
926 programs).
927 </li></ul>
928
929 <p>Here is a configuration file fragment illustrating most of
930 these points:
931 </p>
932 <div class="example">
933 <pre class="example-preformatted">% TeX input files -- i.e., anything to be found by \input or \openin ...
934 latex209_inputs = .:$TEXMF/tex/latex209//:$TEXMF/tex//
935 latex2e_inputs = .:$TEXMF/tex/latex//:$TEXMF/tex//
936 TEXINPUTS = .:$TEXMF/tex//
937 TEXINPUTS.latex209 = $latex209_inputs
938 TEXINPUTS.latex2e = $latex2e_inputs
939 TEXINPUTS.latex = $latex2e_inputs
940 </pre></div>
941
942 <a class="index-entry-id" id="index-_003d-omitted-in-texmf_002ecnf-and-misparsing"></a>
943 <p>The combination of spaces being ignored before the <code class="code">.</code> of a
944 program name qualifer and the optional &lsquo;<samp class="samp">=</samp>&rsquo; for the assignment has
945 an unexpected consequence: if the value begins with a literal &lsquo;<samp class="samp">.</samp>&rsquo;
946 and the &lsquo;<samp class="samp">=</samp>&rsquo; is omitted, the intended value is interpreted as a
947 program name. For example, a line <code class="code">var .;/some/path</code> is taken as
948 an empty value for <code class="code">var</code> running under the program named
949 &lsquo;<samp class="samp">;/some/path</samp>&rsquo;. To diagnose this, Kpathsea warns if the program
950 name contains a path separator or other special character. The
951 simplest way to avoid the problem is to use the <code class="code">=</code>.
952 </p>
953 <p>Exactly when a character will be considered special or act as itself
954 depends on the context in which it is used. The rules are inherent in
955 the multiple levels of interpretation of the configuration (parsing,
956 expansion, search, &hellip;) and so cannot be concisely stated,
957 unfortunately. There is no general escape mechanism; in particular,
958 &lsquo;<samp class="samp">\</samp>&rsquo; is not an &ldquo;escape character&rdquo; in <samp class="file">texmf.cnf</samp> files.
959 When it comes choosing directory names for installation, it is safest to
960 avoid them all.
961 </p>
962 <a class="index-entry-id" id="index-cnf_002ec"></a>
963 <p>The implementation of all this is in <samp class="file">kpathsea/cnf.c</samp>.
964 </p>
965
966 <hr>
967 </div>
968 </div>
969 <div class="section-level-extent" id="Path-expansion">
970 <div class="nav-panel">
971 <p>
972 Next: <a href="#Casefolding-search" accesskey="n" rel="next">Casefolding search</a>, Previous: <a href="#Path-sources" accesskey="p" rel="prev">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
973 </div>
974 <h3 class="section" id="Path-expansion-1"><span>5.3 Path expansion<a class="copiable-link" href="#Path-expansion-1"> &para;</a></span></h3>
975
976 <a class="index-entry-id" id="index-path-expansion"></a>
977 <a class="index-entry-id" id="index-expansion_002c-search-path"></a>
978
979 <p>Kpathsea recognizes certain special characters and constructions in
980 search paths, similar to that in shells. As a general example:
981 &lsquo;<samp class="samp">~$USER/{foo,bar}//baz</samp>&rsquo; expands to all subdirectories under
982 directories <samp class="file">foo</samp> and <samp class="file">bar</samp> in <code class="t">$USER</code>&rsquo;s home directory that
983 contain a directory or file <samp class="file">baz</samp>.
984 </p>
985 <p>These expansions are explained in the sections below.
986 </p>
987
988
989 <ul class="mini-toc">
990 <li><a href="#Default-expansion" accesskey="1">Default expansion</a></li>
991 <li><a href="#Variable-expansion" accesskey="2">Variable expansion</a></li>
992 <li><a href="#Tilde-expansion" accesskey="3">Tilde expansion</a></li>
993 <li><a href="#Brace-expansion" accesskey="4">Brace expansion</a></li>
994 <li><a href="#KPSE_005fDOT-expansion" accesskey="5"><code class="code">KPSE_DOT</code> expansion</a></li>
995 <li><a href="#Subdirectory-expansion" accesskey="6">Subdirectory expansion</a></li>
996 </ul>
997 <hr>
998 <div class="subsection-level-extent" id="Default-expansion">
999 <div class="nav-panel">
1000 <p>
1001 Next: <a href="#Variable-expansion" accesskey="n" rel="next">Variable expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1002 </div>
1003 <h4 class="subsection" id="Default-expansion-1"><span>5.3.1 Default expansion<a class="copiable-link" href="#Default-expansion-1"> &para;</a></span></h4>
1004
1005 <a class="index-entry-id" id="index-_003a_003a-expansion"></a>
1006 <a class="index-entry-id" id="index-doubled-colons"></a>
1007 <a class="index-entry-id" id="index-leading-colons"></a>
1008 <a class="index-entry-id" id="index-trailing-colons"></a>
1009 <a class="index-entry-id" id="index-extra-colons"></a>
1010 <a class="index-entry-id" id="index-default-expansion"></a>
1011 <a class="index-entry-id" id="index-expansion_002c-default"></a>
1012
1013 <p>If the highest-priority search path (see <a class="pxref" href="#Path-sources">Path sources</a>) contains an
1014 <em class="dfn">extra colon</em> (i.e., leading, trailing, or doubled), Kpathsea
1015 inserts at that point the next-highest-priority search path that is
1016 defined. If that inserted path has an extra colon, the same happens
1017 with the next-highest. (An extra colon in the compile-time default
1018 value has unpredictable results, so installers beware.)
1019 </p>
1020 <p>For example, given an environment variable setting
1021 </p>
1022 <div class="example">
1023 <pre class="example-preformatted">setenv TEXINPUTS /home/karl:
1024 </pre></div>
1025
1026 <p>and a <code class="code">TEXINPUTS</code> value from <samp class="file">texmf.cnf</samp> of
1027 </p>
1028 <div class="example">
1029 <pre class="example-preformatted">.:$TEXMF//tex
1030 </pre></div>
1031
1032 <p>then the final value used for searching will be:
1033 </p>
1034 <div class="example">
1035 <pre class="example-preformatted">/home/karl:.:$TEXMF//tex
1036 </pre></div>
1037
1038 <p>Put another way, default expansion works on &ldquo;formats&rdquo; (search
1039 paths), and not directly on environment variables. Example, showing
1040 the trailing &lsquo;<samp class="samp">:</samp>&rsquo; ignored in the first case and expanded in the second:
1041 </p>
1042 <div class="example">
1043 <pre class="example-preformatted">$ env TTFONTS=/tmp: kpsewhich --expand-path '$TTFONTS'
1044 /tmp
1045 $ env TTFONTS=/tmp: kpsewhich --show-path=.ttf
1046 /tmp:.:/home/olaf/texmf/fonts/truetype//:...
1047 </pre></div>
1048
1049 <p>Since Kpathsea looks for multiple configuration files, it would be
1050 natural to expect that (for example) an extra colon in
1051 <samp class="file">./texmf.cnf</samp> would expand to the path in <samp class="file">$TEXMF/texmf.cnf</samp>.
1052 Or, with Dvips&rsquo; configuration files, that an extra colon in
1053 <samp class="file">config.$PRINTER</samp> would expand to the path in <samp class="file">config.ps</samp>.
1054 This doesn&rsquo;t happen. It&rsquo;s not clear this would be desirable in all
1055 cases, and trying to devise a way to specify the path to which the extra
1056 colon should expand seemed truly baroque.
1057 <a class="index-entry-id" id="index-Bach_002c-Johann-Sebastian"></a>
1058 </p>
1059 <p>Technicality: Since it would be useless to insert the default value in
1060 more than one place, Kpathsea changes only one extra &lsquo;<samp class="samp">:</samp>&rsquo; and leaves
1061 any others in place (they will eventually be ignored). Kpathsea checks
1062 first for a leading &lsquo;<samp class="samp">:</samp>&rsquo;, then a trailing &lsquo;<samp class="samp">:</samp>&rsquo;, then a doubled
1063 &lsquo;<samp class="samp">:</samp>&rsquo;.
1064 </p>
1065 <a class="index-entry-id" id="index-kdefault_002ec"></a>
1066 <p>You can trace this by debugging &ldquo;paths&rdquo; (see <a class="pxref" href="#Debugging">Debugging</a>).
1067 Default expansion is implemented in the source file
1068 <samp class="file">kpathsea/kdefault.c</samp>.
1069 </p>
1070
1071 <hr>
1072 </div>
1073 <div class="subsection-level-extent" id="Variable-expansion">
1074 <div class="nav-panel">
1075 <p>
1076 Next: <a href="#Tilde-expansion" accesskey="n" rel="next">Tilde expansion</a>, Previous: <a href="#Default-expansion" accesskey="p" rel="prev">Default expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1077 </div>
1078 <h4 class="subsection" id="Variable-expansion-1"><span>5.3.2 Variable expansion<a class="copiable-link" href="#Variable-expansion-1"> &para;</a></span></h4>
1079
1080 <a class="index-entry-id" id="index-_0024-expansion"></a>
1081 <a class="index-entry-id" id="index-environment-variables-in-paths"></a>
1082 <a class="index-entry-id" id="index-variable-expansion"></a>
1083 <a class="index-entry-id" id="index-expansion_002c-variable"></a>
1084 <a class="index-entry-id" id="index-texmf_002ecnf_002c-and-variable-expansion"></a>
1085
1086 <p>&lsquo;<samp class="samp">$foo</samp>&rsquo; or &lsquo;<samp class="samp">${foo}</samp>&rsquo; in a path element is replaced by (1) the
1087 value of an environment variable &lsquo;<samp class="samp">foo</samp>&rsquo; (if defined); (2) the value
1088 of &lsquo;<samp class="samp">foo</samp>&rsquo; from <samp class="file">texmf.cnf</samp> (if defined); (3) the empty string.
1089 </p>
1090 <p>If the character after the &lsquo;<samp class="samp">$</samp>&rsquo; is alphanumeric or &lsquo;<samp class="samp">_</samp>&rsquo;, the
1091 variable name consists of all consecutive such characters. If the
1092 character after the &lsquo;<samp class="samp">$</samp>&rsquo; is a &lsquo;<samp class="samp">{</samp>&rsquo;, the variable name consists
1093 of everything up to the next &lsquo;<samp class="samp">}</samp>&rsquo; (braces may not be nested around
1094 variable names). Otherwise, Kpathsea gives a warning and ignores the
1095 &lsquo;<samp class="samp">$</samp>&rsquo; and its following character.
1096 </p>
1097 <a class="index-entry-id" id="index-quoting-variable-values"></a>
1098 <a class="index-entry-id" id="index-shell-variables"></a>
1099 <p>You must quote the <code class="t">$</code>&rsquo;s and braces as necessary for your shell.
1100 <em class="emph">Shell</em> variable values cannot be seen by Kpathsea, i.e., ones
1101 defined by <code class="code">set</code> in C shells and without <code class="code">export</code> in Bourne
1102 shells.
1103 </p>
1104 <p>For example, given
1105 </p><div class="example">
1106 <pre class="example-preformatted">setenv tex /home/texmf
1107 setenv TEXINPUTS .:$tex:${tex}prev
1108 </pre></div>
1109 <p>the final <code class="code">TEXINPUTS</code> path is the three directories:
1110 </p><div class="example">
1111 <pre class="example-preformatted">.:/home/texmf:/home/texmfprev
1112 </pre></div>
1113
1114 <p>The &lsquo;<samp class="samp">.<var class="var">progname</var></samp>&rsquo; suffix on variables and
1115 &lsquo;<samp class="samp">_<var class="var">progname</var></samp>&rsquo; on environment variable names are not implemented
1116 for general variable expansions. These are only recognized when search
1117 paths are initialized (see <a class="pxref" href="#Path-sources">Path sources</a>).
1118 </p>
1119 <a class="index-entry-id" id="index-variable_002ec"></a>
1120 <p>Variable expansion is implemented in the source file
1121 <samp class="file">kpathsea/variable.c</samp>.
1122 </p>
1123
1124 <hr>
1125 </div>
1126 <div class="subsection-level-extent" id="Tilde-expansion">
1127 <div class="nav-panel">
1128 <p>
1129 Next: <a href="#Brace-expansion" accesskey="n" rel="next">Brace expansion</a>, Previous: <a href="#Variable-expansion" accesskey="p" rel="prev">Variable expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1130 </div>
1131 <h4 class="subsection" id="Tilde-expansion-1"><span>5.3.3 Tilde expansion<a class="copiable-link" href="#Tilde-expansion-1"> &para;</a></span></h4>
1132
1133 <a class="index-entry-id" id="index-_007e-expansion"></a>
1134 <a class="index-entry-id" id="index-home-directories-in-paths"></a>
1135 <a class="index-entry-id" id="index-tilde-expansion"></a>
1136 <a class="index-entry-id" id="index-expansion_002c-tilde"></a>
1137
1138 <a class="index-entry-id" id="index-HOME_002c-as-_007e-expansion"></a>
1139 <a class="index-entry-id" id="index-USERPROFILE_002c-as-_007e-expansion"></a>
1140 <p>A leading &lsquo;<samp class="samp">~</samp>&rsquo; in a path element is replaced by the value of the
1141 environment variable <code class="code">HOME</code>, or <samp class="file">.</samp> if <code class="code">HOME</code> is not
1142 set. On Windows, the environment variable <code class="code">USERPROFILE</code> is
1143 checked instead of <code class="code">HOME</code>.
1144 </p>
1145 <p>A leading &lsquo;<samp class="samp">~<var class="var">user</var></samp>&rsquo; in a path element is replaced by
1146 <var class="var">user</var>&rsquo;s home directory from the system <samp class="file">passwd</samp> database.
1147 </p>
1148 <p>For example,
1149 </p><div class="example">
1150 <pre class="example-preformatted">setenv TEXINPUTS ~/mymacros:
1151 </pre></div>
1152
1153 <p>will prepend a directory <samp class="file">mymacros</samp> in your home
1154 directory to the default path.
1155 </p>
1156 <a class="index-entry-id" id="index-root-user"></a>
1157 <a class="index-entry-id" id="index-trailing-_002f-in-home-directory"></a>
1158 <a class="index-entry-id" id="index-_002f_002c-trailing-in-home-directory"></a>
1159 <p>As a special case, if a home directory ends in &lsquo;<samp class="samp">/</samp>&rsquo;, the trailing
1160 slash is dropped, to avoid inadvertently creating a &lsquo;<samp class="samp">//</samp>&rsquo; construct
1161 in the path. For example, if the home directory of the user &lsquo;<samp class="samp">root</samp>&rsquo;
1162 is &lsquo;<samp class="samp">/</samp>&rsquo;, the path element &lsquo;<samp class="samp">~root/mymacros</samp>&rsquo; expands to just
1163 &lsquo;<samp class="samp">/mymacros</samp>&rsquo;, not &lsquo;<samp class="samp">//mymacros</samp>&rsquo;.
1164 </p>
1165 <a class="index-entry-id" id="index-tilde_002ec"></a>
1166 <p>Tilde expansion is implemented in the source file <samp class="file">kpathsea/tilde.c</samp>.
1167 </p>
1168
1169 <hr>
1170 </div>
1171 <div class="subsection-level-extent" id="Brace-expansion">
1172 <div class="nav-panel">
1173 <p>
1174 Next: <a href="#KPSE_005fDOT-expansion" accesskey="n" rel="next"><code class="code">KPSE_DOT</code> expansion</a>, Previous: <a href="#Tilde-expansion" accesskey="p" rel="prev">Tilde expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1175 </div>
1176 <h4 class="subsection" id="Brace-expansion-1"><span>5.3.4 Brace expansion<a class="copiable-link" href="#Brace-expansion-1"> &para;</a></span></h4>
1177
1178 <a class="index-entry-id" id="index-_007b-expansion"></a>
1179 <a class="index-entry-id" id="index-brace-expansion"></a>
1180
1181 <p>&lsquo;<samp class="samp">x{<var class="var">a</var>,<var class="var">b</var>}y</samp>&rsquo; expands to &lsquo;<samp class="samp">x<var class="var">a</var>y:x<var class="var">b</var>y</samp>&rsquo;.
1182 For example:
1183 </p>
1184 <div class="example">
1185 <pre class="example-preformatted">foo/{1,2}/baz
1186 </pre></div>
1187
1188 <p>expands to &lsquo;<samp class="samp">foo/1/baz:foo/2/baz</samp>&rsquo;. &lsquo;<samp class="samp">:</samp>&rsquo; is the path
1189 separator on the current system; e.g., on a Windows system, it&rsquo;s &lsquo;<samp class="samp">;</samp>&rsquo;.
1190 </p>
1191 <p>Braces can be nested; for example, &lsquo;<samp class="samp">x{A,B{1,2}}y</samp>&rsquo; expands to
1192 &lsquo;<samp class="samp">xAy:xB1y:xB2y</samp>&rsquo;.
1193 </p>
1194 <p>Multiple non-nested braces are expanded from right to left; for example,
1195 &lsquo;<samp class="samp">x{A,B}{1,2}y</samp>&rsquo; expands to &lsquo;<samp class="samp">x{A,B}1y:x{A,B}2y</samp>&rsquo;, which
1196 expands to &lsquo;<samp class="samp">xA1y:xB1y:xA2y:xB2y</samp>&rsquo;.
1197 </p>
1198 <a class="index-entry-id" id="index-multiple-TeX-hierarchies"></a>
1199 <p>This feature can be used to implement multiple TeX hierarchies, by
1200 assigning a brace list to <code class="code">$TEXMF</code>, as mentioned in
1201 <samp class="file">texmf.in</samp>.
1202 </p>
1203 <p>You can also use the path separator instead of the comma. The last
1204 example could have been written &lsquo;<samp class="samp">x{A:B}{1:2}y</samp>&rsquo; (on Unix).
1205 </p>
1206
1207 <a class="index-entry-id" id="index-expand_002ec"></a>
1208 <p>Brace expansion is implemented in the source file
1209 <samp class="file">kpathsea/expand.c</samp>.
1210 </p>
1211
1212 <hr>
1213 </div>
1214 <div class="subsection-level-extent" id="KPSE_005fDOT-expansion">
1215 <div class="nav-panel">
1216 <p>
1217 Next: <a href="#Subdirectory-expansion" accesskey="n" rel="next">Subdirectory expansion</a>, Previous: <a href="#Brace-expansion" accesskey="p" rel="prev">Brace expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1218 </div>
1219 <h4 class="subsection" id="KPSE_005fDOT-expansion-1"><span>5.3.5 <code class="code">KPSE_DOT</code> expansion<a class="copiable-link" href="#KPSE_005fDOT-expansion-1"> &para;</a></span></h4>
1220
1221 <a class="index-entry-id" id="index-KPSE_005fDOT-expansion"></a>
1222
1223 <p>When <code class="code">KPSE_DOT</code> is defined in the environment, it names a directory
1224 that should be considered the current directory for the purpose of
1225 looking up files in the search paths. This feature is needed by the
1226 &lsquo;<samp class="samp">mktex&hellip;</samp>&rsquo; scripts <a class="ref" href="#mktex-scripts"><samp class="file">mktex</samp> scripts</a>, because these
1227 change the working directory. You should not ever define it yourself.
1228 </p>
1229
1230 <hr>
1231 </div>
1232 <div class="subsection-level-extent" id="Subdirectory-expansion">
1233 <div class="nav-panel">
1234 <p>
1235 Previous: <a href="#KPSE_005fDOT-expansion" accesskey="p" rel="prev"><code class="code">KPSE_DOT</code> expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1236 </div>
1237 <h4 class="subsection" id="Subdirectory-expansion-1"><span>5.3.6 Subdirectory expansion<a class="copiable-link" href="#Subdirectory-expansion-1"> &para;</a></span></h4>
1238
1239 <a class="index-entry-id" id="index-_002f_002f"></a>
1240 <a class="index-entry-id" id="index-subdirectory-searching"></a>
1241 <a class="index-entry-id" id="index-expansion_002c-subdirectory"></a>
1242
1243 <a class="index-entry-id" id="index-alphabetical-order_002c-not"></a>
1244 <p>Two or more consecutive slashes in a path element following a directory
1245 <var class="var">d</var> is replaced by all subdirectories of <var class="var">d</var>: first those
1246 subdirectories directly under <var class="var">d</var>, then the subsubdirectories under
1247 those, and so on. At each level, the order in which the directories are
1248 searched is unspecified. (It&rsquo;s &ldquo;directory order&rdquo;, and definitely not
1249 alphabetical.)
1250 </p>
1251 <p>If you specify any filename components after the &lsquo;<samp class="samp">//</samp>&rsquo;, only
1252 subdirectories which match those components are included. For example,
1253 &lsquo;<samp class="samp">/a//b</samp>&rsquo; would expand into directories <samp class="file">/a/1/b</samp>, <samp class="file">/a/2/b</samp>,
1254 <samp class="file">/a/1/1/b</samp>, and so on, but not <samp class="file">/a/b/c</samp> or <samp class="file">/a/1</samp>.
1255 </p>
1256 <p>You can include multiple &lsquo;<samp class="samp">//</samp>&rsquo; constructs in the path.
1257 </p>
1258 <p>&lsquo;<samp class="samp">//</samp>&rsquo; at the beginning of a path is ignored. Searching every
1259 directory on the system is not relevant for TeX.
1260 </p>
1261 <a class="index-entry-id" id="index-trick-for-detecting-leaf-directories"></a>
1262 <a class="index-entry-id" id="index-leaf-directory-trick"></a>
1263 <a class="index-entry-id" id="index-Farwell_002c-Matthew"></a>
1264 <a class="index-entry-id" id="index-MacKenzie_002c-David-1"></a>
1265 <p>We need to discuss one related implementation trick, originally taken
1266 from GNU find. Matthew Farwell suggested it, and David MacKenzie
1267 implemented it.
1268 </p>
1269 <a class="index-entry-id" id="index-st_005fnlink"></a>
1270 <p>The trick is that in normal Unix implementations (though not in the
1271 POSIX specification), a directory which contains no subdirectories
1272 will have exactly two links (namely, one for <samp class="file">.</samp> and one for
1273 <samp class="file">..</samp>). That is to say, the <code class="code">st_nlink</code> field in the
1274 &lsquo;<samp class="samp">stat</samp>&rsquo; structure will be two. Thus, we don&rsquo;t have to stat
1275 everything in the bottom-level (leaf) directories&mdash;we can just check
1276 <code class="code">st_nlink</code>, notice it&rsquo;s two, and do no more work.
1277 </p>
1278 <p>Kpathsea never does this <code class="code">st_nlink=2</code> check (or any disk
1279 checking) for <code class="code">!!</code> trees (see <a class="pxref" href="#ls_002dR"><samp class="file">ls-R</samp></a>). And the non-<code class="code">!!</code>
1280 trees in a TeX Live installation are typically extremely small.
1281 Therefore the <code class="code">st_nlink</code> check is not performed by default at
1282 all, as of 2025 (Kpathsea 6.3.4). That way, two not-uncommon
1283 situations work out: 1)&nbsp;all <code class="code">gvisor</code>-handled filesystems return
1284 <code class="code">st_nlink=1</code> before some post-2025 release
1285 (<a class="url" href="https://tug.org/pipermail/texhax/2025-July/026772.html">https://tug.org/pipermail/texhax/2025-July/026772.html</a>);
1286 2)&nbsp;a symbolic link to another directory in such an apparent leaf
1287 directory will get followed even though <code class="code">st_nlink=2</code>
1288 (<a class="url" href="https://tex.stackexchange.com/questions/132908">https://tex.stackexchange.com/questions/132908</a>).
1289 </p>
1290 <p>If you have an extremely large non-<code class="code">!!</code> tree, most likely
1291 <code class="code">TEXMFHOME</code>, you may find it useful to enable the check: you can
1292 do this by setting the configuration variable
1293 <code class="code">texmf_nlink_for_leaf</code> to 1. Alternatively, with such a large
1294 tree, you may find it even more useful to add the tree to
1295 <code class="code">TEXMFDBS</code> so that only <code class="code">ls-R</code> lookups are done (again,
1296 see <a class="pxref" href="#ls_002dR"><samp class="file">ls-R</samp></a>).
1297 </p>
1298 <a class="index-entry-id" id="index-elt_002ddirs_002ec"></a>
1299 <p>Unfortunately, in some cases files in leaf directories are
1300 <code class="code">stat</code>&rsquo;d anyway: if the path specification is, say,
1301 &lsquo;<samp class="samp">$TEXMF/fonts//pk//</samp>&rsquo;, then files in a subdirectory
1302 &lsquo;<samp class="samp">&hellip;/pk</samp>&rsquo;, even if it is a leaf, are checked. The reason
1303 cannot be explained without reference to the implementation, so read
1304 <samp class="file">kpathsea/elt-dirs.c</samp> (search for &lsquo;<samp class="samp">may descend</samp>&rsquo;) if you are
1305 curious. And if you find a way to solve the problem, please let me
1306 know.
1307 </p>
1308 <a class="index-entry-id" id="index-elt_002ddirs_002ec-1"></a>
1309 <p>Subdirectory expansion is implemented in the source file
1310 <samp class="file">kpathsea/elt-dirs.c</samp>.
1311 </p>
1312
1313 <hr>
1314 </div>
1315 </div>
1316 <div class="section-level-extent" id="Casefolding-search">
1317 <div class="nav-panel">
1318 <p>
1319 Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database (<code class="code">ls-R</code>)</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1320 </div>
1321 <h3 class="section" id="Casefolding-search-1"><span>5.4 Casefolding search<a class="copiable-link" href="#Casefolding-search-1"> &para;</a></span></h3>
1322
1323 <a class="index-entry-id" id="index-casefolding-search"></a>
1324 <a class="index-entry-id" id="index-search_002c-case_002dinsensitive"></a>
1325
1326 <p>In Kpathsea version 6.3.0 (released with TeX Live 2018), a new
1327 fallback search was implemented on Unix-like systems, including Macs:
1328 for each path element in turn, if no match is found by the normal
1329 search, and the path element allows for checking the filesystem, a
1330 second check is made for a case-insensitive match.
1331 </p>
1332 <a class="index-entry-id" id="index-texmf_005fcasefold_005fsearch"></a>
1333 <p>This is enabled at compile-time on Unix systems, and enabled at
1334 runtime by setting the configuration variable
1335 <code class="code">texmf_casefold_search</code>, to a true value, e.g., &lsquo;<samp class="samp">1</samp>&rsquo;; this is
1336 done by default in TeX Live.
1337 </p>
1338
1339 <ul class="mini-toc">
1340 <li><a href="#Casefolding-rationale" accesskey="1">Casefolding rationale</a></li>
1341 <li><a href="#Casefolding-examples" accesskey="2">Casefolding examples</a></li>
1342 </ul>
1343 <hr>
1344 <div class="subsection-level-extent" id="Casefolding-rationale">
1345 <div class="nav-panel">
1346 <p>
1347 Next: <a href="#Casefolding-examples" accesskey="n" rel="next">Casefolding examples</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1348 </div>
1349 <h4 class="subsection" id="Casefolding-rationale-1"><span>5.4.1 Casefolding rationale<a class="copiable-link" href="#Casefolding-rationale-1"> &para;</a></span></h4>
1350
1351 <a class="index-entry-id" id="index-casefolding-fallback-rationale"></a>
1352 <a class="index-entry-id" id="index-rationale-for-casefolding-fallback"></a>
1353 <a class="index-entry-id" id="index-system_002ddependent-casefolding-behavior"></a>
1354
1355 <a class="index-entry-id" id="index-filesystem_002c-case_002d_0028in_0029sensitive"></a>
1356 <a class="index-entry-id" id="index-Apple-filesystem_002c-case_002dinsensitive"></a>
1357 <a class="index-entry-id" id="index-Mac-filesystem_002c-case_002dinsensitive"></a>
1358 <p>The purpose of the fallback casefolding search is to ease moving
1359 complex documents between case-insensitive (file)systems and
1360 case-sensitive ones. In particular, Apple decided to make the default
1361 filesystem on Macs be case-insensitive some years ago, and this has
1362 exacerbated a problem of people creating documents that use, say, an
1363 image under the name <samp class="file">foo.jpg</samp>, while the actual file is named
1364 <samp class="file">foo.JPG</samp> or <samp class="file">Foo.jpg</samp>. It works on the Mac but if the
1365 document is transferred and run on a standard case-sensitive Unix
1366 (file)system, the file can&rsquo;t be found, due only to differences in
1367 case.
1368 </p>
1369 <p>This same problematic scenario has always existed on Windows, but for
1370 whatever reason, it has become much more common since Apple also went
1371 to a case-insensitive filesystem. Hence the relatively late change
1372 to the Kpathsea behavior.
1373 </p>
1374 <a class="index-entry-id" id="index-Windows-and-casefolding"></a>
1375 <p>The fallback case-insensitive search is omitted at compile-time on
1376 Windows, where (for practical purposes) all file names are
1377 case-insensitive at the kernel level, and so the normal search will
1378 already have definitively matched or not. Therefore, search results
1379 in unusual cases can be different on Windows and Unix&mdash;but this has
1380 always been true.
1381 </p>
1382
1383 <hr>
1384 </div>
1385 <div class="subsection-level-extent" id="Casefolding-examples">
1386 <div class="nav-panel">
1387 <p>
1388 Previous: <a href="#Casefolding-rationale" accesskey="p" rel="prev">Casefolding rationale</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1389 </div>
1390 <h4 class="subsection" id="Casefolding-examples-1"><span>5.4.2 Casefolding examples<a class="copiable-link" href="#Casefolding-examples-1"> &para;</a></span></h4>
1391
1392 <a class="index-entry-id" id="index-casefolding-examples"></a>
1393 <a class="index-entry-id" id="index-examples_002c-of-casefolding-searches"></a>
1394
1395 <p>The casefolding implementation prefers exact matches to casefolded
1396 matches within a given path element, so as to retain most
1397 compatibility. Backward compatibility is not perfect, however, as a
1398 casefolded match may be found in an earlier path element than an exact
1399 match was previously found (see example #4 below). Still, preferring
1400 the match in the earlier element seemed potentially less confusing
1401 than otherwise, and is in fact consistent with past behavior on
1402 Windows. Since case mismatches are rare to begin with, and name
1403 collisions with respect only to case thus even more rare, the hope is
1404 that it will not cause difficulties in practice.
1405 </p>
1406 <p>If it&rsquo;s desirable in a given situation to have the exact same search
1407 behavior as previously, that can be accomplished by setting the
1408 configuration variable <code class="code">texmf_casefold_search</code> to &lsquo;<samp class="samp">0</samp>&rsquo;
1409 (see <a class="pxref" href="#Path-sources">Path sources</a>).
1410 </p>
1411 <p>Some examples to illustrate the new behavior follow.
1412 </p>
1413 <p>Example #1: suppose the file <samp class="file">./foobar.tex</samp> exists. Now,
1414 searching for <samp class="file">./FooBar.TeX</samp> (or any other case variation) will
1415 succeed, returning <samp class="file">./foobar.tex</samp>&mdash;the name as stored on disk.
1416 In previous releases, or if <code class="code">texmf_casefold_search</code> is false, the
1417 search would fail.
1418 </p>
1419 <p>Example #2: suppose we are using a case-sensitive (file)system, and
1420 the search path is &lsquo;<samp class="samp">.:/somedir</samp>&rsquo;, and the files
1421 <samp class="file">./foobar.tex</samp> and <samp class="file">/somedir/FooBar.TeX</samp> both exist. Both
1422 now and previously, searching for <samp class="file">foobar.tex</samp> returns
1423 <samp class="file">./foobar.tex</samp>. However, searching for <samp class="file">FooBar.TeX</samp> now
1424 returns <samp class="file">./foobar.tex</samp> instead of <samp class="file">/somedir/FooBar.TeX</samp>;
1425 this is the incompatibility mentioned above. Also (as expected),
1426 searching for <samp class="file">FOOBAR.TEX</samp> (or whatever variation) will now
1427 return <samp class="file">./foobar.tex</samp>, whereas before it would fail. Searching
1428 for all (&lsquo;<samp class="samp">kpsewhich --all</samp>&rsquo;) <samp class="file">foobar.tex</samp> will return both
1429 matches.
1430 </p>
1431 <p>Example #3: same as example #2, but on a case-insensitive
1432 (file)system: both now and previously, searching for <samp class="file">FooBar.TeX</samp>
1433 returns <samp class="file">./foobar.tex</samp>, since the system considers that a match.
1434 The Kpathsea casefolding never comes into play.
1435 </p>
1436 <p>Example #4: if we have (on a case-sensitive system) both
1437 <samp class="file">./foobar.tex</samp> and <samp class="file">./FOOBAR.TEX</samp>, searching with the exact
1438 case returns that exact match, now and previously. Searching for
1439 <samp class="file">FooBar.tex</samp> will now return one or the other (chosen
1440 arbitrarily), rather than failing. Perhaps unexpectedly, searching
1441 for all <samp class="file">foobar.tex</samp> or <samp class="file">FooBar.tex</samp> will also return only
1442 one or the other, not both (see more below).
1443 </p>
1444 <p>Example #5: the font file <samp class="file">STIX-Regular.otf</samp> is included in
1445 TeX Live in the system directory
1446 <samp class="file">texmf-dist/fonts/opentype/public/stix</samp>. Because Kpathsea never
1447 searches the disk in the big system directory, the casefolding is not
1448 done, and a search for &lsquo;<samp class="samp">stix-regular.otf</samp>&rsquo; will fail (on
1449 case-sensitive systems), as it always has.
1450 </p>
1451 <a class="index-entry-id" id="index-_0021_0021-and-casefolding"></a>
1452 <p>The caveat about not searching the disk amounts to saying that
1453 casefolding does not happen in the trees specified with &lsquo;<samp class="samp">!!</samp>&rsquo;
1454 (see <a class="pxref" href="#ls_002dR"><samp class="file">ls-R</samp></a>), that is, where only database (<samp class="file">ls-R</samp>) searching
1455 is done. In TeX Live, that is the &lsquo;<samp class="samp">texmf-local</samp>&rsquo; and
1456 &lsquo;<samp class="samp">texmf-dist</samp>&rsquo; trees (also <code class="code">$TEXMFSYSCONFIG</code> and
1457 <code class="code">$TEXMFSYSVAR</code>, but those are rarely noticed). The rationale for
1458 this is that in practice, case mangling happens with user-created
1459 files, not with packages distributed as part of the TeX system.
1460 </p>
1461 <p>One more caveat: the purpose of <code class="code">kpsewhich</code> is to exercise the
1462 path searching in Kpathsea as it is actually done. Therefore, as
1463 shown above, &lsquo;<samp class="samp">kpsewhich --all</samp>&rsquo; will not return all matches
1464 regardless of case within a given path element. If you want to find
1465 all matches in all directories, <code class="code">find</code> is the best tool, although
1466 the setup takes a couple steps:
1467 </p>
1468 <div class="example">
1469 <pre class="example-preformatted">kpsewhich -show-path=tex &gt;/tmp/texpath # search path specification
1470 kpsewhich -expand-path=&quot;`cat /tmp/texpath`&quot; &gt;/tmp/texdirs # all dirs
1471 tr ':' '\n' &lt;/tmp/texdirs &gt;/tmp/texdirlist # colons to newlines
1472 find `cat /tmp/texdirlist` -iname somefile.tex -print &lt;/tmp/texdirlist
1473 </pre></div>
1474
1475 <a class="index-entry-id" id="index-Findutils_002c-GNU-package"></a>
1476 <a class="index-entry-id" id="index-_002diname_002c-find-predicate"></a>
1477 <p>Sorry that it&rsquo;s annoyingly lengthy, but implementing this inside
1478 Kpathsea would be a lot of error-prone trouble for something that is
1479 only useful for debugging. If your <code class="code">find</code> does not support
1480 <code class="code">-iname</code>, you can get GNU Find from
1481 <a class="url" href="https://gnu.org/software/findutils">https://gnu.org/software/findutils</a>.
1482 </p>
1483 <p>The casefolding search is implemented in the source file
1484 <samp class="file">kpathsea/pathsearch.c</samp>. Two implementation points:
1485 </p>
1486 <ul class="itemize mark-bullet">
1487 <li><a class="index-entry-id" id="index-access-system-call"></a>
1488 Kpathsea never tries to check if a given directory resides on a
1489 case-insensitive filesystem, because there is no efficient and
1490 portable way to do so. All it does is try to see if a potential file
1491 name is a readable normal file (with, usually, the <code class="code">access</code>
1492 system call).
1493
1494 </li><li>Kpathsea does not do any case-insensitive matching of the directories
1495 along the path. It&rsquo;s not going to find <samp class="file">/Some/Random/file.tex</samp>
1496 when looking for <samp class="file">/some/random/file.tex</samp>. The casefolding only
1497 happens with the elements of the leaf directory.
1498
1499 </li></ul>
1500
1501
1502 <hr>
1503 </div>
1504 </div>
1505 <div class="section-level-extent" id="Filename-database">
1506 <div class="nav-panel">
1507 <p>
1508 Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next"><code class="code">kpsewhich</code>: Standalone path searching</a>, Previous: <a href="#Casefolding-search" accesskey="p" rel="prev">Casefolding search</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1509 </div>
1510 <h3 class="section" id="Filename-database-_0028ls_002dR_0029"><span>5.5 Filename database (<code class="code">ls-R</code>)<a class="copiable-link" href="#Filename-database-_0028ls_002dR_0029"> &para;</a></span></h3>
1511
1512 <a class="index-entry-id" id="index-filename-database"></a>
1513 <a class="index-entry-id" id="index-database_002c-for-filenames"></a>
1514 <a class="index-entry-id" id="index-externally_002dbuilt-filename-database"></a>
1515
1516 <p>Kpathsea goes to some lengths to minimize disk accesses for searches
1517 (see <a class="pxref" href="#Subdirectory-expansion">Subdirectory expansion</a>). Nevertheless, in practice searching
1518 every possible directory in typical TeX installations takes an
1519 excessively long time.
1520 </p>
1521 <p>Therefore, Kpathsea can use an externally-built <em class="dfn">filename
1522 database</em> file named <samp class="file">ls-R</samp> that maps files to directories, thus
1523 avoiding the need to exhaustively search the disk.
1524 </p>
1525 <p>A second database file <samp class="file">aliases</samp> allows you to give additional
1526 names to the files listed in <samp class="file">ls-R</samp>.
1527 </p>
1528 <p>The <samp class="file">ls-R</samp> and <samp class="file">aliases</samp> features are implemented in the
1529 source file <samp class="file">kpathsea/db.c</samp>.
1530 </p>
1531
1532
1533 <ul class="mini-toc">
1534 <li><a href="#ls_002dR" accesskey="1"><samp class="file">ls-R</samp></a></li>
1535 <li><a href="#Filename-aliases" accesskey="2">Filename aliases</a></li>
1536 <li><a href="#Database-format" accesskey="3">Database format</a></li>
1537 </ul>
1538 <hr>
1539 <div class="subsection-level-extent" id="ls_002dR">
1540 <div class="nav-panel">
1541 <p>
1542 Next: <a href="#Filename-aliases" accesskey="n" rel="next">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code class="code">ls-R</code>)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1543 </div>
1544 <h4 class="subsection" id="ls_002dR-1"><span>5.5.1 <samp class="file">ls-R</samp><a class="copiable-link" href="#ls_002dR-1"> &para;</a></span></h4>
1545
1546 <a class="index-entry-id" id="index-ls_002dR-database-file"></a>
1547
1548 <p>As mentioned above, you must name the main filename database
1549 <samp class="file">ls-R</samp>. You can put one at the root of each TeX installation
1550 hierarchy you wish to search (<code class="code">$TEXMF</code> by default, which expands
1551 to a braced list of several hierarchies in TeX Live).
1552 </p>
1553 <a class="index-entry-id" id="index-TEXMFDBS"></a>
1554 <a class="index-entry-id" id="index-_0021_0021-in-TEXMFDBS"></a>
1555 <p>Kpathsea looks for <samp class="file">ls-R</samp> files along the <code class="code">TEXMFDBS</code>
1556 path. It is best for this to contain all and only those hierarchies
1557 from <code class="code">$TEXMF</code> which are specified with <code class="code">!!</code>&mdash;and also to
1558 specify them with <code class="code">!!</code> in <code class="code">TEXMFDBS</code>. (See the end of this
1559 section for more on <code class="code">!!</code>.)
1560 </p>
1561 <p>The recommended way to create and maintain &lsquo;<samp class="samp">ls-R</samp>&rsquo; is to run the
1562 <code class="code">mktexlsr</code> script, which is installed in &lsquo;<samp class="samp">$(bindir)</samp>&rsquo;
1563 (<samp class="file">/usr/local/bin</samp> by default). That script goes to some trouble to
1564 follow symbolic links as necessary, etc. It&rsquo;s also invoked by the
1565 distributed &lsquo;<samp class="samp">mktex&hellip;</samp>&rsquo; scripts.
1566 </p>
1567 <a class="index-entry-id" id="index-ls_002dR_002c-simplest-build"></a>
1568 <p>At its simplest, though, you can build <samp class="file">ls-R</samp> with the command
1569 </p><div class="example">
1570 <pre class="example-preformatted">cd <var class="var">/your/texmf/root</var> &amp;&amp; ls -LAR ./ &gt;ls-R
1571 </pre></div>
1572
1573 <a class="index-entry-id" id="index-_002d_002dcolor_003dtty"></a>
1574 <a class="index-entry-id" id="index-_002fetc_002fprofile-and-aliases"></a>
1575 <p>presuming your <code class="code">ls</code> produces the right output format (see the
1576 section below). GNU <code class="code">ls</code>, for example, outputs in this format.
1577 Also presuming your <code class="code">ls</code> hasn&rsquo;t been aliased in a system file
1578 (e.g., <samp class="file">/etc/profile</samp>) to something problematic, e.g., &lsquo;<samp class="samp">ls
1579 --color=tty</samp>&rsquo;. In that case, you will have to disable the alias before
1580 generating <samp class="file">ls-R</samp>. For the precise definition of the file format,
1581 see <a class="ref" href="#Database-format">Database format</a>.
1582 </p>
1583 <p>Regardless of whether you use the supplied script or your own, you
1584 will almost certainly want to invoke it via <code class="code">cron</code>, so when you
1585 make changes in the installed files (say if you install a new LaTeX
1586 package), <samp class="file">ls-R</samp> will be automatically updated. However, for
1587 those using TeX Live or system distributions, the package managers
1588 should run <code class="code">mktexlsr</code> as needed.
1589 </p>
1590 <a class="index-entry-id" id="index-_002dA-option-to-ls"></a>
1591 <a class="index-entry-id" id="index-dot-files"></a>
1592 <a class="index-entry-id" id="index-_002e-files"></a>
1593 <a class="index-entry-id" id="index-_002e-directories_002c-ignored"></a>
1594 <a class="index-entry-id" id="index-_002etex-file_002c-included-in-ls_002dR"></a>
1595 <p>The &lsquo;<samp class="samp">-A</samp>&rsquo; option to <code class="code">ls</code> includes files beginning with &lsquo;<samp class="samp">.</samp>&rsquo;
1596 (except for <samp class="file">.</samp> and <samp class="file">..</samp>), such as the file <samp class="file">.tex</samp>
1597 included with the LaTeX tools package. (On the other hand,
1598 <em class="emph">directories</em> whose names begin with &lsquo;<samp class="samp">.</samp>&rsquo; are always ignored.)
1599 </p>
1600 <a class="index-entry-id" id="index-symbolic-links_002c-and-ls_002dR"></a>
1601 <a class="index-entry-id" id="index-_002dL-option-to-ls"></a>
1602 <p>If your system does not support symbolic links, omit the &lsquo;<samp class="samp">-L</samp>&rsquo;.
1603 </p>
1604 <a class="index-entry-id" id="index-automounter_002c-and-ls_002dR"></a>
1605 <a class="index-entry-id" id="index-NFS-and-ls_002dR"></a>
1606 <p><code class="code">ls -LAR <var class="var">/your/texmf/root</var></code> will also work. But using
1607 &lsquo;<samp class="samp">./</samp>&rsquo; avoids embedding absolute pathnames, so the hierarchy can be
1608 easily transported. It also avoids possible trouble with automounters
1609 or other network filesystem conventions.
1610 </p>
1611 <a class="index-entry-id" id="index-warning-about-unusable-ls_002dR"></a>
1612 <a class="index-entry-id" id="index-unusable-ls_002dR-warning"></a>
1613 <p>Kpathsea warns you if it finds an <samp class="file">ls-R</samp> file, but the file does
1614 not contain any usable entries. The usual culprit is running plain
1615 &lsquo;<samp class="samp">ls -R</samp>&rsquo; instead of &lsquo;<samp class="samp">ls -LR ./</samp>&rsquo; or &lsquo;<samp class="samp">ls -R
1616 <var class="var">/your/texmf/root</var></samp>&rsquo;. Another possibility is some system directory
1617 name starting with a &lsquo;<samp class="samp">.</samp>&rsquo; (perhaps if you are using AFS); Kpathsea
1618 ignores everything under such directories.
1619 </p>
1620 <a class="index-entry-id" id="index-_0021_0021-in-path-specifications"></a>
1621 <a class="index-entry-id" id="index-disk-searching_002c-avoiding"></a>
1622 <p>If a particular path element begins with &lsquo;<samp class="samp">!!</samp>&rsquo;, <em class="emph">only</em> the
1623 database will be searched for that element, never the disk; and if the
1624 database does not exist, nothing at all will be searched. In TeX
1625 Live, most of the trees are specified with &lsquo;<samp class="samp">!!</samp>&rsquo;.
1626 </p>
1627 <p>For path elements that do not begin with &lsquo;<samp class="samp">!!</samp>&rsquo;, if the database
1628 exists, it will be used, and the disk will not be searched. However,
1629 in this case, if the database does not exist, the disk will be
1630 searched. In TeX Live, the most notable case of this is the
1631 <code class="code">TEXMFHOME</code> tree, to allow users to add and remove files from
1632 their own tree without having to worry about <code class="code">ls-R</code>.
1633 </p>
1634 <p>(Aside: there are uncommon cases where a &lsquo;<samp class="samp">!!</samp>&rsquo; tree will be
1635 searched on disk even if the <code class="code">ls-R</code> file exists; they are too
1636 obscure to try to explain here. See <samp class="file">pathsearch.c</samp> in the source
1637 if you need to know.)
1638 </p>
1639 <p>To sum up: do not create an <code class="code">ls-R</code> file unless you also take care
1640 to keep it up to date. Otherwise newly-installed files will not be
1641 found.
1642 </p>
1643
1644
1645 <hr>
1646 </div>
1647 <div class="subsection-level-extent" id="Filename-aliases">
1648 <div class="nav-panel">
1649 <p>
1650 Next: <a href="#Database-format" accesskey="n" rel="next">Database format</a>, Previous: <a href="#ls_002dR" accesskey="p" rel="prev"><samp class="file">ls-R</samp></a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code class="code">ls-R</code>)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1651 </div>
1652 <h4 class="subsection" id="Filename-aliases-1"><span>5.5.2 Filename aliases<a class="copiable-link" href="#Filename-aliases-1"> &para;</a></span></h4>
1653
1654 <a class="index-entry-id" id="index-filename-aliases"></a>
1655 <a class="index-entry-id" id="index-aliases_002c-for-filenames"></a>
1656
1657 <p>In some circumstances, you may wish to find a file under several names.
1658 For example, suppose a TeX document was created using a DOS system
1659 and tries to read <samp class="file">longtabl.sty</samp>. But now it&rsquo;s being run on a Unix
1660 system, and the file has its original name, <samp class="file">longtable.sty</samp>. The
1661 file won&rsquo;t be found. You need to give the actual file
1662 <samp class="file">longtable.sty</samp> an alias &lsquo;<samp class="samp">longtabl.sty</samp>&rsquo;.
1663 </p>
1664
1665 <p>You can handle this by creating a file <samp class="file">aliases</samp> as a companion to
1666 the <samp class="file">ls-R</samp> for the hierarchy containing the file in question. (You
1667 must have an <samp class="file">ls-R</samp> for the alias feature to work.)
1668 </p>
1669 <p>The format of <samp class="file">aliases</samp> is simple: two whitespace-separated words
1670 per line; the first is the real name <samp class="file">longtable.sty</samp>, and second is
1671 the alias (<samp class="file">longtabl.sty</samp>). These must be base filenames, with no
1672 directory components. <samp class="file">longtable.sty</samp> must be in the sibling
1673 <samp class="file">ls-R</samp>.
1674 </p>
1675 <p>Also, blank lines and lines starting with &lsquo;<samp class="samp">%</samp>&rsquo; or &lsquo;<samp class="samp">#</samp>&rsquo; are
1676 ignored in <samp class="file">aliases</samp>, to allow for comments.
1677 </p>
1678 <p>If a real file <samp class="file">longtabl.sty</samp> exists, it is used regardless of any
1679 aliases.
1680 </p>
1681
1682 <hr>
1683 </div>
1684 <div class="subsection-level-extent" id="Database-format">
1685 <div class="nav-panel">
1686 <p>
1687 Previous: <a href="#Filename-aliases" accesskey="p" rel="prev">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code class="code">ls-R</code>)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1688 </div>
1689 <h4 class="subsection" id="Database-format-1"><span>5.5.3 Database format<a class="copiable-link" href="#Database-format-1"> &para;</a></span></h4>
1690
1691 <a class="index-entry-id" id="index-format-of-external-database"></a>
1692 <a class="index-entry-id" id="index-database_002c-format-of"></a>
1693
1694 <p>The &ldquo;database&rdquo; read by Kpathsea is a line-oriented file of plain
1695 text. The format is that generated by GNU (and most other) <code class="code">ls</code>
1696 programs given the &lsquo;<samp class="samp">-R</samp>&rsquo; option, as follows.
1697 </p>
1698 <ul class="itemize mark-bullet">
1699 <li>Blank lines are ignored.
1700
1701 </li><li>If a line begins with &lsquo;<samp class="samp">/</samp>&rsquo; or &lsquo;<samp class="samp">./</samp>&rsquo; or &lsquo;<samp class="samp">../</samp>&rsquo; and ends with
1702 a colon, it&rsquo;s the name of a directory. (&lsquo;<samp class="samp">../</samp>&rsquo; lines aren&rsquo;t useful,
1703 however, and should not be generated.)
1704
1705 </li><li>All other lines define entries in the most recently seen directory.
1706 <code class="t">/</code>&rsquo;s in such lines will produce possibly-strange results.
1707
1708 </li><li>Files with no preceding directory line are ignored.
1709 </li></ul>
1710
1711 <p>For example, here&rsquo;s the first few lines of <samp class="file">ls-R</samp> (which totals
1712 about 30K bytes) on my system:
1713 </p>
1714 <div class="example">
1715 <pre class="example-preformatted">bibtex
1716 dvips
1717 fonts
1718 ls-R
1719 metafont
1720 metapost
1721 tex
1722 web2c
1723
1724 ./bibtex:
1725 bib
1726 bst
1727 doc
1728
1729 ./bibtex/bib:
1730 asi.bib
1731 btxdoc.bib
1732 ...
1733 </pre></div>
1734
1735
1736 <hr>
1737 </div>
1738 </div>
1739 <div class="section-level-extent" id="Invoking-kpsewhich">
1740 <div class="nav-panel">
1741 <p>
1742 Previous: <a href="#Filename-database" accesskey="p" rel="prev">Filename database (<code class="code">ls-R</code>)</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1743 </div>
1744 <h3 class="section" id="kpsewhich_003a-Standalone-path-searching"><span>5.6 <code class="code">kpsewhich</code>: Standalone path searching<a class="copiable-link" href="#kpsewhich_003a-Standalone-path-searching"> &para;</a></span></h3>
1745
1746 <a class="index-entry-id" id="index-kpsewhich"></a>
1747 <a class="index-entry-id" id="index-path-searching_002c-standalone"></a>
1748 <a class="index-entry-id" id="index-standalone-path-searching"></a>
1749
1750 <p>The Kpsewhich program exercises the path searching functionality
1751 independent of any particular application. This can also be useful as a
1752 sort of <code class="code">find</code> program to locate files in your TeX hierarchies,
1753 perhaps in administrative scripts. It is used heavily in the
1754 distributed &lsquo;<samp class="samp">mktex&hellip;</samp>&rsquo; scripts.
1755 </p>
1756 <p>Synopsis:
1757 </p>
1758 <div class="example">
1759 <pre class="example-preformatted">kpsewhich <var class="var">option</var>... <var class="var">filename</var>...
1760 </pre></div>
1761
1762 <p>The options and filename(s) to look up can be intermixed.
1763 Options can start with either &lsquo;<samp class="samp">-</samp>&rsquo; or &lsquo;<samp class="samp">--</samp>&rsquo;, and any unambiguous
1764 abbreviation is accepted.
1765 </p>
1766 <p>Kpsewhich looks up each non-option argument on the command line as a
1767 filename, and outputs (by default) the first file found to standard
1768 output. If a file is not found, and more than <var class="var">filename</var> is given,
1769 a blank line is output for that file. See examples below.
1770 </p>
1771 <p>The exit status is zero if all files were found, nonzero otherwise.
1772 </p>
1773
1774
1775 <ul class="mini-toc">
1776 <li><a href="#kpsewhich-examples" accesskey="1"><code class="code">kpsewhich</code> examples</a></li>
1777 <li><a href="#Path-searching-options" accesskey="2">Path searching options</a></li>
1778 <li><a href="#Specially_002drecognized-files" accesskey="3">Specially-recognized files for <code class="command">kpsewhich</code></a></li>
1779 <li><a href="#Auxiliary-tasks" accesskey="4">Auxiliary tasks</a></li>
1780 <li><a href="#Standard-options" accesskey="5">Standard options</a></li>
1781 </ul>
1782 <hr>
1783 <div class="subsection-level-extent" id="kpsewhich-examples">
1784 <div class="nav-panel">
1785 <p>
1786 Next: <a href="#Path-searching-options" accesskey="n" rel="next">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1787 </div>
1788 <h4 class="subsection" id="kpsewhich-examples-1"><span>5.6.1 <code class="code">kpsewhich</code> examples<a class="copiable-link" href="#kpsewhich-examples-1"> &para;</a></span></h4>
1789
1790 <a class="index-entry-id" id="index-kpsewhich-examples"></a>
1791 <a class="index-entry-id" id="index-examples_002c-of-running-kpsewhich"></a>
1792
1793 <p>Some examples of running <code class="code">kpsewhich</code> with a typical TeX tree.
1794 A basic successful search (exit status 0):
1795 </p>
1796 <div class="example">
1797 <pre class="example-preformatted">$ kpsewhich plain.tex
1798 /usr/local/texlive/2024/texmf-dist/tex/plain/base/plain.tex
1799 </pre></div>
1800
1801 <p>Searching for multiple files, one of which is not found (exit status
1802 is 1 for this):
1803 </p>
1804 <div class="example">
1805 <pre class="example-preformatted">$ kpsewhich plain.tex foobar plain.mf
1806 /usr/local/texlive/2024/texmf-dist/tex/plain/base/plain.tex
1807
1808 /usr/local/texlive/2024/texmf-dist/metafont/base/plain.mf
1809 </pre></div>
1810
1811 <p>Using <code class="code">--all</code> to see all files by the same name (exit status 0):
1812 </p>
1813 <div class="example">
1814 <pre class="example-preformatted">$ kpsewhich --all language.dat
1815 /usr/local/texlive/2024/texmf-dist/tex/generic/config/language.dat
1816 /usr/local/texlive/2024/texmf-dist/lambda/generic/config/language.dat
1817 </pre></div>
1818
1819 <hr>
1820 </div>
1821 <div class="subsection-level-extent" id="Path-searching-options">
1822 <div class="nav-panel">
1823 <p>
1824 Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files for <code class="command">kpsewhich</code></a>, Previous: <a href="#kpsewhich-examples" accesskey="p" rel="prev"><code class="code">kpsewhich</code> examples</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
1825 </div>
1826 <h4 class="subsection" id="Path-searching-options-1"><span>5.6.2 Path searching options<a class="copiable-link" href="#Path-searching-options-1"> &para;</a></span></h4>
1827
1828 <a class="index-entry-id" id="index-path-searching-options"></a>
1829
1830 <p>Various options alter the path searching behavior. Options apply to
1831 all lookups.
1832 </p>
1833 <dl class="table">
1834 <dt><a class="index-entry-id" id="index-all-matches_002c-finding"></a>
1835 <a id="index-_002d_002dall"></a><span>&lsquo;<samp class="samp">--all</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dall"> &para;</a></span></dt>
1836 <dd><p>Report all matches found, one per line. By default, if there is more
1837 than one match, just one will be reported (chosen effectively at
1838 random). Exception: with the glyph formats (<code class="code">pk</code>, <code class="code">gf</code>),
1839 this option has no effect and only the first match is returned.
1840 </p>
1841 <p>With both <code class="code">-all</code> and multiple input files, there&rsquo;s no easy way to
1842 discern which matches belong to which files; you have to check the
1843 basename of the output. This could be improved, if there is any demand.
1844 </p>
1845 </dd>
1846 <dt><a class="index-entry-id" id="index-_002d_002dno_002dcasefold_002dsearch"></a>
1847 <a id="index-_002d_002dcasefold_002dsearch"></a><span>&lsquo;<samp class="samp">--casefold-search</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dcasefold_002dsearch"> &para;</a></span></dt>
1848 <dt>&lsquo;<samp class="samp">--no-casefold-search</samp>&rsquo;</dt>
1849 <dd><p>Explicitly enable or disable the fallback to a case-insensitive search
1850 on Unix platforms (see <a class="pxref" href="#Casefolding-search">Casefolding search</a>); no effect on Windows.
1851 The default is enabled, set in <code class="code">texmf.cnf</code>. Disabling
1852 (<code class="code">--no-casefold-search</code>) does not mean that searches magically
1853 become case-sensitive when the underlying (file)system is
1854 case-insensitive, it merely means that Kpathsea does not do any
1855 casefolding itself.
1856 </p>
1857 </dd>
1858 <dt><a id="index-_002d_002dcnf_002dline"></a><span>&lsquo;<samp class="samp">--cnf-line=<var class="var">str</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dcnf_002dline"> &para;</a></span></dt>
1859 <dd><p>Parse <var class="var">str</var> as if it were a line in the <samp class="file">texmf.cnf</samp>
1860 configuration file (see <a class="pxref" href="#Config-files">Config files</a>), overriding settings in the
1861 actual configuration files, and also in the environment (see <a class="pxref" href="#Path-sources">Path sources</a>). This is implemented by making any settings from <var class="var">str</var>
1862 in the environment, overwriting any value already there. Thus, an
1863 extra colon in a &lsquo;<samp class="samp">--cnf-line</samp>&rsquo; value will refer to the value from
1864 a configuration file, not a user-set environment variable.
1865 </p>
1866 <p>Furthermore, any variable set from <var class="var">str</var> will also be set with the
1867 program name suffix. For example, <code class="code">pdftex
1868 --cnf-line=TEXINPUTS=/foo:</code> will set both <code class="code">TEXINPUTS</code> and
1869 <code class="code">TEXINPUTS_pdftex</code> in the environment (and the value will be
1870 <samp class="file">/foo</samp> followed by the setting from <samp class="file">texmf.cnf</samp>, ignoring
1871 any user-set <code class="code">TEXINPUTS</code>).
1872 </p>
1873 <p>This behavior is desirable because, in practice, many variables in the
1874 distributed <samp class="file">texmf.cnf</samp> are program-specific, and the intuitive
1875 behavior is for values set on the command line with <code class="code">--cnf-line</code>
1876 to override them.
1877 </p>
1878 </dd>
1879 <dt><a class="index-entry-id" id="index-_002dD-num"></a>
1880 <a class="index-entry-id" id="index-resolution_002c-setting"></a>
1881 <a id="index-_002d_002ddpi_003dnum"></a><span>&lsquo;<samp class="samp">--dpi=<var class="var">num</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002ddpi_003dnum"> &para;</a></span></dt>
1882 <dd><p>Set the resolution to <var class="var">num</var>; this only affects &lsquo;<samp class="samp">gf</samp>&rsquo; and
1883 &lsquo;<samp class="samp">pk</samp>&rsquo; lookups. &lsquo;<samp class="samp">-D</samp>&rsquo; is a synonym, for compatibility with
1884 Dvips. Default is 600.
1885 </p>
1886 </dd>
1887 <dt><a class="index-entry-id" id="index-engine-name"></a>
1888 <a id="index-_002d_002dengine_003dname"></a><span>&lsquo;<samp class="samp">--engine=<var class="var">name</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dengine_003dname"> &para;</a></span></dt>
1889 <dd><p>Set the engine name to <var class="var">name</var>. By default it is not set in
1890 <code class="code">kpsewhich</code> (TeX engines set it to the appropriate string).
1891 The engine name is used in some search paths to allow files with the
1892 same name but used by different engines to coexist.
1893 </p>
1894 <p>In particular, since the memory dump files
1895 (<samp class="file">.fmt</samp>/<samp class="file">.base</samp>/<samp class="file">.mem</samp>) are now stored in
1896 subdirectories named for the engine (<samp class="file">tex</samp>, <samp class="file">pdftex</samp>,
1897 <samp class="file">xetex</samp>, etc.), you must specify an engine name in order to find
1898 them. For example, <samp class="file">cont-en.fmt</samp> typically exists for both
1899 <samp class="file">pdftex</samp> and <samp class="file">xetex</samp>. With the default path settings, you
1900 can use &lsquo;<samp class="samp">--engine=/</samp>&rsquo; to look for any dump file, regardless of
1901 engine; if a dump file exists for more than one engine, it&rsquo;s
1902 indeterminate which one is returned. (The &lsquo;<samp class="samp">/</samp>&rsquo; ends up specifying
1903 a normal recursive search along the path where the dumps are stored,
1904 namely &lsquo;<samp class="samp">$TEXMF/web2c{/$engine,}</samp>&rsquo;.)
1905 </p>
1906 </dd>
1907 <dt><a id="index-_002d_002dformat_003dname"></a><span>&lsquo;<samp class="samp">--format=<var class="var">name</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dformat_003dname"> &para;</a></span></dt>
1908 <dd><p>Set the format for lookup to <var class="var">name</var>. By default, the format is
1909 guessed from the filename, with &lsquo;<samp class="samp">tex</samp>&rsquo; being used if nothing else
1910 fits. The recognized filename extensions (including any leading
1911 &lsquo;<samp class="samp">.</samp>&rsquo;) are also allowable <var class="var">name</var>s.
1912 </p>
1913 <p>All formats also have a name, which is the only way to specify formats
1914 with no associated suffix. For example, for Dvips configuration files
1915 you can use &lsquo;<samp class="samp">--format=&quot;dvips config&quot;</samp>&rsquo;. (The quotes are for the
1916 sake of the shell.)
1917 </p>
1918 <p>Here&rsquo;s the current list of recognized names and the associated suffixes.
1919 See <a class="xref" href="#Supported-file-formats">Supported file formats</a>, for more information on each of these.
1920 </p>
1921 <p>The strings in parentheses are abbreviations recognized only by
1922 <code class="code">kpsewhich</code> (not the underlying library calls). They are
1923 provided when it would otherwise require an argument containing a
1924 space to specify the format, to simplify quoting of calls from shells.
1925 </p>
1926 <div class="example">
1927 <pre class="example-preformatted">gf: gf
1928 pk: pk
1929 bitmap font (bitmapfont):
1930 tfm: .tfm
1931 afm: .afm
1932 base: .base
1933 bib: .bib
1934 bst: .bst
1935 cnf: .cnf
1936 ls-R: ls-R ls-r
1937 fmt: .fmt
1938 map: .map
1939 mem: .mem
1940 mf: .mf
1941 mfpool: .pool
1942 mft: .mft
1943 mp: .mp
1944 mppool: .pool
1945 MetaPost support (mpsupport):
1946 ocp: .ocp
1947 ofm: .ofm .tfm
1948 opl: .opl .pl
1949 otp: .otp
1950 ovf: .ovf .vf
1951 ovp: .ovp .vpl
1952 graphic/figure: .eps .epsi
1953 tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf
1954 TeX system documentation (doc):
1955 texpool: .pool
1956 TeX system source (source, src): .dtx .ins
1957 PostScript header (psheader): .pro
1958 Troff fonts (trofffont):
1959 type1 fonts: .pfa .pfb
1960 vf: .vf
1961 dvips config (dvipsconfig):
1962 ist: .ist
1963 truetype fonts (truetype, ttf): .ttf .ttc .TTF .TTC .dfont
1964 type42 fonts (type42): .t42 .T42
1965 web2c files (web2c):
1966 other text files (othertext):
1967 other binary files (otherbin):
1968 misc fonts (miscfont):
1969 web: .web .ch
1970 cweb: .w .web .ch
1971 enc files (enc): .enc
1972 cmap files (cmap):
1973 subfont definition files (sfd): .sfd
1974 opentype fonts (opentype, otf): .otf .OTF
1975 pdftex config (pdftexconfig):
1976 lig files (lig): .lig
1977 texmfscripts:
1978 lua: .lua .luatex .luc .luctex .texlua .texluc .tlu
1979 font feature files (fea): .fea
1980 cid maps (cidmap): .cid .cidmap
1981 mlbib: .mlbib .bib
1982 mlbst: .mlbst .bst
1983 clua: .dll .so
1984 ris: .ris
1985 bltxml: .bltxml
1986 </pre></div>
1987
1988 <p>This option and &lsquo;<samp class="samp">--path</samp>&rsquo; are mutually exclusive.
1989 </p>
1990 </dd>
1991 <dt><a class="index-entry-id" id="index-interactive-query"></a>
1992 <a id="index-_002d_002dinteractive"></a><span>&lsquo;<samp class="samp">--interactive</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dinteractive"> &para;</a></span></dt>
1993 <dd><p>After processing the command line, read additional filenames to look up
1994 from standard input.
1995 </p>
1996 </dd>
1997 <dt><a class="index-entry-id" id="index-_002d_002dno_002dmktex_003dfiletype"></a>
1998 <a id="index-_002d_002dmktex_003dfiletype"></a><span>&lsquo;<samp class="samp">--mktex=<var class="var">filetype</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dmktex_003dfiletype"> &para;</a></span></dt>
1999 <dt>&lsquo;<samp class="samp">--no-mktex=<var class="var">filetype</var></samp>&rsquo;</dt>
2000 <dd><p>Turn on or off the &lsquo;<samp class="samp">mktex</samp>&rsquo; script associated with <var class="var">filetype</var>.
2001 Usual values for <var class="var">filetype</var> are &lsquo;<samp class="samp">pk</samp>&rsquo;, &lsquo;<samp class="samp">mf</samp>&rsquo;, &lsquo;<samp class="samp">tex</samp>&rsquo;,
2002 and &lsquo;<samp class="samp">tfm</samp>&rsquo;. By default, all are off in Kpsewhich, even if they
2003 are enabled for TeX. This option implies setting
2004 <code class="code">--must-exist</code>. See <a class="xref" href="#mktex-scripts"><samp class="file">mktex</samp> scripts</a>.
2005 </p>
2006 </dd>
2007 <dt><a id="index-_002d_002dmode_003dstring"></a><span>&lsquo;<samp class="samp">--mode=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dmode_003dstring"> &para;</a></span></dt>
2008 <dd><p>Set the mode name to <var class="var">string</var>; this also only affects &lsquo;<samp class="samp">gf</samp>&rsquo; and
2009 &lsquo;<samp class="samp">pk</samp>&rsquo; lookups. No default: any mode will be found. See <a class="xref" href="#mktex-script-arguments"><samp class="file">mktex</samp> script arguments</a>.
2010 </p>
2011 </dd>
2012 <dt><a id="index-_002d_002dmust_002dexist"></a><span>&lsquo;<samp class="samp">--must-exist</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dmust_002dexist"> &para;</a></span></dt>
2013 <dd><p>Do everything possible to find the files, notably including searching
2014 the disk and running the &lsquo;<samp class="samp">mktex</samp>&rsquo; scripts. By default, only the
2015 <samp class="file">ls-R</samp> database is checked, in the interest of efficiency.
2016 </p>
2017 </dd>
2018 <dt><a id="index-_002d_002dpath_003dstring"></a><span>&lsquo;<samp class="samp">--path=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dpath_003dstring"> &para;</a></span></dt>
2019 <dd><p>Search along the path <var class="var">string</var> (colon-separated as usual), instead
2020 of guessing the search path from the filename. &lsquo;<samp class="samp">//</samp>&rsquo; and all the
2021 usual expansions are supported (see <a class="pxref" href="#Path-expansion">Path expansion</a>). This option
2022 and &lsquo;<samp class="samp">--format</samp>&rsquo; are mutually exclusive. To output the complete
2023 directory expansion of a path, instead of doing a one-shot lookup, see
2024 &lsquo;<samp class="samp">--expand-path</samp>&rsquo; and &lsquo;<samp class="samp">--show-path</samp>&rsquo; in the following section.
2025 </p>
2026 </dd>
2027 <dt><a id="index-_002d_002dprogname_003dname"></a><span>&lsquo;<samp class="samp">--progname=<var class="var">name</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dprogname_003dname"> &para;</a></span></dt>
2028 <dd><p>Set the program name to <var class="var">name</var>; default is &lsquo;<samp class="samp">kpsewhich</samp>&rsquo;. This
2029 can affect the search paths via the &lsquo;<samp class="samp">.<var class="var">prognam</var></samp>&rsquo; feature in
2030 configuration files (see <a class="pxref" href="#Config-files">Config files</a>).
2031 </p>
2032 </dd>
2033 <dt><a id="index-_002d_002dsubdir_003dstring"></a><span>&lsquo;<samp class="samp">--subdir=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dsubdir_003dstring"> &para;</a></span></dt>
2034 <dd><p>Report only those matches whose directory part <em class="emph">ends</em> with
2035 <var class="var">string</var> (compared literally, except case is ignored on a
2036 case-insensitive operating system). For example, suppose there are
2037 two matches for a given name:
2038 </p>
2039 <div class="example">
2040 <pre class="example-preformatted">kpsewhich foo.sty
2041 &rArr; /some/where/foo.sty
2042 /another/place/foo.sty
2043 </pre></div>
2044
2045 <p>Then we can narrow the result to what we are interested in with
2046 <samp class="option">--subdir</samp>:
2047 </p>
2048 <div class="example">
2049 <pre class="example-preformatted">kpsewhich --subdir=where foo.sty
2050 &rArr; /some/where/foo.sty
2051
2052 kpsewhich --subdir=place foo.sty
2053 &rArr; /another/place/foo.sty
2054 </pre></div>
2055
2056 <p>The string to match must be at the end of the directory part of the
2057 match, and it is taken literally, with no pattern matching:
2058 </p>
2059 <div class="example">
2060 <pre class="example-preformatted">kpsewhich --subdir=another foo.sty
2061 &rArr;
2062 </pre></div>
2063
2064 <p>The string to match may cross directory components:
2065 </p>
2066 <div class="example">
2067 <pre class="example-preformatted">kpsewhich --subdir=some/where foo.sty
2068 &rArr; /some/where/foo.sty
2069 </pre></div>
2070
2071 <p><samp class="option">--subdir</samp> implies <samp class="option">--all</samp>; if there is more than one
2072 match, they will all be reported (in our example, both &lsquo;<samp class="samp">where</samp>&rsquo;
2073 and &lsquo;<samp class="samp">place</samp>&rsquo; end in &lsquo;<samp class="samp">e</samp>&rsquo;):
2074 </p>
2075 <div class="example">
2076 <pre class="example-preformatted">kpsewhich --subdir=e
2077 &rArr; /some/where/foo.sty
2078 /another/place/foo.sty
2079 </pre></div>
2080
2081 <p>Because of the above rules, the presence of a leading &lsquo;<samp class="samp">/</samp>&rsquo; is
2082 important, since it &ldquo;anchors&rdquo; the match to a full component name:
2083 </p>
2084 <div class="example">
2085 <pre class="example-preformatted">kpsewhich --subdir=/lace foo.sty
2086 &rArr;
2087 </pre></div>
2088
2089 <p>However, a trailing &lsquo;<samp class="samp">/</samp>&rsquo; is immaterial (and ignored), since the
2090 match always takes place at the end of the directory part:
2091 </p>
2092 <div class="example">
2093 <pre class="example-preformatted">kpsewhich --subdir=lace/ foo.sty
2094 &rArr; /another/place/foo.sty
2095 </pre></div>
2096
2097 <p>The purpose of these rules is to make it convenient to find results
2098 only within a particular area of the tree. For instance, a given
2099 script named <samp class="file">foo.lua</samp> might exist within both
2100 <samp class="file">texmf-dist/scripts/pkg1/</samp> and <samp class="file">texmf-dist/scripts/pkg2/</samp>.
2101 By specifying, say, &lsquo;<samp class="samp">--subdir=/pkg1</samp>&rsquo;, you can be sure of getting
2102 the one you are interested in.
2103 </p>
2104 <p>We only match at the end because a site might happen to install TeX
2105 in <samp class="file">/some/coincidental/pkg1/path/</samp>, and we wouldn&rsquo;t want to match
2106 <samp class="file">texmf-dist/scripts/pkg2/</samp> that when searching for &lsquo;<samp class="samp">/pkg1</samp>&rsquo;.
2107 </p>
2108 </dd>
2109 </dl>
2110
2111
2112 <hr>
2113 </div>
2114 <div class="subsection-level-extent" id="Specially_002drecognized-files">
2115 <div class="nav-panel">
2116 <p>
2117 Next: <a href="#Auxiliary-tasks" accesskey="n" rel="next">Auxiliary tasks</a>, Previous: <a href="#Path-searching-options" accesskey="p" rel="prev">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2118 </div>
2119 <h4 class="subsection" id="Specially_002drecognized-files-for-kpsewhich"><span>5.6.3 Specially-recognized files for <code class="command">kpsewhich</code><a class="copiable-link" href="#Specially_002drecognized-files-for-kpsewhich"> &para;</a></span></h4>
2120
2121 <p><code class="command">kpsewhich</code> recognizes a few special filenames on the command
2122 line and defaults to using the &lsquo;known&rsquo; file formats for them, merely
2123 to save the time and trouble of specifying the format. This is only a
2124 feature of <code class="command">kpsewhich</code>; when using the Kpathsea library
2125 itself, none of these special filenames are recognized, and it&rsquo;s still
2126 up to the caller to specify the desired format.
2127 </p>
2128 <p>Here is the list of special filenames to <code class="command">kpsewhich</code>, along
2129 with their corresponding format:
2130 </p>
2131 <dl class="table">
2132 <dt><a id="index-config_002eps"></a><span><samp class="file">config.ps</samp><a class="copiable-link" href="#index-config_002eps"> &para;</a></span></dt>
2133 <dd><p><code class="code">dvips config</code>
2134 </p>
2135 </dd>
2136 <dt><a id="index-dvipdfmx_002ecfg"></a><span><samp class="file">dvipdfmx.cfg</samp><a class="copiable-link" href="#index-dvipdfmx_002ecfg"> &para;</a></span></dt>
2137 <dd><p>&lsquo;<samp class="samp">other text files</samp>&rsquo;
2138 </p>
2139 </dd>
2140 <dt><a id="index-fmtutil_002ecnf"></a><span><samp class="file">fmtutil.cnf</samp><a class="copiable-link" href="#index-fmtutil_002ecnf"> &para;</a></span></dt>
2141 <dd><p>&lsquo;<samp class="samp">web2c files</samp>&rsquo;
2142 </p>
2143 </dd>
2144 <dt><a id="index-glyphlist_002etxt"></a><span><samp class="file">glyphlist.txt</samp><a class="copiable-link" href="#index-glyphlist_002etxt"> &para;</a></span></dt>
2145 <dd><p>&lsquo;<samp class="samp">map</samp>&rsquo;
2146 </p>
2147 </dd>
2148 <dt><a id="index-mktex_002ecnf"></a><span><samp class="file">mktex.cnf</samp><a class="copiable-link" href="#index-mktex_002ecnf"> &para;</a></span></dt>
2149 <dd><p>&lsquo;<samp class="samp">web2c files</samp>&rsquo;
2150 </p>
2151 </dd>
2152 <dt><a id="index-pdfglyphlist_002etxt"></a><span><samp class="file">pdfglyphlist.txt</samp><a class="copiable-link" href="#index-pdfglyphlist_002etxt"> &para;</a></span></dt>
2153 <dd><p>&lsquo;<samp class="samp">map</samp>&rsquo;
2154 </p>
2155 </dd>
2156 <dt><a class="index-entry-id" id="index-pdftexconfig_002etex"></a>
2157 <a id="index-pdftex_002ecfg"></a><span><samp class="file">pdftex.cfg</samp><a class="copiable-link" href="#index-pdftex_002ecfg"> &para;</a></span></dt>
2158 <dd><p>&lsquo;<samp class="samp">pdftex config</samp>&rsquo; (although <samp class="file">pdftex.cfg</samp> is not used any more;
2159 look for the file <samp class="file">pdftexconfig.tex</samp> instead.)
2160 </p>
2161 </dd>
2162 <dt><a id="index-texmf_002ecnf"></a><span><samp class="file">texmf.cnf</samp><a class="copiable-link" href="#index-texmf_002ecnf"> &para;</a></span></dt>
2163 <dd><p>&lsquo;<samp class="samp">cnf</samp>&rsquo;
2164 </p>
2165 </dd>
2166 <dt><a id="index-XDvi"></a><span><samp class="file">XDvi</samp><a class="copiable-link" href="#index-XDvi"> &para;</a></span></dt>
2167 <dd><p>&lsquo;<samp class="samp">other text files</samp>&rsquo;
2168 </p>
2169 </dd>
2170 </dl>
2171
2172 <p>A user-specified format will override the above defaults.
2173 </p>
2174 <a class="index-entry-id" id="index-tcfmgr_002emap"></a>
2175 <p>Another reference for information about TeX&rsquo;s many special files is
2176 <samp class="file">tcfmgr.map</samp>, found in <samp class="file">texmf/texconfig/tcfmgr.map</samp>, which
2177 records various information about the above configuration files (among
2178 others).
2179 </p>
2180
2181 <hr>
2182 </div>
2183 <div class="subsection-level-extent" id="Auxiliary-tasks">
2184 <div class="nav-panel">
2185 <p>
2186 Next: <a href="#Standard-options" accesskey="n" rel="next">Standard options</a>, Previous: <a href="#Specially_002drecognized-files" accesskey="p" rel="prev">Specially-recognized files for <code class="command">kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2187 </div>
2188 <h4 class="subsection" id="Auxiliary-tasks-1"><span>5.6.4 Auxiliary tasks<a class="copiable-link" href="#Auxiliary-tasks-1"> &para;</a></span></h4>
2189
2190 <a class="index-entry-id" id="index-auxiliary-tasks"></a>
2191
2192 <p>Kpsewhich provides some features in addition to path lookup as such:
2193 </p>
2194 <dl class="table">
2195 <dt><a id="index-_002d_002ddebug_003dnum"></a><span>&lsquo;<samp class="samp">--debug=<var class="var">num</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002ddebug_003dnum"> &para;</a></span></dt>
2196 <dd><p>Set debugging options to <var class="var">num</var>. See <a class="xref" href="#Debugging">Debugging</a>.
2197 </p>
2198 </dd>
2199 <dt><a id="index-_002d_002dexpand_002dbraces_003dstring"></a><span>&lsquo;<samp class="samp">--expand-braces=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dexpand_002dbraces_003dstring"> &para;</a></span></dt>
2200 <dd><p>Output variable, tilde, and brace expansion of <var class="var">string</var>, which is
2201 assumed to be a single path element. See <a class="xref" href="#Path-expansion">Path expansion</a>.
2202 </p>
2203 </dd>
2204 <dt><a id="index-_002d_002dexpand_002dpath_003dstring"></a><span>&lsquo;<samp class="samp">--expand-path=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dexpand_002dpath_003dstring"> &para;</a></span></dt>
2205 <dd><p>Output the complete expansion of <var class="var">string</var>, with each element
2206 separated by the usual path separator on the current system (&lsquo;<samp class="samp">;</samp>&rsquo;
2207 on Windows, &lsquo;<samp class="samp">:</samp>&rsquo; otherwise). This may be useful to construct a
2208 custom search path for a format not otherwise supported. To retrieve
2209 the search path for a format that is already supported, see
2210 &lsquo;<samp class="samp">--show-path</samp>&rsquo;.
2211 </p>
2212 <p>Nonexistent directories are culled from the output:
2213 </p>
2214 <div class="example">
2215 <pre class="example-preformatted">$ kpsewhich --expand-path '/tmp'
2216 &rArr; /tmp
2217 $ kpsewhich --expand-path '/nonesuch'
2218 &rArr;
2219 </pre></div>
2220
2221 <p>For one-shot uses of an arbitrary (not built in to Kpathsea) path, see
2222 &lsquo;<samp class="samp">--path</samp>&rsquo; (see <a class="pxref" href="#Path-searching-options">Path searching options</a>).
2223 </p>
2224 </dd>
2225 <dt><a id="index-_002d_002dexpand_002dvar_003dstring"></a><span>&lsquo;<samp class="samp">--expand-var=<var class="var">string</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dexpand_002dvar_003dstring"> &para;</a></span></dt>
2226 <dd><p>Output the variable and tilde expansion of <var class="var">string</var>. For example,
2227 with the usual <samp class="file">texmf.cnf</samp>, &lsquo;<samp class="samp">kpsewhich
2228 --expand-var='$TEXMF'</samp>&rsquo; returns the TeX system hierarchy root(s).
2229 See <a class="xref" href="#Path-expansion">Path expansion</a>. The specified <var class="var">string</var> can contain
2230 anything, though, not just variable references. This calls
2231 <code class="code">kpse_var_expand</code> (see <a class="pxref" href="#Programming-with-config-files">Programming with config files</a>).
2232 </p>
2233 </dd>
2234 <dt><a id="index-_002d_002dhelp_002dformats"></a><span>&lsquo;<samp class="samp">--help-formats</samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dhelp_002dformats"> &para;</a></span></dt>
2235 <dd><p>Output information about each supported format (see <a class="pxref" href="#Supported-file-formats">Supported file formats</a>), including the names and abbreviations, variables
2236 looked for, and the original path.
2237 </p>
2238 </dd>
2239 <dt><a class="index-entry-id" id="index-_002d_002dsafe_002dextended_002dout_002dname_003dname"></a>
2240 <a id="index-_002d_002dsafe_002dextended_002din_002dname_003dname"></a><span>&lsquo;<samp class="samp">--safe-extended-in-name=<var class="var">name</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dsafe_002dextended_002din_002dname_003dname"> &para;</a></span></dt>
2241 <dt>&lsquo;<samp class="samp">--safe-extended-out-name=<var class="var">name</var></samp>&rsquo;</dt>
2242 <dd><p>As with &lsquo;<samp class="samp">--safe-in-name</samp>&rsquo; and &lsquo;<samp class="samp">--safe-out-name</samp>&rsquo; (next item),
2243 but also allow files under the variables <code class="code">TEXMFVAR</code> and
2244 <code class="code">TEXMFSYSVAR</code> (see <a class="pxref" href="#Calling-sequence">Calling sequence</a>).
2245 </p>
2246 </dd>
2247 <dt><a class="index-entry-id" id="index-_002d_002dsafe_002dout_002dname_003dname"></a>
2248 <a id="index-_002d_002dsafe_002din_002dname_003dname"></a><span>&lsquo;<samp class="samp">--safe-in-name=<var class="var">name</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dsafe_002din_002dname_003dname"> &para;</a></span></dt>
2249 <dt>&lsquo;<samp class="samp">--safe-out-name=<var class="var">name</var></samp>&rsquo;</dt>
2250 <dd><p>Exit successfully if <var class="var">name</var> is safe to open for reading or
2251 writing, respectively, else unsuccessfully. No errors are output.
2252 These tests take account of the related Kpathsea configuration
2253 settings (see <a class="pxref" href="#Calling-sequence">Calling sequence</a>).
2254 </p>
2255 </dd>
2256 <dt><a id="index-_002d_002dshow_002dpath_003dname"></a><span>&lsquo;<samp class="samp">--show-path=<var class="var">name</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dshow_002dpath_003dname"> &para;</a></span></dt>
2257 <dd><p>Show the path that would be used for file lookups of file type
2258 <var class="var">name</var>. Either a filename extension (&lsquo;<samp class="samp">pk</samp>&rsquo;, &lsquo;<samp class="samp">.vf</samp>&rsquo;, etc.)
2259 or an integer can be used, just as with &lsquo;<samp class="samp">--format</samp>&rsquo;, described in
2260 the previous section.
2261 </p>
2262 </dd>
2263 <dt><a id="index-_002d_002dvar_002dbrace_002dvalue_003dvariable"></a><span>&lsquo;<samp class="samp">--var-brace-value=<var class="var">variable</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dvar_002dbrace_002dvalue_003dvariable"> &para;</a></span></dt>
2264 <dd><p>Like &lsquo;<samp class="samp">--var-value</samp>&rsquo; (next), but also expands &lsquo;<samp class="samp">{...}</samp>&rsquo;
2265 constructs. (see <a class="pxref" href="#Brace-expansion">Brace expansion</a>). Thus, the value is assumed to
2266 possibly be several path elements, and &lsquo;<samp class="samp">~</samp>&rsquo; is expanded at the
2267 beginning of each. The path separator is changed to that of the
2268 current system in the expansion.
2269 </p>
2270 <p>Example: &lsquo;<samp class="samp">FOO='.;~' kpsewhich --var-brace-value=FOO</samp>&rsquo; outputs (on
2271 a Unix-ish system) &lsquo;<samp class="samp">.:/home/karl</samp>&rsquo;, supposing the latter is the
2272 current user&rsquo;s home directory. Note that the &lsquo;<samp class="samp">;</samp>&rsquo; in the source
2273 value, as commonly used in <samp class="file">texmf.cnf</samp>, has changed to a
2274 &lsquo;<samp class="samp">:</samp>&rsquo;, as the normal path separator on the current system. On a
2275 Windows-ish system, the &lsquo;<samp class="samp">;</samp>&rsquo; would remain.
2276 </p>
2277 </dd>
2278 <dt><a id="index-_002d_002dvar_002dvalue_003dvariable"></a><span>&lsquo;<samp class="samp">--var-value=<var class="var">variable</var></samp>&rsquo;<a class="copiable-link" href="#index-_002d_002dvar_002dvalue_003dvariable"> &para;</a></span></dt>
2279 <dd><p>Outputs the value of <var class="var">variable</var> (a simple identifier like
2280 &lsquo;<samp class="samp">TEXMFDIST</samp>&rsquo;, with no &lsquo;<samp class="samp">$</samp>&rsquo; or other constructs), expanding
2281 &lsquo;<samp class="samp">$</samp>&rsquo; (see <a class="pxref" href="#Variable-expansion">Variable expansion</a>) and &lsquo;<samp class="samp">~</samp>&rsquo; (see <a class="pxref" href="#Tilde-expansion">Tilde expansion</a>) constructs in the value. &lsquo;<samp class="samp">~</samp>&rsquo; expansion happens at the
2282 beginning of the overall value and at the beginning of a variable
2283 expansion, but not arbitrarily within the string. Braces are not expanded.
2284 </p>
2285 <p>Example: &lsquo;<samp class="samp">--var-value=texmf_casefold_search</samp>&rsquo; outputs (if the
2286 default is not changed) &lsquo;<samp class="samp">1</samp>&rsquo;.
2287 </p>
2288 <p>Example to contrast with &lsquo;<samp class="samp">--var-brace-value</samp>&rsquo;: &lsquo;<samp class="samp">FOO='.;~'
2289 kpsewhich --var-value=FOO</samp>&rsquo; outputs &lsquo;<samp class="samp">.;~</samp>&rsquo;, i.e., the same as the
2290 input value, on all systems.
2291 </p>
2292 </dd>
2293 </dl>
2294
2295
2296 <hr>
2297 </div>
2298 <div class="subsection-level-extent" id="Standard-options">
2299 <div class="nav-panel">
2300 <p>
2301 Previous: <a href="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code class="code">kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2302 </div>
2303 <h4 class="subsection" id="Standard-options-1"><span>5.6.5 Standard options<a class="copiable-link" href="#Standard-options-1"> &para;</a></span></h4>
2304
2305 <a class="index-entry-id" id="index-standard-options"></a>
2306
2307 <p>Kpsewhich accepts the standard GNU options:
2308 </p>
2309 <ul class="itemize mark-bullet">
2310 <li><a class="index-entry-id" id="index-_002d_002dhelp"></a>
2311 &lsquo;<samp class="samp">--help</samp>&rsquo; prints a help message on standard output and exits
2312 successfully.
2313
2314 </li><li><a class="index-entry-id" id="index-_002d_002dversion"></a>
2315 &lsquo;<samp class="samp">--version</samp>&rsquo; prints the Kpathsea version number and exits successfully.
2316 </li></ul>
2317
2318
2319 <hr>
2320 </div>
2321 </div>
2322 </div>
2323 <div class="chapter-level-extent" id="TeX-support">
2324 <div class="nav-panel">
2325 <p>
2326 Next: <a href="#Programming" accesskey="n" rel="next">Programming</a>, Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2327 </div>
2328 <h2 class="chapter" id="TeX-support-1"><span>6 TeX support<a class="copiable-link" href="#TeX-support-1"> &para;</a></span></h2>
2329
2330 <a class="index-entry-id" id="index-TeX-support"></a>
2331
2332 <p>Although the basic features in Kpathsea can be used for any type of
2333 path searching, it came about, as usual, with a specific application
2334 in mind: I wrote Kpathsea specifically for TeX system programs. I
2335 had been struggling with the programs I was using (Dvips, Xdvi, and
2336 TeX itself) having slightly different notions of how to specify
2337 paths; and debugging was painful, since no code was shared.
2338 </p>
2339 <p>Therefore, Kpathsea provides some TeX-specific formats and
2340 features. Indeed, many of the purportedly generic path searching
2341 features were provided because they seemed useful in that conTeXt
2342 (font lookup, particularly).
2343 </p>
2344 <p>Kpathsea provides a standard way to search for files of any of the
2345 supported file types; glyph fonts are a bit different than all the
2346 rest. Searches are based solely on names of files, not their
2347 contents&mdash;if a GF file is (mis)named <samp class="file">cmr10.600pk</samp>, it will be
2348 found as a PK file.
2349 </p>
2350
2351
2352 <ul class="mini-toc">
2353 <li><a href="#Supported-file-formats" accesskey="1">Supported file formats</a></li>
2354 <li><a href="#File-lookup" accesskey="2">File lookup</a></li>
2355 <li><a href="#Glyph-lookup" accesskey="3">Glyph lookup</a></li>
2356 <li><a href="#Suppressing-warnings" accesskey="4">Suppressing warnings</a></li>
2357 <li><a href="#mktex-scripts" accesskey="5"><samp class="file">mktex</samp> scripts</a></li>
2358 </ul>
2359 <hr>
2360 <div class="section-level-extent" id="Supported-file-formats">
2361 <div class="nav-panel">
2362 <p>
2363 Next: <a href="#File-lookup" accesskey="n" rel="next">File lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2364 </div>
2365 <h3 class="section" id="Supported-file-formats-1"><span>6.1 Supported file formats<a class="copiable-link" href="#Supported-file-formats-1"> &para;</a></span></h3>
2366
2367 <a class="index-entry-id" id="index-supported-file-formats"></a>
2368 <a class="index-entry-id" id="index-file-formats_002c-supported"></a>
2369
2370 <a class="index-entry-id" id="index-environment-variables-for-TeX"></a>
2371 <a class="index-entry-id" id="index-TeX-environment-variables"></a>
2372
2373 <p>Kpathsea has support for a number of file types. Each file type has a
2374 list of environment and config file variables that are checked to define
2375 the search path, and most have a default suffix that plays a role in
2376 finding files (see the next section). Some also define additional
2377 suffixes, and/or a program to be run to create missing files on the fly.
2378 </p>
2379 <a class="index-entry-id" id="index-program_002dvarying-paths"></a>
2380 <p>Since environment variables containing periods, such as
2381 &lsquo;<samp class="samp">TEXINPUTS.latex</samp>&rsquo;, are not allowed on some systems, Kpathsea looks
2382 for environment variables with an underscore, e.g.,
2383 &lsquo;<samp class="samp">TEXINPUTS_latex</samp>&rsquo; (see <a class="pxref" href="#Config-files">Config files</a>).
2384 </p>
2385 <p>The following table lists the above information. You can also get the
2386 list by giving the &lsquo;<samp class="samp">--help-formats</samp>&rsquo; option to <code class="code">kpsewhich</code>
2387 (see <a class="pxref" href="#Auxiliary-tasks">Auxiliary tasks</a>).
2388 </p>
2389 <dl class="table">
2390 <dt><a class="index-entry-id" id="index-AFMFONTS"></a>
2391 <a id="index-_002eafm"></a><span>&lsquo;<samp class="samp">afm</samp>&rsquo;<a class="copiable-link" href="#index-_002eafm"> &para;</a></span></dt>
2392 <dd><p>(Adobe font metrics, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite class="cite">Dvips</cite>)
2393 <code class="code">AFMFONTS</code>;
2394 suffix &lsquo;<samp class="samp">.afm</samp>&rsquo;.
2395 </p>
2396 </dd>
2397 <dt><a class="index-entry-id" id="index-MFBASES"></a>
2398 <a class="index-entry-id" id="index-TEXMFINI"></a>
2399 <a id="index-_002ebase"></a><span>&lsquo;<samp class="samp">base</samp>&rsquo;<a class="copiable-link" href="#index-_002ebase"> &para;</a></span></dt>
2400 <dd><p>(Metafont memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite class="cite">Web2c</cite>)
2401 <code class="code">MFBASES</code>, <code class="code">TEXMFINI</code>;
2402 suffix &lsquo;<samp class="samp">.base</samp>&rsquo;.
2403 </p>
2404 </dd>
2405 <dt><a class="index-entry-id" id="index-BIBINPUTS"></a>
2406 <a class="index-entry-id" id="index-TEXBIB"></a>
2407 <a id="index-_002ebib"></a><span>&lsquo;<samp class="samp">bib</samp>&rsquo;<a class="copiable-link" href="#index-_002ebib"> &para;</a></span></dt>
2408 <dd><p>(BibTeX bibliography source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#bibtex-invocation">bibtex invocation</a> in <cite class="cite">Web2c</cite>)
2409 <code class="code">BIBINPUTS</code>, <code class="code">TEXBIB</code>;
2410 suffix &lsquo;<samp class="samp">.bib</samp>&rsquo;.
2411 </p>
2412 </dd>
2413 <dt><a class="index-entry-id" id="index-BLTXMLINPUTS"></a>
2414 <a id="index-_002ebltxml"></a><span>&lsquo;<samp class="samp">bltxml</samp>&rsquo;<a class="copiable-link" href="#index-_002ebltxml"> &para;</a></span></dt>
2415 <dd><p>(BibLaTeXML bibliography files for Biber, <a class="url" href="https://ctan.org/pkg/biber">https://ctan.org/pkg/biber</a>)
2416 <code class="code">BLTXMLINPUTS</code>
2417 suffix &lsquo;<samp class="samp">.bltxml</samp>&rsquo;.
2418 </p>
2419 </dd>
2420 <dt><a class="index-entry-id" id="index-BSTINPUTS"></a>
2421 <a id="index-_002ebst"></a><span>&lsquo;<samp class="samp">bst</samp>&rsquo;<a class="copiable-link" href="#index-_002ebst"> &para;</a></span></dt>
2422 <dd><p>(BibTeX style, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Basic-BibTeX-style-files">Basic BibTeX
2423 style files</a> in <cite class="cite">Web2c</cite>)
2424 <code class="code">BSTINPUTS</code>;
2425 suffix &lsquo;<samp class="samp">.bst</samp>&rsquo;.
2426 </p>
2427 </dd>
2428 <dt><a class="index-entry-id" id="index-_002eso"></a>
2429 <a class="index-entry-id" id="index-CLUAINPUTS"></a>
2430 <a id="index-_002edll"></a><span>&lsquo;<samp class="samp">clua</samp>&rsquo;<a class="copiable-link" href="#index-_002edll"> &para;</a></span></dt>
2431 <dd><p>(dynamic libraries for Lua, <a class="url" href="https://ctan.org/pkg/luatex">https://ctan.org/pkg/luatex</a>)
2432 <code class="code">CLUAINPUTS</code>
2433 suffixes &lsquo;<samp class="samp">.dll</samp>&rsquo; and &lsquo;<samp class="samp">.so</samp>&rsquo;.
2434 </p>
2435 </dd>
2436 <dt><a class="index-entry-id" id="index-CMAPFONTS"></a>
2437 <a id="index-_002ecmap"></a><span>&lsquo;<samp class="samp">cmap</samp>&rsquo;<a class="copiable-link" href="#index-_002ecmap"> &para;</a></span></dt>
2438 <dd><p>(character map files)
2439 <code class="code">CMAPFONTS</code>;
2440 suffix &lsquo;<samp class="samp">.cmap</samp>&rsquo;.
2441 </p>
2442 </dd>
2443 <dt><a class="index-entry-id" id="index-TEXMFCNF-1"></a>
2444 <a id="index-_002ecnf"></a><span>&lsquo;<samp class="samp">cnf</samp>&rsquo;<a class="copiable-link" href="#index-_002ecnf"> &para;</a></span></dt>
2445 <dd><p>(Runtime configuration files, see <a class="pxref" href="#Config-files">Config files</a>)
2446 <code class="code">TEXMFCNF</code>;
2447 suffix &lsquo;<samp class="samp">.cnf</samp>&rsquo;.
2448 </p>
2449 </dd>
2450 <dt><a class="index-entry-id" id="index-_002eweb"></a>
2451 <a class="index-entry-id" id="index-CWEBINPUTS"></a>
2452 <a id="index-_002ew"></a><span>&lsquo;<samp class="samp">cweb</samp>&rsquo;<a class="copiable-link" href="#index-_002ew"> &para;</a></span></dt>
2453 <dd><p>(CWEB input files)
2454 <code class="code">CWEBINPUTS</code>;
2455 suffixes &lsquo;<samp class="samp">.w</samp>&rsquo;, &lsquo;<samp class="samp">.web</samp>&rsquo;;
2456 additional suffix &lsquo;<samp class="samp">.ch</samp>&rsquo;.
2457 </p>
2458 </dd>
2459 <dt><a class="index-entry-id" id="index-config_002eps_002c-search-path-for"></a>
2460 <a id="index-TEXCONFIG"></a><span>&lsquo;<samp class="samp">dvips config</samp>&rsquo;<a class="copiable-link" href="#index-TEXCONFIG"> &para;</a></span></dt>
2461 <dd><p>(Dvips &lsquo;<samp class="samp">config.*</samp>&rsquo; files, such as <samp class="file">config.ps</samp>, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config
2462 files</a> in <cite class="cite">Dvips</cite>)
2463 <code class="code">TEXCONFIG</code>.
2464 </p>
2465 </dd>
2466 <dt><a class="index-entry-id" id="index-ENCFONTS"></a>
2467 <a id="index-_002eenc"></a><span>&lsquo;<samp class="samp">enc files</samp>&rsquo;<a class="copiable-link" href="#index-_002eenc"> &para;</a></span></dt>
2468 <dd><p>(encoding vectors)
2469 <code class="code">ENCFONTS</code>;
2470 suffix &lsquo;<samp class="samp">.enc</samp>&rsquo;.
2471 </p>
2472 </dd>
2473 <dt><a class="index-entry-id" id="index-TEXFORMATS"></a>
2474 <a class="index-entry-id" id="index-TEXMFINI-1"></a>
2475 <a id="index-_002efmt"></a><span>&lsquo;<samp class="samp">fmt</samp>&rsquo;<a class="copiable-link" href="#index-_002efmt"> &para;</a></span></dt>
2476 <dd><p>(TeX memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite class="cite">Web2c</cite>)
2477 <code class="code">TEXFORMATS</code>, <code class="code">TEXMFINI</code>;
2478 suffix &lsquo;<samp class="samp">.fmt</samp>&rsquo;.
2479 </p>
2480 </dd>
2481 <dt><a class="index-entry-id" id="index-FONTCIDMAPS"></a>
2482 <a id="index-_002ecid"></a><span>&lsquo;<samp class="samp">font cid map</samp>&rsquo;<a class="copiable-link" href="#index-_002ecid"> &para;</a></span></dt>
2483 <dd><p>(CJK mapping)
2484 <code class="code">FONTCIDMAPS</code>
2485 suffix &lsquo;<samp class="samp">.cid</samp>&rsquo;.
2486 </p>
2487 </dd>
2488 <dt><a class="index-entry-id" id="index-FONTFEATURES"></a>
2489 <a id="index-_002efea"></a><span>&lsquo;<samp class="samp">font feature files</samp>&rsquo;<a class="copiable-link" href="#index-_002efea"> &para;</a></span></dt>
2490 <dd><p>(primarily for OpenType font features)
2491 <code class="code">FONTFEATURES</code>
2492 suffix &lsquo;<samp class="samp">.fea</samp>&rsquo;.
2493 </p>
2494 </dd>
2495 <dt><a class="index-entry-id" id="index-GFFONTS"></a>
2496 <a class="index-entry-id" id="index-GLYPHFONTS"></a>
2497 <a class="index-entry-id" id="index-TEXFONTS"></a>
2498 <a id="index-gf"></a><span>&lsquo;<samp class="samp">gf</samp>&rsquo;<a class="copiable-link" href="#index-gf"> &para;</a></span></dt>
2499 <dd><p>(generic font bitmap, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite class="cite">Dvips</cite>)
2500 <code class="code"><var class="var">program</var>FONTS</code>, <code class="code">GFFONTS</code>, <code class="code">GLYPHFONTS</code>, <code class="code">TEXFONTS</code>;
2501 suffix &lsquo;<samp class="samp">gf</samp>&rsquo;.
2502 </p>
2503 </dd>
2504 <dt><a class="index-entry-id" id="index-_002eepsi"></a>
2505 <a class="index-entry-id" id="index-TEXPICTS"></a>
2506 <a class="index-entry-id" id="index-TEXINPUTS"></a>
2507 <a id="index-_002eeps"></a><span>&lsquo;<samp class="samp">graphic/figure</samp>&rsquo;<a class="copiable-link" href="#index-_002eeps"> &para;</a></span></dt>
2508 <dd><p>(Encapsulated PostScript figures, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#PostScript-figures">PostScript figures</a> in <cite class="cite">Dvips</cite>)
2509 <code class="code">TEXPICTS</code>, <code class="code">TEXINPUTS</code>;
2510 additional suffixes: &lsquo;<samp class="samp">.eps</samp>&rsquo;, &lsquo;<samp class="samp">.epsi</samp>&rsquo;.
2511 </p>
2512 </dd>
2513 <dt><a class="index-entry-id" id="index-TEXINDEXSTYLE"></a>
2514 <a class="index-entry-id" id="index-INDEXSTYLE"></a>
2515 <a id="index-_002eist"></a><span>&lsquo;<samp class="samp">ist</samp>&rsquo;<a class="copiable-link" href="#index-_002eist"> &para;</a></span></dt>
2516 <dd><p>(makeindex style files)
2517 <code class="code">TEXINDEXSTYLE</code>, <code class="code">INDEXSTYLE</code>;
2518 suffix &lsquo;<samp class="samp">.ist</samp>&rsquo;.
2519 </p>
2520 </dd>
2521 <dt><a class="index-entry-id" id="index-LIGFONTS"></a>
2522 <a id="index-_002elig"></a><span>&lsquo;<samp class="samp">lig files</samp>&rsquo;<a class="copiable-link" href="#index-_002elig"> &para;</a></span></dt>
2523 <dd><p>(ligature definition files)
2524 <code class="code">LIGFONTS</code>;
2525 suffix &lsquo;<samp class="samp">.lig</samp>&rsquo;.
2526 </p>
2527 </dd>
2528 <dt><a class="index-entry-id" id="index-TEXMFDBS-1"></a>
2529 <a id="index-ls_002dR"></a><span>&lsquo;<samp class="samp">ls-R</samp>&rsquo;<a class="copiable-link" href="#index-ls_002dR"> &para;</a></span></dt>
2530 <dd><p>(Filename databases, see <a class="pxref" href="#Filename-database">Filename database (<code class="code">ls-R</code>)</a>)
2531 <code class="code">TEXMFDBS</code>.
2532 </p>
2533 </dd>
2534 <dt><a class="index-entry-id" id="index-_002eluatex"></a>
2535 <a class="index-entry-id" id="index-_002eluc"></a>
2536 <a class="index-entry-id" id="index-_002eluctex"></a>
2537 <a class="index-entry-id" id="index-_002etexlua"></a>
2538 <a class="index-entry-id" id="index-_002etexluc"></a>
2539 <a class="index-entry-id" id="index-_002etlu"></a>
2540 <a class="index-entry-id" id="index-LUAINPUTS"></a>
2541 <a id="index-_002elua"></a><span>&lsquo;<samp class="samp">lua</samp>&rsquo;<a class="copiable-link" href="#index-_002elua"> &para;</a></span></dt>
2542 <dd><p>(Lua scripts, <a class="url" href="https://ctan.org/pkg/luatex">https://ctan.org/pkg/luatex</a>)
2543 <code class="code">LUAINPUTS</code>
2544 suffixes &lsquo;<samp class="samp">.lua</samp>&rsquo;, &lsquo;<samp class="samp">.luatex</samp>&rsquo;, &lsquo;<samp class="samp">.luc</samp>&rsquo;, &lsquo;<samp class="samp">.luctex</samp>&rsquo;,
2545 &lsquo;<samp class="samp">.texlua</samp>&rsquo;, &lsquo;<samp class="samp">.texluc</samp>&rsquo;, &lsquo;<samp class="samp">.tlu</samp>&rsquo;.
2546 </p>
2547 </dd>
2548 <dt><a class="index-entry-id" id="index-TEXFONTMAPS"></a>
2549 <a id="index-_002emap"></a><span>&lsquo;<samp class="samp">map</samp>&rsquo;<a class="copiable-link" href="#index-_002emap"> &para;</a></span></dt>
2550 <dd><p>(Fontmaps, see <a class="pxref" href="#Fontmap">Fontmap</a>)
2551 <code class="code">TEXFONTMAPS</code>;
2552 suffix &lsquo;<samp class="samp">.map</samp>&rsquo;.
2553 </p>
2554 </dd>
2555 <dt><a class="index-entry-id" id="index-MPMEMS"></a>
2556 <a class="index-entry-id" id="index-TEXMFINI-2"></a>
2557 <a id="index-_002emem"></a><span>&lsquo;<samp class="samp">mem</samp>&rsquo;<a class="copiable-link" href="#index-_002emem"> &para;</a></span></dt>
2558 <dd><p>(MetaPost memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite class="cite">Web2c</cite>)
2559 <code class="code">MPMEMS</code>, <code class="code">TEXMFINI</code>;
2560 suffix &lsquo;<samp class="samp">.mem</samp>&rsquo;.
2561 </p>
2562 </dd>
2563 <dt><a id="index-MPSUPPORT"></a><span>&lsquo;<samp class="samp"><span class="r">MetaPost support</span></samp>&rsquo;<a class="copiable-link" href="#index-MPSUPPORT"> &para;</a></span></dt>
2564 <dd><p>(MetaPost support files, used by DMP; see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#dmp-invocation">dmp invocation</a> in <cite class="cite">Web2c</cite>)
2565 <code class="code">MPSUPPORT</code>.
2566 </p>
2567 </dd>
2568 <dt><a class="index-entry-id" id="index-MFINPUTS"></a>
2569 <a id="index-_002emf"></a><span>&lsquo;<samp class="samp">mf</samp>&rsquo;<a class="copiable-link" href="#index-_002emf"> &para;</a></span></dt>
2570 <dd><p>(Metafont source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mf-invocation">mf invocation</a> in <cite class="cite">Web2c</cite>)
2571 <code class="code">MFINPUTS</code>;
2572 suffix &lsquo;<samp class="samp">.mf</samp>&rsquo;;
2573 dynamic creation program: <code class="code">mktexmf</code>.
2574 </p>
2575 </dd>
2576 <dt><a class="index-entry-id" id="index-MFPOOL"></a>
2577 <a id="index-_002epool"></a><span>&lsquo;<samp class="samp">mfpool</samp>&rsquo;<a class="copiable-link" href="#index-_002epool"> &para;</a></span></dt>
2578 <dd><p>(Metafont program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite class="cite">Web2c</cite>)
2579 <code class="code">MFPOOL</code>, <code class="code">TEXMFINI</code>;
2580 suffix &lsquo;<samp class="samp">.pool</samp>&rsquo;.
2581 </p>
2582 </dd>
2583 <dt><a class="index-entry-id" id="index-MFTINPUTS"></a>
2584 <a id="index-_002emft"></a><span>&lsquo;<samp class="samp">mft</samp>&rsquo;<a class="copiable-link" href="#index-_002emft"> &para;</a></span></dt>
2585 <dd><p>(<code class="code">MFT</code> style file, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mft-invocation">mft invocation</a> in <cite class="cite">Web2c</cite>)
2586 <code class="code">MFTINPUTS</code>;
2587 suffix &lsquo;<samp class="samp">.mft</samp>&rsquo;.
2588 </p>
2589 </dd>
2590 <dt><a id="index-MISCFONTS"></a><span>&lsquo;<samp class="samp">misc fonts</samp>&rsquo;<a class="copiable-link" href="#index-MISCFONTS"> &para;</a></span></dt>
2591 <dd><p>(font-related files that don&rsquo;t fit the other categories)
2592 <code class="code">MISCFONTS</code>
2593 </p>
2594 </dd>
2595 <dt><a class="index-entry-id" id="index-MLBIBINPUTS"></a>
2596 <a class="index-entry-id" id="index-BIBINPUTS-1"></a>
2597 <a class="index-entry-id" id="index-TEXBIB-1"></a>
2598 <a id="index-_002emlbib"></a><span>&lsquo;<samp class="samp">mlbib</samp>&rsquo;<a class="copiable-link" href="#index-_002emlbib"> &para;</a></span></dt>
2599 <dd><p>(MlBibTeX bibliography source)
2600 <code class="code">MLBIBINPUTS</code>, <code class="code">BIBINPUTS</code>, <code class="code">TEXBIB</code>;
2601 suffixes &lsquo;<samp class="samp">.mlbib</samp>&rsquo;, &lsquo;<samp class="samp">.mlbib</samp>&rsquo;.
2602 </p>
2603 </dd>
2604 <dt><a class="index-entry-id" id="index-MLBSTINPUTS"></a>
2605 <a class="index-entry-id" id="index-BSTINPUTS-1"></a>
2606 <a id="index-_002emlbst"></a><span>&lsquo;<samp class="samp">mlbst</samp>&rsquo;<a class="copiable-link" href="#index-_002emlbst"> &para;</a></span></dt>
2607 <dd><p>(MlBibTeX style)
2608 <code class="code">MLBSTINPUTS</code>, <code class="code">BSTINPUTS</code>;
2609 suffixes &lsquo;<samp class="samp">.mlbst</samp>&rsquo;, &lsquo;<samp class="samp">.bst</samp>&rsquo;.
2610 </p>
2611 </dd>
2612 <dt><a class="index-entry-id" id="index-MPINPUTS"></a>
2613 <a id="index-_002emp"></a><span>&lsquo;<samp class="samp">mp</samp>&rsquo;<a class="copiable-link" href="#index-_002emp"> &para;</a></span></dt>
2614 <dd><p>(MetaPost source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mpost-invocation">mpost invocation</a> in <cite class="cite">Web2c</cite>)
2615 <code class="code">MPINPUTS</code>;
2616 suffix &lsquo;<samp class="samp">.mp</samp>&rsquo;.
2617 </p>
2618 </dd>
2619 <dt><a class="index-entry-id" id="index-MPPOOL"></a>
2620 <a id="index-_002epool-1"></a><span>&lsquo;<samp class="samp">mppool</samp>&rsquo;<a class="copiable-link" href="#index-_002epool-1"> &para;</a></span></dt>
2621 <dd><p>(MetaPost program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite class="cite">Web2c</cite>)
2622 <code class="code">MPPOOL</code>, <code class="code">TEXMFINI</code>;
2623 suffix &lsquo;<samp class="samp">.pool</samp>&rsquo;.
2624 </p>
2625 </dd>
2626 <dt><a class="index-entry-id" id="index-OCPINPUTS"></a>
2627 <a id="index-_002eocp"></a><span>&lsquo;<samp class="samp">ocp</samp>&rsquo;<a class="copiable-link" href="#index-_002eocp"> &para;</a></span></dt>
2628 <dd><p>(Omega compiled process files)
2629 <code class="code">OCPINPUTS</code>; <br>
2630 suffix &lsquo;<samp class="samp">.ocp</samp>&rsquo;;
2631 dynamic creation program: <code class="code">MakeOmegaOCP</code>.
2632 </p>
2633 </dd>
2634 <dt><a class="index-entry-id" id="index-OFMFONTS"></a>
2635 <a id="index-_002eofm"></a><span>&lsquo;<samp class="samp">ofm</samp>&rsquo;<a class="copiable-link" href="#index-_002eofm"> &para;</a></span></dt>
2636 <dd><p>(Omega font metrics)
2637 <code class="code">OFMFONTS</code>, <code class="code">TEXFONTS</code>; <br>
2638 suffixes &lsquo;<samp class="samp">.ofm</samp>&rsquo;, &lsquo;<samp class="samp">.tfm</samp>&rsquo;;
2639 dynamic creation program: <code class="code">MakeOmegaOFM</code>.
2640 </p>
2641 </dd>
2642 <dt><a id="index-OPENTYPEFONTS"></a><span>&lsquo;<samp class="samp">opentype fonts</samp>&rsquo;<a class="copiable-link" href="#index-OPENTYPEFONTS"> &para;</a></span></dt>
2643 <dd><p>(OpenType fonts)
2644 <code class="code">OPENTYPEFONTS</code>.
2645 </p>
2646 </dd>
2647 <dt><a id="index-_002eopl"></a><span>&lsquo;<samp class="samp">opl</samp>&rsquo;<a class="copiable-link" href="#index-_002eopl"> &para;</a></span></dt>
2648 <dd><p>(Omega property lists)
2649 <code class="code">OPLFONTS</code>, <code class="code">TEXFONTS</code>;
2650 suffix &lsquo;<samp class="samp">.opl</samp>&rsquo;.
2651 </p>
2652 </dd>
2653 <dt><a class="index-entry-id" id="index-OTPINPUTS"></a>
2654 <a id="index-_002eotp"></a><span>&lsquo;<samp class="samp">otp</samp>&rsquo;<a class="copiable-link" href="#index-_002eotp"> &para;</a></span></dt>
2655 <dd><p>(Omega translation process files)
2656 <code class="code">OTPINPUTS</code>;
2657 suffix &lsquo;<samp class="samp">.otp</samp>&rsquo;.
2658 </p>
2659 </dd>
2660 <dt><a class="index-entry-id" id="index-OVFFONTS"></a>
2661 <a id="index-_002eovf"></a><span>&lsquo;<samp class="samp">ovf</samp>&rsquo;<a class="copiable-link" href="#index-_002eovf"> &para;</a></span></dt>
2662 <dd><p>(Omega virtual fonts)
2663 <code class="code">OVFFONTS</code>, <code class="code">TEXFONTS</code>;
2664 suffix &lsquo;<samp class="samp">.ovf</samp>&rsquo;.
2665 </p>
2666 </dd>
2667 <dt><a class="index-entry-id" id="index-OVPFONTS"></a>
2668 <a id="index-_002eovp"></a><span>&lsquo;<samp class="samp">ovp</samp>&rsquo;<a class="copiable-link" href="#index-_002eovp"> &para;</a></span></dt>
2669 <dd><p>(Omega virtual property lists)
2670 <code class="code">OVPFONTS</code>, <code class="code">TEXFONTS</code>;
2671 suffix &lsquo;<samp class="samp">.ovp</samp>&rsquo;.
2672 </p>
2673 </dd>
2674 <dt><a id="index-PDFTEXCONFIG"></a><span>&lsquo;<samp class="samp">pdftex config</samp>&rsquo;<a class="copiable-link" href="#index-PDFTEXCONFIG"> &para;</a></span></dt>
2675 <dd><p>(PDFTeX-specific configuration files)
2676 <code class="code">PDFTEXCONFIG</code>.
2677 </p>
2678 </dd>
2679 <dt><a class="index-entry-id" id="index-PKFONTS"></a>
2680 <a class="index-entry-id" id="index-TEXPKS"></a>
2681 <a class="index-entry-id" id="index-GLYPHFONTS-1"></a>
2682 <a class="index-entry-id" id="index-TEXFONTS-1"></a>
2683 <a id="index-_002epk"></a><span>&lsquo;<samp class="samp">pk</samp>&rsquo;<a class="copiable-link" href="#index-_002epk"> &para;</a></span></dt>
2684 <dd><p>(packed bitmap fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite class="cite">Dvips</cite>)
2685 <code class="code"><var class="var">PROGRAM</var>FONTS</code> (<var class="var">program</var> being &lsquo;<samp class="samp">XDVI</samp>&rsquo;, etc.),
2686 <code class="code">PKFONTS</code>, <code class="code">TEXPKS</code>, <code class="code">GLYPHFONTS</code>, <code class="code">TEXFONTS</code>;
2687 suffix &lsquo;<samp class="samp">pk</samp>&rsquo;;
2688 dynamic creation program: <code class="code">mktexpk</code>.
2689 </p>
2690 </dd>
2691 <dt><a class="index-entry-id" id="index-TEXPSHEADERS"></a>
2692 <a class="index-entry-id" id="index-PSHEADERS"></a>
2693 <a id="index-_002epro"></a><span>&lsquo;<samp class="samp">PostScript header</samp>&rsquo;<a class="copiable-link" href="#index-_002epro"> &para;</a></span></dt>
2694 <dd><p>(downloadable PostScript, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Header-files">Header files</a> in <cite class="cite">Dvips</cite>)
2695 <code class="code">TEXPSHEADERS</code>, <code class="code">PSHEADERS</code>;
2696 additional suffix &lsquo;<samp class="samp">.pro</samp>&rsquo;.
2697 </p>
2698 </dd>
2699 <dt><a class="index-entry-id" id="index-RISINPUTS"></a>
2700 <a id="index-_002eris"></a><span>&lsquo;<samp class="samp">ris</samp>&rsquo;<a class="copiable-link" href="#index-_002eris"> &para;</a></span></dt>
2701 <dd><p>(RIS bibliography files, primarily for Biber, <a class="url" href="https://ctan.org/pkg/biber">https://ctan.org/pkg/biber</a>)
2702 <code class="code">RISINPUTS</code>
2703 suffix &lsquo;<samp class="samp">.ris</samp>&rsquo;.
2704 </p>
2705 </dd>
2706 <dt><a class="index-entry-id" id="index-SFDFONTS"></a>
2707 <a id="index-_002esfd"></a><span>&lsquo;<samp class="samp">subfont definition files</samp>&rsquo;<a class="copiable-link" href="#index-_002esfd"> &para;</a></span></dt>
2708 <dd><p>(subfont definition files)
2709 <code class="code">SFDFONTS</code>
2710 suffix &lsquo;<samp class="samp">.sfd</samp>&rsquo;.
2711 </p>
2712 </dd>
2713 <dt><a class="index-entry-id" id="index-TEXINPUTS-1"></a>
2714 <a id="index-_002etex"></a><span>&lsquo;<samp class="samp">tex</samp>&rsquo;<a class="copiable-link" href="#index-_002etex"> &para;</a></span></dt>
2715 <dd><p>(TeX source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite class="cite">Web2c</cite>)
2716 <code class="code">TEXINPUTS</code>;
2717 suffix &lsquo;<samp class="samp">.tex</samp>&rsquo;;
2718 additional suffixes: none, because such a list cannot be complete;
2719 dynamic creation program: <code class="code">mktextex</code>.
2720 </p>
2721 </dd>
2722 <dt><a class="index-entry-id" id="index-TEXDOCS"></a>
2723 <a id="index-doc-files"></a><span>&lsquo;<samp class="samp">TeX system documentation</samp>&rsquo;<a class="copiable-link" href="#index-doc-files"> &para;</a></span></dt>
2724 <dd><p>(Documentation files for the TeX system)
2725 <code class="code">TEXDOCS</code>.
2726 </p>
2727 </dd>
2728 <dt><a class="index-entry-id" id="index-TEXSOURCES"></a>
2729 <a id="index-source-files"></a><span>&lsquo;<samp class="samp">TeX system sources</samp>&rsquo;<a class="copiable-link" href="#index-source-files"> &para;</a></span></dt>
2730 <dd><p>(Source files for the TeX system)
2731 <code class="code">TEXSOURCES</code>.
2732 </p>
2733 </dd>
2734 <dt><a id="index-TEXMFSCRIPTS"></a><span>&lsquo;<samp class="samp">texmfscripts</samp>&rsquo;<a class="copiable-link" href="#index-TEXMFSCRIPTS"> &para;</a></span></dt>
2735 <dd><p>(Architecture-independent executables distributed in the texmf trees)
2736 <code class="code">TEXMFSCRIPTS</code>.
2737 </p>
2738 </dd>
2739 <dt><a class="index-entry-id" id="index-TEXPOOL"></a>
2740 <a id="index-_002epool-2"></a><span>&lsquo;<samp class="samp">texpool</samp>&rsquo;<a class="copiable-link" href="#index-_002epool-2"> &para;</a></span></dt>
2741 <dd><p>(TeX program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite class="cite">Web2c</cite>)
2742 <code class="code">TEXPOOL</code>, <code class="code">TEXMFINI</code>;
2743 suffix &lsquo;<samp class="samp">.pool</samp>&rsquo;.
2744 </p>
2745 </dd>
2746 <dt><a class="index-entry-id" id="index-TFMFONTS"></a>
2747 <a class="index-entry-id" id="index-TEXFONTS-2"></a>
2748 <a id="index-_002etfm"></a><span>&lsquo;<samp class="samp">tfm</samp>&rsquo;<a class="copiable-link" href="#index-_002etfm"> &para;</a></span></dt>
2749 <dd><p>(TeX font metrics, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite class="cite">Dvips</cite>)
2750 <code class="code">TFMFONTS</code>, <code class="code">TEXFONTS</code>;
2751 suffix &lsquo;<samp class="samp">.tfm</samp>&rsquo;;
2752 dynamic creation program: <code class="code">mktextfm</code>.
2753 </p>
2754 </dd>
2755 <dt><a id="index-TRFONTS"></a><span>&lsquo;<samp class="samp">Troff fonts</samp>&rsquo;<a class="copiable-link" href="#index-TRFONTS"> &para;</a></span></dt>
2756 <dd><p>(Troff fonts, used by DMP; see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#DMP-invocation">DMP invocation</a> in <cite class="cite">Web2c</cite>)
2757 <code class="code">TRFONTS</code>.
2758 </p>
2759 </dd>
2760 <dt><a class="index-entry-id" id="index-_002ettc"></a>
2761 <a class="index-entry-id" id="index-TTFONTS"></a>
2762 <a id="index-_002ettf"></a><span>&lsquo;<samp class="samp">truetype fonts</samp>&rsquo;<a class="copiable-link" href="#index-_002ettf"> &para;</a></span></dt>
2763 <dd><p>(TrueType outline fonts) <code class="code">TTFONTS</code>; suffixes &lsquo;<samp class="samp">.ttf</samp>&rsquo; and
2764 &lsquo;<samp class="samp">.TTF</samp>&rsquo;, &lsquo;<samp class="samp">.ttc</samp>&rsquo; and &lsquo;<samp class="samp">.TTC</samp>&rsquo;, &lsquo;<samp class="samp">.dfont</samp>&rsquo;.
2765 </p>
2766 </dd>
2767 <dt><a class="index-entry-id" id="index-_002epfb"></a>
2768 <a class="index-entry-id" id="index-T1FONTS"></a>
2769 <a class="index-entry-id" id="index-T1INPUTS"></a>
2770 <a class="index-entry-id" id="index-TEXPSHEADERS-1"></a>
2771 <a class="index-entry-id" id="index-DVIPSHEADERS"></a>
2772 <a id="index-_002epfa"></a><span>&lsquo;<samp class="samp">type1 fonts</samp>&rsquo;<a class="copiable-link" href="#index-_002epfa"> &para;</a></span></dt>
2773 <dd><p>(Type 1 PostScript outline fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite class="cite">Dvips</cite>)
2774 <code class="code">T1FONTS</code>, <code class="code">T1INPUTS</code>, <code class="code">TEXPSHEADERS</code>, <code class="code">DVIPSHEADERS</code>;
2775 suffixes &lsquo;<samp class="samp">.pfa</samp>&rsquo;, &lsquo;<samp class="samp">.pfb</samp>&rsquo;.
2776 </p>
2777 </dd>
2778 <dt><a id="index-T42FONTS"></a><span>&lsquo;<samp class="samp">type42 fonts</samp>&rsquo;<a class="copiable-link" href="#index-T42FONTS"> &para;</a></span></dt>
2779 <dd><p>(Type 42 PostScript outline fonts) <code class="code">T42FONTS</code>.
2780 </p>
2781 </dd>
2782 <dt><a class="index-entry-id" id="index-VFFONTS"></a>
2783 <a class="index-entry-id" id="index-TEXFONTS-3"></a>
2784 <a id="index-_002evf"></a><span>&lsquo;<samp class="samp">vf</samp>&rsquo;<a class="copiable-link" href="#index-_002evf"> &para;</a></span></dt>
2785 <dd><p>(virtual fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite class="cite">Dvips</cite>)
2786 <code class="code">VFFONTS</code>, <code class="code">TEXFONTS</code>;
2787 suffix &lsquo;<samp class="samp">.vf</samp>&rsquo;.
2788 </p>
2789 </dd>
2790 <dt><a class="index-entry-id" id="index-WEBINPUTS"></a>
2791 <a id="index-_002eweb-1"></a><span>&lsquo;<samp class="samp">web</samp>&rsquo;<a class="copiable-link" href="#index-_002eweb-1"> &para;</a></span></dt>
2792 <dd><p>(WEB input files)
2793 <code class="code">WEBINPUTS</code>;
2794 suffix &lsquo;<samp class="samp">.web</samp>&rsquo;;
2795 additional suffix &lsquo;<samp class="samp">.ch</samp>&rsquo;.
2796 </p>
2797 </dd>
2798 <dt><a id="index-WEB2C"></a><span>&lsquo;<samp class="samp">web2c files</samp>&rsquo;<a class="copiable-link" href="#index-WEB2C"> &para;</a></span></dt>
2799 <dd><p>(files specific to the web2c implementation)
2800 <code class="code">WEB2C</code>.
2801 </p></dd>
2802 </dl>
2803
2804 <p>There are two special cases, because the paths and environment variables
2805 always depend on the name of the program: the variable name is
2806 constructed by converting the program name to upper case, and then
2807 appending &lsquo;<samp class="samp">INPUTS</samp>&rsquo;. Assuming the program is called &lsquo;<samp class="samp">foo</samp>&rsquo;,
2808 this gives us the following table.
2809 </p>
2810 <dl class="table">
2811 <dt><a id="index-FOOINPUTS"></a><span>&lsquo;<samp class="samp">other text files</samp>&rsquo;<a class="copiable-link" href="#index-FOOINPUTS"> &para;</a></span></dt>
2812 <dd><p>(text files used by &lsquo;<samp class="samp">foo</samp>&rsquo;)
2813 <code class="code">FOOINPUTS</code>.
2814 </p>
2815 </dd>
2816 <dt><a id="index-FOOINPUTS-1"></a><span>&lsquo;<samp class="samp">other binary files</samp>&rsquo;<a class="copiable-link" href="#index-FOOINPUTS-1"> &para;</a></span></dt>
2817 <dd><p>(binary files used by &lsquo;<samp class="samp">foo</samp>&rsquo;)
2818 <code class="code">FOOINPUTS</code>.
2819 </p></dd>
2820 </dl>
2821
2822 <p>If an environment variable by these names are set, the corresponding
2823 <samp class="file">texmf.cnf</samp> definition won&rsquo;t be looked at (unless, as usual, the
2824 environment variable value has an extra &lsquo;<samp class="samp">:</samp>&rsquo;). See <a class="xref" href="#Default-expansion">Default expansion</a>.
2825 </p>
2826 <p>For the font variables, the intent is that:
2827 </p><ul class="itemize mark-bullet">
2828 <li><code class="code">TEXFONTS</code> is the default for everything.
2829
2830 </li><li><code class="code">GLYPHFONTS</code> is the default for bitmap (or, more precisely,
2831 non-metric) files.
2832
2833 </li><li>Each font format has a variable of its own.
2834
2835 </li><li><a class="index-entry-id" id="index-XDVIFONTS"></a>
2836 <a class="index-entry-id" id="index-DVIPSFONTS"></a>
2837 Each program has its own font override path as well; e.g.,
2838 <code class="code">DVIPSFONTS</code> for Dvipsk. Again, this is for bitmaps, not metrics.
2839
2840 </li></ul>
2841
2842
2843 <hr>
2844 </div>
2845 <div class="section-level-extent" id="File-lookup">
2846 <div class="nav-panel">
2847 <p>
2848 Next: <a href="#Glyph-lookup" accesskey="n" rel="next">Glyph lookup</a>, Previous: <a href="#Supported-file-formats" accesskey="p" rel="prev">Supported file formats</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2849 </div>
2850 <h3 class="section" id="File-lookup-1"><span>6.2 File lookup<a class="copiable-link" href="#File-lookup-1"> &para;</a></span></h3>
2851
2852 <a class="index-entry-id" id="index-file-lookup"></a>
2853 <a class="index-entry-id" id="index-searching-for-files"></a>
2854 <a class="index-entry-id" id="index-TeX-file-lookup"></a>
2855
2856 <p>This section describes how Kpathsea searches for most files (bitmap font
2857 searches are the exception, as described in the next section).
2858 </p>
2859 <p>Here is the search strategy for a file <var class="var">name</var>:
2860 </p>
2861 <ol class="enumerate">
2862 <li> If the file format defines default suffixes, and the suffix of
2863 <var class="var">name</var> name is not already a known suffix for that format, try the
2864 name with each default appended, and use alternative names found in
2865 the fontmaps if necessary. Example: given &lsquo;<samp class="samp">foo.bar</samp>&rsquo;, look for
2866 &lsquo;<samp class="samp">foo.bar.tex</samp>&rsquo;.
2867
2868 </li><li> Search for <var class="var">name</var>, and if necessary for alternative names found in
2869 the fontmaps. Example: given &lsquo;<samp class="samp">foo.bar</samp>&rsquo;, we also look for
2870 &lsquo;<samp class="samp">foo.bar</samp>&rsquo;.
2871
2872 </li><li> If the file format defines a program to invoke to create missing files,
2873 run it (see <a class="pxref" href="#mktex-scripts"><samp class="file">mktex</samp> scripts</a>).
2874 </li></ol>
2875
2876 <a class="index-entry-id" id="index-extensions_002c-filename"></a>
2877 <a class="index-entry-id" id="index-suffixes_002c-filename"></a>
2878 <a class="index-entry-id" id="index-try_005fstd_005fextension_005ffirst"></a>
2879 <p>The order in which we search for &ldquo;suffixed&rdquo; name (item&nbsp;1) or
2880 the &ldquo;as-is&rdquo; name (item&nbsp;2) is controlled by the
2881 <samp class="file">try_std_extension_first</samp> configuration value. The default set
2882 in <samp class="file">texmf.cnf</samp> is true, since common suffixes are already
2883 recognized: &lsquo;<samp class="samp">babel.sty</samp>&rsquo; will only look for &lsquo;<samp class="samp">babel.sty</samp>&rsquo;, not
2884 &lsquo;<samp class="samp">babel.sty.tex</samp>&rsquo;, regardless of this setting.
2885 </p>
2886 <p>When the suffix is unknown (e.g., &lsquo;<samp class="samp">foo.bar</samp>&rsquo;), both names are
2887 always tried; the difference is the order in which they are tried.
2888 </p>
2889 <p><samp class="file">try_std_extension_first</samp> only affects names being looked up
2890 which *already* have an extension. A name without an extension (e.g.,
2891 &lsquo;<samp class="samp">tex story</samp>&rsquo;) will always have an extension added first.
2892 </p>
2893 <a class="index-entry-id" id="index-tex_002dfile_002ec"></a>
2894 <a class="index-entry-id" id="index-kpathsea_005ffind_005ffile"></a>
2895 <p>This algorithm is implemented in the function
2896 <code class="code">kpathsea_find_file</code> in the source file
2897 <samp class="file">kpathsea/tex-file.c</samp>. You can watch it in action with the
2898 debugging options (see <a class="pxref" href="#Debugging">Debugging</a>).
2899 </p>
2900
2901 <hr>
2902 </div>
2903 <div class="section-level-extent" id="Glyph-lookup">
2904 <div class="nav-panel">
2905 <p>
2906 Next: <a href="#Suppressing-warnings" accesskey="n" rel="next">Suppressing warnings</a>, Previous: <a href="#File-lookup" accesskey="p" rel="prev">File lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2907 </div>
2908 <h3 class="section" id="Glyph-lookup-1"><span>6.3 Glyph lookup<a class="copiable-link" href="#Glyph-lookup-1"> &para;</a></span></h3>
2909
2910 <a class="index-entry-id" id="index-glyph-lookup"></a>
2911 <a class="index-entry-id" id="index-searching-for-glyphs"></a>
2912 <a class="index-entry-id" id="index-TeX-glyph-lookup"></a>
2913
2914 <p>This section describes how Kpathsea searches for a bitmap font in GF or
2915 PK format (or either) given a font name (e.g., &lsquo;<samp class="samp">cmr10</samp>&rsquo;) and a
2916 resolution (e.g., 600).
2917 </p>
2918 <p>Here is an outline of the search strategy (details in the sections
2919 below) for a file <var class="var">name</var> at resolution <var class="var">dpi</var>. The search stops
2920 at the first successful lookup.
2921 </p>
2922 <ol class="enumerate">
2923 <li> Look for an existing file <var class="var">name</var>.<var class="var">dpi</var><var class="var">format</var> in the
2924 specified format(s).
2925
2926 </li><li> If <var class="var">name</var> is an alias for a file <var class="var">f</var> in the fontmap
2927 file <samp class="file">texfonts.map</samp>, look for <var class="var">f</var>.<var class="var">dpi</var>.
2928
2929 </li><li> Run an external program (typically named &lsquo;<samp class="samp">mktexpk</samp>&rsquo;) to
2930 generate the font (see <a class="pxref" href="#mktex-scripts"><samp class="file">mktex</samp> scripts</a>)
2931
2932 </li><li> Look for <var class="var">fallback</var>.<var class="var">dpi</var>, where <var class="var">fallback</var> is some
2933 last-resort font (typically &lsquo;<samp class="samp">cmr10</samp>&rsquo;).
2934 </li></ol>
2935
2936 <a class="index-entry-id" id="index-tex_002dglyph_002ec"></a>
2937 <a class="index-entry-id" id="index-kpathsea_005ffind_005fglyph"></a>
2938 <p>This is implemented in <code class="code">kpathsea_find_glyph</code> in
2939 <samp class="file">kpathsea/tex-glyph.c</samp>.
2940 </p>
2941
2942
2943 <ul class="mini-toc">
2944 <li><a href="#Basic-glyph-lookup" accesskey="1">Basic glyph lookup</a></li>
2945 <li><a href="#Fontmap" accesskey="2">Fontmap</a></li>
2946 <li><a href="#Fallback-font" accesskey="3">Fallback font</a></li>
2947 </ul>
2948 <hr>
2949 <div class="subsection-level-extent" id="Basic-glyph-lookup">
2950 <div class="nav-panel">
2951 <p>
2952 Next: <a href="#Fontmap" accesskey="n" rel="next">Fontmap</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2953 </div>
2954 <h4 class="subsection" id="Basic-glyph-lookup-1"><span>6.3.1 Basic glyph lookup<a class="copiable-link" href="#Basic-glyph-lookup-1"> &para;</a></span></h4>
2955
2956 <a class="index-entry-id" id="index-basic-glyph-lookup"></a>
2957 <a class="index-entry-id" id="index-common-features-in-glyph-lookup"></a>
2958
2959 <p>When Kpathsea looks for a bitmap font <var class="var">name</var> at resolution <var class="var">dpi</var>
2960 in a format <var class="var">format</var>, it first checks each directory in the search
2961 path for a file &lsquo;<samp class="samp"><var class="var">name</var>.<var class="var">dpi</var><var class="var">format</var></samp>&rsquo;; for example,
2962 &lsquo;<samp class="samp">cmr10.600pk</samp>&rsquo;. Kpathsea looks for a PK file first, then a GF file.
2963 </p>
2964 <p>If that fails, Kpathsea looks for
2965 &lsquo;<samp class="samp">dpi<var class="var">dpi</var>/<var class="var">name</var>.<var class="var">format</var></samp>&rsquo;; for example,
2966 &lsquo;<samp class="samp">dpi600/cmr10.pk</samp>&rsquo;. This is how fonts are typically stored on
2967 filesystems (such as DOS) that permit only three-character extensions.
2968 </p>
2969 <a class="index-entry-id" id="index-tolerance-for-glyph-lookup"></a>
2970 <a class="index-entry-id" id="index-glyph-lookup-bitmap-tolerance"></a>
2971 <a class="index-entry-id" id="index-KPSE_005fBITMAP_005fTOLERANCE"></a>
2972 <p>If that fails, Kpathsea looks for a font with a close-enough <var class="var">dpi</var>.
2973 &ldquo;Close enough&rdquo; is defined by the macro <code class="code">KPSE_BITMAP_TOLERANCE</code> in
2974 <samp class="file">kpathsea/tex-glyph.h</samp> to be <code class="code"><var class="var">dpi</var> / 500 + 1</code>. This is
2975 slightly more than the 0.2% minimum allowed by the DVI standard
2976 (<a class="url" href="CTAN:/dviware/driv-standard/level-0">CTAN:/dviware/driv-standard/level-0</a>).
2977 </p>
2978
2979 <hr>
2980 </div>
2981 <div class="subsection-level-extent" id="Fontmap">
2982 <div class="nav-panel">
2983 <p>
2984 Next: <a href="#Fallback-font" accesskey="n" rel="next">Fallback font</a>, Previous: <a href="#Basic-glyph-lookup" accesskey="p" rel="prev">Basic glyph lookup</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
2985 </div>
2986 <h4 class="subsection" id="Fontmap-1"><span>6.3.2 Fontmap<a class="copiable-link" href="#Fontmap-1"> &para;</a></span></h4>
2987
2988 <a class="index-entry-id" id="index-fontmap-files"></a>
2989 <a class="index-entry-id" id="index-font-alias-files"></a>
2990 <a class="index-entry-id" id="index-aliases-for-fonts"></a>
2991
2992 <a class="index-entry-id" id="index-texfonts_002emap"></a>
2993 <p>If a bitmap font or metric file is not found with the original name (see
2994 the previous section), Kpathsea looks through any <em class="dfn">fontmap</em> files
2995 for an <em class="dfn">alias</em> for the original font name. These files are named
2996 <samp class="file">texfonts.map</samp> and searched for along the <code class="code">TEXFONTMAPS</code>
2997 environment/config file variable. All <samp class="file">texfonts.map</samp> files that
2998 are found are read; earlier definitions override later ones.
2999 </p>
3000 <p>This feature is intended to help in two respects:
3001 </p>
3002 <ol class="enumerate">
3003 <li> <a class="index-entry-id" id="index-fontnames_002c-arbitrary-length"></a>
3004 An alias name is limited in length only by available memory, not by your
3005 filesystem. Therefore, if you want to ask for &lsquo;<samp class="samp">Times-Roman</samp>&rsquo;
3006 instead of <samp class="file">ptmr</samp>, you can (you get &lsquo;<samp class="samp">ptmr8r</samp>&rsquo;).
3007
3008 </li><li> <a class="index-entry-id" id="index-circle-fonts"></a>
3009 <a class="index-entry-id" id="index-lcircle10"></a>
3010 A few fonts have historically had multiple names: specifically,
3011 LaTeX&rsquo;s &ldquo;circle font&rdquo; has variously been known as <samp class="file">circle10</samp>,
3012 <samp class="file">lcircle10</samp>, and <samp class="file">lcirc10</samp>. Aliases can make all the names
3013 equivalent, so that it no longer matters what the name of the installed
3014 file is; TeX documents will find their favorite name.
3015
3016 </li></ol>
3017
3018 <p>The format of fontmap files:
3019 </p>
3020 <ul class="itemize mark-bullet">
3021 <li><a class="index-entry-id" id="index-comments_002c-in-fontmap-files"></a>
3022 Comments start with the last &lsquo;<samp class="samp">%</samp>&rsquo; on a line and continue to
3023 the end of the line. (This provides for names that include a %,
3024 ill-advised as that may be.)
3025
3026 </li><li><a class="index-entry-id" id="index-whitespace_002c-in-fontmap-files"></a>
3027 Blank lines are ignored.
3028
3029 </li><li>Each nonblank line is broken up into a series of <em class="dfn">words</em>:
3030 a sequence of non-whitespace characters.
3031
3032 </li><li><a class="index-entry-id" id="index-include-fontmap-directive"></a>
3033 If the first word is &lsquo;<samp class="samp">include</samp>&rsquo;, the second word is used as
3034 a filename, and it is searched for and read.
3035
3036 </li><li>Otherwise, the first word on each line is the true filename;
3037
3038 </li><li>the second word is the alias;
3039
3040 </li><li>subsequent words are ignored.
3041 </li></ul>
3042
3043 <p>If an alias has an extension, it matches only those files with that
3044 extension; otherwise, it matches anything with the same root, regardless
3045 of extension. For example, an alias &lsquo;<samp class="samp">foo.tfm</samp>&rsquo; matches only when
3046 <samp class="file">foo.tfm</samp> is being searched for; but an alias &lsquo;<samp class="samp">foo</samp>&rsquo; matches
3047 <samp class="file">foo.vf</samp>, <samp class="file">foo.600pk</samp>, etc.
3048 </p>
3049 <p>As an example, here is an excerpt from the <samp class="file">texfonts.map</samp> in the
3050 Web2c distribution. It makes the old and new names of the LaTeX
3051 circle fonts equivalent.
3052 </p>
3053 <div class="example">
3054 <pre class="example-preformatted">circle10 lcircle10
3055 circle10 lcirc10
3056 lcircle10 circle10
3057 lcircle10 lcirc10
3058 lcirc10 circle10
3059 lcirc10 lcircle10
3060 ...
3061 </pre></div>
3062
3063 <p>Fontmaps are implemented in the file <samp class="file">kpathsea/fontmap.c</samp>.
3064 The Fontname distribution has much more information on font naming
3065 (see <cite class="cite"><a data-manual="fontname" href="fontname.html#Top">Filenames for TeX fonts</a></cite>).
3066 </p>
3067
3068 <hr>
3069 </div>
3070 <div class="subsection-level-extent" id="Fallback-font">
3071 <div class="nav-panel">
3072 <p>
3073 Previous: <a href="#Fontmap" accesskey="p" rel="prev">Fontmap</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3074 </div>
3075 <h4 class="subsection" id="Fallback-font-1"><span>6.3.3 Fallback font<a class="copiable-link" href="#Fallback-font-1"> &para;</a></span></h4>
3076
3077 <a class="index-entry-id" id="index-fallback-font"></a>
3078 <a class="index-entry-id" id="index-fallback-resolutions"></a>
3079 <a class="index-entry-id" id="index-font-of-last-resort"></a>
3080 <a class="index-entry-id" id="index-resolutions_002c-last_002dresort"></a>
3081 <a class="index-entry-id" id="index-last_002dresort-font"></a>
3082
3083 <a class="index-entry-id" id="index-DVIPSSIZES"></a>
3084 <a class="index-entry-id" id="index-XDVISIZES"></a>
3085 <a class="index-entry-id" id="index-DVILJSIZES"></a>
3086 <a class="index-entry-id" id="index-TEXSIZES"></a>
3087 <a class="index-entry-id" id="index-default_005ftexsizes"></a>
3088 <p>If a bitmap font cannot be found or created at the requested size,
3089 Kpathsea looks for the font at a set of <em class="dfn">fallback resolutions</em>. You
3090 specify these resolutions as a colon-separated list (like search paths).
3091 Kpathsea looks first for a program-specific environment variable (e.g.,
3092 <code class="code">DVIPSSIZES</code> for Dvipsk), then the environment variable
3093 <code class="code">TEXSIZES</code>, then a default specified at compilation time (the Make
3094 variable <code class="code">default_texsizes</code>). You can set this list to be empty if
3095 you prefer to find fonts at their stated size or not at all.
3096 </p>
3097 <a class="index-entry-id" id="index-cmr10_002c-as-fallback-font"></a>
3098 <a class="index-entry-id" id="index-kpathsea_005finit_005fprog"></a>
3099 <p>Finally, if the font cannot be found even at the fallback resolutions,
3100 Kpathsea looks for a fallback font, typically <samp class="file">cmr10</samp>. Programs
3101 must enable this feature by calling <code class="code">kpathsea_init_prog</code>
3102 (see <a class="pxref" href="#Calling-sequence">Calling sequence</a>); the default is no fallback font.
3103 </p>
3104
3105 <hr>
3106 </div>
3107 </div>
3108 <div class="section-level-extent" id="Suppressing-warnings">
3109 <div class="nav-panel">
3110 <p>
3111 Next: <a href="#mktex-scripts" accesskey="n" rel="next"><samp class="file">mktex</samp> scripts</a>, Previous: <a href="#Glyph-lookup" accesskey="p" rel="prev">Glyph lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3112 </div>
3113 <h3 class="section" id="Suppressing-warnings-1"><span>6.4 Suppressing warnings<a class="copiable-link" href="#Suppressing-warnings-1"> &para;</a></span></h3>
3114
3115 <a class="index-entry-id" id="index-warnings_002c-suppressing"></a>
3116 <a class="index-entry-id" id="index-suppressing-warnings"></a>
3117
3118 <a class="index-entry-id" id="index-TEX_005fHUSH-1"></a>
3119 <p>Kpathsea provides a way to suppress selected usually-harmless warnings;
3120 this is useful at large sites where most users are not administrators,
3121 and thus the warnings are merely a source of confusion, not a help. To
3122 do this, you set the environment variable or configuration file value
3123 <code class="code">TEX_HUSH</code> to a colon-separated list of values. Here are the
3124 possibilities:
3125 </p>
3126 <dl class="vtable">
3127 <dt><a id="index-all"></a><span>&lsquo;<samp class="samp">all</samp>&rsquo;<a class="copiable-link" href="#index-all"> &para;</a></span></dt>
3128 <dd><p>Suppress everything possible.
3129 </p>
3130 </dd>
3131 <dt><a id="index-checksum"></a><span>&lsquo;<samp class="samp">checksum</samp>&rsquo;<a class="copiable-link" href="#index-checksum"> &para;</a></span></dt>
3132 <dd><a class="index-entry-id" id="index-mismatched-checksum-warnings"></a>
3133 <p>Suppress mismatched font checksum warnings.
3134 </p>
3135 </dd>
3136 <dt><a id="index-lostchar"></a><span>&lsquo;<samp class="samp">lostchar</samp>&rsquo;<a class="copiable-link" href="#index-lostchar"> &para;</a></span></dt>
3137 <dd><a class="index-entry-id" id="index-missing-character-warnings"></a>
3138 <p>Suppress warnings when a character is missing from a font that a DVI or
3139 VF file tries to typeset.
3140 </p>
3141 </dd>
3142 <dt><a id="index-none"></a><span>&lsquo;<samp class="samp">none</samp>&rsquo;<a class="copiable-link" href="#index-none"> &para;</a></span></dt>
3143 <dd><p>Don&rsquo;t suppress any warnings.
3144 </p>
3145 </dd>
3146 <dt><a id="index-readable"></a><span>&lsquo;<samp class="samp">readable</samp>&rsquo;<a class="copiable-link" href="#index-readable"> &para;</a></span></dt>
3147 <dd><a class="index-entry-id" id="index-unreadable-file-warnings"></a>
3148 <p>Suppress warnings about attempts to access a file whose permissions
3149 render it unreadable.
3150 </p>
3151 </dd>
3152 <dt><a id="index-special"></a><span>&lsquo;<samp class="samp">special</samp>&rsquo;<a class="copiable-link" href="#index-special"> &para;</a></span></dt>
3153 <dd><a class="index-entry-id" id="index-unknown-special-warnings"></a>
3154 <a class="index-entry-id" id="index-_005cspecial_002c-suppressing-warnings-about"></a>
3155 <p>Suppresses warnings about an unimplemented or unparsable
3156 &lsquo;<samp class="samp">\special</samp>&rsquo; command.
3157 </p></dd>
3158 </dl>
3159
3160 <p><samp class="file">tex-hush.c</samp> defines the function that checks the
3161 variable value. Each driver implements its own checks where
3162 appropriate.
3163 </p>
3164
3165 <hr>
3166 </div>
3167 <div class="section-level-extent" id="mktex-scripts">
3168 <div class="nav-panel">
3169 <p>
3170 Previous: <a href="#Suppressing-warnings" accesskey="p" rel="prev">Suppressing warnings</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3171 </div>
3172 <h3 class="section" id="mktex-scripts-1"><span>6.5 <samp class="file">mktex</samp> scripts<a class="copiable-link" href="#mktex-scripts-1"> &para;</a></span></h3>
3173
3174 <a class="index-entry-id" id="index-mktex-scripts"></a>
3175 <a class="index-entry-id" id="index-scripts-for-file-creation"></a>
3176
3177 <a class="index-entry-id" id="index-font-set_002c-infinite"></a>
3178 <a class="index-entry-id" id="index-dynamic-creation-of-files"></a>
3179 <a class="index-entry-id" id="index-Sauter-fonts_002c-and-dynamic-source-creation"></a>
3180 <a class="index-entry-id" id="index-EC-fonts_002c-and-dynamic-source-creation"></a>
3181 <p>If Kpathsea cannot otherwise find a file, for some file types it is
3182 configured by default to invoke an external program to create it
3183 dynamically (see <a class="pxref" href="#mktex-configuration"><samp class="file">mktex</samp> configuration</a>). These are collectively
3184 known as <em class="dfn"><code class="code">mktex</code> scripts</em>, since most of them are named
3185 <code class="code">mktex...</code>.
3186 </p>
3187 <p>For example, this is useful for fonts (bitmaps, TFM&rsquo;s, and
3188 arbitrarily-sizable Metafont sources such as the Sauter and EC fonts),
3189 since any given document can use fonts never before referenced.
3190 Building all fonts in advance is therefore impractical, if not
3191 impossible.
3192 </p>
3193 <p>It is also useful for the TeX &lsquo;<samp class="samp">.fmt</samp>&rsquo; (and Metafont
3194 &lsquo;<samp class="samp">.base</samp>&rsquo; and Metapost &lsquo;<samp class="samp">.mem</samp>&rsquo; files, see <a data-manual="Web2c" href="Web2c.html#Memory-dumps">Memory
3195 dumps</a> in <cite class="cite">web2c</cite>), where pre-generating every format consumes a
3196 lot of both time and space.
3197 </p>
3198 <p>The script is passed the name of the file to create and possibly other
3199 arguments, as explained below. It must echo the full pathname of the
3200 file it created (and nothing else) to standard output; it can write
3201 diagnostics to standard error.
3202 </p>
3203
3204
3205 <ul class="mini-toc">
3206 <li><a href="#mktex-configuration" accesskey="1"><samp class="file">mktex</samp> configuration</a></li>
3207 <li><a href="#mktex-script-names" accesskey="2"><samp class="file">mktex</samp> script names</a></li>
3208 <li><a href="#mktex-script-arguments" accesskey="3"><samp class="file">mktex</samp> script arguments</a></li>
3209 </ul>
3210 <hr>
3211 <div class="subsection-level-extent" id="mktex-configuration">
3212 <div class="nav-panel">
3213 <p>
3214 Next: <a href="#mktex-script-names" accesskey="n" rel="next"><samp class="file">mktex</samp> script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp class="file">mktex</samp> scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3215 </div>
3216 <h4 class="subsection" id="mktex-configuration-1"><span>6.5.1 <samp class="file">mktex</samp> configuration<a class="copiable-link" href="#mktex-configuration-1"> &para;</a></span></h4>
3217
3218 <a class="index-entry-id" id="index-mktex-script-configuration"></a>
3219 <a class="index-entry-id" id="index-configuration-of-mktex-scripts"></a>
3220 <a class="index-entry-id" id="index-enabling-mktex-scripts"></a>
3221 <a class="index-entry-id" id="index-disabling-mktex-scripts"></a>
3222
3223 <p>The list of file types and program names that can run an external
3224 program to create missing files is listed in the next section. In the
3225 absence of <code class="code">configure</code> options specifying otherwise, everything
3226 but <samp class="file">mktextex</samp> will be enabled by default. The <code class="code">configure</code>
3227 options to change the defaults are:
3228 </p>
3229 <a class="index-entry-id" id="index-configure-options-for-mktex-scripts"></a>
3230 <a class="index-entry-id" id="index-_002d_002dwithout_002dmktexfmt_002ddefault"></a>
3231 <a class="index-entry-id" id="index-_002d_002dwithout_002dmktexmf_002ddefault"></a>
3232 <a class="index-entry-id" id="index-_002d_002dwithout_002dmktexocp_002ddefault"></a>
3233 <a class="index-entry-id" id="index-_002d_002dwithout_002dmktexofm_002ddefault"></a>
3234 <a class="index-entry-id" id="index-_002d_002dwithout_002dmktexpk_002ddefault"></a>
3235 <a class="index-entry-id" id="index-_002d_002dwithout_002dmktextfm_002ddefault"></a>
3236 <a class="index-entry-id" id="index-_002d_002dwith_002dmktextex_002ddefault"></a>
3237 <div class="example">
3238 <pre class="example-preformatted">--without-mktexfmt-default
3239 --without-mktexmf-default
3240 --without-mktexocp-default
3241 --without-mktexofm-default
3242 --without-mktexpk-default
3243 --without-mktextfm-default
3244 --with-mktextex-default
3245 </pre></div>
3246
3247 <p>The <code class="code">configure</code> setting is overridden if the environment variable
3248 or configuration file value named for the script is set; e.g.,
3249 <samp class="file">MKTEXPK</samp> (see <a class="pxref" href="#mktex-script-arguments"><samp class="file">mktex</samp> script arguments</a>).
3250 </p>
3251 <a class="index-entry-id" id="index-fmtutils_002ecnf"></a>
3252 <p><code class="code">mktexfmt</code> reads a file <samp class="file">fmtutil.cnf</samp>, typically located in
3253 <samp class="file">texmf/web2c/</samp> to glean its configuration information. The rest
3254 of the files and features in this section are primarily intended for
3255 the font generation scripts.
3256 </p>
3257 <a class="index-entry-id" id="index-mktex_002ecnf-1"></a>
3258 <a class="index-entry-id" id="index-mktex_002eopt"></a>
3259 <a class="index-entry-id" id="index-site-overrides-for-mktex_002e_002e_002e"></a>
3260 <p>As distributed, all the scripts source a file
3261 <samp class="file">texmf/web2c/mktex.cnf</samp> if it exists, so you can override various
3262 defaults.
3263 See <samp class="file">mktex.opt</samp>, for instance, which defines the default mode,
3264 resolution, some special directory names, etc. If you prefer not to
3265 change the distributed scripts, you can simply create <samp class="file">mktex.cnf</samp>
3266 with the appropriate definitions (you do not need to create it if you
3267 have nothing to put in it). <samp class="file">mktex.cnf</samp> has no special syntax;
3268 it&rsquo;s an arbitrary Bourne shell script. The distribution contains a
3269 sample <samp class="file">mktex.cnf</samp> for you to copy and modify as you please (it
3270 is not installed anywhere).
3271 </p>
3272 <a class="index-entry-id" id="index-mktex_002eopt-1"></a>
3273 <a class="index-entry-id" id="index-MT_005fFEATURES"></a>
3274 <p>In addition, you can configure a number of features with the
3275 <code class="code">MT_FEATURES</code> variable, which you can define:
3276 </p>
3277 <ul class="itemize mark-bullet">
3278 <li>in <samp class="file">mktex.opt</samp>, as just mentioned;
3279
3280 </li><li>by editing the file <samp class="file">mktex.opt</samp>, either before &lsquo;<samp class="samp">make
3281 install</samp>&rsquo; (in the source hierarchy) or after (in the installed
3282 hierarchy);
3283
3284 </li><li>or in the environment.
3285 </li></ul>
3286
3287 <p>If none of the options below are enabled, <code class="code">mktexpk</code>,
3288 <code class="code">mktextfm</code>, and <code class="code">mktexmf</code> follow the following procedure to
3289 decide where fonts should be installed. Find the tree where the font&rsquo;s
3290 sources are, and test the permissions of the &lsquo;<samp class="samp">fonts</samp>&rsquo; directory of
3291 that tree to determine whether it is writable. If it is, put the files
3292 in the tree in appropriate locations. If it isn&rsquo;t writable, see whether
3293 the tree is a system tree (named in <code class="code">SYSTEXMF</code>). If so, the
3294 <code class="code">VARTEXFONTS</code> tree is used. In all other cases the working
3295 directory is used.
3296 </p>
3297 <p>The &lsquo;<samp class="samp">appendonlydir</samp>&rsquo; option is enabled by default.
3298 </p>
3299 <dl class="vtable">
3300 <dt><a id="index-appendonlydir"></a><span>&lsquo;<samp class="samp">appendonlydir</samp>&rsquo;<a class="copiable-link" href="#index-appendonlydir"> &para;</a></span></dt>
3301 <dd><a class="index-entry-id" id="index-directories_002c-making-append_002donly"></a>
3302 <a class="index-entry-id" id="index-mktexdir"></a>
3303 <p>Tell <code class="code">mktexdir</code> to create directories append-only, i.e., set
3304 their sticky bit (see <a data-manual="coreutils" href="https://www.gnu.org/software/coreutils/manual/coreutils.html#Mode-Structure">Mode Structure</a> in <cite class="cite">GNU Core
3305 Utilities</cite>). This feature is silently ignored on non-Unix platforms
3306 (e.g. Windows/NT and MS-DOS) which don&rsquo;t support similar functionality.
3307 This feature is enabled by default.
3308 </p>
3309 </dd>
3310 <dt><a id="index-dosnames"></a><span>&lsquo;<samp class="samp">dosnames</samp>&rsquo;<a class="copiable-link" href="#index-dosnames"> &para;</a></span></dt>
3311 <dd><a class="index-entry-id" id="index-8_002e3-filenames_002c-using"></a>
3312 <a class="index-entry-id" id="index-DOS-compatible-names"></a>
3313 <a class="index-entry-id" id="index-dpinnn-directories"></a>
3314 <p>Use 8.3 names; e.g., <samp class="file">dpi600/cmr10.pk</samp> instead of
3315 <samp class="file">cmr10.600pk</samp>. Note that this feature only affects filenames that
3316 would otherwise clash with other TeX-related filenames; <samp class="file">mktex</samp>
3317 scripts do nothing about filenames which exceed the 8+3 MS-DOS limits
3318 but remain unique when truncated (by the OS) to these limits, and nether
3319 do the scripts care about possible clashes with files which aren&rsquo;t
3320 related with TeX. For example, <samp class="file">cmr10.600pk</samp> would clash with
3321 <samp class="file">cmr10.600gf</samp> and is therefore changed when &lsquo;<samp class="samp">dosnames</samp>&rsquo; is in
3322 effect, but <samp class="file">mf.pool</samp> and <samp class="file">mp.base</samp> don&rsquo;t clash with any
3323 TeX-related files and are therefore unchanged.
3324 </p>
3325 <p>This feature is turned on by default on MS-DOS. If you do not wish
3326 &lsquo;<samp class="samp">dosnames</samp>&rsquo; to be set on an MS-DOS platform, you need to set the
3327 <code class="code">MT_FEATURES</code> environment variable to a value that doesn&rsquo;t include
3328 &lsquo;<samp class="samp">dosnames</samp>&rsquo;. You can also change the default setting by editing
3329 <samp class="file">mktex.opt</samp>, but only if you use the <samp class="file">mktex</samp> shell scripts;
3330 the emulation programs don&rsquo;t consult <samp class="file">mktex.opt</samp>.
3331 </p>
3332 </dd>
3333 <dt><a id="index-fontmaps-1"></a><span>&lsquo;<samp class="samp">fontmaps</samp>&rsquo;<a class="copiable-link" href="#index-fontmaps-1"> &para;</a></span></dt>
3334 <dd><a class="index-entry-id" id="index-fontmaps"></a>
3335 <a class="index-entry-id" id="index-fontname"></a>
3336 <p>Instead of deriving the location of a font in the destination tree from
3337 the location of the sources, the aliases and directory names from the
3338 Fontname distribution are used. (see <a data-manual="fontname" href="fontname.html#Top">Introduction</a> in <cite class="cite">Fontname</cite>).
3339 </p>
3340 </dd>
3341 <dt><a id="index-nomfdrivers"></a><span>&lsquo;<samp class="samp">nomfdrivers</samp>&rsquo;<a class="copiable-link" href="#index-nomfdrivers"> &para;</a></span></dt>
3342 <dd><a class="index-entry-id" id="index-metafont-driver-files"></a>
3343 <p>Let mktexpk and mktextfm create metafont driver files in a temporary
3344 directory. These will be used for just one metafont run and not
3345 installed permanently.
3346 </p>
3347 </dd>
3348 <dt><a id="index-nomode"></a><span>&lsquo;<samp class="samp">nomode</samp>&rsquo;<a class="copiable-link" href="#index-nomode"> &para;</a></span></dt>
3349 <dd><a class="index-entry-id" id="index-mode-directory_002c-omitting"></a>
3350 <p>Omit the directory level for the mode name; this is fine as long as
3351 you generate fonts for only one mode.
3352 </p>
3353 </dd>
3354 <dt><a id="index-stripsupplier"></a><span>&lsquo;<samp class="samp">stripsupplier</samp>&rsquo;<a class="copiable-link" href="#index-stripsupplier"> &para;</a></span></dt>
3355 <dd><a class="index-entry-id" id="index-supplier-directory_002c-omitting"></a>
3356 <p>Omit the font supplier name directory level.
3357 </p>
3358 </dd>
3359 <dt><a id="index-striptypeface"></a><span>&lsquo;<samp class="samp">striptypeface</samp>&rsquo;<a class="copiable-link" href="#index-striptypeface"> &para;</a></span></dt>
3360 <dd><a class="index-entry-id" id="index-typeface-directory_002c-omitting"></a>
3361 <p>Omit the font typeface name directory level.
3362 </p>
3363 </dd>
3364 <dt><a id="index-strip"></a><span>&lsquo;<samp class="samp">strip</samp>&rsquo;<a class="copiable-link" href="#index-strip"> &para;</a></span></dt>
3365 <dd><a class="index-entry-id" id="index-supplier-directory_002c-omitting-1"></a>
3366 <a class="index-entry-id" id="index-typeface-directory_002c-omitting-1"></a>
3367 <p>Omit the font supplier and typeface name directory levels. This feature
3368 is deprecated in favour of &lsquo;<samp class="samp">stripsupplier</samp>&rsquo; and &lsquo;<samp class="samp">striptypeface</samp>&rsquo;.
3369 </p>
3370 </dd>
3371 <dt><a id="index-varfonts"></a><span>&lsquo;<samp class="samp">varfonts</samp>&rsquo;<a class="copiable-link" href="#index-varfonts"> &para;</a></span></dt>
3372 <dd><a class="index-entry-id" id="index-_002fvar_002ftmp_002ftexfonts"></a>
3373 <a class="index-entry-id" id="index-VARTEXFONTS"></a>
3374 <a class="index-entry-id" id="index-Linux-File-System-Standard"></a>
3375 <p>When this option is enabled, fonts that would otherwise be written in
3376 system texmf tree go to the <code class="code">VARTEXFONTS</code> tree instead. The
3377 default value in <samp class="file">kpathsea/Makefile.in</samp> is
3378 <samp class="file">/var/tmp/texfonts</samp>. The <cite class="cite">Linux File System Standard</cite>
3379 recommends <samp class="file">/var/tex/fonts</samp>.
3380 </p>
3381 <a class="index-entry-id" id="index-USE_005fVARTEXFONTS"></a>
3382 <p>The &lsquo;<samp class="samp">varfonts</samp>&rsquo; setting in <code class="code">MT_FEATURES</code> is overridden by the
3383 <code class="code">USE_VARTEXFONTS</code> environment variable: if set to &lsquo;<samp class="samp">1</samp>&rsquo;, the
3384 feature is enabled, and if set to &lsquo;<samp class="samp">0</samp>&rsquo;, the feature is disabled.
3385 </p>
3386 </dd>
3387 <dt><a id="index-texmfvar"></a><span>&lsquo;<samp class="samp">texmfvar</samp>&rsquo;<a class="copiable-link" href="#index-texmfvar"> &para;</a></span></dt>
3388 <dd><a class="index-entry-id" id="index-TEXMFVAR"></a>
3389 <p>Force generated files that would go into a system tree (as defined by
3390 <code class="code">SYSTEXMF</code>) into <code class="code">TEXMFVAR</code>. Starting with teTeX-3.0, the
3391 variable <code class="code">TEXMFVAR</code> is always set. The &lsquo;<samp class="samp">varfonts</samp>&rsquo; feature takes
3392 precedence if also set.
3393 </p>
3394 <a class="index-entry-id" id="index-USE_005fTEXMFVAR"></a>
3395 <p>The &lsquo;<samp class="samp">texmfvar</samp>&rsquo; setting in <code class="code">MT_FEATURES</code> is overridden by the
3396 <code class="code">USE_TEXMFVAR</code> environment variable: if set to &lsquo;<samp class="samp">1</samp>&rsquo;, the
3397 feature is enabled, and if set to &lsquo;<samp class="samp">0</samp>&rsquo;, the feature is disabled.
3398 </p></dd>
3399 </dl>
3400
3401
3402 <hr>
3403 </div>
3404 <div class="subsection-level-extent" id="mktex-script-names">
3405 <div class="nav-panel">
3406 <p>
3407 Next: <a href="#mktex-script-arguments" accesskey="n" rel="next"><samp class="file">mktex</samp> script arguments</a>, Previous: <a href="#mktex-configuration" accesskey="p" rel="prev"><samp class="file">mktex</samp> configuration</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp class="file">mktex</samp> scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3408 </div>
3409 <h4 class="subsection" id="mktex-script-names-1"><span>6.5.2 <samp class="file">mktex</samp> script names<a class="copiable-link" href="#mktex-script-names-1"> &para;</a></span></h4>
3410
3411 <a class="index-entry-id" id="index-mktex-script-names"></a>
3412 <a class="index-entry-id" id="index-names-for-mktex-scripts"></a>
3413
3414 <p>The following table shows the default name of the script for each
3415 of the file types which support runtime generation.
3416 </p>
3417 <dl class="table">
3418 <dt><a class="index-entry-id" id="index-fmtutil"></a>
3419 <a id="index-mktexfmt"></a><span><samp class="file">mktexfmt</samp><a class="copiable-link" href="#index-mktexfmt"> &para;</a></span></dt>
3420 <dd><p>(&lsquo;<samp class="samp">.fmt</samp>&rsquo;, &lsquo;<samp class="samp">.base</samp>&rsquo;, &lsquo;<samp class="samp">.mem</samp>&rsquo;) TeX/Metafont/MetaPost
3421 formats. This script is also named <code class="command">fmtutil</code>, and reads
3422 <samp class="file">fmtutil.cnf</samp> for configuration information.
3423 </p>
3424 </dd>
3425 <dt><a id="index-mktexmf"></a><span><samp class="file">mktexmf</samp><a class="copiable-link" href="#index-mktexmf"> &para;</a></span></dt>
3426 <dd><p>(&lsquo;<samp class="samp">.mf</samp>&rsquo;) Metafont input files.
3427 </p>
3428 </dd>
3429 <dt><a id="index-mkocp"></a><span><samp class="file">mkocp</samp><a class="copiable-link" href="#index-mkocp"> &para;</a></span></dt>
3430 <dd><p>(&lsquo;<samp class="samp">.ocp</samp>&rsquo;) Omega compiled process files.
3431 </p>
3432 </dd>
3433 <dt><a id="index-mkofm"></a><span><samp class="file">mkofm</samp><a class="copiable-link" href="#index-mkofm"> &para;</a></span></dt>
3434 <dd><p>(&lsquo;<samp class="samp">.ofm</samp>&rsquo;) Omega font metric files.
3435 </p>
3436 </dd>
3437 <dt><a id="index-mktexpk"></a><span><samp class="file">mktexpk</samp><a class="copiable-link" href="#index-mktexpk"> &para;</a></span></dt>
3438 <dd><p>(&lsquo;<samp class="samp">pk</samp>&rsquo;) Glyph fonts.
3439 </p>
3440 </dd>
3441 <dt><a id="index-mktextex"></a><span><samp class="file">mktextex</samp><a class="copiable-link" href="#index-mktextex"> &para;</a></span></dt>
3442 <dd><p>(&lsquo;<samp class="samp">.tex</samp>&rsquo;) TeX input files (disabled by default).
3443 </p>
3444 </dd>
3445 <dt><a id="index-mktextfm"></a><span><samp class="file">mktextfm</samp><a class="copiable-link" href="#index-mktextfm"> &para;</a></span></dt>
3446 <dd><p>(&lsquo;<samp class="samp">.tfm</samp>&rsquo;) TFM files.
3447 </p></dd>
3448 </dl>
3449
3450 <a class="index-entry-id" id="index-DVIPSMAKEPK"></a>
3451 <a class="index-entry-id" id="index-XDVIMAKEPK"></a>
3452 <a class="index-entry-id" id="index-DVILJMAKEPK"></a>
3453 <p>These names can be overridden by an environment variable specific
3454 to the program; for example, <code class="code">DVIPSMAKEPK</code> for Dvipsk.
3455 </p>
3456 <a class="index-entry-id" id="index-missfont_002elog"></a>
3457 <a class="index-entry-id" id="index-failed-mktex_002e_002e_002e-script-invocation"></a>
3458 <p>If a <code class="code">mktex&hellip;</code> script fails, the invocation is appended to a
3459 file <samp class="file">missfont.log</samp> (by default) in the current directory. After
3460 fixing the problem, you can then execute the log file to create the
3461 missing files.
3462 </p>
3463 <a class="index-entry-id" id="index-TEXMF_005fOUTPUT_005fDIRECTORY_002c-and-missfont_002elog"></a>
3464 <a class="index-entry-id" id="index-TEXMFOUTPUT_002c-and-missfont_002elog"></a>
3465 <p>If the environment variable <code class="code">TEXMF_OUTPUT_DIRECTORY</code> is set,
3466 <samp class="file">missfont.log</samp> is first tried to be written there; if it&rsquo;s not
3467 set, the current directory is tried first. If that first write fails
3468 and the environment variable or configuration file value
3469 <code class="code">TEXMFOUTPUT</code> is set, we try to write <samp class="file">missfont.log</samp> there.
3470 Otherwise nothing is written.
3471 </p>
3472 <a class="index-entry-id" id="index-MISSFONT_005fLOG"></a>
3473 <p>The base filename &lsquo;<samp class="samp">missfont.log</samp>&rsquo; is overridden by the
3474 <code class="code">MISSFONT_LOG</code> environment variable or configuration file value.
3475 </p>
3476
3477 <hr>
3478 </div>
3479 <div class="subsection-level-extent" id="mktex-script-arguments">
3480 <div class="nav-panel">
3481 <p>
3482 Previous: <a href="#mktex-script-names" accesskey="p" rel="prev"><samp class="file">mktex</samp> script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp class="file">mktex</samp> scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3483 </div>
3484 <h4 class="subsection" id="mktex-script-arguments-1"><span>6.5.3 <samp class="file">mktex</samp> script arguments<a class="copiable-link" href="#mktex-script-arguments-1"> &para;</a></span></h4>
3485
3486 <a class="index-entry-id" id="index-arguments-to-mktex"></a>
3487
3488 <p>The first argument to a <samp class="file">mktex</samp> script is always the name
3489 of the file to be created.
3490 </p>
3491 <p>In the default <samp class="file">mktexpk</samp> implementation, additional arguments may
3492 also be passed:
3493 </p>
3494 <dl class="table">
3495 <dt>&lsquo;<samp class="samp">--dpi <var class="var">num</var></samp>&rsquo;</dt>
3496 <dd><p>Sets the resolution of the generated font to <var class="var">num</var>.
3497 </p></dd>
3498 <dt>&lsquo;<samp class="samp">--mfmode <var class="var">name</var></samp>&rsquo;</dt>
3499 <dd><p>Sets the Metafont mode to <var class="var">name</var>.
3500 </p></dd>
3501 <dt>&lsquo;<samp class="samp">--bdpi <var class="var">num</var></samp>&rsquo;</dt>
3502 <dd><p>Sets the &ldquo;base dpi&rdquo; for the font. This must match the mode being
3503 used.
3504 </p></dd>
3505 <dt>&lsquo;<samp class="samp">--mag <var class="var">string</var></samp>&rsquo;</dt>
3506 <dd><p>A &ldquo;magstep&rdquo; string suitable for the Metafont <code class="code">mag</code> variable.
3507 This must match the combination of <var class="var">bdpi</var> and <var class="var">dpi</var> being used.
3508 </p></dd>
3509 <dt>&lsquo;<samp class="samp">--destdir <var class="var">string</var></samp>&rsquo;</dt>
3510 <dd><p>A directory name. If the directory is absolute, it is used as-is.
3511 Otherwise, it is appended to the root destination directory set in the
3512 script.
3513 </p></dd>
3514 </dl>
3515
3516
3517 <hr>
3518 </div>
3519 </div>
3520 </div>
3521 <div class="chapter-level-extent" id="Programming">
3522 <div class="nav-panel">
3523 <p>
3524 Next: <a href="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Previous: <a href="#TeX-support" accesskey="p" rel="prev">TeX support</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3525 </div>
3526 <h2 class="chapter" id="Programming-1"><span>7 Programming<a class="copiable-link" href="#Programming-1"> &para;</a></span></h2>
3527
3528 <p>This chapter is for programmers who wish to use Kpathsea.
3529 See <a class="xref" href="#Introduction">Introduction</a>, for the conditions under which you may do so (in
3530 short, it is released under LGPLv2.1 or later).
3531 </p>
3532
3533
3534 <ul class="mini-toc">
3535 <li><a href="#Programming-overview" accesskey="1">Programming overview</a></li>
3536 <li><a href="#Calling-sequence" accesskey="2">Calling sequence</a></li>
3537 <li><a href="#Safe-filenames" accesskey="3">Safe filenames</a></li>
3538 <li><a href="#Program_002dspecific-files" accesskey="4">Program-specific files</a></li>
3539 <li><a href="#Programming-with-config-files" accesskey="5">Programming with config files</a></li>
3540 </ul>
3541 <hr>
3542 <div class="section-level-extent" id="Programming-overview">
3543 <div class="nav-panel">
3544 <p>
3545 Next: <a href="#Calling-sequence" accesskey="n" rel="next">Calling sequence</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3546 </div>
3547 <h3 class="section" id="Programming-overview-1"><span>7.1 Programming overview<a class="copiable-link" href="#Programming-overview-1"> &para;</a></span></h3>
3548
3549 <a class="index-entry-id" id="index-programming-overview"></a>
3550 <a class="index-entry-id" id="index-overview-of-programming-with-Kpathsea"></a>
3551
3552 <p>Aside from this manual, your best source of information is the source
3553 to the programs that use Kpathsea (see <a class="pxref" href="#Introduction">Introduction</a>). First,
3554 Kpsewhich is a small utility program whose sole purpose is to exercise
3555 the main path-searching functionality. Of the drivers, Dviljk is
3556 probably the simplest full application program. Xdvik adds VF support
3557 and the complication of X resources. Dvipsk adds the complication of
3558 its own config files. Web2c is source code I also maintain, so it
3559 uses Kpathsea rather straightforwardly, but is of course complicated
3560 by the Web to C translation.
3561 </p>
3562 <a class="index-entry-id" id="index-re_002dentrant-API"></a>
3563 <a class="index-entry-id" id="index-API_002c-re_002dentrant"></a>
3564 <p>When looking at these program sources, you should know that previous
3565 versions of the library had a different programming interface; the
3566 current interface supports re-entrancy. Historically, the library
3567 function names were prefixed with <code class="code">kpse_</code> instead of
3568 <code class="code">kpathsea_</code>, and they did not need an instance variable as first
3569 argument. This change was made in 2009. The old functions will never
3570 disappear, and can reliably continue to be used when they suffice, as
3571 they do for the programs above. The main application using the
3572 re-entrant API is the MetaPost library used by MetaPost and LuaTeX.
3573 </p>
3574 <a class="index-entry-id" id="index-pathsearch_002eh"></a>
3575 <a class="index-entry-id" id="index-tex_002dfile_002eh"></a>
3576 <a class="index-entry-id" id="index-tex_002dglyph_002eh"></a>
3577 <a class="index-entry-id" id="index-kpathsea_002eh"></a>
3578 <p>Beyond these examples, the <samp class="file">.h</samp> files in the Kpathsea source
3579 describe the interfaces and functionality (and of course the <samp class="file">.c</samp>
3580 files define the actual routines, which are the ultimate documentation).
3581 <samp class="file">pathsearch.h</samp> declares the basic searching routine.
3582 <samp class="file">tex-file.h</samp> and <samp class="file">tex-glyph.h</samp> define the interfaces for
3583 looking up particular kinds of files. In view of the way the headers
3584 depend on each other, it is recommended to use <code class="code">#include
3585 &lt;kpathsea/kpathsea.h&gt;</code>, which includes every Kpathsea header.
3586 </p>
3587 <a class="index-entry-id" id="index-config_002eh"></a>
3588 <a class="index-entry-id" id="index-c_002dauto_002eh"></a>
3589 <p>If you want to include only specific headers, you should still
3590 consider including <samp class="file">kpathsea/config.h</samp> before including any other
3591 Kpathsea header, as it provides symbols used in the other headers;
3592 <samp class="file">kpathsea/config.h</samp> includes <samp class="file">kpathsea/c-auto.h</samp>, which is
3593 generated by Autoconf.
3594 </p>
3595 <a class="index-entry-id" id="index-file-types_002c-registering-new"></a>
3596 <p>The library provides no way for an external program to register new file
3597 types: <samp class="file">tex-file.[ch]</samp> must be modified to do this. For example,
3598 Kpathsea has support for looking up Dvips config files, even though no
3599 program other than Dvips is likely to ever want to do so. I felt this
3600 was acceptable, since along with new file types should also come new
3601 defaults in <samp class="file">texmf.cnf</samp> (and its descendant <samp class="file">paths.h</samp>), since
3602 it&rsquo;s simplest for users if they can modify one configuration file for
3603 all kinds of paths.
3604 </p>
3605 <p>Kpathsea does not parse any formats itself; it barely opens any files.
3606 Its primary purpose is to return filenames. The GNU font utilities
3607 package contains libraries to read TFM, GF, and PK files, as do the
3608 programs above, of course.
3609 </p>
3610
3611 <hr>
3612 </div>
3613 <div class="section-level-extent" id="Calling-sequence">
3614 <div class="nav-panel">
3615 <p>
3616 Next: <a href="#Safe-filenames" accesskey="n" rel="next">Safe filenames</a>, Previous: <a href="#Programming-overview" accesskey="p" rel="prev">Programming overview</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3617 </div>
3618 <h3 class="section" id="Calling-sequence-1"><span>7.2 Calling sequence<a class="copiable-link" href="#Calling-sequence-1"> &para;</a></span></h3>
3619
3620 <a class="index-entry-id" id="index-programming-with-Kpathsea"></a>
3621 <a class="index-entry-id" id="index-calling-sequence"></a>
3622
3623 <p>The typical way to use Kpathsea in your program goes something like this:
3624 </p>
3625 <ol class="enumerate">
3626 <li> <a class="index-entry-id" id="index-kpathsea_005fnew"></a>
3627 Call <code class="code">kpathsea_new</code> to create a new library instance. This variable
3628 must be passed as the first argument to all the following library functions.
3629 The rest of this manual will be using <code class="code">kpse</code> as a placeholder for
3630 the name of this variable.
3631
3632 </li><li> <a class="index-entry-id" id="index-kpathsea_005fset_005fprogram_005fname"></a>
3633 <a class="index-entry-id" id="index-argv_005b0_005d"></a>
3634 Call <code class="code">kpathsea_set_program_name</code> with <code class="code">argv[0]</code> as the second
3635 argument; the third argument is a string or <code class="code">NULL</code>. The third
3636 argument is used by Kpathsea as the program name for the
3637 <code class="code">.<var class="var">program</var></code> feature of config files (see <a class="pxref" href="#Config-files">Config files</a>).
3638 If the third argument is <code class="code">NULL</code>, the value of the second argument
3639 is used. This function must be called before any other use of the
3640 Kpathsea library.
3641
3642 <a class="index-entry-id" id="index-kpse_002d_003einvocation_005fname"></a>
3643 <a class="index-entry-id" id="index-kpse_002d_003einvocation_005fshort_005fname"></a>
3644 <a class="index-entry-id" id="index-kpse_002d_003eprogram_005fname"></a>
3645 <a class="index-entry-id" id="index-error-message-macros"></a>
3646 <p><code class="code">kpathsea_set_program_name</code> always sets the variables
3647 <code class="code">kpse-&gt;invocation_name</code> and <code class="code">kpse-&gt;invocation_short_name</code>.
3648 These variables are used in the error message macros defined in
3649 <samp class="file">kpathsea/lib.h</samp>. It sets the variable
3650 <code class="code">kpse-&gt;program_name</code> to the program name it uses.
3651 </p>
3652 <a class="index-entry-id" id="index-KPATHSEA_005fDEBUG"></a>
3653 <p>It also initializes debugging options based on the environment
3654 variable <code class="code">KPATHSEA_DEBUG</code> (if that is set).
3655 </p>
3656 <a class="index-entry-id" id="index-SELFAUTOLOC"></a>
3657 <a class="index-entry-id" id="index-SELFAUTODIR"></a>
3658 <a class="index-entry-id" id="index-SELFAUTOPARENT"></a>
3659 <a class="index-entry-id" id="index-symlinks_002c-resolving"></a>
3660 <a class="index-entry-id" id="index-expanding-symlinks"></a>
3661 <p>Finally, it sets the environment variables <code class="code">SELFAUTOLOC</code>,
3662 <code class="code">SELFAUTODIR</code> and <code class="code">SELFAUTOPARENT</code> to the location, parent
3663 and grandparent directory of the executable, removing <samp class="file">.</samp> and
3664 <samp class="file">..</samp> path elements and resolving symbolic links. These are used
3665 in the default configuration file to allow people to invoke TeX from
3666 anywhere. You can use &lsquo;<samp class="samp">kpsewhich --expand-var=\$SELFAUTOLOC</samp>&rsquo;,
3667 etc., to see the values.
3668 </p>
3669 </li><li> <a class="index-entry-id" id="index-kpse_002d_003edebug-variable"></a>
3670 <a class="index-entry-id" id="index-debugging-options_002c-in-Kpathsea_002dusing-program"></a>
3671 Set debugging options. See <a class="xref" href="#Debugging">Debugging</a>. If your program doesn&rsquo;t have
3672 a debugging option already, you can define one and set
3673 <code class="code">kpse-&gt;debug</code> to the number that the user supplies (as in Dviljk
3674 and Web2c), or you can just omit this altogether (users can always set
3675 the <code class="code">KPATHSEA_DEBUG</code> environment variable). If you do have
3676 runtime debugging already, you need to merge Kpathsea&rsquo;s options with
3677 yours (as in Dvipsk and Xdvik).
3678
3679 </li><li> <a class="index-entry-id" id="index-client_005fpath-in-kpse_002d_003eformat_005finfo"></a>
3680 <a class="index-entry-id" id="index-kpse_002d_003eformat_005finfo"></a>
3681 <a class="index-entry-id" id="index-resident_002ec"></a>
3682 <a class="index-entry-id" id="index-config-files_002c-for-Kpathsea_002dusing-programs"></a>
3683 If your program has its own configuration files that can define search
3684 paths, you should assign those paths to the <code class="code">client_path</code> member in
3685 the appropriate element of the <code class="code">kpse-&gt;format_info</code> array. (This
3686 array is indexed by file type; see <samp class="file">tex-file.h</samp>.) See
3687 <samp class="file">resident.c</samp> in Dvipsk for an example.
3688
3689 </li><li> <a class="index-entry-id" id="index-kpathsea_005finit_005fprog-1"></a>
3690 <a class="index-entry-id" id="index-proginit_002eh"></a>
3691 Call <code class="code">kpathsea_init_prog</code> (see <samp class="file">proginit.c</samp>). It&rsquo;s useful
3692 for the DVI drivers, at least, but for other programs it may be
3693 simpler to extract the parts of it that actually apply. This does not
3694 initialize any paths, it just looks for (and sets) certain environment
3695 variables and other random information. Search paths are always
3696 initialized at the first call to find a file of a given type, not
3697 requiring an explicit initialization call; this eliminates much
3698 useless work, e.g., initializing the BibTeX search paths in a DVI
3699 driver.
3700
3701 </li><li> <a class="index-entry-id" id="index-kpathsea_005ffind_005ffile-1"></a>
3702 The routine to actually find a file of type <var class="var">format</var> is
3703 <samp class="file">kpathsea_find_file</samp>. You can call
3704 <code class="code">kpathsea_find_file</code> after doing only the first and second of the
3705 initialization steps above&mdash;Kpathsea automatically reads the
3706 <samp class="file">texmf.cnf</samp> generic config files, looks for environment variables,
3707 and does expansions at the first lookup.
3708
3709 </li><li> <a class="index-entry-id" id="index-kpathsea_005ffind_005fglyph-1"></a>
3710 To find PK and/or GF bitmap fonts, the routine
3711 is <code class="code">kpathsea_find_glyph</code>, defined in
3712 <samp class="file">tex-glyph.h</samp>. This returns a structure in addition to the
3713 resultant filename, because fonts can be found in so many ways. See the
3714 documentation in the source.
3715
3716 </li><li> Before opening a file, especially for writing, you should check if the
3717 filename is acceptable. See the next section (see <a class="pxref" href="#Safe-filenames">Safe filenames</a>).
3718
3719 </li><li> <a class="index-entry-id" id="index-kpathsea_005fopen_005ffile"></a>
3720 To actually open a file, not just return a filename, call
3721 <code class="code">kpathsea_open_file</code>. This function takes the name to look up and a
3722 Kpathsea file format as arguments, and returns the usual <code class="code">FILE *</code>.
3723 It always assumes the file must exist, and thus will search the disk if
3724 necessary (unless the search path specified &lsquo;<samp class="samp">!!</samp>&rsquo;, etc.). In other
3725 words, if you are looking up a VF or some other file that need not
3726 exist, don&rsquo;t use this.
3727
3728 </li><li> <a class="index-entry-id" id="index-kpathsea_005ffinish"></a>
3729 To close the Kpathsea library instance you are using, call
3730 <code class="code">kpathsea_finish</code>. This function closes any open log files and
3731 frees the memory used by the instance.
3732
3733 </li></ol>
3734
3735 <a class="index-entry-id" id="index-hash-table-routines"></a>
3736 <a class="index-entry-id" id="index-memory-allocation-routines"></a>
3737 <a class="index-entry-id" id="index-string-routines"></a>
3738 <a class="index-entry-id" id="index-reading-arbitrary_002dlength-lines"></a>
3739 <a class="index-entry-id" id="index-input-lines_002c-reading"></a>
3740 <a class="index-entry-id" id="index-lines_002c-reading-arbitrary_002dlength"></a>
3741 <p>Kpathsea also provides many utility routines. Some are generic: hash
3742 tables, memory allocation, string concatenation and copying, string
3743 lists, reading input lines of arbitrary length, etc. Others are
3744 filename-related: default path, tilde, and variable expansion,
3745 <code class="code">stat</code> calls, etc.
3746 </p>
3747 <a class="index-entry-id" id="index-c_002d_002a_002eh"></a>
3748 <a class="index-entry-id" id="index-autoconf_002c-recommended"></a>
3749 <p>The <samp class="file">c-*.h</samp> header files can also help your program adapt to many
3750 different systems. You will almost certainly want to use Autoconf and
3751 probably Automake for configuring and building your software if you use
3752 Kpathsea; I strongly recommend using Autoconf and Automake regardless.
3753 They are available from <a class="url" href="https://gnu.org/software">https://gnu.org/software</a>.
3754 </p>
3755
3756 <hr>
3757 </div>
3758 <div class="section-level-extent" id="Safe-filenames">
3759 <div class="nav-panel">
3760 <p>
3761 Next: <a href="#Program_002dspecific-files" accesskey="n" rel="next">Program-specific files</a>, Previous: <a href="#Calling-sequence" accesskey="p" rel="prev">Calling sequence</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3762 </div>
3763 <h3 class="section" id="Safe-filenames-1"><span>7.3 Safe filenames<a class="copiable-link" href="#Safe-filenames-1"> &para;</a></span></h3>
3764
3765 <a class="index-entry-id" id="index-openout_005fany"></a>
3766 <a class="anchor" id="openout_005fany"></a><a class="index-entry-id" id="index-trojan-horse"></a>
3767 <p>See <a class="xref" href="#Security">Security</a>, for some general security considerations with the
3768 TeX system.
3769 </p>
3770 <p>In the implementation, the main security feature to disallow writing
3771 to potentially dangerous files is a configuration variable
3772 <code class="code">openout_any</code>. It specifies one of three levels:
3773 </p>
3774 <ul class="itemize mark-bullet">
3775 <li><a class="index-entry-id" id="index-unrestricted-mode_002c-for-output-files"></a>
3776 When set to &lsquo;<samp class="samp">a</samp>&rsquo; (for &ldquo;any&rdquo;), no restrictions are imposed.
3777
3778 </li><li><a class="index-entry-id" id="index-restricted-mode_002c-for-output-files"></a>
3779 When is set to &lsquo;<samp class="samp">r</samp>&rsquo; (for &ldquo;restricted&rdquo;), filenames beginning
3780 with &lsquo;<samp class="samp">.</samp>&rsquo; are disallowed.
3781
3782 </li><li><a class="index-entry-id" id="index-paranoid-mode_002c-for-output-files"></a>
3783 When set to &lsquo;<samp class="samp">p</samp>&rsquo; (for &ldquo;paranoid&rdquo;), additional restrictions are
3784 imposed.
3785
3786 <ol class="enumerate">
3787 <li> <a class="index-entry-id" id="index-TEXMF_005fOUTPUT_005fDIRECTORY_002c-and-paranoid-output-files"></a>
3788 <a class="index-entry-id" id="index-TEXMFOUTPUT_002c-and-paranoid-output-files"></a>
3789 First, an absolute filename must refer to a file in (or in a
3790 subdirectory of) either the <code class="code">TEXMF_OUTPUT_DIRECTORY</code> environment
3791 variable or the <code class="code">TEXMFOUTPUT</code> environment variable or
3792 configuration file setting.
3793
3794 </li><li> <a class="index-entry-id" id="index-TEXMFSYSVAR"></a>
3795 <a class="index-entry-id" id="index-TEXMFVAR-1"></a>
3796 <a class="index-entry-id" id="index-luaotfload"></a>
3797 LuaTeX uses a so-called &ldquo;extended&rdquo; mode, in which the values of
3798 <code class="code">TEXMFVAR</code> and <code class="code">TEXMFSYSVAR</code> are also checked for absolute
3799 filenames. This is done because, in practice, fundamental parts of
3800 the LuaLaTeX system (notably <code class="code">luaotfload</code>) need a cache
3801 directory, and historically the <code class="code">TEXMF[SYS]VAR</code> variables are
3802 what has been used. We neither recommend nor expect any other programs
3803 to need this.
3804
3805 </li><li> Finally, any attempt to go up a directory level is forbidden; that is,
3806 paths may not contain a &lsquo;<samp class="samp">..</samp>&rsquo; component.
3807
3808 </li></ol>
3809 </li></ul>
3810
3811 <p>The paranoid setting is the default. Any program intended to be safely
3812 called from TeX should implement the same measures, one way or
3813 another. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Shell-escapes">Shell escapes</a> in <cite class="cite">Web2c</cite>.
3814 </p>
3815 <p>Kpathsea does not resolve &lsquo;<samp class="samp">..</samp>&rsquo; components, or symbolic links, to
3816 see if the final result is an acceptable directory; they are simply
3817 forbidden. That is, Kpathsea merely considers the value as a string,
3818 not looking on the filesystem at all. (However, if another program
3819 wants to do such resolutions and check the result, that&rsquo;s ok; possibly
3820 preferable.)
3821 </p>
3822 <p>For backwards compatibility, &lsquo;<samp class="samp">y</samp>&rsquo; and &lsquo;<samp class="samp">1</samp>&rsquo; are synonyms of
3823 &lsquo;<samp class="samp">a</samp>&rsquo;, while &lsquo;<samp class="samp">n</samp>&rsquo; and &lsquo;<samp class="samp">0</samp>&rsquo; are synonyms for &lsquo;<samp class="samp">r</samp>&rsquo;.
3824 </p>
3825 <a class="index-entry-id" id="index-kpathsea_005fout_005fname_005fok"></a>
3826 <p>The function <code class="code">kpathsea_out_name_ok</code>, with a filename as second
3827 argument, returns <code class="code">true</code> if that filename is acceptable to be
3828 opened for output or <code class="code">false</code> otherwise. The Kpsewhich program
3829 has an option (&lsquo;<samp class="samp">--safe-out-name</samp>&rsquo;) providing a command line
3830 interface for the check.
3831 </p>
3832 <a class="index-entry-id" id="index-kpathsea_005fout_005fname_005fok_005fextended"></a>
3833 <p>For LuaTeX&rsquo;s extended mode, the function is
3834 <code class="code">kpathsea_out_name_ok_extended</code>, and the Kpsewhich option is
3835 &lsquo;<samp class="samp">--safe-extended-out-name</samp>&rsquo;.
3836 </p>
3837 <a class="index-entry-id" id="index-kpathsea_005fin_005fname_005fok"></a>
3838 <a class="index-entry-id" id="index-kpathsea_005fin_005fname_005fok_005fextended"></a>
3839 <a class="index-entry-id" id="index-openin_005fany"></a>
3840 <p>Although the analogous functions <code class="code">kpathsea_in_name_ok</code> (resp.
3841 <code class="code">_extended</code>, as well as the others below, exist to check a
3842 filename being acceptable for reading, as of 2026, they always return
3843 true without checking anything. This is because no other value was
3844 useful (or used) in practice. More comments about this are in the
3845 default <samp class="file">texmf.cnf</samp>, at <code class="code">openin_any</code> (which variable is
3846 defined, but is now ignored).
3847 </p>
3848 <p>The functions above write a message to standard error if the usage is
3849 forbidden (so every caller does not have to do so). Each function has
3850 a <code class="code">_silent</code> counterpart which does not write the message; this is
3851 what Kpsewhich calls, since messages would be counterproductive in
3852 that case. Thus:
3853 </p>
3854 <a class="index-entry-id" id="index-kpathsea_005fout_005fname_005fok_005fsilent"></a>
3855 <a class="index-entry-id" id="index-kpathsea_005fout_005fname_005fok_005fsilent_005fextended"></a>
3856 <a class="index-entry-id" id="index-kpathsea_005fin_005fname_005fok_005fsilent"></a>
3857 <a class="index-entry-id" id="index-kpathsea_005fin_005fname_005fok_005fsilent_005fextended"></a>
3858
3859 <div class="example">
3860 <pre class="example-preformatted">kpathsea_out_name_ok_silent
3861 kpathsea_out_name_ok_silent_extended
3862 kpathsea_in_name_ok_silent
3863 kpathsea_in_name_ok_silent_extended
3864 </pre></div>
3865
3866 <p>Furthermore, there are <code class="code">kpse_...</code> versions of all the above
3867 functions (as usual), with the default library instance implicitly
3868 passed as the first argument. LuaTeX provides both <code class="code">kpse.*</code>
3869 and <code class="code">kpathsea.*</code> bindings, so it&rsquo;s good to always have both.
3870 </p>
3871 <p>Sorry for the combinatorial explosion, but we hope no further options
3872 will ever be needed. If so, we&rsquo;ll likely provide a more generic
3873 interface as well as the above.
3874 </p>
3875
3876 <hr>
3877 </div>
3878 <div class="section-level-extent" id="Program_002dspecific-files">
3879 <div class="nav-panel">
3880 <p>
3881 Next: <a href="#Programming-with-config-files" accesskey="n" rel="next">Programming with config files</a>, Previous: <a href="#Safe-filenames" accesskey="p" rel="prev">Safe filenames</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3882 </div>
3883 <h3 class="section" id="Program_002dspecific-files-1"><span>7.4 Program-specific files<a class="copiable-link" href="#Program_002dspecific-files-1"> &para;</a></span></h3>
3884
3885 <p>Many programs will need to find some configuration files. Kpathsea
3886 contains some support to make it easy to place them in their own
3887 directories. The Standard TeX directory structure (see <a data-manual="tds" href="tds.html#Top">Introduction</a> in <cite class="cite">A Directory Structure for TeX files</cite>), specifies
3888 that such files should go into a subdirectory named after the program,
3889 like &lsquo;<samp class="samp">texmf/ttf2pk</samp>&rsquo;.
3890 </p>
3891 <p>Two formats, &lsquo;<samp class="samp">kpse_program_text_format</samp>&rsquo; and
3892 &lsquo;<samp class="samp">kpse_program_binary_format</samp>&rsquo;, use <code class="code">.:$TEXMF/<var class="var">program</var>//</code>
3893 as their compiled-in search path. To override this default, you can
3894 use the variable <code class="code"><var class="var">PROGRAM</var>INPUTS</code> in the environment and/or
3895 &lsquo;<samp class="samp">texmf.cnf</samp>&rsquo;. That is to say, the name of the variable is
3896 constructed by converting the name of the program to upper case, and
3897 appending <code class="code">INPUTS</code>.
3898 </p>
3899 <p>The only difference between these two formats is whether
3900 <code class="code">kpathsea_open_file</code> will open the files it finds in text or binary
3901 mode.
3902 </p>
3903
3904 <hr>
3905 </div>
3906 <div class="section-level-extent" id="Programming-with-config-files">
3907 <div class="nav-panel">
3908 <p>
3909 Previous: <a href="#Program_002dspecific-files" accesskey="p" rel="prev">Program-specific files</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3910 </div>
3911 <h3 class="section" id="Programming-with-config-files-1"><span>7.5 Programming with config files<a class="copiable-link" href="#Programming-with-config-files-1"> &para;</a></span></h3>
3912
3913 <a class="index-entry-id" id="index-programming-with-config-files"></a>
3914 <a class="index-entry-id" id="index-config-files_002c-programming-with"></a>
3915
3916 <p>You can (and probably should) use the same <code class="code">texmf.cnf</code>
3917 configuration file that Kpathsea uses for your program. This helps
3918 installers by keeping all configuration in one place.
3919 </p>
3920 <a class="index-entry-id" id="index-kpathsea_005fvar_005fvalue"></a>
3921 <a class="index-entry-id" id="index-variable_002eh"></a>
3922 <a class="index-entry-id" id="index-shell_005fescape_002c-example-for-code"></a>
3923 <p>To retrieve a value for a configuration variable <var class="var">var</var>, the best
3924 way is to call <code class="code">kpathsea_var_value</code> on the string
3925 <code class="code"><var class="var">var</var></code>. This will look first for an environment variable
3926 <var class="var">var</var>, then a config file value. The result will be the value
3927 found or &lsquo;<samp class="samp">NULL</samp>&rsquo;. This function is declared in
3928 <samp class="file">kpathsea/variable.h</samp>. For an example, see the
3929 <code class="code">shell_escape</code> code in <samp class="file">web2c/lib/texmfmp.c</samp>.
3930 </p>
3931 <p>The routine to do full variable and tilde expansion of an arbitrary
3932 string in the context of a search path (as opposed to simply
3933 retrieving a value) is <code class="code">kpathsea_var_expand</code>, also declared in
3934 <samp class="file">kpathsea/variable.h</samp>. However, it&rsquo;s generally only necessary to
3935 set the search path structure components as explained in the previous
3936 section instead of using this directly. Because of its usage with any
3937 input string, undefined <code class="code">$FOO</code> constructs in the argument to
3938 <code class="code">kpathsea_var_expand</code> are returned literally (<code class="code">&quot;$FOO&quot;</code>),
3939 while undefined <code class="code">${FOO}</code> constructs are expanded to the empty
3940 string.
3941 </p>
3942 <a class="index-entry-id" id="index-kpathsea_005fcnf_005fget"></a>
3943 <a class="index-entry-id" id="index-cnf_002eh"></a>
3944 <p>If for some reason you want to retrieve a value <em class="emph">only</em> from a
3945 config file, not automatically looking for a corresponding environment
3946 variable, call <code class="code">kpathsea_cnf_get</code> (declared in <samp class="file">kpathsea/cnf.h</samp>)
3947 with the string <var class="var">var</var>.
3948 </p>
3949 <p>No initialization calls are needed.
3950 </p>
3951
3952 <hr>
3953 </div>
3954 </div>
3955 <div class="chapter-level-extent" id="Reporting-bugs">
3956 <div class="nav-panel">
3957 <p>
3958 Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Programming" accesskey="p" rel="prev">Programming</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3959 </div>
3960 <h2 class="chapter" id="Reporting-bugs-1"><span>8 Reporting bugs<a class="copiable-link" href="#Reporting-bugs-1"> &para;</a></span></h2>
3961
3962 <a class="index-entry-id" id="index-reporting-bugs"></a>
3963 <a class="index-entry-id" id="index-bugs_002c-reporting"></a>
3964
3965 <a class="index-entry-id" id="index-tex_002dk_0040tug_002eorg-_0028bug-address_0029"></a>
3966 <a class="index-entry-id" id="index-bug-address"></a>
3967 <p>If you have problems or suggestions, please report them to
3968 <a class="email" href="mailto:[email protected]">[email protected]</a> using the bug checklist below.
3969 </p>
3970 <p>Please report bugs in the documentation; not only factual errors or
3971 inconsistent behavior, but unclear or incomplete explanations, typos,
3972 wrong fonts, &hellip;
3973 </p>
3974
3975
3976 <ul class="mini-toc">
3977 <li><a href="#Bug-checklist" accesskey="1">Bug checklist</a></li>
3978 <li><a href="#Mailing-lists" accesskey="2">Mailing lists</a></li>
3979 <li><a href="#Debugging" accesskey="3">Debugging</a></li>
3980 <li><a href="#Logging" accesskey="4">Logging</a></li>
3981 <li><a href="#Common-problems" accesskey="5">Common problems</a></li>
3982 </ul>
3983 <hr>
3984 <div class="section-level-extent" id="Bug-checklist">
3985 <div class="nav-panel">
3986 <p>
3987 Next: <a href="#Mailing-lists" accesskey="n" rel="next">Mailing lists</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
3988 </div>
3989 <h3 class="section" id="Bug-checklist-1"><span>8.1 Bug checklist<a class="copiable-link" href="#Bug-checklist-1"> &para;</a></span></h3>
3990
3991 <a class="index-entry-id" id="index-checklist-for-bug-reports"></a>
3992 <a class="index-entry-id" id="index-bug-checklist"></a>
3993
3994 <p>Before reporting a bug, please check below to be sure it isn&rsquo;t already
3995 known (see <a class="pxref" href="#Common-problems">Common problems</a>).
3996 </p>
3997 <p>Bug reports should be sent via electronic mail to
3998 <a class="email" href="mailto:[email protected]">[email protected]</a>.
3999 </p>
4000 <p>The general principle is that a good bug report includes all the
4001 information necessary for reproduction. Therefore, to enable
4002 investigation, your report should include the following:
4003 </p>
4004 <ul class="itemize mark-bullet">
4005 <li><a class="index-entry-id" id="index-version-numbers_002c-determining"></a>
4006 The version number(s) of the program(s) involved, and of Kpathsea
4007 itself. You can get the former by giving a sole option &lsquo;<samp class="samp">--version</samp>&rsquo;
4008 to the program, and the latter by running &lsquo;<samp class="samp">kpsewhich --version</samp>&rsquo;.
4009 The <samp class="file">NEWS</samp> and <samp class="file">ChangeLog</samp> files also contain the version
4010 number.
4011
4012 </li><li><a class="index-entry-id" id="index-uname"></a>
4013 The hardware, operating system (including version), compiler, and
4014 <code class="code">make</code> program you are using (the output of <code class="code">uname -a</code> is a
4015 start on the first two, though incomplete).
4016
4017 </li><li><a class="index-entry-id" id="index-config_002elog"></a>
4018 Any options you gave to <code class="code">configure</code>. This is recorded in the
4019 <samp class="file">config.status</samp> files.
4020
4021 <a class="index-entry-id" id="index-configuration-bugs"></a>
4022 <a class="index-entry-id" id="index-config_002estatus"></a>
4023 <p>If you are reporting a bug in &lsquo;<samp class="samp">configure</samp>&rsquo; itself, it&rsquo;s probably
4024 system-dependent, and it will be unlikely the maintainers can do
4025 anything useful if you merely report that thus-and-such is broken.
4026 Therefore, you need to do some additional work: for some bugs, you can
4027 look in the file <samp class="file">config.log</samp> where the test that failed should
4028 appear, along with the compiler invocation and source program in
4029 question. You can then compile it yourself by hand, and discover why
4030 the test failed. Other &lsquo;<samp class="samp">configure</samp>&rsquo; bugs do not involve the
4031 compiler; in that case, the only recourse is to inspect the
4032 <code class="code">configure</code> shell script itself, or the Autoconf macros that
4033 generated <code class="code">configure</code>.
4034 </p>
4035 </li><li>The log of all debugging output, if the bug is in path searching. You
4036 can get this by setting the environment variable <code class="code">KPATHSEA_DEBUG</code>
4037 to &lsquo;<samp class="samp">-1</samp>&rsquo; before running the program. Please look at the log
4038 yourself to make sure the behavior is really a bug before reporting it;
4039 perhaps &ldquo;old&rdquo; environment variable settings are causing files not to
4040 be found, for example.
4041
4042 </li><li>The contents of any input files necessary to reproduce the bug. For
4043 bugs in DVI-reading programs, for example, this generally means a DVI
4044 file (and any EPS or other files it uses)&mdash;TeX source files are
4045 helpful, but the DVI file is required, because that&rsquo;s the actual
4046 program input.
4047
4048 </li><li><a class="index-entry-id" id="index-context-diff"></a>
4049 <a class="index-entry-id" id="index-sending-patches"></a>
4050 <a class="index-entry-id" id="index-ChangeLog-entry"></a>
4051 If you are sending a patch (do so if you can!), please do so in the form
4052 of a context diff (&lsquo;<samp class="samp">diff -c</samp>&rsquo;) against the original distribution
4053 source. Any other form of diff is either not as complete or harder for
4054 me to understand. Please also include a <samp class="file">ChangeLog</samp> entry.
4055
4056 </li><li><a class="index-entry-id" id="index-stack-trace"></a>
4057 <a class="index-entry-id" id="index-debugger"></a>
4058 <a class="index-entry-id" id="index-crashes_002c-reporting"></a>
4059 <a class="index-entry-id" id="index-core-dumps_002c-reporting"></a>
4060 <a class="index-entry-id" id="index-null-pointers_002c-dereferencing"></a>
4061 <a class="index-entry-id" id="index-gdb_002c-recommended"></a>
4062 If the bug involved is an actual crash (i.e., core dump), it is easy
4063 and useful to include a stack trace from a debugger (I recommend the
4064 GNU debugger GDB (<a class="url" href="https://gnu.org/software/gdb">https://gnu.org/software/gdb</a>). If the
4065 cause is apparent (a <code class="code">NULL</code> value being dereferenced, for
4066 example), please send the details along. If the program involved is
4067 TeX or Metafont, and the crash is happening at apparently-sound
4068 code, however, the bug may well be in the compiler, rather than in the
4069 program or the library (see <a class="pxref" href="#TeX-or-Metafont-failing">TeX or
4070 Metafont failing</a>).
4071
4072 </li><li>Any additional information that will be helpful in reproducing,
4073 diagnosing, or fixing the bug.
4074 </li></ul>
4075
4076
4077 <hr>
4078 </div>
4079 <div class="section-level-extent" id="Mailing-lists">
4080 <div class="nav-panel">
4081 <p>
4082 Next: <a href="#Debugging" accesskey="n" rel="next">Debugging</a>, Previous: <a href="#Bug-checklist" accesskey="p" rel="prev">Bug checklist</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4083 </div>
4084 <h3 class="section" id="Mailing-lists-1"><span>8.2 Mailing lists<a class="copiable-link" href="#Mailing-lists-1"> &para;</a></span></h3>
4085
4086 <a class="index-entry-id" id="index-mailing-lists"></a>
4087 <a class="index-entry-id" id="index-bug-mailing-list"></a>
4088 <a class="index-entry-id" id="index-announcement-mailing-list"></a>
4089
4090 <a class="index-entry-id" id="index-tex_002dk_0040tug_002eorg"></a>
4091 <p>Web2c and Kpathsea in general are discussed on the mailing list
4092 <a class="email" href="mailto:[email protected]">[email protected]</a>. You can subscribe and peruse the archives on
4093 the web <a class="url" href="https://lists.tug.org/tex-k">https://lists.tug.org/tex-k</a>.
4094 </p>
4095 <p>You do not need to join to submit a report, nor will it affect whether
4096 you get a response. Be aware that large data files are sometimes
4097 included in bug reports. If this is a problem for you, do not join
4098 the list.
4099 </p>
4100 <p>If you are looking for general TeX help, such as how to install a
4101 full TeX system or how to use LaTeX, please see
4102 <a class="url" href="https://tug.org/begin.html">https://tug.org/begin.html</a>.
4103 </p>
4104
4105 <hr>
4106 </div>
4107 <div class="section-level-extent" id="Debugging">
4108 <div class="nav-panel">
4109 <p>
4110 Next: <a href="#Logging" accesskey="n" rel="next">Logging</a>, Previous: <a href="#Mailing-lists" accesskey="p" rel="prev">Mailing lists</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4111 </div>
4112 <h3 class="section" id="Debugging-1"><span>8.3 Debugging<a class="copiable-link" href="#Debugging-1"> &para;</a></span></h3>
4113
4114 <a class="index-entry-id" id="index-debugging"></a>
4115 <a class="index-entry-id" id="index-runtime-debugging"></a>
4116 <a class="index-entry-id" id="index-options-for-debugging"></a>
4117
4118 <a class="index-entry-id" id="index-kpse_002d_003edebug"></a>
4119 <a class="index-entry-id" id="index-debug_002eh"></a>
4120 <p>Kpathsea provides a number of runtime debugging options, detailed below
4121 by their names and corresponding numeric values. When the files you
4122 expect aren&rsquo;t being found, the thing to do is enable these options and
4123 examine the output.
4124 </p>
4125 <p>You can set these with some runtime argument (e.g., &lsquo;<samp class="samp">-d</samp>&rsquo;) to the
4126 program; in that case, you should use the numeric values described in
4127 the program&rsquo;s documentation (which, for Dvipsk and Xdvik, are different
4128 than those below). It&rsquo;s best to give the &lsquo;<samp class="samp">-d</samp>&rsquo; (or whatever) option
4129 first, for maximal output. Dvipsk and Xdvik have additional
4130 program-specific debugging options as well.
4131 </p>
4132 <a class="index-entry-id" id="index-KPATHSEA_005fDEBUG-1"></a>
4133 <a class="index-entry-id" id="index-kpse_002d_003edebug-1"></a>
4134 <p>You can also set the environment variable <code class="code">KPATHSEA_DEBUG</code>; in this
4135 case, you should use the numbers below. If you run the program under a
4136 debugger and set the instance variable <code class="code">kpse-&gt;debug</code>, also use the numbers
4137 below.
4138 </p>
4139 <a class="index-entry-id" id="index-_002d1-debugging-value"></a>
4140 <p>In any case, by far the simplest value to use is &lsquo;<samp class="samp">-1</samp>&rsquo;, which will
4141 turn on all debugging output. This is usually better than guessing
4142 which particular values will yield the output you need.
4143 </p>
4144 <a class="index-entry-id" id="index-debugging-output"></a>
4145 <a class="index-entry-id" id="index-standard-error-and-debugging-output"></a>
4146 <p>Debugging output always goes to standard error, so you can redirect it
4147 easily. For example, in Bourne-compatible shells:
4148 </p><div class="example">
4149 <pre class="example-preformatted">dvips -d -1 ... 2&gt;/tmp/debug
4150 </pre></div>
4151
4152 <a class="index-entry-id" id="index-Kpsewhich_002c-and-debugging"></a>
4153 <p>It is sometimes helpful to run the standalone Kpsewhich utility
4154 (see <a class="pxref" href="#Invoking-kpsewhich"><code class="code">kpsewhich</code>: Standalone path searching</a>), instead of the original program.
4155 </p>
4156 <a class="index-entry-id" id="index-numeric-debugging-values"></a>
4157 <p>In any case, you cannot use the names below; you must always use
4158 somebody&rsquo;s numbers. (Sorry.) To set more than one option, just sum
4159 the corresponding numbers.
4160 </p>
4161 <dl class="vtable">
4162 <dt><a id="index-KPSE_005fDEBUG_005fSTAT-_00281_0029"></a><span><code class="code">KPSE_DEBUG_STAT <span class="r">(1)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fSTAT-_00281_0029"> &para;</a></span></dt>
4163 <dd><p>Report &lsquo;<samp class="samp">stat</samp>&rsquo;(2) calls. This is useful for verifying that your
4164 directory structure is not forcing Kpathsea to do many additional file
4165 tests (see <a class="pxref" href="#Slow-path-searching">Slow path searching</a>, and see <a class="pxref" href="#Subdirectory-expansion">Subdirectory expansion</a>). If you are using an up-to-date <samp class="file">ls-R</samp> database
4166 (see <a class="pxref" href="#Filename-database">Filename database (<code class="code">ls-R</code>)</a>), this should produce no output unless a
4167 nonexistent file that must exist is searched for.
4168 </p>
4169 </dd>
4170 <dt><a id="index-KPSE_005fDEBUG_005fHASH-_00282_0029"></a><span><code class="code">KPSE_DEBUG_HASH <span class="r">(2)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fHASH-_00282_0029"> &para;</a></span></dt>
4171 <dd><p>Report lookups in all hash tables: <samp class="file">ls-R</samp> and <samp class="file">aliases</samp>
4172 (see <a class="pxref" href="#Filename-database">Filename database (<code class="code">ls-R</code>)</a>); font aliases (see <a class="pxref" href="#Fontmap">Fontmap</a>); and config
4173 file values (see <a class="pxref" href="#Config-files">Config files</a>). Useful when expected values are not
4174 being found, e.g.., file searches are looking at the disk instead of
4175 using <samp class="file">ls-R</samp>.
4176 </p>
4177 </dd>
4178 <dt><a id="index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"></a><span><code class="code">KPSE_DEBUG_FOPEN <span class="r">(4)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"> &para;</a></span></dt>
4179 <dd><a class="index-entry-id" id="index-fopen_002c-redefined"></a>
4180 <p>Report file openings and closings. Especially useful when your system&rsquo;s
4181 file table is full, for seeing which files have been opened but never
4182 closed. In case you want to set breakpoints in a debugger: this works by
4183 redefining &lsquo;<samp class="samp">fopen</samp>&rsquo; (&lsquo;<samp class="samp">fclose</samp>&rsquo;) to be &lsquo;<samp class="samp">kpse_fopen_trace</samp>&rsquo;
4184 (&lsquo;<samp class="samp">kpse_fclose_trace</samp>&rsquo;).
4185 </p>
4186 </dd>
4187 <dt><a id="index-KPSE_005fDEBUG_005fPATHS-_00288_0029"></a><span><code class="code">KPSE_DEBUG_PATHS <span class="r">(8)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fPATHS-_00288_0029"> &para;</a></span></dt>
4188 <dd><a class="index-entry-id" id="index-kpse_005fformat_005finfo_005ftype"></a>
4189 <p>Report general path information for each file type Kpathsea is asked to
4190 search. This is useful when you are trying to track down how a
4191 particular path got defined&mdash;from <samp class="file">texmf.cnf</samp>, <samp class="file">config.ps</samp>,
4192 an environment variable, the compile-time default, etc. This is the
4193 contents of the <code class="code">kpse_format_info_type</code> structure defined in
4194 <samp class="file">tex-file.h</samp>.
4195 </p>
4196 </dd>
4197 <dt><a id="index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"></a><span><code class="code">KPSE_DEBUG_EXPAND <span class="r">(16)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"> &para;</a></span></dt>
4198 <dd><p>Report the directory list corresponding to each path element Kpathsea
4199 searches. This is only relevant when Kpathsea searches the disk, since
4200 <samp class="file">ls-R</samp> searches don&rsquo;t look through directory lists in this way.
4201 </p>
4202 </dd>
4203 <dt><a id="index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"></a><span><code class="code">KPSE_DEBUG_SEARCH <span class="r">(32)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"> &para;</a></span></dt>
4204 <dd><p>Report on each file search: the name of the file searched for, the path
4205 searched in, whether or not the file must exist (when drivers search for
4206 <samp class="file">cmr10.vf</samp>, it need not exist), and whether or not we are
4207 collecting all occurrences of the file in the path (as with, e.g.,
4208 <samp class="file">texmf.cnf</samp> and <samp class="file">texfonts.map</samp>), or just the first (as with
4209 most lookups). This can help you correlate what Kpathsea is doing with
4210 what is in your input file.
4211 </p>
4212 </dd>
4213 <dt><a id="index-KPSE_005fDEBUG_005fVARS-_002864_0029"></a><span><code class="code">KPSE_DEBUG_VARS <span class="r">(64)</span></code><a class="copiable-link" href="#index-KPSE_005fDEBUG_005fVARS-_002864_0029"> &para;</a></span></dt>
4214 <dd><p>Report the value of each variable Kpathsea looks up. This is useful for
4215 verifying that variables do indeed obtain their correct values.
4216 </p>
4217 </dd>
4218 <dt><a id="index-GSFTOPK_005fDEBUG-_0028128_0029"></a><span><code class="code">GSFTOPK_DEBUG <span class="r">(128)</span></code><a class="copiable-link" href="#index-GSFTOPK_005fDEBUG-_0028128_0029"> &para;</a></span></dt>
4219 <dd><p>Activates debugging printout specific to <code class="code">gsftopk</code> program.
4220 </p>
4221 </dd>
4222 <dt><a id="index-MAKETEX_005fDEBUG-_0028512_0029"></a><span><code class="code">MAKETEX_DEBUG <span class="r">(512)</span></code><a class="copiable-link" href="#index-MAKETEX_005fDEBUG-_0028512_0029"> &para;</a></span></dt>
4223 <dd><p>If you use the optional <code class="code">mktex</code> programs instead of the
4224 traditional shell scripts, this will report the name of the site file
4225 (<samp class="file">mktex.cnf</samp> by default) which is read, directories created by
4226 <code class="code">mktexdir</code>, the full path of the <samp class="file">ls-R</samp> database built by
4227 <code class="code">mktexlsr</code>, font map searches, <code class="code">MT_FEATURES</code> in effect,
4228 parameters from <code class="code">mktexnam</code>, filenames added by
4229 <code class="code">mktexupd</code>, and some subsidiary commands run by the programs.
4230 </p>
4231 </dd>
4232 <dt><a id="index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"></a><span><code class="code">MAKETEX_FINE_DEBUG <span class="r">(1024)</span></code><a class="copiable-link" href="#index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"> &para;</a></span></dt>
4233 <dd><p>When the optional <code class="code">mktex</code> programs are used, this will print
4234 additional debugging info from functions internal to these programs.
4235 </p></dd>
4236 </dl>
4237
4238 <a class="index-entry-id" id="index-kdebug_003a"></a>
4239 <a class="index-entry-id" id="index-hash_005fsummary_005fonly-variable-for-debugging"></a>
4240 <a class="index-entry-id" id="index-hash-table-buckets_002c-printing"></a>
4241 <p>Debugging output from Kpathsea is always written to standard error, and
4242 begins with the string &lsquo;<samp class="samp">kdebug:</samp>&rsquo;. (Except for hash table buckets,
4243 which just start with the number, but you can only get that output
4244 running under a debugger. See comments at the <code class="code">hash_summary_only</code>
4245 variable in <samp class="file">kpathsea/db.c</samp>.)
4246 </p>
4247
4248 <hr>
4249 </div>
4250 <div class="section-level-extent" id="Logging">
4251 <div class="nav-panel">
4252 <p>
4253 Next: <a href="#Common-problems" accesskey="n" rel="next">Common problems</a>, Previous: <a href="#Debugging" accesskey="p" rel="prev">Debugging</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4254 </div>
4255 <h3 class="section" id="Logging-1"><span>8.4 Logging<a class="copiable-link" href="#Logging-1"> &para;</a></span></h3>
4256
4257 <a class="index-entry-id" id="index-log-file"></a>
4258
4259 <a class="index-entry-id" id="index-logging-successful-searches"></a>
4260 <a class="index-entry-id" id="index-recording-successful-searches"></a>
4261 <a class="index-entry-id" id="index-usage-patterns_002c-finding"></a>
4262 <a class="index-entry-id" id="index-disk-usage_002c-reducing"></a>
4263 <p>Kpathsea can record the time and filename found for each successful
4264 search. This may be useful in finding good candidates for deletion when
4265 your filesystem is full, or in discovering usage patterns
4266 at your site.
4267 </p>
4268 <a class="index-entry-id" id="index-TEXMFLOG"></a>
4269 <p>To do this, define the environment or config file variable
4270 <code class="code">TEXMFLOG</code>. The value is the name of the file to append the
4271 information to. The file is created if it doesn&rsquo;t exist, and appended
4272 to if it does.
4273 </p>
4274 <a class="index-entry-id" id="index-epoch_002c-seconds-since"></a>
4275 <a class="index-entry-id" id="index-time-system-call"></a>
4276 <p>Each successful search turns into one line in the log file: two words
4277 separated by a space. The first word is the time of the search, as the
4278 integer number of seconds since &ldquo;the epoch&rdquo;, i.e., UTC midnight 1
4279 January 1970 (more precisely, the result of the <code class="code">time</code> system
4280 call). The second word is the filename.
4281 </p>
4282 <p>For example, after <code class="code">setenv TEXMFLOG /tmp/log</code>, running Dvips on
4283 <samp class="file">story.dvi</samp> appends the following lines:
4284 </p>
4285 <div class="example">
4286 <pre class="example-preformatted">774455887 /usr/local/share/texmf/dvips/config.ps
4287 774455887 /usr/local/share/texmf/dvips/psfonts.map
4288 774455888 /usr/local/share/texmf/dvips/texc.pro
4289 774455888 /usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmbx10.600pk
4290 774455889 /usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmsl10.600pk
4291 774455889 /usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmr10.600pk
4292 774455889 /usr/local/share/texmf/dvips/texc.pro
4293 </pre></div>
4294
4295 <a class="index-entry-id" id="index-privacy_002c-semblance-of"></a>
4296 <p>Only filenames that are absolute are recorded, to preserve
4297 some semblance of privacy.
4298 </p>
4299 <p>In addition to this Kpathsea-specific logging, <code class="command">pdftex</code>
4300 provides an option <samp class="option">-recorder</samp> to write the names of all files
4301 accessed during a run to the file <samp class="file"><var class="var">basefile</var>.fls</samp>.
4302 </p>
4303 <p>Finally, most systems provide a general tool to output each system
4304 call, thus including opening and closing files. It might be named
4305 <code class="command">strace</code>, <code class="command">truss</code>, <code class="command">struss</code>, or something
4306 else.
4307 </p>
4308
4309 <hr>
4310 </div>
4311 <div class="section-level-extent" id="Common-problems">
4312 <div class="nav-panel">
4313 <p>
4314 Previous: <a href="#Logging" accesskey="p" rel="prev">Logging</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4315 </div>
4316 <h3 class="section" id="Common-problems-1"><span>8.5 Common problems<a class="copiable-link" href="#Common-problems-1"> &para;</a></span></h3>
4317
4318 <a class="index-entry-id" id="index-common-problems"></a>
4319 <a class="index-entry-id" id="index-problems_002c-common"></a>
4320 <a class="index-entry-id" id="index-FAQ_002c-Kpathsea"></a>
4321
4322 <p>Here are some common problems with configuration, compilation, linking,
4323 execution, &hellip;
4324 </p>
4325
4326 <ul class="mini-toc">
4327 <li><a href="#Unable-to-find-files" accesskey="1">Unable to find files</a></li>
4328 <li><a href="#Slow-path-searching" accesskey="2">Slow path searching</a></li>
4329 <li><a href="#Unable-to-generate-fonts" accesskey="3">Unable to generate fonts</a></li>
4330 <li><a href="#TeX-or-Metafont-failing" accesskey="4">TeX or Metafont failing</a></li>
4331 </ul>
4332 <hr>
4333 <div class="subsection-level-extent" id="Unable-to-find-files">
4334 <div class="nav-panel">
4335 <p>
4336 Next: <a href="#Slow-path-searching" accesskey="n" rel="next">Slow path searching</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4337 </div>
4338 <h4 class="subsection" id="Unable-to-find-files-1"><span>8.5.1 Unable to find files<a class="copiable-link" href="#Unable-to-find-files-1"> &para;</a></span></h4>
4339
4340 <a class="index-entry-id" id="index-unable-to-find-files"></a>
4341 <a class="index-entry-id" id="index-files_002c-unable-to-find"></a>
4342
4343 <p>If a program complains it cannot find fonts (or other input files), any
4344 of several things might be wrong. In any case, you may find the
4345 debugging options helpful. See <a class="xref" href="#Debugging">Debugging</a>.
4346 </p>
4347 <ul class="itemize mark-bullet">
4348 <li>Perhaps you simply haven&rsquo;t installed all the necessary files; the basic
4349 fonts and input files are distributed separately from the programs.
4350 See <a class="xref" href="#unixtex_002eftp"><samp class="file">unixtex.ftp</samp>: Obtaining TeX</a>.
4351
4352 </li><li><a class="index-entry-id" id="index-_002fetc_002fprofile"></a>
4353 <a class="index-entry-id" id="index-environment-variables_002c-old"></a>
4354 You have (perhaps unknowingly) told Kpathsea to use search paths that
4355 don&rsquo;t reflect where the files actually are. One common cause is having
4356 environment variables set from a previous installation, thus overriding
4357 what you carefully set in <samp class="file">texmf.cnf</samp> (see <a class="pxref" href="#Supported-file-formats">Supported file formats</a>). System <samp class="file">/etc/profile</samp> or other files such may be the
4358 culprit.
4359
4360 </li><li><a class="index-entry-id" id="index-symbolic-links-not-found"></a>
4361 <a class="index-entry-id" id="index-leaf-directories-wrongly-guessed"></a>
4362 Your files reside in a directory that is only pointed to via a symbolic
4363 link within a leaf directory, and is not listed in <samp class="file">ls-R</samp>.
4364
4365 <p>Unfortunately, Kpathsea&rsquo;s subdirectory searching has a problematic
4366 deficiency: If a directory <var class="var">d</var> being searched for subdirectories
4367 contains symbolic links to other directories (and possibly other plain
4368 files or symlinks), but no true subdirectories, by default <var class="var">d</var>
4369 will be considered a leaf directory, i.e., the symbolic links will not
4370 be followed. See <a class="xref" href="#Subdirectory-expansion">Subdirectory expansion</a>.
4371 </p>
4372 <p>You can work around this problem by creating an empty dummy subdirectory
4373 in <var class="var">d</var>. Then <var class="var">d</var> will no longer be a leaf, and the symlinks will
4374 be followed.
4375 </p>
4376 <p>Another workaround is to set the configuration variable
4377 <code class="code">kpse_ignore_nlink_for_leaf</code> to 1. Then Kpathsea will look at
4378 all entries in all directories in determining whether they are
4379 (symlinks to) subdirectories. This is not the default because it is
4380 considerably expensive to consider the contents of every leaf directory.
4381 </p>
4382 <p>The directory immediately followed by the &lsquo;<samp class="samp">//</samp>&rsquo; in the path
4383 specification is always searched for subdirectories, even if it is a
4384 leaf. Presumably you would not have asked for the directory to be
4385 searched for subdirectories if you didn&rsquo;t want it to be.
4386 </p>
4387 </li><li>If the fonts (or whatever) don&rsquo;t already exist, <code class="code">mktexpk</code> (or
4388 <code class="code">mktexmf</code> or <code class="code">mktextfm</code>) will try to create them. If
4389 these rather complicated shell scripts fail, you&rsquo;ll eventually get an
4390 error message saying something like &lsquo;<samp class="samp">Can't find font
4391 <var class="var">fontname</var></samp>&rsquo;. The best solution is to fix (or at least report) the
4392 bug in <code class="code">mktexpk</code>; the workaround is to generate the necessary
4393 fonts by hand with Metafont, or to grab them from a CTAN site
4394 (see <a class="pxref" href="#unixtex_002eftp"><samp class="file">unixtex.ftp</samp>: Obtaining TeX</a>).
4395
4396 </li><li>There is a bug in the library. See <a class="xref" href="#Reporting-bugs">Reporting bugs</a>.
4397 </li></ul>
4398
4399
4400 <hr>
4401 </div>
4402 <div class="subsection-level-extent" id="Slow-path-searching">
4403 <div class="nav-panel">
4404 <p>
4405 Next: <a href="#Unable-to-generate-fonts" accesskey="n" rel="next">Unable to generate fonts</a>, Previous: <a href="#Unable-to-find-files" accesskey="p" rel="prev">Unable to find files</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4406 </div>
4407 <h4 class="subsection" id="Slow-path-searching-1"><span>8.5.2 Slow path searching<a class="copiable-link" href="#Slow-path-searching-1"> &para;</a></span></h4>
4408
4409 <a class="index-entry-id" id="index-excessive-startup-time"></a>
4410 <a class="index-entry-id" id="index-slow-startup-time"></a>
4411 <a class="index-entry-id" id="index-startup-time_002c-excessive"></a>
4412
4413 <p>If your program takes an excessively long time to find fonts or other
4414 input files, but does eventually succeed, here are some possible culprits:
4415 </p>
4416 <ul class="itemize mark-bullet">
4417 <li>Most likely, you just have a lot of directories to search, and that
4418 takes a noticeable time. The solution is to create and maintain a
4419 separate <samp class="file">ls-R</samp> file that lists all the files in your main TeX
4420 hierarchy. See <a class="xref" href="#Filename-database">Filename database (<code class="code">ls-R</code>)</a>. Kpathsea always uses <samp class="file">ls-R</samp>
4421 if it&rsquo;s present; there&rsquo;s no need to recompile or reconfigure any of the
4422 programs.
4423
4424 </li><li>Your recursively-searched directories (e.g.,
4425 <samp class="file">/usr/local/share/texmf/fonts//</samp>), contain a mixture of files and
4426 directories. This prevents Kpathsea from using a useful optimization
4427 (see <a class="pxref" href="#Subdirectory-expansion">Subdirectory expansion</a>).
4428
4429 <p>It is best to have only directories (and perhaps a <samp class="file">README</samp>) in the
4430 upper levels of the directory structure, and it&rsquo;s very important to have
4431 <em class="emph">only</em> files, and no subdirectories, in the leaf directories where
4432 the dozens of TFM, PK, or whatever files reside.
4433 </p></li></ul>
4434
4435 <p>In any case, you may find the debugging options helpful in determining
4436 precisely when the disk or network is being pounded. See <a class="xref" href="#Debugging">Debugging</a>.
4437 </p>
4438
4439 <hr>
4440 </div>
4441 <div class="subsection-level-extent" id="Unable-to-generate-fonts">
4442 <div class="nav-panel">
4443 <p>
4444 Next: <a href="#TeX-or-Metafont-failing" accesskey="n" rel="next">TeX or Metafont failing</a>, Previous: <a href="#Slow-path-searching" accesskey="p" rel="prev">Slow path searching</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4445 </div>
4446 <h4 class="subsection" id="Unable-to-generate-fonts-1"><span>8.5.3 Unable to generate fonts<a class="copiable-link" href="#Unable-to-generate-fonts-1"> &para;</a></span></h4>
4447
4448 <a class="index-entry-id" id="index-unable-to-generate-fonts"></a>
4449 <a class="index-entry-id" id="index-font-generation-failures"></a>
4450
4451 <p>Metafont outputs fonts in bitmap format, tuned for a particular
4452 device at a particular resolution, in order to allow for the
4453 highest-possible quality of output. Some DVI-to-whatever programs,
4454 such as Dvips, try to generate these on the fly when they are needed,
4455 but this generation may fail in several cases.
4456 </p>
4457 <a class="index-entry-id" id="index-mktexpk-can_0027t-guess-mode"></a>
4458 <p>If <code class="code">mktexpk</code> runs, but fails with this error:
4459 </p><div class="example">
4460 <pre class="example-preformatted">mktexpk: Can't guess mode for <var class="var">nnn</var> dpi devices.
4461 mktexpk: Use a config file to specify the mode, or update me.
4462 </pre></div>
4463 <p>you need to ensure the resolution and mode match; just
4464 specifying the resolution, as in <code class="code">-D 360</code>, is not enough.
4465 </p>
4466 <p>You can specify the mode name with the <code class="code">-mode</code> option on the
4467 Dvips command line, or in a Dvips configuration file (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config
4468 files</a> in <cite class="cite">Dvips</cite>), such as <samp class="file">config.ps</samp> in your document
4469 directory, <samp class="file">~/.dvipsrc</samp> in your home directory, or in a system
4470 directory (again named <samp class="file">config.ps</samp>). (Other drivers use other
4471 files, naturally.)
4472 </p>
4473 <p>For example, if you need 360<span class="dmn">dpi</span> fonts, you could include this in
4474 a configuration file:
4475 </p><div class="example">
4476 <pre class="example-preformatted">D 360
4477 M lqmed
4478 </pre></div>
4479
4480 <a class="index-entry-id" id="index-Metafont-using-the-wrong-device"></a>
4481 <a class="index-entry-id" id="index-device_002c-wrong"></a>
4482 <p>If Metafont runs, but generates fonts at the wrong resolution or for
4483 the wrong device, most likely <code class="code">mktexpk</code>&rsquo;s built-in guess for the
4484 mode is wrong, and you should override it as above.
4485 </p>
4486 <p>See <a class="url" href="https://ctan.org/pkg/modes">https://ctan.org/pkg/modes</a> for a list of resolutions and mode
4487 names for most devices (additional submissions are welcome).
4488 </p>
4489 <a class="index-entry-id" id="index-_002e2602gf"></a>
4490 <a class="index-entry-id" id="index-2602gf"></a>
4491 <a class="index-entry-id" id="index-Metafont-making-too_002dlarge-fonts"></a>
4492 <a class="index-entry-id" id="index-proof-mode"></a>
4493 <a class="index-entry-id" id="index-online-Metafont-display_002c-spurious"></a>
4494 <p>If Metafont runs but generates fonts at a resolution of 2602<span class="dmn">dpi</span>
4495 (and prints out the name of each character as well as just a character
4496 number, and maybe tries to display the characters), then your Metafont
4497 base file probably hasn&rsquo;t been made properly. (It&rsquo;s using the default
4498 <code class="code">proof</code> mode, instead of an actual device mode.) To make a proper
4499 <samp class="file">plain.base</samp>, assuming the local mode definitions are contained in
4500 a file <samp class="file">modes.mf</samp>, run the following command (assuming Unix):
4501 </p>
4502 <div class="example">
4503 <pre class="example-preformatted">inimf &quot;plain; input modes; dump&quot;
4504 </pre></div>
4505
4506 <a class="index-entry-id" id="index-plain_002ebase"></a>
4507 <p>Then copy the <samp class="file">plain.base</samp> file from the current directory to where
4508 the base files are stored on your system
4509 (<samp class="file">/usr/local/share/texmf/web2c</samp> by default), and make a link
4510 (either hard or soft) from <samp class="file">plain.base</samp> to <samp class="file">mf.base</samp> in that
4511 directory.
4512 See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite class="cite">Web2c</cite>.
4513 </p>
4514 <a class="index-entry-id" id="index-Metafont-installation"></a>
4515 <p>If <code class="code">mf</code> is a command not found at all by <code class="code">mktexpk</code>, then you
4516 need to install Metafont (see <a class="pxref" href="#unixtex_002eftp"><samp class="file">unixtex.ftp</samp>: Obtaining TeX</a>).
4517 </p>
4518
4519 <hr>
4520 </div>
4521 <div class="subsection-level-extent" id="TeX-or-Metafont-failing">
4522 <div class="nav-panel">
4523 <p>
4524 Previous: <a href="#Unable-to-generate-fonts" accesskey="p" rel="prev">Unable to generate fonts</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4525 </div>
4526 <h4 class="subsection" id="TeX-or-Metafont-failing-1"><span>8.5.4 TeX or Metafont failing<a class="copiable-link" href="#TeX-or-Metafont-failing-1"> &para;</a></span></h4>
4527
4528 <a class="index-entry-id" id="index-TeX-failures"></a>
4529 <a class="index-entry-id" id="index-Metafont-failures"></a>
4530 <a class="index-entry-id" id="index-compiler-bugs"></a>
4531 <p>If TeX or Metafont get a segmentation fault or otherwise fail while
4532 running a normal input file, the problem is usually a compiler bug
4533 (unlikely as that may sound). Even if the trip and trap tests are
4534 passed, problems may lurk. Optimization occasionally causes trouble in
4535 programs other than TeX and Metafont themselves, too.
4536 </p>
4537 <a class="index-entry-id" id="index-optimization-caveat"></a>
4538 <p>For a workaround, if you enabled any optimization flags, it&rsquo;s best to
4539 omit optimization entirely. In any case, the way to find the facts is
4540 to run the program under the debugger and see where it&rsquo;s failing.
4541 </p>
4542 <a class="index-entry-id" id="index-GNU-C-compiler-bugs"></a>
4543 <a class="index-entry-id" id="index-system-C-compiler-bugs"></a>
4544 <p>Also, if you have trouble with a system C compiler, I advise trying the
4545 GNU C compiler. And vice versa, unfortunately; but in that case I also
4546 recommend reporting a bug to the GCC mailing list; see <a data-manual="gcc" href="https://gcc.gnu.org/onlinedocs/gcc/Bugs.html#Bugs">Bugs</a> in <cite class="cite">Using and Porting GNU CC</cite>.
4547 </p>
4548 <a class="index-entry-id" id="index-compiler-bugs_002c-finding"></a>
4549 <p>To report compiler bugs effectively requires perseverance and
4550 perspicacity: you must find the miscompiled line, and that usually
4551 involves delving backwards in time from the point of error, checking
4552 through TeX&rsquo;s (or whatever program&rsquo;s) data structures. Good luck.
4553 </p>
4554
4555 <hr>
4556 </div>
4557 </div>
4558 </div>
4559 <div class="unnumbered-level-extent" id="Index">
4560 <div class="nav-panel">
4561 <p>
4562 Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
4563 </div>
4564 <h2 class="unnumbered" id="Index-1"><span>Index<a class="copiable-link" href="#Index-1"> &para;</a></span></h2>
4565
4566 <div class="printindex cp-printindex">
4567 <table class="cp-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a>
4568 &nbsp;
4569 <a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>;</b></a>
4570 &nbsp;
4571 <a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>:</b></a>
4572 &nbsp;
4573 <a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>!</b></a>
4574 &nbsp;
4575 <a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>.</b></a>
4576 &nbsp;
4577 <a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>{</b></a>
4578 &nbsp;
4579 <a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>/</b></a>
4580 &nbsp;
4581 <a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>\</b></a>
4582 &nbsp;
4583 <a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>=</b></a>
4584 &nbsp;
4585 <a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>~</b></a>
4586 &nbsp;
4587 <a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>$</b></a>
4588 &nbsp;
4589 <a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>2</b></a>
4590 &nbsp;
4591 <a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a>
4592 &nbsp;
4593 <br>
4594 <a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
4595 &nbsp;
4596 <a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
4597 &nbsp;
4598 <a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
4599 &nbsp;
4600 <a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
4601 &nbsp;
4602 <a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
4603 &nbsp;
4604 <a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
4605 &nbsp;
4606 <a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
4607 &nbsp;
4608 <a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
4609 &nbsp;
4610 <a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
4611 &nbsp;
4612 <a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a>
4613 &nbsp;
4614 <a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
4615 &nbsp;
4616 <a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
4617 &nbsp;
4618 <a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
4619 &nbsp;
4620 <a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
4621 &nbsp;
4622 <a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
4623 &nbsp;
4624 <a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
4625 &nbsp;
4626 <a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
4627 &nbsp;
4628 <a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
4629 &nbsp;
4630 <a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
4631 &nbsp;
4632 <a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a>
4633 &nbsp;
4634 <a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a>
4635 &nbsp;
4636 <a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
4637 &nbsp;
4638 <a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a>
4639 &nbsp;
4640 <a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
4641 &nbsp;
4642 </td></tr></table>
4643 <table class="cp-entries-printindex">
4644 <tr><td></td><th class="entries-header-printindex">Index Entry</th><th class="sections-header-printindex">Section</th></tr>
4645 <tr><td colspan="3"><hr></td></tr>
4646 <tr><th id="Index_cp_symbol-1">-</th></tr>
4647 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dall"><code>--all</code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4648 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dcasefold_002dsearch"><code>--casefold-search</code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4649 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dcnf_002dline"><code>--cnf-line</code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4650 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dcnf_002dline_002c-source-for-path"><code>&lsquo;<samp class="samp">--cnf-line</samp>&rsquo;, source for path</code></a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
4651 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dcolor_003dtty"><code>--color=tty</code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4652 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002ddebug_003dnum"><code>--debug=<var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4653 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002ddpi_003dnum"><code>--dpi=<var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4654 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dengine_003dname"><code>--engine=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4655 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dexpand_002dbraces_003dstring"><code>--expand-braces=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4656 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dexpand_002dpath_003dstring"><code>--expand-path=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4657 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dexpand_002dvar_003dstring"><code>--expand-var=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4658 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dformat_003dname"><code>--format=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4659 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp"><code>--help</code></a></td><td class="printindex-index-section"><a href="#Standard-options">Standard options</a></td></tr>
4660 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dhelp_002dformats"><code>--help-formats</code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4661 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dinteractive"><code>--interactive</code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4662 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dmktex_003dfiletype"><code>--mktex=<var class="var">filetype</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4663 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dmode_003dstring"><code>--mode=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4664 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dmust_002dexist"><code>--must-exist</code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4665 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dno_002dcasefold_002dsearch"><code>--no-casefold-search</code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4666 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dno_002dmktex_003dfiletype"><code>--no-mktex=<var class="var">filetype</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4667 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dpath_003dstring"><code>--path=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4668 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dprogname_003dname"><code>--progname=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4669 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dsafe_002dextended_002din_002dname_003dname"><code>--safe-extended-in-name=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4670 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dsafe_002dextended_002dout_002dname_003dname"><code>--safe-extended-out-name=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4671 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dsafe_002din_002dname_003dname"><code>--safe-in-name=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4672 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dsafe_002dout_002dname_003dname"><code>--safe-out-name=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4673 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dshow_002dpath_003dname"><code>--show-path=<var class="var">name</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4674 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dsubdir_003dstring"><code>--subdir=<var class="var">string</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4675 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dvar_002dbrace_002dvalue_003dvariable"><code>--var-brace-value=<var class="var">variable</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4676 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dvar_002dvalue_003dvariable"><code>--var-value=<var class="var">variable</var></code></a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4677 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dversion"><code>--version</code></a></td><td class="printindex-index-section"><a href="#Standard-options">Standard options</a></td></tr>
4678 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwith_002dmktextex_002ddefault"><code>--with-mktextex-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4679 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dmktexfmt_002ddefault"><code>--without-mktexfmt-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4680 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dmktexmf_002ddefault"><code>--without-mktexmf-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4681 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dmktexocp_002ddefault"><code>--without-mktexocp-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4682 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dmktexofm_002ddefault"><code>--without-mktexofm-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4683 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dmktexpk_002ddefault"><code>--without-mktexpk-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4684 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002dwithout_002dmktextfm_002ddefault"><code>--without-mktextfm-default</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4685 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002d1-debugging-value"><code>-1 <span class="r">debugging value</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
4686 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dA-option-to-ls"><code>-A <span class="r">option to <code class="code">ls</code></span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4687 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dD-num"><code>-D <var class="var">num</var></code></a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4688 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002diname_002c-find-predicate"><code>-iname<span class="r">, find predicate</span></code></a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
4689 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002dL-option-to-ls"><code>-L <span class="r">option to <code class="code">ls</code></span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4690 <tr><td colspan="3"><hr></td></tr>
4691 <tr><th id="Index_cp_symbol-2">;</th></tr>
4692 <tr><td></td><td class="printindex-index-entry"><a href="#index-_003b-translated-to-_003a-in-texmf_002ecnf"><code>; <span class="r">translated to &lsquo;<samp class="samp">:</samp>&rsquo; in <samp class="file">texmf.cnf</samp></span></code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4693 <tr><td colspan="3"><hr></td></tr>
4694 <tr><th id="Index_cp_symbol-3">:</th></tr>
4695 <tr><td></td><td class="printindex-index-entry"><a href="#index-_003a-may-not-be-_003a"><code>: <span class="r">may not be :</span></code></a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4696 <tr><td></td><td class="printindex-index-entry"><a href="#index-_003a_003a-expansion"><code>:: <span class="r">expansion</span></code></a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
4697 <tr><td colspan="3"><hr></td></tr>
4698 <tr><th id="Index_cp_symbol-4">!</th></tr>
4699 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0021_0021-and-casefolding"><code>!! <span class="r">and casefolding</span></code></a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
4700 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0021_0021-in-path-specifications"><code>!! <span class="r">in path specifications</span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4701 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0021_0021-in-TEXMFDBS"><code>!! <span class="r">in <code class="code">TEXMFDBS</code></span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4702 <tr><td colspan="3"><hr></td></tr>
4703 <tr><th id="Index_cp_symbol-5">.</th></tr>
4704 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002e-directories_002c-ignored"><code>. <span class="r">directories, ignored</span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4705 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002e-files"><code>. <span class="r">files</span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4706 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002e2602gf"><code>.2602gf</code></a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
4707 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eafm"><code>.afm</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4708 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebase"><code>.base</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4709 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebib"><code>.bib</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4710 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebltxml"><code>.bltxml</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4711 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebst"><code>.bst</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4712 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecid"><code>.cid</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4713 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecmap"><code>.cmap</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4714 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecnf"><code>.cnf</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4715 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002edll"><code>.dll</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4716 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eenc"><code>.enc</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4717 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eeps"><code>.eps</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4718 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eepsi"><code>.epsi</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4719 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002efea"><code>.fea</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4720 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002efmt"><code>.fmt</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4721 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eist"><code>.ist</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4722 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002elig"><code>.lig</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4723 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002elua"><code>.lua</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4724 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eluatex"><code>.luatex</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4725 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eluc"><code>.luc</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4726 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eluctex"><code>.luctex</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4727 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emap"><code>.map</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4728 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emem"><code>.mem</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4729 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emf"><code>.mf</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4730 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emft"><code>.mft</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4731 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emlbib"><code>.mlbib</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4732 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emlbst"><code>.mlbst</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4733 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002emp"><code>.mp</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4734 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eocp"><code>.ocp</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4735 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eofm"><code>.ofm</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4736 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eopl"><code>.opl</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4737 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eotp"><code>.otp</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4738 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eovf"><code>.ovf</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4739 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eovp"><code>.ovp</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4740 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfa"><code>.pfa</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4741 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epfb"><code>.pfb</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4742 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epk"><code>.pk</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4743 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epool"><code>.pool</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4744 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epool-1"><code>.pool</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4745 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epool-2"><code>.pool</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4746 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002epro"><code>.pro</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4747 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eprofile_002c-_0028un_0029writable-by-TeX"><code>.profile<span class="r">, (un)writable by TeX</span></code></a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
4748 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eprogname-qualifier-in-texmf_002ecnf"><code>.<var class="var">progname</var> <span class="r">qualifier in <samp class="file">texmf.cnf</samp></span></code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4749 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eris"><code>.ris</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4750 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002esfd"><code>.sfd</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4751 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eso"><code>.so</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4752 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etex"><code>.tex</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4753 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etex-file_002c-included-in-ls_002dR"><code>.tex <span class="r">file, included in <samp class="file">ls-R</samp></span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4754 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etexlua"><code>.texlua</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4755 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etexluc"><code>.texluc</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4756 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etfm"><code>.tfm</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4757 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002etlu"><code>.tlu</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4758 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ettc"><code>.ttc</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4759 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ettf"><code>.ttf</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4760 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002evf"><code>.vf</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4761 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002ew"><code>.w</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4762 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eweb"><code>.web</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4763 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002eweb-1"><code>.web</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4764 <tr><td colspan="3"><hr></td></tr>
4765 <tr><th id="Index_cp_symbol-6">{</th></tr>
4766 <tr><td></td><td class="printindex-index-entry"><a href="#index-_007b-expansion"><code>{ <span class="r">expansion</span></code></a></td><td class="printindex-index-section"><a href="#Brace-expansion">Brace expansion</a></td></tr>
4767 <tr><td colspan="3"><hr></td></tr>
4768 <tr><th id="Index_cp_symbol-7">/</th></tr>
4769 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002f-may-not-be-_002f"><code>/ <span class="r">may not be /</span></code></a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4770 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_002c-trailing-in-home-directory"><code>/<span class="r">, trailing in home directory</span></code></a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
4771 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_002f"><code>//</code></a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
4772 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002fetc_002fprofile"><code>/etc/profile</code></a></td><td class="printindex-index-section"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
4773 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002fetc_002fprofile-and-aliases"><code>/etc/profile <span class="r">and aliases</span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4774 <tr><td></td><td class="printindex-index-entry"><a href="#index-_002fvar_002ftmp_002ftexfonts"><code>/var/tmp/texfonts</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4775 <tr><td colspan="3"><hr></td></tr>
4776 <tr><th id="Index_cp_symbol-8">\</th></tr>
4777 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002c-line-continuation-in-texmf_002ecnf"><code>\<span class="r">, line continuation in <samp class="file">texmf.cnf</samp></span></code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4778 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005copenin"><code>\openin</code></a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4779 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005copenout"><code>\openout</code></a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
4780 <tr><td></td><td class="printindex-index-entry"><a href="#index-_005cspecial_002c-suppressing-warnings-about"><code>\special<span class="r">, suppressing warnings about</span></code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
4781 <tr><td colspan="3"><hr></td></tr>
4782 <tr><th id="Index_cp_symbol-9">=</th></tr>
4783 <tr><td></td><td class="printindex-index-entry"><a href="#index-_003d-omitted-in-texmf_002ecnf-and-misparsing"><code>= <span class="r">omitted in <samp class="file">texmf.cnf</samp> and misparsing</span></code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4784 <tr><td colspan="3"><hr></td></tr>
4785 <tr><th id="Index_cp_symbol-10">~</th></tr>
4786 <tr><td></td><td class="printindex-index-entry"><a href="#index-_007e-expansion"><code>~ <span class="r">expansion</span></code></a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
4787 <tr><td colspan="3"><hr></td></tr>
4788 <tr><th id="Index_cp_symbol-11">$</th></tr>
4789 <tr><td></td><td class="printindex-index-entry"><a href="#index-_0024-expansion"><code>$ <span class="r">expansion</span></code></a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
4790 <tr><td colspan="3"><hr></td></tr>
4791 <tr><th id="Index_cp_symbol-12">2</th></tr>
4792 <tr><td></td><td class="printindex-index-entry"><a href="#index-2602gf"><code>2602gf</code></a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
4793 <tr><td colspan="3"><hr></td></tr>
4794 <tr><th id="Index_cp_symbol-13">8</th></tr>
4795 <tr><td></td><td class="printindex-index-entry"><a href="#index-8_002e3-filenames_002c-using">8.3 filenames, using</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4796 <tr><td colspan="3"><hr></td></tr>
4797 <tr><th id="Index_cp_letter-A">A</th></tr>
4798 <tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-filenames">absolute filenames</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4799 <tr><td></td><td class="printindex-index-entry"><a href="#index-access-system-call"><code>access <span class="r">system call</span></code></a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
4800 <tr><td></td><td class="printindex-index-entry"><a href="#index-access-warnings">access warnings</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4801 <tr><td></td><td class="printindex-index-entry"><a href="#index-AFMFONTS"><code>AFMFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4802 <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="#Fontmap">Fontmap</a></td></tr>
4803 <tr><td></td><td class="printindex-index-entry"><a href="#index-aliases_002c-for-filenames">aliases, for filenames</a></td><td class="printindex-index-section"><a href="#Filename-aliases">Filename aliases</a></td></tr>
4804 <tr><td></td><td class="printindex-index-entry"><a href="#index-all"><code>all</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
4805 <tr><td></td><td class="printindex-index-entry"><a href="#index-all-matches_002c-finding">all matches, finding</a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4806 <tr><td></td><td class="printindex-index-entry"><a href="#index-alphabetical-order_002c-not">alphabetical order, not</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
4807 <tr><td></td><td class="printindex-index-entry"><a href="#index-announcement-mailing-list">announcement mailing list</a></td><td class="printindex-index-section"><a href="#Mailing-lists">Mailing lists</a></td></tr>
4808 <tr><td></td><td class="printindex-index-entry"><a href="#index-API_002c-re_002dentrant">API, re-entrant</a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
4809 <tr><td></td><td class="printindex-index-entry"><a href="#index-append_002donly-directories-and-mktexpk">append-only directories and <code class="code">mktexpk</code></a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
4810 <tr><td></td><td class="printindex-index-entry"><a href="#index-appendonlydir"><code>appendonlydir</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4811 <tr><td></td><td class="printindex-index-entry"><a href="#index-Apple-filesystem_002c-case_002dinsensitive">Apple filesystem, case-insensitive</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
4812 <tr><td></td><td class="printindex-index-entry"><a href="#index-arguments-to-mktex">arguments to <samp class="file">mktex</samp></a></td><td class="printindex-index-section"><a href="#mktex-script-arguments">mktex script arguments</a></td></tr>
4813 <tr><td></td><td class="printindex-index-entry"><a href="#index-argv_005b0_005d"><code>argv[0]</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4814 <tr><td></td><td class="printindex-index-entry"><a href="#index-autoconf_002c-recommended"><code>autoconf<span class="r">, recommended</span></code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4815 <tr><td></td><td class="printindex-index-entry"><a href="#index-automounter_002c-and-ls_002dR">automounter, and <samp class="file">ls-R</samp></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4816 <tr><td></td><td class="printindex-index-entry"><a href="#index-auxiliary-tasks">auxiliary tasks</a></td><td class="printindex-index-section"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
4817 <tr><td colspan="3"><hr></td></tr>
4818 <tr><th id="Index_cp_letter-B">B</th></tr>
4819 <tr><td></td><td class="printindex-index-entry"><a href="#index-Bach_002c-Johann-Sebastian">Bach, Johann Sebastian</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
4820 <tr><td></td><td class="printindex-index-entry"><a href="#index-backslash_002dnewline">backslash-newline</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4821 <tr><td></td><td class="printindex-index-entry"><a href="#index-basic-glyph-lookup">basic glyph lookup</a></td><td class="printindex-index-section"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr>
4822 <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="#History">History</a></td></tr>
4823 <tr><td></td><td class="printindex-index-entry"><a href="#index-BIBINPUTS"><code>BIBINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4824 <tr><td></td><td class="printindex-index-entry"><a href="#index-BIBINPUTS-1"><code>BIBINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4825 <tr><td></td><td class="printindex-index-entry"><a href="#index-blank-lines_002c-in-texmf_002ecnf">blank lines, in <samp class="file">texmf.cnf</samp></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4826 <tr><td></td><td class="printindex-index-entry"><a href="#index-BLTXMLINPUTS"><code>BLTXMLINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4827 <tr><td></td><td class="printindex-index-entry"><a href="#index-brace-expansion">brace expansion</a></td><td class="printindex-index-section"><a href="#Brace-expansion">Brace expansion</a></td></tr>
4828 <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="#History">History</a></td></tr>
4829 <tr><td></td><td class="printindex-index-entry"><a href="#index-BSTINPUTS"><code>BSTINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4830 <tr><td></td><td class="printindex-index-entry"><a href="#index-BSTINPUTS-1"><code>BSTINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4831 <tr><td></td><td class="printindex-index-entry"><a href="#index-bug-address">bug address</a></td><td class="printindex-index-section"><a href="#Reporting-bugs">Reporting bugs</a></td></tr>
4832 <tr><td></td><td class="printindex-index-entry"><a href="#index-bug-checklist">bug checklist</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4833 <tr><td></td><td class="printindex-index-entry"><a href="#index-bug-mailing-list">bug mailing list</a></td><td class="printindex-index-section"><a href="#Mailing-lists">Mailing lists</a></td></tr>
4834 <tr><td></td><td class="printindex-index-entry"><a href="#index-bugs_002c-reporting">bugs, reporting</a></td><td class="printindex-index-section"><a href="#Reporting-bugs">Reporting bugs</a></td></tr>
4835 <tr><td colspan="3"><hr></td></tr>
4836 <tr><th id="Index_cp_letter-C">C</th></tr>
4837 <tr><td></td><td class="printindex-index-entry"><a href="#index-c_002d_002a_002eh"><code>c-*.h</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4838 <tr><td></td><td class="printindex-index-entry"><a href="#index-c_002dauto_002eh"><code>c-auto.h</code></a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
4839 <tr><td></td><td class="printindex-index-entry"><a href="#index-cache-of-fonts_002c-local">cache of fonts, local</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
4840 <tr><td></td><td class="printindex-index-entry"><a href="#index-calling-sequence">calling sequence</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4841 <tr><td></td><td class="printindex-index-entry"><a href="#index-casefolding-examples">casefolding examples</a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
4842 <tr><td></td><td class="printindex-index-entry"><a href="#index-casefolding-fallback-rationale">casefolding fallback rationale</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
4843 <tr><td></td><td class="printindex-index-entry"><a href="#index-casefolding-search">casefolding search</a></td><td class="printindex-index-section"><a href="#Casefolding-search">Casefolding search</a></td></tr>
4844 <tr><td></td><td class="printindex-index-entry"><a href="#index-ChangeLog-entry"><code>ChangeLog <span class="r">entry</span></code></a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4845 <tr><td></td><td class="printindex-index-entry"><a href="#index-checklist-for-bug-reports">checklist for bug reports</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4846 <tr><td></td><td class="printindex-index-entry"><a href="#index-checksum"><code>checksum</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
4847 <tr><td></td><td class="printindex-index-entry"><a href="#index-circle-fonts">circle fonts</a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
4848 <tr><td></td><td class="printindex-index-entry"><a href="#index-client_005fpath-in-kpse_002d_003eformat_005finfo"><code>client_path <span class="r">in <code class="code">kpse-&gt;format_info</code></span></code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4849 <tr><td></td><td class="printindex-index-entry"><a href="#index-CLUAINPUTS"><code>CLUAINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4850 <tr><td></td><td class="printindex-index-entry"><a href="#index-CMAPFONTS"><code>CMAPFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4851 <tr><td></td><td class="printindex-index-entry"><a href="#index-cmr10_002c-as-fallback-font"><code>cmr10<span class="r">, as fallback font</span></code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4852 <tr><td></td><td class="printindex-index-entry"><a href="#index-cmr10_002evf"><code>cmr10.vf</code></a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4853 <tr><td></td><td class="printindex-index-entry"><a href="#index-cnf_002ec"><code>cnf.c</code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4854 <tr><td></td><td class="printindex-index-entry"><a href="#index-cnf_002eh"><code>cnf.h</code></a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
4855 <tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-fontmap-files">comments, in fontmap files</a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
4856 <tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-in-texmf_002ecnf">comments, in <samp class="file">texmf.cnf</samp></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4857 <tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-making">comments, making</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
4858 <tr><td></td><td class="printindex-index-entry"><a href="#index-common-features-in-glyph-lookup">common features in glyph lookup</a></td><td class="printindex-index-section"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr>
4859 <tr><td></td><td class="printindex-index-entry"><a href="#index-common-problems">common problems</a></td><td class="printindex-index-section"><a href="#Common-problems">Common problems</a></td></tr>
4860 <tr><td></td><td class="printindex-index-entry"><a href="#index-compilation-value_002c-source-for-path">compilation value, source for path</a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
4861 <tr><td></td><td class="printindex-index-entry"><a href="#index-compiler-bugs">compiler bugs</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
4862 <tr><td></td><td class="printindex-index-entry"><a href="#index-compiler-bugs_002c-finding">compiler bugs, finding</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
4863 <tr><td></td><td class="printindex-index-entry"><a href="#index-conditions-for-use">conditions for use</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
4864 <tr><td></td><td class="printindex-index-entry"><a href="#index-config-files">config files</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4865 <tr><td></td><td class="printindex-index-entry"><a href="#index-config-files_002c-for-Kpathsea_002dusing-programs">config files, for Kpathsea-using programs</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4866 <tr><td></td><td class="printindex-index-entry"><a href="#index-config-files_002c-programming-with">config files, programming with</a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
4867 <tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eh"><code>config.h</code></a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
4868 <tr><td></td><td class="printindex-index-entry"><a href="#index-config_002elog"><code>config.log</code></a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4869 <tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps"><code>config.ps</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
4870 <tr><td></td><td class="printindex-index-entry"><a href="#index-config_002eps_002c-search-path-for"><code>config.ps<span class="r">, search path for</span></code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4871 <tr><td></td><td class="printindex-index-entry"><a href="#index-config_002estatus"><code>config.status</code></a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4872 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-bugs">configuration bugs</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4873 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-file_002c-source-for-path">configuration file, source for path</a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
4874 <tr><td></td><td class="printindex-index-entry"><a href="#index-configuration-of-mktex-scripts">configuration of <samp class="file">mktex</samp> scripts</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4875 <tr><td></td><td class="printindex-index-entry"><a href="#index-configure-options-for-mktex-scripts"><code class="code">configure</code> options for <samp class="file">mktex</samp> scripts</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4876 <tr><td></td><td class="printindex-index-entry"><a href="#index-ConTeXt-and-_0028no_0029-security">ConTeXt and (no) security</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
4877 <tr><td></td><td class="printindex-index-entry"><a href="#index-context-diff">context diff</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4878 <tr><td></td><td class="printindex-index-entry"><a href="#index-continuation-character">continuation character</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
4879 <tr><td></td><td class="printindex-index-entry"><a href="#index-core-dumps_002c-reporting">core dumps, reporting</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4880 <tr><td></td><td class="printindex-index-entry"><a href="#index-crashes-of-TeX-and-security">crashes of TeX and security</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
4881 <tr><td></td><td class="printindex-index-entry"><a href="#index-crashes_002c-reporting">crashes, reporting</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4882 <tr><td></td><td class="printindex-index-entry"><a href="#index-CWEBINPUTS"><code>CWEBINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4883 <tr><td colspan="3"><hr></td></tr>
4884 <tr><th id="Index_cp_letter-D">D</th></tr>
4885 <tr><td></td><td class="printindex-index-entry"><a href="#index-database-search">database search</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4886 <tr><td></td><td class="printindex-index-entry"><a href="#index-database_002c-for-filenames">database, for filenames</a></td><td class="printindex-index-section"><a href="#Filename-database">Filename database</a></td></tr>
4887 <tr><td></td><td class="printindex-index-entry"><a href="#index-database_002c-format-of">database, format of</a></td><td class="printindex-index-section"><a href="#Database-format">Database format</a></td></tr>
4888 <tr><td></td><td class="printindex-index-entry"><a href="#index-debug_002eh"><code>debug.h</code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
4889 <tr><td></td><td class="printindex-index-entry"><a href="#index-debugger">debugger</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4890 <tr><td></td><td class="printindex-index-entry"><a href="#index-debugging">debugging</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
4891 <tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-options_002c-in-Kpathsea_002dusing-program">debugging options, in Kpathsea-using program</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4892 <tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-output">debugging output</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
4893 <tr><td></td><td class="printindex-index-entry"><a href="#index-default-expansion">default expansion</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
4894 <tr><td></td><td class="printindex-index-entry"><a href="#index-default_005ftexsizes"><code>default_texsizes</code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4895 <tr><td></td><td class="printindex-index-entry"><a href="#index-device_002c-wrong">device, wrong</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
4896 <tr><td></td><td class="printindex-index-entry"><a href="#index-directories_002c-making-append_002donly">directories, making append-only</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4897 <tr><td></td><td class="printindex-index-entry"><a href="#index-directory-permissions">directory permissions</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
4898 <tr><td></td><td class="printindex-index-entry"><a href="#index-directory-structure_002c-for-TeX-files">directory structure, for TeX files</a></td><td class="printindex-index-section"><a href="#TeX-directory-structure">TeX directory structure</a></td></tr>
4899 <tr><td></td><td class="printindex-index-entry"><a href="#index-disabling-mktex-scripts">disabling <samp class="file">mktex</samp> scripts</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4900 <tr><td></td><td class="printindex-index-entry"><a href="#index-disk-search">disk search</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4901 <tr><td></td><td class="printindex-index-entry"><a href="#index-disk-searching_002c-avoiding">disk searching, avoiding</a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4902 <tr><td></td><td class="printindex-index-entry"><a href="#index-disk-usage_002c-reducing">disk usage, reducing</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
4903 <tr><td></td><td class="printindex-index-entry"><a href="#index-doc-files"><code>doc files</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4904 <tr><td></td><td class="printindex-index-entry"><a href="#index-DOS-compatible-names">DOS compatible names</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4905 <tr><td></td><td class="printindex-index-entry"><a href="#index-dosnames"><code>dosnames</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4906 <tr><td></td><td class="printindex-index-entry"><a href="#index-dot-files">dot files</a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
4907 <tr><td></td><td class="printindex-index-entry"><a href="#index-doubled-colons">doubled colons</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
4908 <tr><td></td><td class="printindex-index-entry"><a href="#index-dpinnn-directories"><code>dpi<var class="var">nnn</var> directories</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4909 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVILJMAKEPK"><code>DVILJMAKEPK</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
4910 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVILJSIZES"><code>DVILJSIZES</code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4911 <tr><td></td><td class="printindex-index-entry"><a href="#index-dvipdfmx_002ecfg"><code>dvipdfmx.cfg</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
4912 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSFONTS"><code>DVIPSFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4913 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSHEADERS"><code>DVIPSHEADERS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4914 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSMAKEPK"><code>DVIPSMAKEPK</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
4915 <tr><td></td><td class="printindex-index-entry"><a href="#index-DVIPSSIZES"><code>DVIPSSIZES</code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4916 <tr><td></td><td class="printindex-index-entry"><a href="#index-dynamic-creation-of-files">dynamic creation of files</a></td><td class="printindex-index-section"><a href="#mktex-scripts">mktex scripts</a></td></tr>
4917 <tr><td colspan="3"><hr></td></tr>
4918 <tr><th id="Index_cp_letter-E">E</th></tr>
4919 <tr><td></td><td class="printindex-index-entry"><a href="#index-EC-fonts_002c-and-dynamic-source-creation">EC fonts, and dynamic source creation</a></td><td class="printindex-index-section"><a href="#mktex-scripts">mktex scripts</a></td></tr>
4920 <tr><td></td><td class="printindex-index-entry"><a href="#index-elt_002ddirs_002ec"><code>elt-dirs.c</code></a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
4921 <tr><td></td><td class="printindex-index-entry"><a href="#index-elt_002ddirs_002ec-1"><code>elt-dirs.c</code></a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
4922 <tr><td></td><td class="printindex-index-entry"><a href="#index-enabling-mktex-scripts">enabling <samp class="file">mktex</samp> scripts</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4923 <tr><td></td><td class="printindex-index-entry"><a href="#index-ENCFONTS"><code>ENCFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4924 <tr><td></td><td class="printindex-index-entry"><a href="#index-engine-name">engine name</a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
4925 <tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variable_002c-source-for-path">environment variable, source for path</a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
4926 <tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variables-for-TeX">environment variables for TeX</a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4927 <tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variables-in-paths">environment variables in paths</a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
4928 <tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variables_002c-old">environment variables, old</a></td><td class="printindex-index-section"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
4929 <tr><td></td><td class="printindex-index-entry"><a href="#index-epoch_002c-seconds-since">epoch, seconds since</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
4930 <tr><td></td><td class="printindex-index-entry"><a href="#index-error-message-macros">error message macros</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4931 <tr><td></td><td class="printindex-index-entry"><a href="#index-examples_002c-of-casefolding-searches">examples, of casefolding searches</a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
4932 <tr><td></td><td class="printindex-index-entry"><a href="#index-examples_002c-of-running-kpsewhich">examples, of running <code class="code">kpsewhich</code></a></td><td class="printindex-index-section"><a href="#kpsewhich-examples">kpsewhich examples</a></td></tr>
4933 <tr><td></td><td class="printindex-index-entry"><a href="#index-excessive-startup-time">excessive startup time</a></td><td class="printindex-index-section"><a href="#Slow-path-searching">Slow path searching</a></td></tr>
4934 <tr><td></td><td class="printindex-index-entry"><a href="#index-expand_002ec"><code>expand.c</code></a></td><td class="printindex-index-section"><a href="#Brace-expansion">Brace expansion</a></td></tr>
4935 <tr><td></td><td class="printindex-index-entry"><a href="#index-expanding-symlinks">expanding symlinks</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
4936 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-default">expansion, default</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
4937 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-path-element">expansion, path element</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4938 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-search-path">expansion, search path</a></td><td class="printindex-index-section"><a href="#Path-expansion">Path expansion</a></td></tr>
4939 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-subdirectory">expansion, subdirectory</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
4940 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-tilde">expansion, tilde</a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
4941 <tr><td></td><td class="printindex-index-entry"><a href="#index-expansion_002c-variable">expansion, variable</a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
4942 <tr><td></td><td class="printindex-index-entry"><a href="#index-explicitly-relative-filenames">explicitly relative filenames</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4943 <tr><td></td><td class="printindex-index-entry"><a href="#index-extensions_002c-filename">extensions, filename</a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
4944 <tr><td></td><td class="printindex-index-entry"><a href="#index-externally_002dbuilt-filename-database">externally-built filename database</a></td><td class="printindex-index-section"><a href="#Filename-database">Filename database</a></td></tr>
4945 <tr><td></td><td class="printindex-index-entry"><a href="#index-extra-colons">extra colons</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
4946 <tr><td colspan="3"><hr></td></tr>
4947 <tr><th id="Index_cp_letter-F">F</th></tr>
4948 <tr><td></td><td class="printindex-index-entry"><a href="#index-failed-mktex_002e_002e_002e-script-invocation">failed <code class="code">mktex&hellip;</code> script invocation</a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
4949 <tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-font">fallback font</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4950 <tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-resolutions">fallback resolutions</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4951 <tr><td></td><td class="printindex-index-entry"><a href="#index-FAQ_002c-Kpathsea">FAQ, Kpathsea</a></td><td class="printindex-index-section"><a href="#Common-problems">Common problems</a></td></tr>
4952 <tr><td></td><td class="printindex-index-entry"><a href="#index-Farwell_002c-Matthew">Farwell, Matthew</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
4953 <tr><td></td><td class="printindex-index-entry"><a href="#index-file-formats_002c-supported">file formats, supported</a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4954 <tr><td></td><td class="printindex-index-entry"><a href="#index-file-lookup">file lookup</a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
4955 <tr><td></td><td class="printindex-index-entry"><a href="#index-file-permissions">file permissions</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
4956 <tr><td></td><td class="printindex-index-entry"><a href="#index-file-types_002c-registering-new">file types, registering new</a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
4957 <tr><td></td><td class="printindex-index-entry"><a href="#index-filename-aliases">filename aliases</a></td><td class="printindex-index-section"><a href="#Filename-aliases">Filename aliases</a></td></tr>
4958 <tr><td></td><td class="printindex-index-entry"><a href="#index-filename-database">filename database</a></td><td class="printindex-index-section"><a href="#Filename-database">Filename database</a></td></tr>
4959 <tr><td></td><td class="printindex-index-entry"><a href="#index-filenames_002c-absolute-or-explicitly-relative">filenames, absolute or explicitly relative</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4960 <tr><td></td><td class="printindex-index-entry"><a href="#index-files_002c-unable-to-find">files, unable to find</a></td><td class="printindex-index-section"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
4961 <tr><td></td><td class="printindex-index-entry"><a href="#index-filesystem-search">filesystem search</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4962 <tr><td></td><td class="printindex-index-entry"><a href="#index-filesystem_002c-case_002d_0028in_0029sensitive">filesystem, case-(in)sensitive</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
4963 <tr><td></td><td class="printindex-index-entry"><a href="#index-Findutils_002c-GNU-package">Findutils, GNU package</a></td><td class="printindex-index-section"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
4964 <tr><td></td><td class="printindex-index-entry"><a href="#index-floating-directories">floating directories</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
4965 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmtutil"><code>fmtutil</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
4966 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmtutil_002ecnf"><code>fmtutil.cnf</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
4967 <tr><td></td><td class="printindex-index-entry"><a href="#index-fmtutils_002ecnf"><code>fmtutils.cnf</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4968 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-alias-files">font alias files</a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
4969 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-generation-failures">font generation failures</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
4970 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-of-last-resort">font of last resort</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
4971 <tr><td></td><td class="printindex-index-entry"><a href="#index-font-set_002c-infinite">font set, infinite</a></td><td class="printindex-index-section"><a href="#mktex-scripts">mktex scripts</a></td></tr>
4972 <tr><td></td><td class="printindex-index-entry"><a href="#index-FONTCIDMAPS"><code>FONTCIDMAPS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4973 <tr><td></td><td class="printindex-index-entry"><a href="#index-FONTFEATURES"><code>FONTFEATURES</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4974 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontmap-files">fontmap files</a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
4975 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontmaps-1"><code>fontmaps</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4976 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontmaps">fontmaps</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4977 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontname">fontname</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
4978 <tr><td></td><td class="printindex-index-entry"><a href="#index-fontnames_002c-arbitrary-length">fontnames, arbitrary length</a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
4979 <tr><td></td><td class="printindex-index-entry"><a href="#index-FOOINPUTS"><code>FOOINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4980 <tr><td></td><td class="printindex-index-entry"><a href="#index-FOOINPUTS-1"><code>FOOINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4981 <tr><td></td><td class="printindex-index-entry"><a href="#index-fopen_002c-redefined"><code>fopen<span class="r">, redefined</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
4982 <tr><td></td><td class="printindex-index-entry"><a href="#index-format-of-external-database">format of external database</a></td><td class="printindex-index-section"><a href="#Database-format">Database format</a></td></tr>
4983 <tr><td></td><td class="printindex-index-entry"><a href="#index-ftp_002ecs_002estanford_002eedu"><code>ftp.cs.stanford.edu</code></a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
4984 <tr><td></td><td class="printindex-index-entry"><a href="#index-ftp_002etug_002eorg"><code>ftp.tug.org</code></a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
4985 <tr><td></td><td class="printindex-index-entry"><a href="#index-fundamental-purpose-of-Kpathsea">fundamental purpose of Kpathsea</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
4986 <tr><td colspan="3"><hr></td></tr>
4987 <tr><th id="Index_cp_letter-G">G</th></tr>
4988 <tr><td></td><td class="printindex-index-entry"><a href="#index-gdb_002c-recommended"><code>gdb<span class="r">, recommended</span></code></a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
4989 <tr><td></td><td class="printindex-index-entry"><a href="#index-gf"><code>gf</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4990 <tr><td></td><td class="printindex-index-entry"><a href="#index-GFFONTS"><code>GFFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4991 <tr><td></td><td class="printindex-index-entry"><a href="#index-globally-writable-directories">globally writable directories</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
4992 <tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-lookup">glyph lookup</a></td><td class="printindex-index-section"><a href="#Glyph-lookup">Glyph lookup</a></td></tr>
4993 <tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-lookup-bitmap-tolerance">glyph lookup bitmap tolerance</a></td><td class="printindex-index-section"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr>
4994 <tr><td></td><td class="printindex-index-entry"><a href="#index-GLYPHFONTS"><code>GLYPHFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4995 <tr><td></td><td class="printindex-index-entry"><a href="#index-GLYPHFONTS-1"><code>GLYPHFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
4996 <tr><td></td><td class="printindex-index-entry"><a href="#index-glyphlist_002etxt"><code>glyphlist.txt</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
4997 <tr><td></td><td class="printindex-index-entry"><a href="#index-GNU-C-compiler-bugs">GNU C compiler bugs</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
4998 <tr><td></td><td class="printindex-index-entry"><a href="#index-GNU-General-Public-License">GNU General Public License</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
4999 <tr><td></td><td class="printindex-index-entry"><a href="#index-group_002dwritable-directories">group-writable directories</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
5000 <tr><td></td><td class="printindex-index-entry"><a href="#index-GSFTOPK_005fDEBUG-_0028128_0029"><code>GSFTOPK_DEBUG <span class="r">(128)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5001 <tr><td colspan="3"><hr></td></tr>
5002 <tr><th id="Index_cp_letter-H">H</th></tr>
5003 <tr><td></td><td class="printindex-index-entry"><a href="#index-hash-table-buckets_002c-printing">hash table buckets, printing</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5004 <tr><td></td><td class="printindex-index-entry"><a href="#index-hash-table-routines">hash table routines</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5005 <tr><td></td><td class="printindex-index-entry"><a href="#index-hash_005fsummary_005fonly-variable-for-debugging"><code>hash_summary_only <span class="r">variable for debugging</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5006 <tr><td></td><td class="printindex-index-entry"><a href="#index-history-of-Kpathsea">history of Kpathsea</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5007 <tr><td></td><td class="printindex-index-entry"><a href="#index-Hoekwater_002c-Taco">Hoekwater, Taco</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5008 <tr><td></td><td class="printindex-index-entry"><a href="#index-home-directories-in-paths">home directories in paths</a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5009 <tr><td></td><td class="printindex-index-entry"><a href="#index-HOME_002c-as-_007e-expansion"><code>HOME<span class="r">, as ~ expansion</span></code></a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5010 <tr><td colspan="3"><hr></td></tr>
5011 <tr><th id="Index_cp_letter-I">I</th></tr>
5012 <tr><td></td><td class="printindex-index-entry"><a href="#index-identifiers_002c-characters-valid-in">identifiers, characters valid in</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5013 <tr><td></td><td class="printindex-index-entry"><a href="#index-include-fontmap-directive"><code>include <span class="r">fontmap directive</span></code></a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
5014 <tr><td></td><td class="printindex-index-entry"><a href="#index-INDEXSTYLE"><code>INDEXSTYLE</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5015 <tr><td></td><td class="printindex-index-entry"><a href="#index-input-lines_002c-reading">input lines, reading</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5016 <tr><td></td><td class="printindex-index-entry"><a href="#index-interactive-query">interactive query</a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
5017 <tr><td></td><td class="printindex-index-entry"><a href="#index-interface_002c-not-frozen">interface, not frozen</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5018 <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>
5019 <tr><td colspan="3"><hr></td></tr>
5020 <tr><th id="Index_cp_letter-K">K</th></tr>
5021 <tr><td></td><td class="printindex-index-entry"><a href="#index-kdebug_003a">&lsquo;<samp class="samp">kdebug:</samp>&rsquo;</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5022 <tr><td></td><td class="printindex-index-entry"><a href="#index-kdefault_002ec"><code>kdefault.c</code></a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
5023 <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="#History">History</a></td></tr>
5024 <tr><td></td><td class="printindex-index-entry"><a href="#index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by">Knuth, Donald E., archive of programs by</a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5025 <tr><td></td><td class="printindex-index-entry"><a href="#index-Kpathsea-config-file_002c-source-for-path">Kpathsea config file, source for path</a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
5026 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fcnf_005fget"><code>kpathsea_cnf_get</code></a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
5027 <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="#Calling-sequence">Calling sequence</a></td></tr>
5028 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPATHSEA_005fDEBUG-1"><code>KPATHSEA_DEBUG</code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5029 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005ffind_005ffile"><code>kpathsea_find_file</code></a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
5030 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005ffind_005ffile-1"><code>kpathsea_find_file</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5031 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005ffind_005fglyph"><code>kpathsea_find_glyph</code></a></td><td class="printindex-index-section"><a href="#Glyph-lookup">Glyph lookup</a></td></tr>
5032 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005ffind_005fglyph-1"><code>kpathsea_find_glyph</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5033 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005ffinish"><code>kpathsea_finish</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5034 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fin_005fname_005fok"><code>kpathsea_in_name_ok</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5035 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fin_005fname_005fok_005fextended"><code>kpathsea_in_name_ok_extended</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5036 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fin_005fname_005fok_005fsilent"><code>kpathsea_in_name_ok_silent</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5037 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fin_005fname_005fok_005fsilent_005fextended"><code>kpathsea_in_name_ok_silent_extended</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5038 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005finit_005fprog"><code>kpathsea_init_prog</code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
5039 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005finit_005fprog-1"><code>kpathsea_init_prog</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5040 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fnew"><code>kpathsea_new</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5041 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fopen_005ffile"><code>kpathsea_open_file</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5042 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fout_005fname_005fok"><code>kpathsea_out_name_ok</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5043 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fout_005fname_005fok_005fextended"><code>kpathsea_out_name_ok_extended</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5044 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fout_005fname_005fok_005fsilent"><code>kpathsea_out_name_ok_silent</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5045 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fout_005fname_005fok_005fsilent_005fextended"><code>kpathsea_out_name_ok_silent_extended</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5046 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fset_005fprogram_005fname"><code>kpathsea_set_program_name</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5047 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_005fvar_005fvalue"><code>kpathsea_var_value</code></a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
5048 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPATHSEA_005fWARNING"><code>KPATHSEA_WARNING</code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5049 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpathsea_002eh"><code>kpathsea.h</code></a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5050 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse-mode-of-LuaTeX">kpse mode of LuaTeX</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
5051 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fBITMAP_005fTOLERANCE"><code>KPSE_BITMAP_TOLERANCE</code></a></td><td class="printindex-index-section"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr>
5052 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"><code>KPSE_DEBUG_EXPAND <span class="r">(16)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5053 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"><code>KPSE_DEBUG_FOPEN <span class="r">(4)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5054 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fHASH-_00282_0029"><code>KPSE_DEBUG_HASH <span class="r">(2)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5055 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fPATHS-_00288_0029"><code>KPSE_DEBUG_PATHS <span class="r">(8)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5056 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"><code>KPSE_DEBUG_SEARCH <span class="r">(32)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5057 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fSTAT-_00281_0029"><code>KPSE_DEBUG_STAT <span class="r">(1)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5058 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDEBUG_005fVARS-_002864_0029"><code>KPSE_DEBUG_VARS <span class="r">(64)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5059 <tr><td></td><td class="printindex-index-entry"><a href="#index-KPSE_005fDOT-expansion"><code>KPSE_DOT <span class="r">expansion</span></code></a></td><td class="printindex-index-section"><a href="#KPSE_005fDOT-expansion">KPSE_DOT expansion</a></td></tr>
5060 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_005fformat_005finfo_005ftype"><code>kpse_format_info_type</code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5061 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003edebug"><code>kpse-&gt;debug</code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5062 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003edebug-1"><code>kpse-&gt;debug</code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5063 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003edebug-variable"><code>kpse-&gt;debug <span class="r">variable</span></code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5064 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003eformat_005finfo"><code>kpse-&gt;format_info</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5065 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003einvocation_005fname"><code>kpse-&gt;invocation_name</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5066 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003einvocation_005fshort_005fname"><code>kpse-&gt;invocation_short_name</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5067 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpse_002d_003eprogram_005fname"><code>kpse-&gt;program_name</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5068 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpsewhich"><code>kpsewhich</code></a></td><td class="printindex-index-section"><a href="#Invoking-kpsewhich">Invoking kpsewhich</a></td></tr>
5069 <tr><td></td><td class="printindex-index-entry"><a href="#index-kpsewhich-examples"><code class="code">kpsewhich</code> examples</a></td><td class="printindex-index-section"><a href="#kpsewhich-examples">kpsewhich examples</a></td></tr>
5070 <tr><td></td><td class="printindex-index-entry"><a href="#index-Kpsewhich_002c-and-debugging">Kpsewhich, and debugging</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5071 <tr><td colspan="3"><hr></td></tr>
5072 <tr><th id="Index_cp_letter-L">L</th></tr>
5073 <tr><td></td><td class="printindex-index-entry"><a href="#index-last_002dresort-font">last-resort font</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
5074 <tr><td></td><td class="printindex-index-entry"><a href="#index-lcircle10"><code>lcircle10</code></a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
5075 <tr><td></td><td class="printindex-index-entry"><a href="#index-leading-colons">leading colons</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
5076 <tr><td></td><td class="printindex-index-entry"><a href="#index-leaf-directories-wrongly-guessed">leaf directories wrongly guessed</a></td><td class="printindex-index-section"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
5077 <tr><td></td><td class="printindex-index-entry"><a href="#index-leaf-directory-trick">leaf directory trick</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
5078 <tr><td></td><td class="printindex-index-entry"><a href="#index-license-for-using-the-library">license for using the library</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5079 <tr><td></td><td class="printindex-index-entry"><a href="#index-LIGFONTS"><code>LIGFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5080 <tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-reading-arbitrary_002dlength">lines, reading arbitrary-length</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5081 <tr><td></td><td class="printindex-index-entry"><a href="#index-Linux-File-System-Standard">Linux File System Standard</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5082 <tr><td></td><td class="printindex-index-entry"><a href="#index-local-cache-of-fonts">local cache of fonts</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
5083 <tr><td></td><td class="printindex-index-entry"><a href="#index-log-file">log file</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5084 <tr><td></td><td class="printindex-index-entry"><a href="#index-logging-successful-searches">logging successful searches</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5085 <tr><td></td><td class="printindex-index-entry"><a href="#index-lost_002bfound-directory"><code>lost+found <span class="r">directory</span></code></a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5086 <tr><td></td><td class="printindex-index-entry"><a href="#index-lostchar"><code>lostchar</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5087 <tr><td></td><td class="printindex-index-entry"><a href="#index-ls_002dR"><code>ls-R</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5088 <tr><td></td><td class="printindex-index-entry"><a href="#index-ls_002dR-database-file"><code>ls-R <span class="r">database file</span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5089 <tr><td></td><td class="printindex-index-entry"><a href="#index-ls_002dR_002c-simplest-build"><code>ls-R<span class="r">, simplest build</span></code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5090 <tr><td></td><td class="printindex-index-entry"><a href="#index-LUAINPUTS"><code>LUAINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5091 <tr><td></td><td class="printindex-index-entry"><a href="#index-luaotfload"><code>luaotfload</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5092 <tr><td></td><td class="printindex-index-entry"><a href="#index-LuaTeX-and-security">LuaTeX and security</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
5093 <tr><td colspan="3"><hr></td></tr>
5094 <tr><th id="Index_cp_letter-M">M</th></tr>
5095 <tr><td></td><td class="printindex-index-entry"><a href="#index-Mac-filesystem_002c-case_002dinsensitive">Mac filesystem, case-insensitive</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
5096 <tr><td></td><td class="printindex-index-entry"><a href="#index-MacKenzie_002c-David">MacKenzie, David</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5097 <tr><td></td><td class="printindex-index-entry"><a href="#index-MacKenzie_002c-David-1">MacKenzie, David</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
5098 <tr><td></td><td class="printindex-index-entry"><a href="#index-magic-characters">magic characters</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5099 <tr><td></td><td class="printindex-index-entry"><a href="#index-mailing-lists">mailing lists</a></td><td class="printindex-index-section"><a href="#Mailing-lists">Mailing lists</a></td></tr>
5100 <tr><td></td><td class="printindex-index-entry"><a href="#index-MAKETEX_005fDEBUG-_0028512_0029"><code>MAKETEX_DEBUG <span class="r">(512)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5101 <tr><td></td><td class="printindex-index-entry"><a href="#index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"><code>MAKETEX_FINE_DEBUG <span class="r">(1024)</span></code></a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5102 <tr><td></td><td class="printindex-index-entry"><a href="#index-memory-allocation-routines">memory allocation routines</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5103 <tr><td></td><td class="printindex-index-entry"><a href="#index-metafont-driver-files">metafont driver files</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5104 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-failures">Metafont failures</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
5105 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-installation">Metafont installation</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5106 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-making-too_002dlarge-fonts">Metafont making too-large fonts</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5107 <tr><td></td><td class="printindex-index-entry"><a href="#index-Metafont-using-the-wrong-device">Metafont using the wrong device</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5108 <tr><td></td><td class="printindex-index-entry"><a href="#index-MFBASES"><code>MFBASES</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5109 <tr><td></td><td class="printindex-index-entry"><a href="#index-MFINPUTS"><code>MFINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5110 <tr><td></td><td class="printindex-index-entry"><a href="#index-MFPOOL"><code>MFPOOL</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5111 <tr><td></td><td class="printindex-index-entry"><a href="#index-MFTINPUTS"><code>MFTINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5112 <tr><td></td><td class="printindex-index-entry"><a href="#index-MISCFONTS"><code>MISCFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5113 <tr><td></td><td class="printindex-index-entry"><a href="#index-mismatched-checksum-warnings">mismatched checksum warnings</a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5114 <tr><td></td><td class="printindex-index-entry"><a href="#index-MISSFONT_005fLOG"><code>MISSFONT_LOG</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5115 <tr><td></td><td class="printindex-index-entry"><a href="#index-missfont_002elog"><code>missfont.log</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5116 <tr><td></td><td class="printindex-index-entry"><a href="#index-missing-character-warnings">missing character warnings</a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5117 <tr><td></td><td class="printindex-index-entry"><a href="#index-mkocp"><code>mkocp</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5118 <tr><td></td><td class="printindex-index-entry"><a href="#index-mkofm"><code>mkofm</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5119 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex-script-configuration"><samp class="file">mktex</samp> script configuration</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5120 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex-script-names"><samp class="file">mktex</samp> script names</a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5121 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex-scripts"><samp class="file">mktex</samp> scripts</a></td><td class="printindex-index-section"><a href="#mktex-scripts">mktex scripts</a></td></tr>
5122 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex_002ecnf"><code>mktex.cnf</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5123 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex_002ecnf-1"><code>mktex.cnf</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5124 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex_002eopt"><code>mktex.opt</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5125 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktex_002eopt-1"><code>mktex.opt</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5126 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktexdir"><code>mktexdir</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5127 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktexfmt"><code>mktexfmt</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5128 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktexmf"><code>mktexmf</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5129 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk"><code>mktexpk</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5130 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktexpk-can_0027t-guess-mode"><code class="code">mktexpk</code> can&rsquo;t guess mode</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5131 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktextex"><code>mktextex</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5132 <tr><td></td><td class="printindex-index-entry"><a href="#index-mktextfm"><code>mktextfm</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5133 <tr><td></td><td class="printindex-index-entry"><a href="#index-MLBIBINPUTS"><code>MLBIBINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5134 <tr><td></td><td class="printindex-index-entry"><a href="#index-MLBSTINPUTS"><code>MLBSTINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5135 <tr><td></td><td class="printindex-index-entry"><a href="#index-mode-directory_002c-omitting">mode directory, omitting</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5136 <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="#History">History</a></td></tr>
5137 <tr><td></td><td class="printindex-index-entry"><a href="#index-MPINPUTS"><code>MPINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5138 <tr><td></td><td class="printindex-index-entry"><a href="#index-MPMEMS"><code>MPMEMS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5139 <tr><td></td><td class="printindex-index-entry"><a href="#index-MPPOOL"><code>MPPOOL</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5140 <tr><td></td><td class="printindex-index-entry"><a href="#index-MPSUPPORT"><code>MPSUPPORT</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5141 <tr><td></td><td class="printindex-index-entry"><a href="#index-MT_005fFEATURES"><code>MT_FEATURES</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5142 <tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-TeX-hierarchies">multiple TeX hierarchies</a></td><td class="printindex-index-section"><a href="#Brace-expansion">Brace expansion</a></td></tr>
5143 <tr><td></td><td class="printindex-index-entry"><a href="#index-must-exist">must exist</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5144 <tr><td colspan="3"><hr></td></tr>
5145 <tr><th id="Index_cp_letter-N">N</th></tr>
5146 <tr><td></td><td class="printindex-index-entry"><a href="#index-names-for-mktex-scripts">names for <samp class="file">mktex</samp> scripts</a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5147 <tr><td></td><td class="printindex-index-entry"><a href="#index-Neumann_002c-Gustaf">Neumann, Gustaf</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5148 <tr><td></td><td class="printindex-index-entry"><a href="#index-NFS-and-ls_002dR">NFS and <samp class="file">ls-R</samp></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5149 <tr><td></td><td class="printindex-index-entry"><a href="#index-nomfdrivers"><code>nomfdrivers</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5150 <tr><td></td><td class="printindex-index-entry"><a href="#index-nomode"><code>nomode</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5151 <tr><td></td><td class="printindex-index-entry"><a href="#index-none"><code>none</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5152 <tr><td></td><td class="printindex-index-entry"><a href="#index-null-pointers_002c-dereferencing">null pointers, dereferencing</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
5153 <tr><td></td><td class="printindex-index-entry"><a href="#index-numeric-debugging-values">numeric debugging values</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5154 <tr><td colspan="3"><hr></td></tr>
5155 <tr><th id="Index_cp_letter-O">O</th></tr>
5156 <tr><td></td><td class="printindex-index-entry"><a href="#index-obtaining-TeX">obtaining TeX</a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5157 <tr><td></td><td class="printindex-index-entry"><a href="#index-OCPINPUTS"><code>OCPINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5158 <tr><td></td><td class="printindex-index-entry"><a href="#index-OFMFONTS"><code>OFMFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5159 <tr><td></td><td class="printindex-index-entry"><a href="#index-online-Metafont-display_002c-spurious">online Metafont display, spurious</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5160 <tr><td></td><td class="printindex-index-entry"><a href="#index-openin_005fany"><code>openin_any</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5161 <tr><td></td><td class="printindex-index-entry"><a href="#index-openout_005fany"><code>openout_any</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5162 <tr><td></td><td class="printindex-index-entry"><a href="#index-OPENTYPEFONTS"><code>OPENTYPEFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5163 <tr><td></td><td class="printindex-index-entry"><a href="#index-optimization-caveat">optimization caveat</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
5164 <tr><td></td><td class="printindex-index-entry"><a href="#index-options-for-debugging">options for debugging</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5165 <tr><td></td><td class="printindex-index-entry"><a href="#index-OTPINPUTS"><code>OTPINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5166 <tr><td></td><td class="printindex-index-entry"><a href="#index-overview-of-path-searching">overview of path searching</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5167 <tr><td></td><td class="printindex-index-entry"><a href="#index-overview-of-programming-with-Kpathsea">overview of programming with Kpathsea</a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5168 <tr><td></td><td class="printindex-index-entry"><a href="#index-OVFFONTS"><code>OVFFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5169 <tr><td></td><td class="printindex-index-entry"><a href="#index-OVPFONTS"><code>OVPFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5170 <tr><td colspan="3"><hr></td></tr>
5171 <tr><th id="Index_cp_letter-P">P</th></tr>
5172 <tr><td></td><td class="printindex-index-entry"><a href="#index-paranoid-mode_002c-for-output-files">paranoid mode, for output files</a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5173 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-expansion">path expansion</a></td><td class="printindex-index-section"><a href="#Path-expansion">Path expansion</a></td></tr>
5174 <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>
5175 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-searching-options">path searching options</a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
5176 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-searching_002c-overview">path searching, overview</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5177 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-searching_002c-standalone">path searching, standalone</a></td><td class="printindex-index-section"><a href="#Invoking-kpsewhich">Invoking kpsewhich</a></td></tr>
5178 <tr><td></td><td class="printindex-index-entry"><a href="#index-path-sources">path sources</a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
5179 <tr><td></td><td class="printindex-index-entry"><a href="#index-pathsearch_002eh"><code>pathsearch.h</code></a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5180 <tr><td></td><td class="printindex-index-entry"><a href="#index-pc-Pascal-compiler"><code>pc <span class="r">Pascal compiler</span></code></a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5181 <tr><td></td><td class="printindex-index-entry"><a href="#index-pdfglyphlist_002etxt"><code>pdfglyphlist.txt</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5182 <tr><td></td><td class="printindex-index-entry"><a href="#index-pdftex_002ecfg"><code>pdftex.cfg</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5183 <tr><td></td><td class="printindex-index-entry"><a href="#index-PDFTEXCONFIG"><code>PDFTEXCONFIG</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5184 <tr><td></td><td class="printindex-index-entry"><a href="#index-pdftexconfig_002etex"><code>pdftexconfig.tex</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5185 <tr><td></td><td class="printindex-index-entry"><a href="#index-permission-denied">permission denied</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5186 <tr><td></td><td class="printindex-index-entry"><a href="#index-permissions_002c-directory">permissions, directory</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
5187 <tr><td></td><td class="printindex-index-entry"><a href="#index-permissions_002c-file">permissions, file</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
5188 <tr><td></td><td class="printindex-index-entry"><a href="#index-PKFONTS"><code>PKFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5189 <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="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5190 <tr><td></td><td class="printindex-index-entry"><a href="#index-privacy_002c-semblance-of">privacy, semblance of</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5191 <tr><td></td><td class="printindex-index-entry"><a href="#index-problems_002c-common">problems, common</a></td><td class="printindex-index-section"><a href="#Common-problems">Common problems</a></td></tr>
5192 <tr><td></td><td class="printindex-index-entry"><a href="#index-proginit_002eh"><code>proginit.h</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5193 <tr><td></td><td class="printindex-index-entry"><a href="#index-program_002dvarying-paths">program-varying paths</a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5194 <tr><td></td><td class="printindex-index-entry"><a href="#index-programming-overview">programming overview</a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5195 <tr><td></td><td class="printindex-index-entry"><a href="#index-programming-with-config-files">programming with config files</a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
5196 <tr><td></td><td class="printindex-index-entry"><a href="#index-programming-with-Kpathsea">programming with Kpathsea</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5197 <tr><td></td><td class="printindex-index-entry"><a href="#index-programs-using-the-library">programs using the library</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5198 <tr><td></td><td class="printindex-index-entry"><a href="#index-proof-mode">proof mode</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5199 <tr><td></td><td class="printindex-index-entry"><a href="#index-PSHEADERS"><code>PSHEADERS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5200 <tr><td></td><td class="printindex-index-entry"><a href="#index-pxp-Pascal-preprocessor"><code>pxp <span class="r">Pascal preprocessor</span></code></a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5201 <tr><td colspan="3"><hr></td></tr>
5202 <tr><th id="Index_cp_letter-Q">Q</th></tr>
5203 <tr><td></td><td class="printindex-index-entry"><a href="#index-quoting-variable-values">quoting variable values</a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
5204 <tr><td colspan="3"><hr></td></tr>
5205 <tr><th id="Index_cp_letter-R">R</th></tr>
5206 <tr><td></td><td class="printindex-index-entry"><a href="#index-rationale-for-casefolding-fallback">rationale for casefolding fallback</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
5207 <tr><td></td><td class="printindex-index-entry"><a href="#index-re_002dentrant-API">re-entrant API</a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5208 <tr><td></td><td class="printindex-index-entry"><a href="#index-readable"><code>readable</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5209 <tr><td></td><td class="printindex-index-entry"><a href="#index-reading-arbitrary_002dlength-lines">reading arbitrary-length lines</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5210 <tr><td></td><td class="printindex-index-entry"><a href="#index-recording-successful-searches">recording successful searches</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5211 <tr><td></td><td class="printindex-index-entry"><a href="#index-relative-filenames">relative filenames</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5212 <tr><td></td><td class="printindex-index-entry"><a href="#index-reporting-bugs">reporting bugs</a></td><td class="printindex-index-section"><a href="#Reporting-bugs">Reporting bugs</a></td></tr>
5213 <tr><td></td><td class="printindex-index-entry"><a href="#index-resident_002ec"><code>resident.c</code></a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5214 <tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-setting">resolution, setting</a></td><td class="printindex-index-section"><a href="#Path-searching-options">Path searching options</a></td></tr>
5215 <tr><td></td><td class="printindex-index-entry"><a href="#index-resolutions_002c-last_002dresort">resolutions, last-resort</a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
5216 <tr><td></td><td class="printindex-index-entry"><a href="#index-restricted-mode_002c-for-output-files">restricted mode, for output files</a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5217 <tr><td></td><td class="printindex-index-entry"><a href="#index-retrieving-TeX">retrieving TeX</a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5218 <tr><td></td><td class="printindex-index-entry"><a href="#index-right_002dhand-side-of-variable-assignments">right-hand side of variable assignments</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5219 <tr><td></td><td class="printindex-index-entry"><a href="#index-RISINPUTS"><code>RISINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5220 <tr><td></td><td class="printindex-index-entry"><a href="#index-Rokicki_002c-Tom">Rokicki, Tom</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5221 <tr><td></td><td class="printindex-index-entry"><a href="#index-root-user"><code class="t">root</code> user</a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5222 <tr><td></td><td class="printindex-index-entry"><a href="#index-runtime-configuration-files">runtime configuration files</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5223 <tr><td></td><td class="printindex-index-entry"><a href="#index-runtime-debugging">runtime debugging</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5224 <tr><td colspan="3"><hr></td></tr>
5225 <tr><th id="Index_cp_letter-S">S</th></tr>
5226 <tr><td></td><td class="printindex-index-entry"><a href="#index-Sauter-fonts_002c-and-dynamic-source-creation">Sauter fonts, and dynamic source creation</a></td><td class="printindex-index-section"><a href="#mktex-scripts">mktex scripts</a></td></tr>
5227 <tr><td></td><td class="printindex-index-entry"><a href="#index-scripts-for-file-creation">scripts for file creation</a></td><td class="printindex-index-section"><a href="#mktex-scripts">mktex scripts</a></td></tr>
5228 <tr><td></td><td class="printindex-index-entry"><a href="#index-search-path_002c-defined">search path, defined</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5229 <tr><td></td><td class="printindex-index-entry"><a href="#index-search_002c-case_002dinsensitive">search, case-insensitive</a></td><td class="printindex-index-section"><a href="#Casefolding-search">Casefolding search</a></td></tr>
5230 <tr><td></td><td class="printindex-index-entry"><a href="#index-searching-for-files">searching for files</a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
5231 <tr><td></td><td class="printindex-index-entry"><a href="#index-searching-for-glyphs">searching for glyphs</a></td><td class="printindex-index-section"><a href="#Glyph-lookup">Glyph lookup</a></td></tr>
5232 <tr><td></td><td class="printindex-index-entry"><a href="#index-searching-overview">searching overview</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5233 <tr><td></td><td class="printindex-index-entry"><a href="#index-searching-the-database">searching the database</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5234 <tr><td></td><td class="printindex-index-entry"><a href="#index-searching-the-disk">searching the disk</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5235 <tr><td></td><td class="printindex-index-entry"><a href="#index-security-considerations">security considerations</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
5236 <tr><td></td><td class="printindex-index-entry"><a href="#index-SELFAUTODIR">SELFAUTODIR</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5237 <tr><td></td><td class="printindex-index-entry"><a href="#index-SELFAUTOLOC">SELFAUTOLOC</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5238 <tr><td></td><td class="printindex-index-entry"><a href="#index-SELFAUTOPARENT">SELFAUTOPARENT</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5239 <tr><td></td><td class="printindex-index-entry"><a href="#index-sending-patches">sending patches</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
5240 <tr><td></td><td class="printindex-index-entry"><a href="#index-setgid-scripts">setgid scripts</a></td><td class="printindex-index-section"><a href="#Global-font-cache-and-security">Global font cache and security</a></td></tr>
5241 <tr><td></td><td class="printindex-index-entry"><a href="#index-SFDFONTS"><code>SFDFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5242 <tr><td></td><td class="printindex-index-entry"><a href="#index-shell-commands_002c-security">shell commands, security</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
5243 <tr><td></td><td class="printindex-index-entry"><a href="#index-shell-variables">shell variables</a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
5244 <tr><td></td><td class="printindex-index-entry"><a href="#index-shell_005fescape_002c-example-for-code"><code>shell_escape<span class="r">, example for code</span></code></a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
5245 <tr><td></td><td class="printindex-index-entry"><a href="#index-site-overrides-for-mktex_002e_002e_002e">site overrides for <code class="code">mktex&hellip;</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5246 <tr><td></td><td class="printindex-index-entry"><a href="#index-skeleton-TeX-directory">skeleton TeX directory</a></td><td class="printindex-index-section"><a href="#TeX-directory-structure">TeX directory structure</a></td></tr>
5247 <tr><td></td><td class="printindex-index-entry"><a href="#index-slow-startup-time">slow startup time</a></td><td class="printindex-index-section"><a href="#Slow-path-searching">Slow path searching</a></td></tr>
5248 <tr><td></td><td class="printindex-index-entry"><a href="#index-source-files"><code>source files</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5249 <tr><td></td><td class="printindex-index-entry"><a href="#index-sources-for-search-paths">sources for search paths</a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
5250 <tr><td></td><td class="printindex-index-entry"><a href="#index-special"><code>special</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5251 <tr><td></td><td class="printindex-index-entry"><a href="#index-st_005fnlink"><code>st_nlink</code></a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
5252 <tr><td></td><td class="printindex-index-entry"><a href="#index-stack-trace">stack trace</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
5253 <tr><td></td><td class="printindex-index-entry"><a href="#index-standalone-path-searching">standalone path searching</a></td><td class="printindex-index-section"><a href="#Invoking-kpsewhich">Invoking kpsewhich</a></td></tr>
5254 <tr><td></td><td class="printindex-index-entry"><a href="#index-standard-error-and-debugging-output">standard error and debugging output</a></td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
5255 <tr><td></td><td class="printindex-index-entry"><a href="#index-standard-options">standard options</a></td><td class="printindex-index-section"><a href="#Standard-options">Standard options</a></td></tr>
5256 <tr><td></td><td class="printindex-index-entry"><a href="#index-startup-time_002c-excessive">startup time, excessive</a></td><td class="printindex-index-section"><a href="#Slow-path-searching">Slow path searching</a></td></tr>
5257 <tr><td></td><td class="printindex-index-entry"><a href="#index-string-routines">string routines</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5258 <tr><td></td><td class="printindex-index-entry"><a href="#index-strip"><code>strip</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5259 <tr><td></td><td class="printindex-index-entry"><a href="#index-stripsupplier"><code>stripsupplier</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5260 <tr><td></td><td class="printindex-index-entry"><a href="#index-striptypeface"><code>striptypeface</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5261 <tr><td></td><td class="printindex-index-entry"><a href="#index-subdirectory-searching">subdirectory searching</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
5262 <tr><td></td><td class="printindex-index-entry"><a href="#index-suffixes_002c-filename">suffixes, filename</a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
5263 <tr><td></td><td class="printindex-index-entry"><a href="#index-suggestions_002c-making">suggestions, making</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5264 <tr><td></td><td class="printindex-index-entry"><a href="#index-Sun-2">Sun 2</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5265 <tr><td></td><td class="printindex-index-entry"><a href="#index-supplier-directory_002c-omitting">supplier directory, omitting</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5266 <tr><td></td><td class="printindex-index-entry"><a href="#index-supplier-directory_002c-omitting-1">supplier directory, omitting</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5267 <tr><td></td><td class="printindex-index-entry"><a href="#index-supported-file-formats">supported file formats</a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5268 <tr><td></td><td class="printindex-index-entry"><a href="#index-suppressing-warnings">suppressing warnings</a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5269 <tr><td></td><td class="printindex-index-entry"><a href="#index-symbolic-links-not-found">symbolic links not found</a></td><td class="printindex-index-section"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
5270 <tr><td></td><td class="printindex-index-entry"><a href="#index-symbolic-links_002c-and-ls_002dR">symbolic links, and <samp class="file">ls-R</samp></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5271 <tr><td></td><td class="printindex-index-entry"><a href="#index-symlinks_002c-resolving">symlinks, resolving</a></td><td class="printindex-index-section"><a href="#Calling-sequence">Calling sequence</a></td></tr>
5272 <tr><td></td><td class="printindex-index-entry"><a href="#index-system-C-compiler-bugs">system C compiler bugs</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
5273 <tr><td></td><td class="printindex-index-entry"><a href="#index-system_002ddependent-casefolding-behavior">system-dependent casefolding behavior</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
5274 <tr><td colspan="3"><hr></td></tr>
5275 <tr><th id="Index_cp_letter-T">T</th></tr>
5276 <tr><td></td><td class="printindex-index-entry"><a href="#index-T1FONTS"><code>T1FONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5277 <tr><td></td><td class="printindex-index-entry"><a href="#index-T1INPUTS"><code>T1INPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5278 <tr><td></td><td class="printindex-index-entry"><a href="#index-T42FONTS"><code>T42FONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5279 <tr><td></td><td class="printindex-index-entry"><a href="#index-tcfmgr_002emap"><code>tcfmgr.map</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5280 <tr><td></td><td class="printindex-index-entry"><a href="#index-TDS">TDS</a></td><td class="printindex-index-section"><a href="#TeX-directory-structure">TeX directory structure</a></td></tr>
5281 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-directory-structure">TeX directory structure</a></td><td class="printindex-index-section"><a href="#TeX-directory-structure">TeX directory structure</a></td></tr>
5282 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-environment-variables">TeX environment variables</a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5283 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-failures">TeX failures</a></td><td class="printindex-index-section"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
5284 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-file-lookup">TeX file lookup</a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
5285 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-glyph-lookup">TeX glyph lookup</a></td><td class="printindex-index-section"><a href="#Glyph-lookup">Glyph lookup</a></td></tr>
5286 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-support">TeX support</a></td><td class="printindex-index-section"><a href="#TeX-support">TeX support</a></td></tr>
5287 <tr><td></td><td class="printindex-index-entry"><a href="#index-TeX-Users-Group">TeX Users Group</a></td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
5288 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEX_005fHUSH"><code>TEX_HUSH</code></a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5289 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEX_005fHUSH-1"><code>TEX_HUSH</code></a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5290 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002dfile_002ec"><code>tex-file.c</code></a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
5291 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002dfile_002eh"><code>tex-file.h</code></a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5292 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002dglyph_002ec"><code>tex-glyph.c</code></a></td><td class="printindex-index-section"><a href="#Glyph-lookup">Glyph lookup</a></td></tr>
5293 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002dglyph_002eh"><code>tex-glyph.h</code></a></td><td class="printindex-index-section"><a href="#Programming-overview">Programming overview</a></td></tr>
5294 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002dk_0040tug_002eorg"><code>[email protected]</code></a></td><td class="printindex-index-section"><a href="#Mailing-lists">Mailing lists</a></td></tr>
5295 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002dk_0040tug_002eorg-_0028bug-address_0029"><code>[email protected] <span class="r">(bug address)</span></code></a></td><td class="printindex-index-section"><a href="#Reporting-bugs">Reporting bugs</a></td></tr>
5296 <tr><td></td><td class="printindex-index-entry"><a href="#index-tex_002eweb"><code>tex.web</code></a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5297 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXBIB"><code>TEXBIB</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5298 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXBIB-1"><code>TEXBIB</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5299 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXCONFIG"><code>TEXCONFIG</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5300 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXDOCS"><code>TEXDOCS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5301 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTMAPS"><code>TEXFONTMAPS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5302 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS"><code>TEXFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5303 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS-1"><code>TEXFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5304 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS-2"><code>TEXFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5305 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFONTS-3"><code>TEXFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5306 <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="#Fontmap">Fontmap</a></td></tr>
5307 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXFORMATS"><code>TEXFORMATS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5308 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXINDEXSTYLE"><code>TEXINDEXSTYLE</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5309 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXINPUTS"><code>TEXINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5310 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXINPUTS-1"><code>TEXINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5311 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMF"><code>TEXMF</code></a></td><td class="printindex-index-section"><a href="#TeX-directory-structure">TeX directory structure</a></td></tr>
5312 <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="#Casefolding-search">Casefolding search</a></td></tr>
5313 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMF_005fOUTPUT_005fDIRECTORY_002c-and-missfont_002elog"><code>TEXMF_OUTPUT_DIRECTORY<span class="r">, and <samp class="file">missfont.log</samp></span></code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5314 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMF_005fOUTPUT_005fDIRECTORY_002c-and-paranoid-output-files"><code>TEXMF_OUTPUT_DIRECTORY<span class="r">, and paranoid output files</span></code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5315 <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="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5316 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf-missing_002c-warning-about"><samp class="file">texmf.cnf</samp> missing, warning about</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5317 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf_002c-and-variable-expansion"><code>texmf.cnf<span class="r">, and variable expansion</span></code></a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
5318 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf_002c-definition-for"><code>texmf.cnf<span class="r">, definition for</span></code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5319 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmf_002ecnf_002c-source-for-path"><code>texmf.cnf<span class="r">, source for path</span></code></a></td><td class="printindex-index-section"><a href="#Path-sources">Path sources</a></td></tr>
5320 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFCNF"><code>TEXMFCNF</code></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5321 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFCNF-1"><code>TEXMFCNF</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5322 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFDBS"><code>TEXMFDBS</code></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5323 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFDBS-1"><code>TEXMFDBS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5324 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFINI"><code>TEXMFINI</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5325 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFINI-1"><code>TEXMFINI</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5326 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFINI-2"><code>TEXMFINI</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5327 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFLOG"><code>TEXMFLOG</code></a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5328 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFOUTPUT_002c-and-missfont_002elog"><code>TEXMFOUTPUT<span class="r">, and <samp class="file">missfont.log</samp></span></code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5329 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFOUTPUT_002c-and-paranoid-output-files"><code>TEXMFOUTPUT<span class="r">, and paranoid output files</span></code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5330 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFSCRIPTS"><code>TEXMFSCRIPTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5331 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFSYSVAR"><code>TEXMFSYSVAR</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5332 <tr><td></td><td class="printindex-index-entry"><a href="#index-texmfvar"><code>texmfvar</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5333 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFVAR"><code>TEXMFVAR</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5334 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXMFVAR-1"><code>TEXMFVAR</code></a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5335 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPICTS"><code>TEXPICTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5336 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPKS"><code>TEXPKS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5337 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPOOL"><code>TEXPOOL</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5338 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPSHEADERS"><code>TEXPSHEADERS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5339 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXPSHEADERS-1"><code>TEXPSHEADERS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5340 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXSIZES"><code>TEXSIZES</code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
5341 <tr><td></td><td class="printindex-index-entry"><a href="#index-TEXSOURCES"><code>TEXSOURCES</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5342 <tr><td></td><td class="printindex-index-entry"><a href="#index-TFMFONTS"><code>TFMFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5343 <tr><td></td><td class="printindex-index-entry"><a href="#index-tilde-expansion">tilde expansion</a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5344 <tr><td></td><td class="printindex-index-entry"><a href="#index-tilde_002ec"><code>tilde.c</code></a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5345 <tr><td></td><td class="printindex-index-entry"><a href="#index-time-system-call"><code>time <span class="r">system call</span></code></a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5346 <tr><td></td><td class="printindex-index-entry"><a href="#index-tolerance-for-glyph-lookup">tolerance for glyph lookup</a></td><td class="printindex-index-section"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr>
5347 <tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-_002f-in-home-directory">trailing &lsquo;<samp class="samp">/</samp>&rsquo; in home directory</a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5348 <tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-colons">trailing colons</a></td><td class="printindex-index-section"><a href="#Default-expansion">Default expansion</a></td></tr>
5349 <tr><td></td><td class="printindex-index-entry"><a href="#index-translations_002c-of-path-searching-description">translations, of path searching description</a></td><td class="printindex-index-section"><a href="#Path-searching">Path searching</a></td></tr>
5350 <tr><td></td><td class="printindex-index-entry"><a href="#index-TRFONTS"><code>TRFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5351 <tr><td></td><td class="printindex-index-entry"><a href="#index-trick-for-detecting-leaf-directories">trick for detecting leaf directories</a></td><td class="printindex-index-section"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
5352 <tr><td></td><td class="printindex-index-entry"><a href="#index-trojan-horse">trojan horse</a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5353 <tr><td></td><td class="printindex-index-entry"><a href="#index-trojan-horse-attack">trojan horse attack</a></td><td class="printindex-index-section"><a href="#Security">Security</a></td></tr>
5354 <tr><td></td><td class="printindex-index-entry"><a href="#index-try_005fstd_005fextension_005ffirst"><code>try_std_extension_first</code></a></td><td class="printindex-index-section"><a href="#File-lookup">File lookup</a></td></tr>
5355 <tr><td></td><td class="printindex-index-entry"><a href="#index-TTFONTS"><code>TTFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5356 <tr><td></td><td class="printindex-index-entry"><a href="#index-tug_002eorg"><code>tug.org</code></a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5357 <tr><td></td><td class="printindex-index-entry"><a href="#index-typeface-directory_002c-omitting">typeface directory, omitting</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5358 <tr><td></td><td class="printindex-index-entry"><a href="#index-typeface-directory_002c-omitting-1">typeface directory, omitting</a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5359 <tr><td colspan="3"><hr></td></tr>
5360 <tr><th id="Index_cp_letter-U">U</th></tr>
5361 <tr><td></td><td class="printindex-index-entry"><a href="#index-unable-to-find-files">unable to find files</a></td><td class="printindex-index-section"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
5362 <tr><td></td><td class="printindex-index-entry"><a href="#index-unable-to-generate-fonts">unable to generate fonts</a></td><td class="printindex-index-section"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
5363 <tr><td></td><td class="printindex-index-entry"><a href="#index-uname"><code>uname</code></a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
5364 <tr><td></td><td class="printindex-index-entry"><a href="#index-unixtex_002eftp"><code>unixtex.ftp</code></a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5365 <tr><td></td><td class="printindex-index-entry"><a href="#index-unknown-special-warnings">unknown special warnings</a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5366 <tr><td></td><td class="printindex-index-entry"><a href="#index-unreadable-file-warnings">unreadable file warnings</a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5367 <tr><td></td><td class="printindex-index-entry"><a href="#index-unreadable-files">unreadable files</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5368 <tr><td></td><td class="printindex-index-entry"><a href="#index-unrestricted-mode_002c-for-output-files">unrestricted mode, for output files</a></td><td class="printindex-index-section"><a href="#Safe-filenames">Safe filenames</a></td></tr>
5369 <tr><td></td><td class="printindex-index-entry"><a href="#index-unusable-ls_002dR-warning">unusable <samp class="file">ls-R</samp> warning</a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5370 <tr><td></td><td class="printindex-index-entry"><a href="#index-usage-patterns_002c-finding">usage patterns, finding</a></td><td class="printindex-index-section"><a href="#Logging">Logging</a></td></tr>
5371 <tr><td></td><td class="printindex-index-entry"><a href="#index-USE_005fTEXMFVAR"><code>USE_TEXMFVAR</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5372 <tr><td></td><td class="printindex-index-entry"><a href="#index-USE_005fVARTEXFONTS"><code>USE_VARTEXFONTS</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5373 <tr><td></td><td class="printindex-index-entry"><a href="#index-USERPROFILE_002c-as-_007e-expansion"><code>USERPROFILE<span class="r">, as ~ expansion</span></code></a></td><td class="printindex-index-section"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
5374 <tr><td colspan="3"><hr></td></tr>
5375 <tr><th id="Index_cp_letter-V">V</th></tr>
5376 <tr><td></td><td class="printindex-index-entry"><a href="#index-varfonts"><code>varfonts</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5377 <tr><td></td><td class="printindex-index-entry"><a href="#index-variable-expansion">variable expansion</a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
5378 <tr><td></td><td class="printindex-index-entry"><a href="#index-variable_002ec"><code>variable.c</code></a></td><td class="printindex-index-section"><a href="#Variable-expansion">Variable expansion</a></td></tr>
5379 <tr><td></td><td class="printindex-index-entry"><a href="#index-variable_002eh"><code>variable.h</code></a></td><td class="printindex-index-section"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
5380 <tr><td></td><td class="printindex-index-entry"><a href="#index-VARTEXFONTS"><code>VARTEXFONTS</code></a></td><td class="printindex-index-section"><a href="#mktex-configuration">mktex configuration</a></td></tr>
5381 <tr><td></td><td class="printindex-index-entry"><a href="#index-VAX-11_002f750">VAX 11/750</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5382 <tr><td></td><td class="printindex-index-entry"><a href="#index-version-numbers_002c-determining">version numbers, determining</a></td><td class="printindex-index-section"><a href="#Bug-checklist">Bug checklist</a></td></tr>
5383 <tr><td></td><td class="printindex-index-entry"><a href="#index-VF-files_002c-not-found">VF files, not found</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5384 <tr><td></td><td class="printindex-index-entry"><a href="#index-VFFONTS"><code>VFFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5385 <tr><td></td><td class="printindex-index-entry"><a href="#index-Vojta_002c-Paul">Vojta, Paul</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5386 <tr><td colspan="3"><hr></td></tr>
5387 <tr><th id="Index_cp_letter-W">W</th></tr>
5388 <tr><td></td><td class="printindex-index-entry"><a href="#index-Walsh_002c-Norman">Walsh, Norman</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5389 <tr><td></td><td class="printindex-index-entry"><a href="#index-warning-about-unusable-ls_002dR">warning about unusable <samp class="file">ls-R</samp></a></td><td class="printindex-index-section"><a href="#ls_002dR">ls-R</a></td></tr>
5390 <tr><td></td><td class="printindex-index-entry"><a href="#index-warning_002c-about-missing-texmf_002ecnf">warning, about missing <samp class="file">texmf.cnf</samp></a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5391 <tr><td></td><td class="printindex-index-entry"><a href="#index-warnings_002c-file-access">warnings, file access</a></td><td class="printindex-index-section"><a href="#Searching-overview">Searching overview</a></td></tr>
5392 <tr><td></td><td class="printindex-index-entry"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a></td><td class="printindex-index-section"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
5393 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEB2C"><code>WEB2C</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5394 <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="#History">History</a></td></tr>
5395 <tr><td></td><td class="printindex-index-entry"><a href="#index-WEBINPUTS"><code>WEBINPUTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5396 <tr><td></td><td class="printindex-index-entry"><a href="#index-whitespace_002c-in-fontmap-files">whitespace, in fontmap files</a></td><td class="printindex-index-section"><a href="#Fontmap">Fontmap</a></td></tr>
5397 <tr><td></td><td class="printindex-index-entry"><a href="#index-whitespace_002c-not-ignored-on-continuation-lines">whitespace, not ignored on continuation lines</a></td><td class="printindex-index-section"><a href="#Config-files">Config files</a></td></tr>
5398 <tr><td></td><td class="printindex-index-entry"><a href="#index-Windows-and-casefolding">Windows and casefolding</a></td><td class="printindex-index-section"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
5399 <tr><td></td><td class="printindex-index-entry"><a href="#index-www_002etug_002eorg"><code>www.tug.org</code></a></td><td class="printindex-index-section"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
5400 <tr><td colspan="3"><hr></td></tr>
5401 <tr><th id="Index_cp_letter-X">X</th></tr>
5402 <tr><td></td><td class="printindex-index-entry"><a href="#index-XDvi"><code>XDvi</code></a></td><td class="printindex-index-section"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
5403 <tr><td></td><td class="printindex-index-entry"><a href="#index-XDVIFONTS"><code>XDVIFONTS</code></a></td><td class="printindex-index-section"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
5404 <tr><td></td><td class="printindex-index-entry"><a href="#index-XDVIMAKEPK"><code>XDVIMAKEPK</code></a></td><td class="printindex-index-section"><a href="#mktex-script-names">mktex script names</a></td></tr>
5405 <tr><td></td><td class="printindex-index-entry"><a href="#index-XDVISIZES"><code>XDVISIZES</code></a></td><td class="printindex-index-section"><a href="#Fallback-font">Fallback font</a></td></tr>
5406 <tr><td colspan="3"><hr></td></tr>
5407 <tr><th id="Index_cp_letter-Z">Z</th></tr>
5408 <tr><td></td><td class="printindex-index-entry"><a href="#index-zuhn_002c-david">zuhn, david</a></td><td class="printindex-index-section"><a href="#History">History</a></td></tr>
5409 <tr><td colspan="3"><hr></td></tr>
5410 </table>
5411 <table class="cp-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a>
5412 &nbsp;
5413 <a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>;</b></a>
5414 &nbsp;
5415 <a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>:</b></a>
5416 &nbsp;
5417 <a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>!</b></a>
5418 &nbsp;
5419 <a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>.</b></a>
5420 &nbsp;
5421 <a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>{</b></a>
5422 &nbsp;
5423 <a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>/</b></a>
5424 &nbsp;
5425 <a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>\</b></a>
5426 &nbsp;
5427 <a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>=</b></a>
5428 &nbsp;
5429 <a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>~</b></a>
5430 &nbsp;
5431 <a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>$</b></a>
5432 &nbsp;
5433 <a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>2</b></a>
5434 &nbsp;
5435 <a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a>
5436 &nbsp;
5437 <br>
5438 <a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a>
5439 &nbsp;
5440 <a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a>
5441 &nbsp;
5442 <a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a>
5443 &nbsp;
5444 <a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a>
5445 &nbsp;
5446 <a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a>
5447 &nbsp;
5448 <a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a>
5449 &nbsp;
5450 <a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a>
5451 &nbsp;
5452 <a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a>
5453 &nbsp;
5454 <a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a>
5455 &nbsp;
5456 <a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a>
5457 &nbsp;
5458 <a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a>
5459 &nbsp;
5460 <a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a>
5461 &nbsp;
5462 <a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a>
5463 &nbsp;
5464 <a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a>
5465 &nbsp;
5466 <a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a>
5467 &nbsp;
5468 <a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a>
5469 &nbsp;
5470 <a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a>
5471 &nbsp;
5472 <a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a>
5473 &nbsp;
5474 <a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a>
5475 &nbsp;
5476 <a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a>
5477 &nbsp;
5478 <a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a>
5479 &nbsp;
5480 <a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a>
5481 &nbsp;
5482 <a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a>
5483 &nbsp;
5484 <a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a>
5485 &nbsp;
5486 </td></tr></table>
5487 </div>
5488
5489 </div>
5490 </div>
5491
5492
5493
5494 </body>
5495 </html>