| 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> [<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"> ¶</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> [<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"> ¶</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’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 ‘<samp class="samp">dvilj</samp>’ 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 ‘<samp class="samp">xdvi</samp>’ 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 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’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> [<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"> ¶</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 “Errors of |
| 261 |
TeX” 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’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’t stand putting |
| 287 |
everything in one big directory, and also couldn’t stand having to |
| 288 |
explicitly specify <samp class="file">cm</samp>, <samp class="file">pandora</samp>, … 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—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’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—there was no Dvipsk or Xdvik or Dviljk at |
| 300 |
this point). After a while, I finally started sharing source files. |
| 301 |
They weren’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’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’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’s help, |
| 323 |
implemented a way for TeX to get at all those neat builtin LJ4 fonts |
| 324 |
… 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’t completely obliterated Unix by then, |
| 332 |
or that software patents haven’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’s another |
| 335 |
story…) |
| 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’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> [<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"> ¶</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’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> [<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"> ¶</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’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 ‘<samp class="samp">-R</samp>’ 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 “kpse” 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’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> [<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"> ¶</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’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’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’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…</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…</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> [<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"> ¶</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., ‘<samp class="samp">xampl.bib</samp>’)</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., ‘<samp class="samp">plain.bst</samp>’, ‘<samp class="samp">acm.bst</samp>’)</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">‘<samp class="samp">.pro</samp>’, ‘<samp class="samp">.ps</samp>’, ‘<samp class="samp">psfonts.map</samp>’</span> |
| 585 |
fonts/ <span class="r">font-related files</span> |
| 586 |
<var class="var">type</var>/ <span class="r">file type (e.g., ‘<samp class="samp">tfm</samp>’, ‘<samp class="samp">pk</samp>’)</span> |
| 587 |
<var class="var">mode</var>/ <span class="r">type of output device (types ‘<samp class="samp">pk</samp>’ and ‘<samp class="samp">gf</samp>’ only)</span> |
| 588 |
<var class="var">supplier</var>/ <span class="r">name of a font supplier (e.g., ‘<samp class="samp">public</samp>’)</span> |
| 589 |
<var class="var">typeface</var>/ <span class="r">name of a typeface (e.g., ‘<samp class="samp">cm</samp>’)</span> |
| 590 |
dpi<var class="var">nnn</var>/ <span class="r">font resolution (types ‘<samp class="samp">pk</samp>’ and ‘<samp class="samp">gf</samp>’ only)</span> |
| 591 |
metafont/ <span class="r">Metafont (non-font) input files</span> |
| 592 |
base/ <span class="r">base distribution (e.g., ‘<samp class="samp">plain.mf</samp>’)</span> |
| 593 |
misc/ <span class="r">single-file packages (e.g., ‘<samp class="samp">modes.mf</samp>’)</span> |
| 594 |
<var class="var">pkg</var>/ <span class="r">name of a package (e.g., ‘<samp class="samp">mfpic</samp>’)</span> |
| 595 |
metapost/ <span class="r">MetaPost input files</span> |
| 596 |
base/ <span class="r">base distribution (e.g., ‘<samp class="samp">plain.mp</samp>’)</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., ‘<samp class="samp">trfonts.map</samp>’)</span> |
| 600 |
mft/ <span class="r">‘<samp class="samp">MFT</samp>’ inputs (e.g., ‘<samp class="samp">plain.mft</samp>’)</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., ‘<samp class="samp">plain</samp>’)</span> |
| 603 |
base/ <span class="r">base distribution for <var class="var">format</var> (e.g., ‘<samp class="samp">plain.tex</samp>’)</span> |
| 604 |
misc/ <span class="r">single-file packages (e.g., ‘<samp class="samp">webmac.tex</samp>’)</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., ‘<samp class="samp">graphics</samp>’, ‘<samp class="samp">mfnfss</samp>’)</span> |
| 607 |
generic/ <span class="r">format-independent packages</span> |
| 608 |
hyphen/ <span class="r">hyphenation patterns (e.g., ‘<samp class="samp">hyphen.tex</samp>’)</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., ‘<samp class="samp">null.tex</samp>’).</span> |
| 611 |
<var class="var">pkg</var>/ <span class="r">name of a package (e.g., ‘<samp class="samp">babel</samp>’)</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> [<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"> ¶</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 |
…) 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> [<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"> ¶</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 |
‘<samp class="samp">foo</samp>’ along a path ‘<samp class="samp">.:/dir</samp>’, 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 “colon” and “slash” mentioned here aren’t necessarily ‘<samp class="samp">:</samp>’ |
| 692 |
and ‘<samp class="samp">/</samp>’ on non-Unix systems. Kpathsea tries to adapt to other |
| 693 |
operating systems’ 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 ‘<samp class="samp">!!</samp>’ 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 “file must exist” condition comes into play with VF files and |
| 720 |
input files read by the TeX ‘<samp class="samp">\openin</samp>’ 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 ‘<samp class="samp">./FooBar.TeX</samp>’ will match a file ‘<samp class="samp">./foobar.tex</samp>’, |
| 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’ 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 ‘<samp class="samp">/</samp>’ or ‘<samp class="samp">./</samp>’ |
| 754 |
or ‘<samp class="samp">../</samp>’, 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 ‘<samp class="samp">readable</samp>’ 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> [<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"> ¶</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 ‘<samp class="samp">latex</samp>’. |
| 800 |
</p> |
| 801 |
</li><li> A program-specific configuration file, e.g., an ‘<samp class="samp">S /a:/b</samp>’ line in |
| 802 |
Dvips’ <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 |
‘<samp class="samp">TEXINPUTS=/c:/d</samp>’ (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> [<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"> ¶</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 ‘<samp class="samp">.:$TEXMF</samp>’, 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’t want |
| 855 |
to see this warning, set the environment variable |
| 856 |
<code class="env">KPATHSEA_WARNING</code> to the single character ‘<samp class="samp">0</samp>’ (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 ‘<samp class="samp">%</samp>’ or ‘<samp class="samp">#</samp>’, 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 “middle” |
| 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 "a%b" |
| 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 ‘<samp class="samp">\</samp>’ 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 ‘<samp class="samp">=</samp>’ 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 |
‘<samp class="samp">=</samp>’, or ‘<samp class="samp">.</samp>’, but sticking to ‘<samp class="samp">A-Za-z_</samp>’ is safest. |
| 897 |
|
| 898 |
</li><li><a class="index-entry-id" id="index-_002eprogname-qualifier-in-texmf_002ecnf"></a> |
| 899 |
If ‘<samp class="samp">.<var class="var">progname</var></samp>’ 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 ‘<samp class="samp">$<var class="var">var</var>.<var class="var">prog</var></samp>’ 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 ‘<samp class="samp">;</samp>’ in <var class="var">value</var> is translated to ‘<samp class="samp">:</samp>’ 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 ‘<samp class="samp">;</samp>’ 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 ‘<samp class="samp">=</samp>’ for the assignment has |
| 945 |
an unexpected consequence: if the value begins with a literal ‘<samp class="samp">.</samp>’ |
| 946 |
and the ‘<samp class="samp">=</samp>’ 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 |
‘<samp class="samp">;/some/path</samp>’. 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, …) and so cannot be concisely stated, |
| 957 |
unfortunately. There is no general escape mechanism; in particular, |
| 958 |
‘<samp class="samp">\</samp>’ is not an “escape character” 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> [<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"> ¶</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 |
‘<samp class="samp">~$USER/{foo,bar}//baz</samp>’ expands to all subdirectories under |
| 982 |
directories <samp class="file">foo</samp> and <samp class="file">bar</samp> in <code class="t">$USER</code>’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> [<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"> ¶</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 “formats” (search |
| 1039 |
paths), and not directly on environment variables. Example, showing |
| 1040 |
the trailing ‘<samp class="samp">:</samp>’ 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’ 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’t happen. It’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 ‘<samp class="samp">:</samp>’ and leaves |
| 1061 |
any others in place (they will eventually be ignored). Kpathsea checks |
| 1062 |
first for a leading ‘<samp class="samp">:</samp>’, then a trailing ‘<samp class="samp">:</samp>’, then a doubled |
| 1063 |
‘<samp class="samp">:</samp>’. |
| 1064 |
</p> |
| 1065 |
<a class="index-entry-id" id="index-kdefault_002ec"></a> |
| 1066 |
<p>You can trace this by debugging “paths” (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> [<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"> ¶</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>‘<samp class="samp">$foo</samp>’ or ‘<samp class="samp">${foo}</samp>’ in a path element is replaced by (1) the |
| 1087 |
value of an environment variable ‘<samp class="samp">foo</samp>’ (if defined); (2) the value |
| 1088 |
of ‘<samp class="samp">foo</samp>’ from <samp class="file">texmf.cnf</samp> (if defined); (3) the empty string. |
| 1089 |
</p> |
| 1090 |
<p>If the character after the ‘<samp class="samp">$</samp>’ is alphanumeric or ‘<samp class="samp">_</samp>’, the |
| 1091 |
variable name consists of all consecutive such characters. If the |
| 1092 |
character after the ‘<samp class="samp">$</samp>’ is a ‘<samp class="samp">{</samp>’, the variable name consists |
| 1093 |
of everything up to the next ‘<samp class="samp">}</samp>’ (braces may not be nested around |
| 1094 |
variable names). Otherwise, Kpathsea gives a warning and ignores the |
| 1095 |
‘<samp class="samp">$</samp>’ 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>’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 ‘<samp class="samp">.<var class="var">progname</var></samp>’ suffix on variables and |
| 1115 |
‘<samp class="samp">_<var class="var">progname</var></samp>’ 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> [<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"> ¶</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 ‘<samp class="samp">~</samp>’ 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 ‘<samp class="samp">~<var class="var">user</var></samp>’ in a path element is replaced by |
| 1146 |
<var class="var">user</var>’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 ‘<samp class="samp">/</samp>’, the trailing |
| 1160 |
slash is dropped, to avoid inadvertently creating a ‘<samp class="samp">//</samp>’ construct |
| 1161 |
in the path. For example, if the home directory of the user ‘<samp class="samp">root</samp>’ |
| 1162 |
is ‘<samp class="samp">/</samp>’, the path element ‘<samp class="samp">~root/mymacros</samp>’ expands to just |
| 1163 |
‘<samp class="samp">/mymacros</samp>’, not ‘<samp class="samp">//mymacros</samp>’. |
| 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> [<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"> ¶</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>‘<samp class="samp">x{<var class="var">a</var>,<var class="var">b</var>}y</samp>’ expands to ‘<samp class="samp">x<var class="var">a</var>y:x<var class="var">b</var>y</samp>’. |
| 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 ‘<samp class="samp">foo/1/baz:foo/2/baz</samp>’. ‘<samp class="samp">:</samp>’ is the path |
| 1189 |
separator on the current system; e.g., on a Windows system, it’s ‘<samp class="samp">;</samp>’. |
| 1190 |
</p> |
| 1191 |
<p>Braces can be nested; for example, ‘<samp class="samp">x{A,B{1,2}}y</samp>’ expands to |
| 1192 |
‘<samp class="samp">xAy:xB1y:xB2y</samp>’. |
| 1193 |
</p> |
| 1194 |
<p>Multiple non-nested braces are expanded from right to left; for example, |
| 1195 |
‘<samp class="samp">x{A,B}{1,2}y</samp>’ expands to ‘<samp class="samp">x{A,B}1y:x{A,B}2y</samp>’, which |
| 1196 |
expands to ‘<samp class="samp">xA1y:xB1y:xA2y:xB2y</samp>’. |
| 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 ‘<samp class="samp">x{A:B}{1:2}y</samp>’ (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> [<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"> ¶</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 |
‘<samp class="samp">mktex…</samp>’ 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> [<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"> ¶</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’s “directory order”, and definitely not |
| 1249 |
alphabetical.) |
| 1250 |
</p> |
| 1251 |
<p>If you specify any filename components after the ‘<samp class="samp">//</samp>’, only |
| 1252 |
subdirectories which match those components are included. For example, |
| 1253 |
‘<samp class="samp">/a//b</samp>’ 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 ‘<samp class="samp">//</samp>’ constructs in the path. |
| 1257 |
</p> |
| 1258 |
<p>‘<samp class="samp">//</samp>’ 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 |
‘<samp class="samp">stat</samp>’ structure will be two. Thus, we don’t have to stat |
| 1275 |
everything in the bottom-level (leaf) directories—we can just check |
| 1276 |
<code class="code">st_nlink</code>, notice it’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) 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) 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>’d anyway: if the path specification is, say, |
| 1301 |
‘<samp class="samp">$TEXMF/fonts//pk//</samp>’, then files in a subdirectory |
| 1302 |
‘<samp class="samp">…/pk</samp>’, 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 ‘<samp class="samp">may descend</samp>’) 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> [<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"> ¶</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., ‘<samp class="samp">1</samp>’; 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> [<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"> ¶</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’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—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> [<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"> ¶</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’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 ‘<samp class="samp">0</samp>’ |
| 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>—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 ‘<samp class="samp">.:/somedir</samp>’, 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 (‘<samp class="samp">kpsewhich --all</samp>’) <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 ‘<samp class="samp">stix-regular.otf</samp>’ 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 ‘<samp class="samp">!!</samp>’ |
| 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 ‘<samp class="samp">texmf-local</samp>’ and |
| 1456 |
‘<samp class="samp">texmf-dist</samp>’ 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, ‘<samp class="samp">kpsewhich --all</samp>’ 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 >/tmp/texpath # search path specification |
| 1470 |
kpsewhich -expand-path="`cat /tmp/texpath`" >/tmp/texdirs # all dirs |
| 1471 |
tr ':' '\n' </tmp/texdirs >/tmp/texdirlist # colons to newlines |
| 1472 |
find `cat /tmp/texdirlist` -iname somefile.tex -print </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’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’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> [<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"> ¶</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> [<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"> ¶</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>—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 ‘<samp class="samp">ls-R</samp>’ is to run the |
| 1562 |
<code class="code">mktexlsr</code> script, which is installed in ‘<samp class="samp">$(bindir)</samp>’ |
| 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’s also invoked by the |
| 1565 |
distributed ‘<samp class="samp">mktex…</samp>’ 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> && ls -LAR ./ >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’t been aliased in a system file |
| 1578 |
(e.g., <samp class="file">/etc/profile</samp>) to something problematic, e.g., ‘<samp class="samp">ls |
| 1579 |
--color=tty</samp>’. 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 ‘<samp class="samp">-A</samp>’ option to <code class="code">ls</code> includes files beginning with ‘<samp class="samp">.</samp>’ |
| 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 ‘<samp class="samp">.</samp>’ 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 ‘<samp class="samp">-L</samp>’. |
| 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 |
‘<samp class="samp">./</samp>’ 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 |
‘<samp class="samp">ls -R</samp>’ instead of ‘<samp class="samp">ls -LR ./</samp>’ or ‘<samp class="samp">ls -R |
| 1616 |
<var class="var">/your/texmf/root</var></samp>’. Another possibility is some system directory |
| 1617 |
name starting with a ‘<samp class="samp">.</samp>’ (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 ‘<samp class="samp">!!</samp>’, <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 ‘<samp class="samp">!!</samp>’. |
| 1626 |
</p> |
| 1627 |
<p>For path elements that do not begin with ‘<samp class="samp">!!</samp>’, 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 ‘<samp class="samp">!!</samp>’ 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> [<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"> ¶</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’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’t be found. You need to give the actual file |
| 1662 |
<samp class="file">longtable.sty</samp> an alias ‘<samp class="samp">longtabl.sty</samp>’. |
| 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 ‘<samp class="samp">%</samp>’ or ‘<samp class="samp">#</samp>’ 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> [<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"> ¶</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 “database” 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 ‘<samp class="samp">-R</samp>’ 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 ‘<samp class="samp">/</samp>’ or ‘<samp class="samp">./</samp>’ or ‘<samp class="samp">../</samp>’ and ends with |
| 1702 |
a colon, it’s the name of a directory. (‘<samp class="samp">../</samp>’ lines aren’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>’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’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> [<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"> ¶</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 ‘<samp class="samp">mktex…</samp>’ 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 ‘<samp class="samp">-</samp>’ or ‘<samp class="samp">--</samp>’, 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> [<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"> ¶</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> [<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"> ¶</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>‘<samp class="samp">--all</samp>’<a class="copiable-link" href="#index-_002d_002dall"> ¶</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’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>‘<samp class="samp">--casefold-search</samp>’<a class="copiable-link" href="#index-_002d_002dcasefold_002dsearch"> ¶</a></span></dt> |
| 1848 |
<dt>‘<samp class="samp">--no-casefold-search</samp>’</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>‘<samp class="samp">--cnf-line=<var class="var">str</var></samp>’<a class="copiable-link" href="#index-_002d_002dcnf_002dline"> ¶</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 ‘<samp class="samp">--cnf-line</samp>’ 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>‘<samp class="samp">--dpi=<var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002d_002ddpi_003dnum"> ¶</a></span></dt> |
| 1882 |
<dd><p>Set the resolution to <var class="var">num</var>; this only affects ‘<samp class="samp">gf</samp>’ and |
| 1883 |
‘<samp class="samp">pk</samp>’ lookups. ‘<samp class="samp">-D</samp>’ 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>‘<samp class="samp">--engine=<var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002d_002dengine_003dname"> ¶</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 ‘<samp class="samp">--engine=/</samp>’ to look for any dump file, regardless of |
| 1901 |
engine; if a dump file exists for more than one engine, it’s |
| 1902 |
indeterminate which one is returned. (The ‘<samp class="samp">/</samp>’ ends up specifying |
| 1903 |
a normal recursive search along the path where the dumps are stored, |
| 1904 |
namely ‘<samp class="samp">$TEXMF/web2c{/$engine,}</samp>’.) |
| 1905 |
</p> |
| 1906 |
</dd> |
| 1907 |
<dt><a id="index-_002d_002dformat_003dname"></a><span>‘<samp class="samp">--format=<var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002d_002dformat_003dname"> ¶</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 ‘<samp class="samp">tex</samp>’ being used if nothing else |
| 1910 |
fits. The recognized filename extensions (including any leading |
| 1911 |
‘<samp class="samp">.</samp>’) 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 ‘<samp class="samp">--format="dvips config"</samp>’. (The quotes are for the |
| 1916 |
sake of the shell.) |
| 1917 |
</p> |
| 1918 |
<p>Here’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 ‘<samp class="samp">--path</samp>’ 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>‘<samp class="samp">--interactive</samp>’<a class="copiable-link" href="#index-_002d_002dinteractive"> ¶</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>‘<samp class="samp">--mktex=<var class="var">filetype</var></samp>’<a class="copiable-link" href="#index-_002d_002dmktex_003dfiletype"> ¶</a></span></dt> |
| 1999 |
<dt>‘<samp class="samp">--no-mktex=<var class="var">filetype</var></samp>’</dt> |
| 2000 |
<dd><p>Turn on or off the ‘<samp class="samp">mktex</samp>’ script associated with <var class="var">filetype</var>. |
| 2001 |
Usual values for <var class="var">filetype</var> are ‘<samp class="samp">pk</samp>’, ‘<samp class="samp">mf</samp>’, ‘<samp class="samp">tex</samp>’, |
| 2002 |
and ‘<samp class="samp">tfm</samp>’. 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>‘<samp class="samp">--mode=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002d_002dmode_003dstring"> ¶</a></span></dt> |
| 2008 |
<dd><p>Set the mode name to <var class="var">string</var>; this also only affects ‘<samp class="samp">gf</samp>’ and |
| 2009 |
‘<samp class="samp">pk</samp>’ 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>‘<samp class="samp">--must-exist</samp>’<a class="copiable-link" href="#index-_002d_002dmust_002dexist"> ¶</a></span></dt> |
| 2013 |
<dd><p>Do everything possible to find the files, notably including searching |
| 2014 |
the disk and running the ‘<samp class="samp">mktex</samp>’ 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>‘<samp class="samp">--path=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002d_002dpath_003dstring"> ¶</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. ‘<samp class="samp">//</samp>’ and all the |
| 2021 |
usual expansions are supported (see <a class="pxref" href="#Path-expansion">Path expansion</a>). This option |
| 2022 |
and ‘<samp class="samp">--format</samp>’ are mutually exclusive. To output the complete |
| 2023 |
directory expansion of a path, instead of doing a one-shot lookup, see |
| 2024 |
‘<samp class="samp">--expand-path</samp>’ and ‘<samp class="samp">--show-path</samp>’ in the following section. |
| 2025 |
</p> |
| 2026 |
</dd> |
| 2027 |
<dt><a id="index-_002d_002dprogname_003dname"></a><span>‘<samp class="samp">--progname=<var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002d_002dprogname_003dname"> ¶</a></span></dt> |
| 2028 |
<dd><p>Set the program name to <var class="var">name</var>; default is ‘<samp class="samp">kpsewhich</samp>’. This |
| 2029 |
can affect the search paths via the ‘<samp class="samp">.<var class="var">prognam</var></samp>’ 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>‘<samp class="samp">--subdir=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002d_002dsubdir_003dstring"> ¶</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 |
⇒ /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 |
⇒ /some/where/foo.sty |
| 2051 |
|
| 2052 |
kpsewhich --subdir=place foo.sty |
| 2053 |
⇒ /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 |
⇒ |
| 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 |
⇒ /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 ‘<samp class="samp">where</samp>’ |
| 2073 |
and ‘<samp class="samp">place</samp>’ end in ‘<samp class="samp">e</samp>’): |
| 2074 |
</p> |
| 2075 |
<div class="example"> |
| 2076 |
<pre class="example-preformatted">kpsewhich --subdir=e |
| 2077 |
⇒ /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 ‘<samp class="samp">/</samp>’ is |
| 2082 |
important, since it “anchors” the match to a full component name: |
| 2083 |
</p> |
| 2084 |
<div class="example"> |
| 2085 |
<pre class="example-preformatted">kpsewhich --subdir=/lace foo.sty |
| 2086 |
⇒ |
| 2087 |
</pre></div> |
| 2088 |
|
| 2089 |
<p>However, a trailing ‘<samp class="samp">/</samp>’ 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 |
⇒ /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, ‘<samp class="samp">--subdir=/pkg1</samp>’, 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’t want to match |
| 2106 |
<samp class="file">texmf-dist/scripts/pkg2/</samp> that when searching for ‘<samp class="samp">/pkg1</samp>’. |
| 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> [<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"> ¶</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 ‘known’ 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’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"> ¶</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"> ¶</a></span></dt> |
| 2137 |
<dd><p>‘<samp class="samp">other text files</samp>’ |
| 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"> ¶</a></span></dt> |
| 2141 |
<dd><p>‘<samp class="samp">web2c files</samp>’ |
| 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"> ¶</a></span></dt> |
| 2145 |
<dd><p>‘<samp class="samp">map</samp>’ |
| 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"> ¶</a></span></dt> |
| 2149 |
<dd><p>‘<samp class="samp">web2c files</samp>’ |
| 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"> ¶</a></span></dt> |
| 2153 |
<dd><p>‘<samp class="samp">map</samp>’ |
| 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"> ¶</a></span></dt> |
| 2158 |
<dd><p>‘<samp class="samp">pdftex config</samp>’ (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"> ¶</a></span></dt> |
| 2163 |
<dd><p>‘<samp class="samp">cnf</samp>’ |
| 2164 |
</p> |
| 2165 |
</dd> |
| 2166 |
<dt><a id="index-XDvi"></a><span><samp class="file">XDvi</samp><a class="copiable-link" href="#index-XDvi"> ¶</a></span></dt> |
| 2167 |
<dd><p>‘<samp class="samp">other text files</samp>’ |
| 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’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> [<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"> ¶</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>‘<samp class="samp">--debug=<var class="var">num</var></samp>’<a class="copiable-link" href="#index-_002d_002ddebug_003dnum"> ¶</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>‘<samp class="samp">--expand-braces=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002d_002dexpand_002dbraces_003dstring"> ¶</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>‘<samp class="samp">--expand-path=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002d_002dexpand_002dpath_003dstring"> ¶</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 (‘<samp class="samp">;</samp>’ |
| 2207 |
on Windows, ‘<samp class="samp">:</samp>’ 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 |
‘<samp class="samp">--show-path</samp>’. |
| 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 |
⇒ /tmp |
| 2217 |
$ kpsewhich --expand-path '/nonesuch' |
| 2218 |
⇒ |
| 2219 |
</pre></div> |
| 2220 |
|
| 2221 |
<p>For one-shot uses of an arbitrary (not built in to Kpathsea) path, see |
| 2222 |
‘<samp class="samp">--path</samp>’ (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>‘<samp class="samp">--expand-var=<var class="var">string</var></samp>’<a class="copiable-link" href="#index-_002d_002dexpand_002dvar_003dstring"> ¶</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>, ‘<samp class="samp">kpsewhich |
| 2228 |
--expand-var='$TEXMF'</samp>’ 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>‘<samp class="samp">--help-formats</samp>’<a class="copiable-link" href="#index-_002d_002dhelp_002dformats"> ¶</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>‘<samp class="samp">--safe-extended-in-name=<var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002d_002dsafe_002dextended_002din_002dname_003dname"> ¶</a></span></dt> |
| 2241 |
<dt>‘<samp class="samp">--safe-extended-out-name=<var class="var">name</var></samp>’</dt> |
| 2242 |
<dd><p>As with ‘<samp class="samp">--safe-in-name</samp>’ and ‘<samp class="samp">--safe-out-name</samp>’ (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>‘<samp class="samp">--safe-in-name=<var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002d_002dsafe_002din_002dname_003dname"> ¶</a></span></dt> |
| 2249 |
<dt>‘<samp class="samp">--safe-out-name=<var class="var">name</var></samp>’</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>‘<samp class="samp">--show-path=<var class="var">name</var></samp>’<a class="copiable-link" href="#index-_002d_002dshow_002dpath_003dname"> ¶</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 (‘<samp class="samp">pk</samp>’, ‘<samp class="samp">.vf</samp>’, etc.) |
| 2259 |
or an integer can be used, just as with ‘<samp class="samp">--format</samp>’, described in |
| 2260 |
the previous section. |
| 2261 |
</p> |
| 2262 |
</dd> |
| 2263 |
<dt><a id="index-_002d_002dvar_002dbrace_002dvalue_003dvariable"></a><span>‘<samp class="samp">--var-brace-value=<var class="var">variable</var></samp>’<a class="copiable-link" href="#index-_002d_002dvar_002dbrace_002dvalue_003dvariable"> ¶</a></span></dt> |
| 2264 |
<dd><p>Like ‘<samp class="samp">--var-value</samp>’ (next), but also expands ‘<samp class="samp">{...}</samp>’ |
| 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 ‘<samp class="samp">~</samp>’ 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: ‘<samp class="samp">FOO='.;~' kpsewhich --var-brace-value=FOO</samp>’ outputs (on |
| 2271 |
a Unix-ish system) ‘<samp class="samp">.:/home/karl</samp>’, supposing the latter is the |
| 2272 |
current user’s home directory. Note that the ‘<samp class="samp">;</samp>’ in the source |
| 2273 |
value, as commonly used in <samp class="file">texmf.cnf</samp>, has changed to a |
| 2274 |
‘<samp class="samp">:</samp>’, as the normal path separator on the current system. On a |
| 2275 |
Windows-ish system, the ‘<samp class="samp">;</samp>’ would remain. |
| 2276 |
</p> |
| 2277 |
</dd> |
| 2278 |
<dt><a id="index-_002d_002dvar_002dvalue_003dvariable"></a><span>‘<samp class="samp">--var-value=<var class="var">variable</var></samp>’<a class="copiable-link" href="#index-_002d_002dvar_002dvalue_003dvariable"> ¶</a></span></dt> |
| 2279 |
<dd><p>Outputs the value of <var class="var">variable</var> (a simple identifier like |
| 2280 |
‘<samp class="samp">TEXMFDIST</samp>’, with no ‘<samp class="samp">$</samp>’ or other constructs), expanding |
| 2281 |
‘<samp class="samp">$</samp>’ (see <a class="pxref" href="#Variable-expansion">Variable expansion</a>) and ‘<samp class="samp">~</samp>’ (see <a class="pxref" href="#Tilde-expansion">Tilde expansion</a>) constructs in the value. ‘<samp class="samp">~</samp>’ 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: ‘<samp class="samp">--var-value=texmf_casefold_search</samp>’ outputs (if the |
| 2286 |
default is not changed) ‘<samp class="samp">1</samp>’. |
| 2287 |
</p> |
| 2288 |
<p>Example to contrast with ‘<samp class="samp">--var-brace-value</samp>’: ‘<samp class="samp">FOO='.;~' |
| 2289 |
kpsewhich --var-value=FOO</samp>’ outputs ‘<samp class="samp">.;~</samp>’, 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> [<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"> ¶</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 |
‘<samp class="samp">--help</samp>’ 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 |
‘<samp class="samp">--version</samp>’ 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> [<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"> ¶</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—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> [<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"> ¶</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 |
‘<samp class="samp">TEXINPUTS.latex</samp>’, are not allowed on some systems, Kpathsea looks |
| 2382 |
for environment variables with an underscore, e.g., |
| 2383 |
‘<samp class="samp">TEXINPUTS_latex</samp>’ (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 ‘<samp class="samp">--help-formats</samp>’ 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>‘<samp class="samp">afm</samp>’<a class="copiable-link" href="#index-_002eafm"> ¶</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 ‘<samp class="samp">.afm</samp>’. |
| 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>‘<samp class="samp">base</samp>’<a class="copiable-link" href="#index-_002ebase"> ¶</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 ‘<samp class="samp">.base</samp>’. |
| 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>‘<samp class="samp">bib</samp>’<a class="copiable-link" href="#index-_002ebib"> ¶</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 ‘<samp class="samp">.bib</samp>’. |
| 2411 |
</p> |
| 2412 |
</dd> |
| 2413 |
<dt><a class="index-entry-id" id="index-BLTXMLINPUTS"></a> |
| 2414 |
<a id="index-_002ebltxml"></a><span>‘<samp class="samp">bltxml</samp>’<a class="copiable-link" href="#index-_002ebltxml"> ¶</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 ‘<samp class="samp">.bltxml</samp>’. |
| 2418 |
</p> |
| 2419 |
</dd> |
| 2420 |
<dt><a class="index-entry-id" id="index-BSTINPUTS"></a> |
| 2421 |
<a id="index-_002ebst"></a><span>‘<samp class="samp">bst</samp>’<a class="copiable-link" href="#index-_002ebst"> ¶</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 ‘<samp class="samp">.bst</samp>’. |
| 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>‘<samp class="samp">clua</samp>’<a class="copiable-link" href="#index-_002edll"> ¶</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 ‘<samp class="samp">.dll</samp>’ and ‘<samp class="samp">.so</samp>’. |
| 2434 |
</p> |
| 2435 |
</dd> |
| 2436 |
<dt><a class="index-entry-id" id="index-CMAPFONTS"></a> |
| 2437 |
<a id="index-_002ecmap"></a><span>‘<samp class="samp">cmap</samp>’<a class="copiable-link" href="#index-_002ecmap"> ¶</a></span></dt> |
| 2438 |
<dd><p>(character map files) |
| 2439 |
<code class="code">CMAPFONTS</code>; |
| 2440 |
suffix ‘<samp class="samp">.cmap</samp>’. |
| 2441 |
</p> |
| 2442 |
</dd> |
| 2443 |
<dt><a class="index-entry-id" id="index-TEXMFCNF-1"></a> |
| 2444 |
<a id="index-_002ecnf"></a><span>‘<samp class="samp">cnf</samp>’<a class="copiable-link" href="#index-_002ecnf"> ¶</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 ‘<samp class="samp">.cnf</samp>’. |
| 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>‘<samp class="samp">cweb</samp>’<a class="copiable-link" href="#index-_002ew"> ¶</a></span></dt> |
| 2453 |
<dd><p>(CWEB input files) |
| 2454 |
<code class="code">CWEBINPUTS</code>; |
| 2455 |
suffixes ‘<samp class="samp">.w</samp>’, ‘<samp class="samp">.web</samp>’; |
| 2456 |
additional suffix ‘<samp class="samp">.ch</samp>’. |
| 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>‘<samp class="samp">dvips config</samp>’<a class="copiable-link" href="#index-TEXCONFIG"> ¶</a></span></dt> |
| 2461 |
<dd><p>(Dvips ‘<samp class="samp">config.*</samp>’ 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>‘<samp class="samp">enc files</samp>’<a class="copiable-link" href="#index-_002eenc"> ¶</a></span></dt> |
| 2468 |
<dd><p>(encoding vectors) |
| 2469 |
<code class="code">ENCFONTS</code>; |
| 2470 |
suffix ‘<samp class="samp">.enc</samp>’. |
| 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>‘<samp class="samp">fmt</samp>’<a class="copiable-link" href="#index-_002efmt"> ¶</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 ‘<samp class="samp">.fmt</samp>’. |
| 2479 |
</p> |
| 2480 |
</dd> |
| 2481 |
<dt><a class="index-entry-id" id="index-FONTCIDMAPS"></a> |
| 2482 |
<a id="index-_002ecid"></a><span>‘<samp class="samp">font cid map</samp>’<a class="copiable-link" href="#index-_002ecid"> ¶</a></span></dt> |
| 2483 |
<dd><p>(CJK mapping) |
| 2484 |
<code class="code">FONTCIDMAPS</code> |
| 2485 |
suffix ‘<samp class="samp">.cid</samp>’. |
| 2486 |
</p> |
| 2487 |
</dd> |
| 2488 |
<dt><a class="index-entry-id" id="index-FONTFEATURES"></a> |
| 2489 |
<a id="index-_002efea"></a><span>‘<samp class="samp">font feature files</samp>’<a class="copiable-link" href="#index-_002efea"> ¶</a></span></dt> |
| 2490 |
<dd><p>(primarily for OpenType font features) |
| 2491 |
<code class="code">FONTFEATURES</code> |
| 2492 |
suffix ‘<samp class="samp">.fea</samp>’. |
| 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>‘<samp class="samp">gf</samp>’<a class="copiable-link" href="#index-gf"> ¶</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 ‘<samp class="samp">gf</samp>’. |
| 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>‘<samp class="samp">graphic/figure</samp>’<a class="copiable-link" href="#index-_002eeps"> ¶</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: ‘<samp class="samp">.eps</samp>’, ‘<samp class="samp">.epsi</samp>’. |
| 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>‘<samp class="samp">ist</samp>’<a class="copiable-link" href="#index-_002eist"> ¶</a></span></dt> |
| 2516 |
<dd><p>(makeindex style files) |
| 2517 |
<code class="code">TEXINDEXSTYLE</code>, <code class="code">INDEXSTYLE</code>; |
| 2518 |
suffix ‘<samp class="samp">.ist</samp>’. |
| 2519 |
</p> |
| 2520 |
</dd> |
| 2521 |
<dt><a class="index-entry-id" id="index-LIGFONTS"></a> |
| 2522 |
<a id="index-_002elig"></a><span>‘<samp class="samp">lig files</samp>’<a class="copiable-link" href="#index-_002elig"> ¶</a></span></dt> |
| 2523 |
<dd><p>(ligature definition files) |
| 2524 |
<code class="code">LIGFONTS</code>; |
| 2525 |
suffix ‘<samp class="samp">.lig</samp>’. |
| 2526 |
</p> |
| 2527 |
</dd> |
| 2528 |
<dt><a class="index-entry-id" id="index-TEXMFDBS-1"></a> |
| 2529 |
<a id="index-ls_002dR"></a><span>‘<samp class="samp">ls-R</samp>’<a class="copiable-link" href="#index-ls_002dR"> ¶</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>‘<samp class="samp">lua</samp>’<a class="copiable-link" href="#index-_002elua"> ¶</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 ‘<samp class="samp">.lua</samp>’, ‘<samp class="samp">.luatex</samp>’, ‘<samp class="samp">.luc</samp>’, ‘<samp class="samp">.luctex</samp>’, |
| 2545 |
‘<samp class="samp">.texlua</samp>’, ‘<samp class="samp">.texluc</samp>’, ‘<samp class="samp">.tlu</samp>’. |
| 2546 |
</p> |
| 2547 |
</dd> |
| 2548 |
<dt><a class="index-entry-id" id="index-TEXFONTMAPS"></a> |
| 2549 |
<a id="index-_002emap"></a><span>‘<samp class="samp">map</samp>’<a class="copiable-link" href="#index-_002emap"> ¶</a></span></dt> |
| 2550 |
<dd><p>(Fontmaps, see <a class="pxref" href="#Fontmap">Fontmap</a>) |
| 2551 |
<code class="code">TEXFONTMAPS</code>; |
| 2552 |
suffix ‘<samp class="samp">.map</samp>’. |
| 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>‘<samp class="samp">mem</samp>’<a class="copiable-link" href="#index-_002emem"> ¶</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 ‘<samp class="samp">.mem</samp>’. |
| 2561 |
</p> |
| 2562 |
</dd> |
| 2563 |
<dt><a id="index-MPSUPPORT"></a><span>‘<samp class="samp"><span class="r">MetaPost support</span></samp>’<a class="copiable-link" href="#index-MPSUPPORT"> ¶</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>‘<samp class="samp">mf</samp>’<a class="copiable-link" href="#index-_002emf"> ¶</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 ‘<samp class="samp">.mf</samp>’; |
| 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>‘<samp class="samp">mfpool</samp>’<a class="copiable-link" href="#index-_002epool"> ¶</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 ‘<samp class="samp">.pool</samp>’. |
| 2581 |
</p> |
| 2582 |
</dd> |
| 2583 |
<dt><a class="index-entry-id" id="index-MFTINPUTS"></a> |
| 2584 |
<a id="index-_002emft"></a><span>‘<samp class="samp">mft</samp>’<a class="copiable-link" href="#index-_002emft"> ¶</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 ‘<samp class="samp">.mft</samp>’. |
| 2588 |
</p> |
| 2589 |
</dd> |
| 2590 |
<dt><a id="index-MISCFONTS"></a><span>‘<samp class="samp">misc fonts</samp>’<a class="copiable-link" href="#index-MISCFONTS"> ¶</a></span></dt> |
| 2591 |
<dd><p>(font-related files that don’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>‘<samp class="samp">mlbib</samp>’<a class="copiable-link" href="#index-_002emlbib"> ¶</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 ‘<samp class="samp">.mlbib</samp>’, ‘<samp class="samp">.mlbib</samp>’. |
| 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>‘<samp class="samp">mlbst</samp>’<a class="copiable-link" href="#index-_002emlbst"> ¶</a></span></dt> |
| 2607 |
<dd><p>(MlBibTeX style) |
| 2608 |
<code class="code">MLBSTINPUTS</code>, <code class="code">BSTINPUTS</code>; |
| 2609 |
suffixes ‘<samp class="samp">.mlbst</samp>’, ‘<samp class="samp">.bst</samp>’. |
| 2610 |
</p> |
| 2611 |
</dd> |
| 2612 |
<dt><a class="index-entry-id" id="index-MPINPUTS"></a> |
| 2613 |
<a id="index-_002emp"></a><span>‘<samp class="samp">mp</samp>’<a class="copiable-link" href="#index-_002emp"> ¶</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 ‘<samp class="samp">.mp</samp>’. |
| 2617 |
</p> |
| 2618 |
</dd> |
| 2619 |
<dt><a class="index-entry-id" id="index-MPPOOL"></a> |
| 2620 |
<a id="index-_002epool-1"></a><span>‘<samp class="samp">mppool</samp>’<a class="copiable-link" href="#index-_002epool-1"> ¶</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 ‘<samp class="samp">.pool</samp>’. |
| 2624 |
</p> |
| 2625 |
</dd> |
| 2626 |
<dt><a class="index-entry-id" id="index-OCPINPUTS"></a> |
| 2627 |
<a id="index-_002eocp"></a><span>‘<samp class="samp">ocp</samp>’<a class="copiable-link" href="#index-_002eocp"> ¶</a></span></dt> |
| 2628 |
<dd><p>(Omega compiled process files) |
| 2629 |
<code class="code">OCPINPUTS</code>; <br> |
| 2630 |
suffix ‘<samp class="samp">.ocp</samp>’; |
| 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>‘<samp class="samp">ofm</samp>’<a class="copiable-link" href="#index-_002eofm"> ¶</a></span></dt> |
| 2636 |
<dd><p>(Omega font metrics) |
| 2637 |
<code class="code">OFMFONTS</code>, <code class="code">TEXFONTS</code>; <br> |
| 2638 |
suffixes ‘<samp class="samp">.ofm</samp>’, ‘<samp class="samp">.tfm</samp>’; |
| 2639 |
dynamic creation program: <code class="code">MakeOmegaOFM</code>. |
| 2640 |
</p> |
| 2641 |
</dd> |
| 2642 |
<dt><a id="index-OPENTYPEFONTS"></a><span>‘<samp class="samp">opentype fonts</samp>’<a class="copiable-link" href="#index-OPENTYPEFONTS"> ¶</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>‘<samp class="samp">opl</samp>’<a class="copiable-link" href="#index-_002eopl"> ¶</a></span></dt> |
| 2648 |
<dd><p>(Omega property lists) |
| 2649 |
<code class="code">OPLFONTS</code>, <code class="code">TEXFONTS</code>; |
| 2650 |
suffix ‘<samp class="samp">.opl</samp>’. |
| 2651 |
</p> |
| 2652 |
</dd> |
| 2653 |
<dt><a class="index-entry-id" id="index-OTPINPUTS"></a> |
| 2654 |
<a id="index-_002eotp"></a><span>‘<samp class="samp">otp</samp>’<a class="copiable-link" href="#index-_002eotp"> ¶</a></span></dt> |
| 2655 |
<dd><p>(Omega translation process files) |
| 2656 |
<code class="code">OTPINPUTS</code>; |
| 2657 |
suffix ‘<samp class="samp">.otp</samp>’. |
| 2658 |
</p> |
| 2659 |
</dd> |
| 2660 |
<dt><a class="index-entry-id" id="index-OVFFONTS"></a> |
| 2661 |
<a id="index-_002eovf"></a><span>‘<samp class="samp">ovf</samp>’<a class="copiable-link" href="#index-_002eovf"> ¶</a></span></dt> |
| 2662 |
<dd><p>(Omega virtual fonts) |
| 2663 |
<code class="code">OVFFONTS</code>, <code class="code">TEXFONTS</code>; |
| 2664 |
suffix ‘<samp class="samp">.ovf</samp>’. |
| 2665 |
</p> |
| 2666 |
</dd> |
| 2667 |
<dt><a class="index-entry-id" id="index-OVPFONTS"></a> |
| 2668 |
<a id="index-_002eovp"></a><span>‘<samp class="samp">ovp</samp>’<a class="copiable-link" href="#index-_002eovp"> ¶</a></span></dt> |
| 2669 |
<dd><p>(Omega virtual property lists) |
| 2670 |
<code class="code">OVPFONTS</code>, <code class="code">TEXFONTS</code>; |
| 2671 |
suffix ‘<samp class="samp">.ovp</samp>’. |
| 2672 |
</p> |
| 2673 |
</dd> |
| 2674 |
<dt><a id="index-PDFTEXCONFIG"></a><span>‘<samp class="samp">pdftex config</samp>’<a class="copiable-link" href="#index-PDFTEXCONFIG"> ¶</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>‘<samp class="samp">pk</samp>’<a class="copiable-link" href="#index-_002epk"> ¶</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 ‘<samp class="samp">XDVI</samp>’, etc.), |
| 2686 |
<code class="code">PKFONTS</code>, <code class="code">TEXPKS</code>, <code class="code">GLYPHFONTS</code>, <code class="code">TEXFONTS</code>; |
| 2687 |
suffix ‘<samp class="samp">pk</samp>’; |
| 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>‘<samp class="samp">PostScript header</samp>’<a class="copiable-link" href="#index-_002epro"> ¶</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 ‘<samp class="samp">.pro</samp>’. |
| 2697 |
</p> |
| 2698 |
</dd> |
| 2699 |
<dt><a class="index-entry-id" id="index-RISINPUTS"></a> |
| 2700 |
<a id="index-_002eris"></a><span>‘<samp class="samp">ris</samp>’<a class="copiable-link" href="#index-_002eris"> ¶</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 ‘<samp class="samp">.ris</samp>’. |
| 2704 |
</p> |
| 2705 |
</dd> |
| 2706 |
<dt><a class="index-entry-id" id="index-SFDFONTS"></a> |
| 2707 |
<a id="index-_002esfd"></a><span>‘<samp class="samp">subfont definition files</samp>’<a class="copiable-link" href="#index-_002esfd"> ¶</a></span></dt> |
| 2708 |
<dd><p>(subfont definition files) |
| 2709 |
<code class="code">SFDFONTS</code> |
| 2710 |
suffix ‘<samp class="samp">.sfd</samp>’. |
| 2711 |
</p> |
| 2712 |
</dd> |
| 2713 |
<dt><a class="index-entry-id" id="index-TEXINPUTS-1"></a> |
| 2714 |
<a id="index-_002etex"></a><span>‘<samp class="samp">tex</samp>’<a class="copiable-link" href="#index-_002etex"> ¶</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 ‘<samp class="samp">.tex</samp>’; |
| 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>‘<samp class="samp">TeX system documentation</samp>’<a class="copiable-link" href="#index-doc-files"> ¶</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>‘<samp class="samp">TeX system sources</samp>’<a class="copiable-link" href="#index-source-files"> ¶</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>‘<samp class="samp">texmfscripts</samp>’<a class="copiable-link" href="#index-TEXMFSCRIPTS"> ¶</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>‘<samp class="samp">texpool</samp>’<a class="copiable-link" href="#index-_002epool-2"> ¶</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 ‘<samp class="samp">.pool</samp>’. |
| 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>‘<samp class="samp">tfm</samp>’<a class="copiable-link" href="#index-_002etfm"> ¶</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 ‘<samp class="samp">.tfm</samp>’; |
| 2752 |
dynamic creation program: <code class="code">mktextfm</code>. |
| 2753 |
</p> |
| 2754 |
</dd> |
| 2755 |
<dt><a id="index-TRFONTS"></a><span>‘<samp class="samp">Troff fonts</samp>’<a class="copiable-link" href="#index-TRFONTS"> ¶</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>‘<samp class="samp">truetype fonts</samp>’<a class="copiable-link" href="#index-_002ettf"> ¶</a></span></dt> |
| 2763 |
<dd><p>(TrueType outline fonts) <code class="code">TTFONTS</code>; suffixes ‘<samp class="samp">.ttf</samp>’ and |
| 2764 |
‘<samp class="samp">.TTF</samp>’, ‘<samp class="samp">.ttc</samp>’ and ‘<samp class="samp">.TTC</samp>’, ‘<samp class="samp">.dfont</samp>’. |
| 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>‘<samp class="samp">type1 fonts</samp>’<a class="copiable-link" href="#index-_002epfa"> ¶</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 ‘<samp class="samp">.pfa</samp>’, ‘<samp class="samp">.pfb</samp>’. |
| 2776 |
</p> |
| 2777 |
</dd> |
| 2778 |
<dt><a id="index-T42FONTS"></a><span>‘<samp class="samp">type42 fonts</samp>’<a class="copiable-link" href="#index-T42FONTS"> ¶</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>‘<samp class="samp">vf</samp>’<a class="copiable-link" href="#index-_002evf"> ¶</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 ‘<samp class="samp">.vf</samp>’. |
| 2788 |
</p> |
| 2789 |
</dd> |
| 2790 |
<dt><a class="index-entry-id" id="index-WEBINPUTS"></a> |
| 2791 |
<a id="index-_002eweb-1"></a><span>‘<samp class="samp">web</samp>’<a class="copiable-link" href="#index-_002eweb-1"> ¶</a></span></dt> |
| 2792 |
<dd><p>(WEB input files) |
| 2793 |
<code class="code">WEBINPUTS</code>; |
| 2794 |
suffix ‘<samp class="samp">.web</samp>’; |
| 2795 |
additional suffix ‘<samp class="samp">.ch</samp>’. |
| 2796 |
</p> |
| 2797 |
</dd> |
| 2798 |
<dt><a id="index-WEB2C"></a><span>‘<samp class="samp">web2c files</samp>’<a class="copiable-link" href="#index-WEB2C"> ¶</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 ‘<samp class="samp">INPUTS</samp>’. Assuming the program is called ‘<samp class="samp">foo</samp>’, |
| 2808 |
this gives us the following table. |
| 2809 |
</p> |
| 2810 |
<dl class="table"> |
| 2811 |
<dt><a id="index-FOOINPUTS"></a><span>‘<samp class="samp">other text files</samp>’<a class="copiable-link" href="#index-FOOINPUTS"> ¶</a></span></dt> |
| 2812 |
<dd><p>(text files used by ‘<samp class="samp">foo</samp>’) |
| 2813 |
<code class="code">FOOINPUTS</code>. |
| 2814 |
</p> |
| 2815 |
</dd> |
| 2816 |
<dt><a id="index-FOOINPUTS-1"></a><span>‘<samp class="samp">other binary files</samp>’<a class="copiable-link" href="#index-FOOINPUTS-1"> ¶</a></span></dt> |
| 2817 |
<dd><p>(binary files used by ‘<samp class="samp">foo</samp>’) |
| 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’t be looked at (unless, as usual, the |
| 2824 |
environment variable value has an extra ‘<samp class="samp">:</samp>’). 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> [<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"> ¶</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 ‘<samp class="samp">foo.bar</samp>’, look for |
| 2866 |
‘<samp class="samp">foo.bar.tex</samp>’. |
| 2867 |
|
| 2868 |
</li><li> Search for <var class="var">name</var>, and if necessary for alternative names found in |
| 2869 |
the fontmaps. Example: given ‘<samp class="samp">foo.bar</samp>’, we also look for |
| 2870 |
‘<samp class="samp">foo.bar</samp>’. |
| 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 “suffixed” name (item 1) or |
| 2880 |
the “as-is” name (item 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: ‘<samp class="samp">babel.sty</samp>’ will only look for ‘<samp class="samp">babel.sty</samp>’, not |
| 2884 |
‘<samp class="samp">babel.sty.tex</samp>’, regardless of this setting. |
| 2885 |
</p> |
| 2886 |
<p>When the suffix is unknown (e.g., ‘<samp class="samp">foo.bar</samp>’), 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 |
‘<samp class="samp">tex story</samp>’) 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> [<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"> ¶</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., ‘<samp class="samp">cmr10</samp>’) 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 ‘<samp class="samp">mktexpk</samp>’) 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 ‘<samp class="samp">cmr10</samp>’). |
| 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> [<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"> ¶</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 ‘<samp class="samp"><var class="var">name</var>.<var class="var">dpi</var><var class="var">format</var></samp>’; for example, |
| 2962 |
‘<samp class="samp">cmr10.600pk</samp>’. Kpathsea looks for a PK file first, then a GF file. |
| 2963 |
</p> |
| 2964 |
<p>If that fails, Kpathsea looks for |
| 2965 |
‘<samp class="samp">dpi<var class="var">dpi</var>/<var class="var">name</var>.<var class="var">format</var></samp>’; for example, |
| 2966 |
‘<samp class="samp">dpi600/cmr10.pk</samp>’. 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 |
“Close enough” 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> [<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"> ¶</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 ‘<samp class="samp">Times-Roman</samp>’ |
| 3006 |
instead of <samp class="file">ptmr</samp>, you can (you get ‘<samp class="samp">ptmr8r</samp>’). |
| 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’s “circle font” 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 ‘<samp class="samp">%</samp>’ 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 ‘<samp class="samp">include</samp>’, 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 ‘<samp class="samp">foo.tfm</samp>’ matches only when |
| 3046 |
<samp class="file">foo.tfm</samp> is being searched for; but an alias ‘<samp class="samp">foo</samp>’ 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> [<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"> ¶</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> [<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"> ¶</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>‘<samp class="samp">all</samp>’<a class="copiable-link" href="#index-all"> ¶</a></span></dt> |
| 3128 |
<dd><p>Suppress everything possible. |
| 3129 |
</p> |
| 3130 |
</dd> |
| 3131 |
<dt><a id="index-checksum"></a><span>‘<samp class="samp">checksum</samp>’<a class="copiable-link" href="#index-checksum"> ¶</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>‘<samp class="samp">lostchar</samp>’<a class="copiable-link" href="#index-lostchar"> ¶</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>‘<samp class="samp">none</samp>’<a class="copiable-link" href="#index-none"> ¶</a></span></dt> |
| 3143 |
<dd><p>Don’t suppress any warnings. |
| 3144 |
</p> |
| 3145 |
</dd> |
| 3146 |
<dt><a id="index-readable"></a><span>‘<samp class="samp">readable</samp>’<a class="copiable-link" href="#index-readable"> ¶</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>‘<samp class="samp">special</samp>’<a class="copiable-link" href="#index-special"> ¶</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 |
‘<samp class="samp">\special</samp>’ 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> [<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"> ¶</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’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 ‘<samp class="samp">.fmt</samp>’ (and Metafont |
| 3194 |
‘<samp class="samp">.base</samp>’ and Metapost ‘<samp class="samp">.mem</samp>’ 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> [<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"> ¶</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’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 ‘<samp class="samp">make |
| 3281 |
install</samp>’ (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’s |
| 3290 |
sources are, and test the permissions of the ‘<samp class="samp">fonts</samp>’ 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’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 ‘<samp class="samp">appendonlydir</samp>’ option is enabled by default. |
| 3298 |
</p> |
| 3299 |
<dl class="vtable"> |
| 3300 |
<dt><a id="index-appendonlydir"></a><span>‘<samp class="samp">appendonlydir</samp>’<a class="copiable-link" href="#index-appendonlydir"> ¶</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’t support similar functionality. |
| 3307 |
This feature is enabled by default. |
| 3308 |
</p> |
| 3309 |
</dd> |
| 3310 |
<dt><a id="index-dosnames"></a><span>‘<samp class="samp">dosnames</samp>’<a class="copiable-link" href="#index-dosnames"> ¶</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’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 ‘<samp class="samp">dosnames</samp>’ is in |
| 3322 |
effect, but <samp class="file">mf.pool</samp> and <samp class="file">mp.base</samp> don’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 |
‘<samp class="samp">dosnames</samp>’ 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’t include |
| 3328 |
‘<samp class="samp">dosnames</samp>’. 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’t consult <samp class="file">mktex.opt</samp>. |
| 3331 |
</p> |
| 3332 |
</dd> |
| 3333 |
<dt><a id="index-fontmaps-1"></a><span>‘<samp class="samp">fontmaps</samp>’<a class="copiable-link" href="#index-fontmaps-1"> ¶</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>‘<samp class="samp">nomfdrivers</samp>’<a class="copiable-link" href="#index-nomfdrivers"> ¶</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>‘<samp class="samp">nomode</samp>’<a class="copiable-link" href="#index-nomode"> ¶</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>‘<samp class="samp">stripsupplier</samp>’<a class="copiable-link" href="#index-stripsupplier"> ¶</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>‘<samp class="samp">striptypeface</samp>’<a class="copiable-link" href="#index-striptypeface"> ¶</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>‘<samp class="samp">strip</samp>’<a class="copiable-link" href="#index-strip"> ¶</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 ‘<samp class="samp">stripsupplier</samp>’ and ‘<samp class="samp">striptypeface</samp>’. |
| 3369 |
</p> |
| 3370 |
</dd> |
| 3371 |
<dt><a id="index-varfonts"></a><span>‘<samp class="samp">varfonts</samp>’<a class="copiable-link" href="#index-varfonts"> ¶</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 ‘<samp class="samp">varfonts</samp>’ setting in <code class="code">MT_FEATURES</code> is overridden by the |
| 3383 |
<code class="code">USE_VARTEXFONTS</code> environment variable: if set to ‘<samp class="samp">1</samp>’, the |
| 3384 |
feature is enabled, and if set to ‘<samp class="samp">0</samp>’, the feature is disabled. |
| 3385 |
</p> |
| 3386 |
</dd> |
| 3387 |
<dt><a id="index-texmfvar"></a><span>‘<samp class="samp">texmfvar</samp>’<a class="copiable-link" href="#index-texmfvar"> ¶</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 ‘<samp class="samp">varfonts</samp>’ feature takes |
| 3392 |
precedence if also set. |
| 3393 |
</p> |
| 3394 |
<a class="index-entry-id" id="index-USE_005fTEXMFVAR"></a> |
| 3395 |
<p>The ‘<samp class="samp">texmfvar</samp>’ setting in <code class="code">MT_FEATURES</code> is overridden by the |
| 3396 |
<code class="code">USE_TEXMFVAR</code> environment variable: if set to ‘<samp class="samp">1</samp>’, the |
| 3397 |
feature is enabled, and if set to ‘<samp class="samp">0</samp>’, 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> [<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"> ¶</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"> ¶</a></span></dt> |
| 3420 |
<dd><p>(‘<samp class="samp">.fmt</samp>’, ‘<samp class="samp">.base</samp>’, ‘<samp class="samp">.mem</samp>’) 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"> ¶</a></span></dt> |
| 3426 |
<dd><p>(‘<samp class="samp">.mf</samp>’) 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"> ¶</a></span></dt> |
| 3430 |
<dd><p>(‘<samp class="samp">.ocp</samp>’) 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"> ¶</a></span></dt> |
| 3434 |
<dd><p>(‘<samp class="samp">.ofm</samp>’) 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"> ¶</a></span></dt> |
| 3438 |
<dd><p>(‘<samp class="samp">pk</samp>’) 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"> ¶</a></span></dt> |
| 3442 |
<dd><p>(‘<samp class="samp">.tex</samp>’) 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"> ¶</a></span></dt> |
| 3446 |
<dd><p>(‘<samp class="samp">.tfm</samp>’) 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…</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’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 ‘<samp class="samp">missfont.log</samp>’ 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> [<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"> ¶</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>‘<samp class="samp">--dpi <var class="var">num</var></samp>’</dt> |
| 3496 |
<dd><p>Sets the resolution of the generated font to <var class="var">num</var>. |
| 3497 |
</p></dd> |
| 3498 |
<dt>‘<samp class="samp">--mfmode <var class="var">name</var></samp>’</dt> |
| 3499 |
<dd><p>Sets the Metafont mode to <var class="var">name</var>. |
| 3500 |
</p></dd> |
| 3501 |
<dt>‘<samp class="samp">--bdpi <var class="var">num</var></samp>’</dt> |
| 3502 |
<dd><p>Sets the “base dpi” for the font. This must match the mode being |
| 3503 |
used. |
| 3504 |
</p></dd> |
| 3505 |
<dt>‘<samp class="samp">--mag <var class="var">string</var></samp>’</dt> |
| 3506 |
<dd><p>A “magstep” 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>‘<samp class="samp">--destdir <var class="var">string</var></samp>’</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> [<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"> ¶</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> [<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"> ¶</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 |
<kpathsea/kpathsea.h></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’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> [<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"> ¶</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->invocation_name</code> and <code class="code">kpse->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->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 ‘<samp class="samp">kpsewhich --expand-var=\$SELFAUTOLOC</samp>’, |
| 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’t have |
| 3672 |
a debugging option already, you can define one and set |
| 3673 |
<code class="code">kpse->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’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->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’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—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 ‘<samp class="samp">!!</samp>’, etc.). In other |
| 3725 |
words, if you are looking up a VF or some other file that need not |
| 3726 |
exist, don’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> [<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"> ¶</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 ‘<samp class="samp">a</samp>’ (for “any”), 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 ‘<samp class="samp">r</samp>’ (for “restricted”), filenames beginning |
| 3780 |
with ‘<samp class="samp">.</samp>’ are disallowed. |
| 3781 |
|
| 3782 |
</li><li><a class="index-entry-id" id="index-paranoid-mode_002c-for-output-files"></a> |
| 3783 |
When set to ‘<samp class="samp">p</samp>’ (for “paranoid”), 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 “extended” 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 ‘<samp class="samp">..</samp>’ 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 ‘<samp class="samp">..</samp>’ 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’s ok; possibly |
| 3820 |
preferable.) |
| 3821 |
</p> |
| 3822 |
<p>For backwards compatibility, ‘<samp class="samp">y</samp>’ and ‘<samp class="samp">1</samp>’ are synonyms of |
| 3823 |
‘<samp class="samp">a</samp>’, while ‘<samp class="samp">n</samp>’ and ‘<samp class="samp">0</samp>’ are synonyms for ‘<samp class="samp">r</samp>’. |
| 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 (‘<samp class="samp">--safe-out-name</samp>’) 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’s extended mode, the function is |
| 3834 |
<code class="code">kpathsea_out_name_ok_extended</code>, and the Kpsewhich option is |
| 3835 |
‘<samp class="samp">--safe-extended-out-name</samp>’. |
| 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’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’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> [<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"> ¶</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 ‘<samp class="samp">texmf/ttf2pk</samp>’. |
| 3890 |
</p> |
| 3891 |
<p>Two formats, ‘<samp class="samp">kpse_program_text_format</samp>’ and |
| 3892 |
‘<samp class="samp">kpse_program_binary_format</samp>’, 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 |
‘<samp class="samp">texmf.cnf</samp>’. 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> [<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"> ¶</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 ‘<samp class="samp">NULL</samp>’. 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’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">"$FOO"</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> [<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"> ¶</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, … |
| 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> [<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"> ¶</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’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 ‘<samp class="samp">--version</samp>’ |
| 4008 |
to the program, and the latter by running ‘<samp class="samp">kpsewhich --version</samp>’. |
| 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 ‘<samp class="samp">configure</samp>’ itself, it’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 ‘<samp class="samp">configure</samp>’ 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 ‘<samp class="samp">-1</samp>’ 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 “old” 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)—TeX source files are |
| 4045 |
helpful, but the DVI file is required, because that’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 (‘<samp class="samp">diff -c</samp>’) 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> [<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"> ¶</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> [<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"> ¶</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’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., ‘<samp class="samp">-d</samp>’) to the |
| 4126 |
program; in that case, you should use the numeric values described in |
| 4127 |
the program’s documentation (which, for Dvipsk and Xdvik, are different |
| 4128 |
than those below). It’s best to give the ‘<samp class="samp">-d</samp>’ (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->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 ‘<samp class="samp">-1</samp>’, 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>/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’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"> ¶</a></span></dt> |
| 4163 |
<dd><p>Report ‘<samp class="samp">stat</samp>’(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"> ¶</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"> ¶</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’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 ‘<samp class="samp">fopen</samp>’ (‘<samp class="samp">fclose</samp>’) to be ‘<samp class="samp">kpse_fopen_trace</samp>’ |
| 4184 |
(‘<samp class="samp">kpse_fclose_trace</samp>’). |
| 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"> ¶</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—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"> ¶</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’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"> ¶</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"> ¶</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"> ¶</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"> ¶</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"> ¶</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 ‘<samp class="samp">kdebug:</samp>’. (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> [<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"> ¶</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’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 “the epoch”, 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> [<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"> ¶</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, … |
| 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> [<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"> ¶</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’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’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’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 ‘<samp class="samp">//</samp>’ 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’t want it to be. |
| 4386 |
</p> |
| 4387 |
</li><li>If the fonts (or whatever) don’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’ll eventually get an |
| 4390 |
error message saying something like ‘<samp class="samp">Can't find font |
| 4391 |
<var class="var">fontname</var></samp>’. 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> [<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"> ¶</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’s present; there’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’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> [<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"> ¶</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>’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’t been made properly. (It’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 "plain; input modes; dump" |
| 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> [<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"> ¶</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’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’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’s (or whatever program’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> [<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"> ¶</a></span></h2> |
| 4565 |
|
| 4566 |
<div class="printindex cp-printindex"> |
| 4567 |
<table class="cp-letters-header-printindex"><tr><th>Jump to: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a> |
| 4568 |
|
| 4569 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>;</b></a> |
| 4570 |
|
| 4571 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>:</b></a> |
| 4572 |
|
| 4573 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>!</b></a> |
| 4574 |
|
| 4575 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>.</b></a> |
| 4576 |
|
| 4577 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>{</b></a> |
| 4578 |
|
| 4579 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>/</b></a> |
| 4580 |
|
| 4581 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>\</b></a> |
| 4582 |
|
| 4583 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>=</b></a> |
| 4584 |
|
| 4585 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>~</b></a> |
| 4586 |
|
| 4587 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>$</b></a> |
| 4588 |
|
| 4589 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>2</b></a> |
| 4590 |
|
| 4591 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a> |
| 4592 |
|
| 4593 |
<br> |
| 4594 |
<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a> |
| 4595 |
|
| 4596 |
<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a> |
| 4597 |
|
| 4598 |
<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a> |
| 4599 |
|
| 4600 |
<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a> |
| 4601 |
|
| 4602 |
<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a> |
| 4603 |
|
| 4604 |
<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a> |
| 4605 |
|
| 4606 |
<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a> |
| 4607 |
|
| 4608 |
<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a> |
| 4609 |
|
| 4610 |
<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a> |
| 4611 |
|
| 4612 |
<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a> |
| 4613 |
|
| 4614 |
<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a> |
| 4615 |
|
| 4616 |
<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a> |
| 4617 |
|
| 4618 |
<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a> |
| 4619 |
|
| 4620 |
<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a> |
| 4621 |
|
| 4622 |
<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a> |
| 4623 |
|
| 4624 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a> |
| 4625 |
|
| 4626 |
<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a> |
| 4627 |
|
| 4628 |
<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a> |
| 4629 |
|
| 4630 |
<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a> |
| 4631 |
|
| 4632 |
<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a> |
| 4633 |
|
| 4634 |
<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a> |
| 4635 |
|
| 4636 |
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a> |
| 4637 |
|
| 4638 |
<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a> |
| 4639 |
|
| 4640 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a> |
| 4641 |
|
| 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>‘<samp class="samp">--cnf-line</samp>’, 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 ‘<samp class="samp">:</samp>’ 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->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…</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">‘<samp class="samp">kdebug:</samp>’</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->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->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->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->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->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->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->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’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…</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 ‘<samp class="samp">/</samp>’ 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: </th><td><a class="summary-letter-printindex" href="#Index_cp_symbol-1"><b>-</b></a> |
| 5412 |
|
| 5413 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-2"><b>;</b></a> |
| 5414 |
|
| 5415 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-3"><b>:</b></a> |
| 5416 |
|
| 5417 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-4"><b>!</b></a> |
| 5418 |
|
| 5419 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-5"><b>.</b></a> |
| 5420 |
|
| 5421 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-6"><b>{</b></a> |
| 5422 |
|
| 5423 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-7"><b>/</b></a> |
| 5424 |
|
| 5425 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-8"><b>\</b></a> |
| 5426 |
|
| 5427 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-9"><b>=</b></a> |
| 5428 |
|
| 5429 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-10"><b>~</b></a> |
| 5430 |
|
| 5431 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-11"><b>$</b></a> |
| 5432 |
|
| 5433 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-12"><b>2</b></a> |
| 5434 |
|
| 5435 |
<a class="summary-letter-printindex" href="#Index_cp_symbol-13"><b>8</b></a> |
| 5436 |
|
| 5437 |
<br> |
| 5438 |
<a class="summary-letter-printindex" href="#Index_cp_letter-A"><b>A</b></a> |
| 5439 |
|
| 5440 |
<a class="summary-letter-printindex" href="#Index_cp_letter-B"><b>B</b></a> |
| 5441 |
|
| 5442 |
<a class="summary-letter-printindex" href="#Index_cp_letter-C"><b>C</b></a> |
| 5443 |
|
| 5444 |
<a class="summary-letter-printindex" href="#Index_cp_letter-D"><b>D</b></a> |
| 5445 |
|
| 5446 |
<a class="summary-letter-printindex" href="#Index_cp_letter-E"><b>E</b></a> |
| 5447 |
|
| 5448 |
<a class="summary-letter-printindex" href="#Index_cp_letter-F"><b>F</b></a> |
| 5449 |
|
| 5450 |
<a class="summary-letter-printindex" href="#Index_cp_letter-G"><b>G</b></a> |
| 5451 |
|
| 5452 |
<a class="summary-letter-printindex" href="#Index_cp_letter-H"><b>H</b></a> |
| 5453 |
|
| 5454 |
<a class="summary-letter-printindex" href="#Index_cp_letter-I"><b>I</b></a> |
| 5455 |
|
| 5456 |
<a class="summary-letter-printindex" href="#Index_cp_letter-K"><b>K</b></a> |
| 5457 |
|
| 5458 |
<a class="summary-letter-printindex" href="#Index_cp_letter-L"><b>L</b></a> |
| 5459 |
|
| 5460 |
<a class="summary-letter-printindex" href="#Index_cp_letter-M"><b>M</b></a> |
| 5461 |
|
| 5462 |
<a class="summary-letter-printindex" href="#Index_cp_letter-N"><b>N</b></a> |
| 5463 |
|
| 5464 |
<a class="summary-letter-printindex" href="#Index_cp_letter-O"><b>O</b></a> |
| 5465 |
|
| 5466 |
<a class="summary-letter-printindex" href="#Index_cp_letter-P"><b>P</b></a> |
| 5467 |
|
| 5468 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Q"><b>Q</b></a> |
| 5469 |
|
| 5470 |
<a class="summary-letter-printindex" href="#Index_cp_letter-R"><b>R</b></a> |
| 5471 |
|
| 5472 |
<a class="summary-letter-printindex" href="#Index_cp_letter-S"><b>S</b></a> |
| 5473 |
|
| 5474 |
<a class="summary-letter-printindex" href="#Index_cp_letter-T"><b>T</b></a> |
| 5475 |
|
| 5476 |
<a class="summary-letter-printindex" href="#Index_cp_letter-U"><b>U</b></a> |
| 5477 |
|
| 5478 |
<a class="summary-letter-printindex" href="#Index_cp_letter-V"><b>V</b></a> |
| 5479 |
|
| 5480 |
<a class="summary-letter-printindex" href="#Index_cp_letter-W"><b>W</b></a> |
| 5481 |
|
| 5482 |
<a class="summary-letter-printindex" href="#Index_cp_letter-X"><b>X</b></a> |
| 5483 |
|
| 5484 |
<a class="summary-letter-printindex" href="#Index_cp_letter-Z"><b>Z</b></a> |
| 5485 |
|
| 5486 |
</td></tr></table> |
| 5487 |
</div> |
| 5488 |
|
| 5489 |
</div> |
| 5490 |
</div> |
| 5491 |
|
| 5492 |
|
| 5493 |
|
| 5494 |
</body> |
| 5495 |
</html> |