summaryrefslogtreecommitdiff
path: root/systems/doc/kpathsea/kpathsea.html
diff options
context:
space:
mode:
Diffstat (limited to 'systems/doc/kpathsea/kpathsea.html')
-rw-r--r--systems/doc/kpathsea/kpathsea.html1252
1 files changed, 572 insertions, 680 deletions
diff --git a/systems/doc/kpathsea/kpathsea.html b/systems/doc/kpathsea/kpathsea.html
index 883cc12929..807fa6091a 100644
--- a/systems/doc/kpathsea/kpathsea.html
+++ b/systems/doc/kpathsea/kpathsea.html
@@ -1,8 +1,11 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
+<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This file documents the Kpathsea library for path searching.
-Copyright (C) 1996-2021 Karl Berry & Olaf Weber.
+Copyright (C) 1996-2022 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -18,9 +21,6 @@ Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the TeX Users Group. -->
-<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Kpathsea: A library for path searching</title>
<meta name="description" content="Kpathsea: A library for path searching">
@@ -28,17 +28,20 @@ approved by the TeX Users Group. -->
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
<link href="#Top" rel="start" title="Top">
<link href="#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="http://tug.org/texinfohtml" rel="up" title="(dir)">
+<link href="#Introduction" rel="next" title="Introduction">
<style type="text/css">
<!--
+a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
-div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
@@ -47,6 +50,7 @@ pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
+span:hover a.copiable-anchor {visibility: visible}
ul.no-bullet {list-style: none}
-->
</style>
@@ -65,7 +69,22 @@ ul.no-bullet {list-style: none}
-<span id="SEC_Contents"></span>
+
+
+<div class="top" id="Top">
+<div class="header">
+<p>
+Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Kpathsea-library"></span><h1 class="top">Kpathsea library</h1>
+
+<p>This manual documents the Kpathsea library for path searching. It
+corresponds to version 6.3.4, released in
+January 2022.
+</p>
+
+
+<div class="Contents_element" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
@@ -155,61 +174,20 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
</ul>
</div>
-
-
-
-<span id="Top"></span><div class="header">
-<p>
-Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Kpathsea-library"></span><h1 class="top">Kpathsea library</h1>
-
-<p>This manual documents the Kpathsea library for path searching. It
-corresponds to version 6.3.3, released in
-February 2021.
-</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Introduction" accesskey="1">Introduction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Overview and history.
-</td></tr>
-<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
-
-</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#unixtex_002eftp" accesskey="2">unixtex.ftp</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Obtaining TeX software.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Security" accesskey="3">Security</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Who can write what files, etc.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#TeX-directory-structure" accesskey="4">TeX directory structure</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Managing the horde of TeX input files.
-</td></tr>
-<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
-
-</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Path-searching" accesskey="5">Path searching</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How filename lookups work.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#TeX-support" accesskey="6">TeX support</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Special support for TeX-related file lookups.
-</td></tr>
-<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
-
-</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Programming" accesskey="7">Programming</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How to use Kpathsea features in your program.
-</td></tr>
-<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
-
-</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Reporting-bugs" accesskey="8">Reporting bugs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Where and how to report bugs.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Index" rel="index" accesskey="9">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
-</td></tr>
-</table>
-
-
<hr>
-<span id="Introduction"></span><div class="header">
+<div class="chapter" id="Introduction">
+<div class="header">
<p>
-Next: <a href="#unixtex_002eftp" accesskey="n" rel="next">unixtex.ftp</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#unixtex_002eftp" accesskey="n" rel="next"><samp>unixtex.ftp</samp>: Obtaining TeX</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Kpathsea library</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
<span id="index-introduction"></span>
<span id="index-fundamental-purpose-of-Kpathsea"></span>
-<p>This manual corresponds to version 6.3.3 of the Kpathsea
-library, released in February 2021.
+<p>This manual corresponds to version 6.3.4 of the Kpathsea
+library, released in January 2022.
</p>
<p>The library&rsquo;s fundamental purpose is to return a filename from a list of
directories specified by the user, similar to what shells do when
@@ -221,9 +199,9 @@ this library:
</p>
<ul>
<li> Dviljk (see the &lsquo;<samp>dvilj</samp>&rsquo; man page)
-</li><li> Dvipsk (see <cite><a href="https://tug.org/texinfohtml/dvips.html#Top">Dvips: A DVI driver</a></cite>)
-</li><li> GNU font utilities (see <cite><a href="fontu.html#Top">GNU font utilities</a></cite>)
-</li><li> Web2c (see <cite><a href="https://tug.org/texinfohtml/web2c.html#Top">Web2c: A TeX implementation</a></cite>)
+</li><li> Dvipsk (see <cite><a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Top">Dvips: A DVI driver</a></cite>)
+</li><li> GNU font utilities (see <cite><a data-manual="fontu" href="fontu.html#Top">GNU font utilities</a></cite>)
+</li><li> Web2c (see <cite><a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Top">Web2c: A TeX implementation</a></cite>)
</li><li> Xdvik (see the &lsquo;<samp>xdvi</samp>&rsquo; man page)
</li></ul>
@@ -232,7 +210,7 @@ this library:
<p>Kpathsea is now maintained as part of the TeX Live distribution
(<a href="https://tug.org/texlive">https://tug.org/texlive</a>), which includes several more
Kpathsea-using programs. For information on configuration, building,
-installing, and more, see <cite><a href="https://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>.
+installing, and more, see <cite><a data-manual="tlbuild" href="https://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>.
</p>
<span id="index-interface_002c-not-frozen"></span>
<span id="index-comments_002c-making"></span>
@@ -261,14 +239,14 @@ you&rsquo;re already a member, thanks!). TUG produces the periodical
proceedings, and arranges courses on TeX for all levels of users
throughout the world. See <a href="https://tug.org">https://tug.org</a> for information.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#History" accesskey="1">History</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#History" accesskey="1">History</a></li>
+</ul>
<hr>
-<span id="History"></span><div class="header">
+<div class="section" id="History">
+<div class="header">
<p>
Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -377,9 +355,12 @@ where Kpathsea is now maintained.
<hr>
-<span id="unixtex_002eftp"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="unixtex_002eftp">
+<div class="header">
<p>
-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">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Security" accesskey="n" rel="next">Security</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="unixtex_002eftp_003a-Obtaining-TeX"></span><h2 class="chapter">2 <samp>unixtex.ftp</samp>: Obtaining TeX</h2>
@@ -425,9 +406,11 @@ Comprehensive TeX Archive Network), <a href="https://ctan.org">https://ctan.org<
<hr>
-<span id="Security"></span><div class="header">
+</div>
+<div class="chapter" id="Security">
+<div class="header">
<p>
-Next: <a href="#TeX-directory-structure" accesskey="n" rel="next">TeX directory structure</a>, Previous: <a href="#unixtex_002eftp" accesskey="p" rel="prev">unixtex.ftp</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#TeX-directory-structure" accesskey="n" rel="next">TeX directory structure</a>, Previous: <a href="#unixtex_002eftp" accesskey="p" rel="prev"><samp>unixtex.ftp</samp>: Obtaining TeX</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Security-1"></span><h2 class="chapter">3 Security</h2>
@@ -443,12 +426,12 @@ illegitimate root access.
<samp>~/.rhosts</samp>, and thus an unwitting user who runs TeX on a random
document is vulnerable to a trojan horse attack. This loophole is
closed by default, but you can be permissive if you so desire in
-<samp>texmf.cnf</samp>. See <a href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>. MetaPost has
+<samp>texmf.cnf</samp>. See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>. MetaPost has
the same issue.
</p>
<p>Dvips, Xdvi, and TeX can also execute shell commands under some
-circumstances. To disable this, see the &lsquo;<samp>-R</samp>&rsquo; option in <a href="https://tug.org/texinfohtml/dvips.html#Option-details">Option
-details</a> in <cite>Dvips</cite>, the xdvi man page, and <a href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex
+circumstances. To disable this, see the &lsquo;<samp>-R</samp>&rsquo; option in <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Option-details">Option
+details</a> in <cite>Dvips</cite>, the xdvi man page, and <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex
invocation</a> in <cite>Web2c</cite>, respectively.
</p>
<span id="index-local-cache-of-fonts"></span>
@@ -466,12 +449,12 @@ fonts is created on every machine.
writable font tree desirable, in spite of the potential security
problems. To do this you should change the value of <code>VARTEXFONTS</code>
in <samp>texmf.cnf</samp> to refer to some globally known directory.
-See <a href="#mktex-configuration">mktex configuration</a>.
+See <a href="#mktex-configuration"><samp>mktex</samp> configuration</a>.
</p>
<span id="index-append_002donly-directories-and-mktexpk"></span>
<p>The first restriction you can apply is to make newly-created directories
under <samp>texmf</samp> be append-only with an option in <samp>mktex.cnf</samp>.
-See <a href="#mktex-configuration">mktex configuration</a>.
+See <a href="#mktex-configuration"><samp>mktex</samp> configuration</a>.
</p>
<span id="index-group_002dwritable-directories"></span>
<span id="index-setgid-scripts"></span>
@@ -497,9 +480,11 @@ always set.
</p>
<hr>
-<span id="TeX-directory-structure"></span><div class="header">
+</div>
+<div class="chapter" id="TeX-directory-structure">
+<div class="header">
<p>
-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">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Security" accesskey="p" rel="prev">Security</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="TeX-directory-structure-1"></span><h2 class="chapter">4 TeX directory structure</h2>
@@ -514,8 +499,8 @@ distribution. It conforms to both the GNU coding standards and the
TeX directory structure (TDS) standard. For rationale and further
explanation, please see those documents. The GNU document is
available from <a href="https://gnu.org/prep/standards">https://gnu.org/prep/standards</a>. The TDS
-document is available from <a href="http://mirror.ctan.org/tds">http://mirror.ctan.org/tds</a>
-(see <a href="#unixtex_002eftp">unixtex.ftp</a>).
+document is available from <a href="https://ctan.org/pkg/tds">https://ctan.org/pkg/tds</a>
+(see <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>).
</p>
<p>In short, here is a skeleton of the default directory structure,
extracted from the TDS document:
@@ -593,9 +578,11 @@ extracted from the TDS document:
<hr>
-<span id="Path-searching"></span><div class="header">
+</div>
+<div class="chapter" id="Path-searching">
+<div class="header">
<p>
-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">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#TeX-support" accesskey="n" rel="next">TeX support</a>, Previous: <a href="#TeX-directory-structure" accesskey="p" rel="prev">TeX directory structure</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Path-searching-1"></span><h2 class="chapter">5 Path searching</h2>
@@ -611,24 +598,19 @@ other languages (Chinese, Spanish, Russian, Japanese, French, German,
&hellip;) as part of the TeX Live guide; see
<a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a> for links.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Searching-overview" accesskey="1">Searching overview</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Basic scheme for searching.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Path-sources" accesskey="2">Path sources</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Where search paths can be defined.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Path-expansion" accesskey="3">Path expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Special constructs in search paths.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Casefolding-search" accesskey="4">Casefolding search</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Fallback to case-insensitive search.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Filename-database" accesskey="5">Filename database</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Using an externally-built list to search.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Invoking-kpsewhich" accesskey="6">Invoking kpsewhich</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Standalone path lookup.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Searching-overview" accesskey="1">Searching overview</a></li>
+<li><a href="#Path-sources" accesskey="2">Path sources</a></li>
+<li><a href="#Path-expansion" accesskey="3">Path expansion</a></li>
+<li><a href="#Casefolding-search" accesskey="4">Casefolding search</a></li>
+<li><a href="#Filename-database" accesskey="5">Filename database (<code>ls-R</code>)</a></li>
+<li><a href="#Invoking-kpsewhich" accesskey="6"><code>kpsewhich</code>: Standalone path searching</a></li>
+</ul>
<hr>
-<span id="Searching-overview"></span><div class="header">
+<div class="section" id="Searching-overview">
+<div class="header">
<p>
Next: <a href="#Path-sources" accesskey="n" rel="next">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -656,7 +638,7 @@ operating systems&rsquo; conventions.
<span id="index-database-search"></span>
<span id="index-searching-the-database"></span>
<p>To check a particular path element <var>e</var>, Kpathsea first sees if a
-prebuilt database (see <a href="#Filename-database">Filename database</a>) applies to <var>e</var>, i.e.,
+prebuilt database (see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>) applies to <var>e</var>, i.e.,
if the database is in a directory that is a prefix of <var>e</var>. If so,
the path specification is matched against the contents of the database.
</p>
@@ -734,7 +716,9 @@ algorithm when searching for a file of a particular type (see <a href="#File-loo
</p>
<hr>
-<span id="Path-sources"></span><div class="header">
+</div>
+<div class="section" id="Path-sources">
+<div class="header">
<p>
Next: <a href="#Path-expansion" accesskey="n" rel="next">Path expansion</a>, Previous: <a href="#Searching-overview" accesskey="p" rel="prev">Searching overview</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -758,7 +742,7 @@ override; for example, <code>TEXINPUTS_latex</code> overrides <code>TEXINPUTS</c
if the program being run is named &lsquo;<samp>latex</samp>&rsquo;.
</p>
</li><li> A program-specific configuration file, e.g., an &lsquo;<samp>S /a:/b</samp>&rsquo; line in
-Dvips&rsquo; <samp>config.ps</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>).
+Dvips&rsquo; <samp>config.ps</samp> (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>).
</li><li> <span id="index-configuration-file_002c-source-for-path"></span>
<span id="index-Kpathsea-config-file_002c-source-for-path"></span>
@@ -775,14 +759,14 @@ debugging options (see <a href="#Debugging">Debugging</a>).
</p>
<p>These sources may be combined via default expansion (see <a href="#Default-expansion">Default expansion</a>).
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Config-files" accesskey="1">Config files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Kpathsea&rsquo;s runtime config files (texmf.cnf).
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Config-files" accesskey="1">Config files</a></li>
+</ul>
<hr>
-<span id="Config-files"></span><div class="header">
+<div class="subsection" id="Config-files">
+<div class="header">
<p>
Up: <a href="#Path-sources" accesskey="u" rel="up">Path sources</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -821,10 +805,10 @@ mentions most features. The format of <samp>texmf.cnf</samp> files follows:
</p>
<ul>
<li> <span id="index-comments_002c-in-texmf_002ecnf"></span>
-Comments start with &lsquo;<samp>%</samp>&rsquo;, either at the beginning of a line or
-preceded by whitespace, and continue to the end of the line. That is,
-similar to most shells, a &lsquo;<samp>%</samp>&rsquo; in the &ldquo;middle&rdquo; of a value does not
-start a comment. Examples:
+Comments start with &lsquo;<samp>%</samp>&rsquo; or &lsquo;<samp>#</samp>&rsquo;, either at the beginning of a
+line or preceded by whitespace, and continue to the end of the line.
+That is, similar to most shells, a comment character in the &ldquo;middle&rdquo;
+of a value does not start a comment. Examples:
<div class="example">
<pre class="example">% this is a comment
@@ -898,16 +882,6 @@ TEXINPUTS.latex2e = $latex2e_inputs
TEXINPUTS.latex = $latex2e_inputs
</pre></div>
-<span id="index-shell-scripts-as-configuration-files"></span>
-<span id="index-configuration-files-as-shell-scripts_002e"></span>
-<p>This format has some similarity to Bourne shell scripts&mdash;change the
-comment character to <code>#</code>, disallow spaces around the <code>=</code>,
-and get rid of the <code>.<var>name</var></code> convention, and it could be run
-through the shell. However, there seemed little advantage in this,
-since all the information would have to passed back to Kpathsea and
-parsed there anyway, since the <code>sh</code> process couldn&rsquo;t affect its
-parent&rsquo;s environment.
-</p>
<span id="index-_003d-omitted-in-texmf_002ecnf-and-misparsing"></span>
<p>The combination of spaces being ignored before the <code>.</code> of a
program name qualifer and the optional &lsquo;<samp>=</samp>&rsquo; for the assignment has
@@ -933,7 +907,10 @@ avoid them all.
</p>
<hr>
-<span id="Path-expansion"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Path-expansion">
+<div class="header">
<p>
Next: <a href="#Casefolding-search" accesskey="n" rel="next">Casefolding search</a>, Previous: <a href="#Path-sources" accesskey="p" rel="prev">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -950,24 +927,19 @@ contain a directory or file <samp>baz</samp>.
</p>
<p>These expansions are explained in the sections below.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Default-expansion" accesskey="1">Default expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">a: or :a or a::b expands to a default.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Variable-expansion" accesskey="2">Variable expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">$foo and ${foo} expand to environment values.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Tilde-expansion" accesskey="3">Tilde expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">~ and ~user expand to home directories.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Brace-expansion" accesskey="4">Brace expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">a{foo,bar}b expands to afoob abarb.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#KPSE_005fDOT-expansion" accesskey="5">KPSE_DOT expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">. is replaced with $KPSE_DOT if it is defined.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Subdirectory-expansion" accesskey="6">Subdirectory expansion</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">a// and a//b recursively expand to subdirs.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Default-expansion" accesskey="1">Default expansion</a></li>
+<li><a href="#Variable-expansion" accesskey="2">Variable expansion</a></li>
+<li><a href="#Tilde-expansion" accesskey="3">Tilde expansion</a></li>
+<li><a href="#Brace-expansion" accesskey="4">Brace expansion</a></li>
+<li><a href="#KPSE_005fDOT-expansion" accesskey="5"><code>KPSE_DOT</code> expansion</a></li>
+<li><a href="#Subdirectory-expansion" accesskey="6">Subdirectory expansion</a></li>
+</ul>
<hr>
-<span id="Default-expansion"></span><div class="header">
+<div class="subsection" id="Default-expansion">
+<div class="header">
<p>
Next: <a href="#Variable-expansion" accesskey="n" rel="next">Variable expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1040,7 +1012,9 @@ Default expansion is implemented in the source file
</p>
<hr>
-<span id="Variable-expansion"></span><div class="header">
+</div>
+<div class="subsection" id="Variable-expansion">
+<div class="header">
<p>
Next: <a href="#Tilde-expansion" accesskey="n" rel="next">Tilde expansion</a>, Previous: <a href="#Default-expansion" accesskey="p" rel="prev">Default expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1091,7 +1065,9 @@ paths are initialized (see <a href="#Path-sources">Path sources</a>).
</p>
<hr>
-<span id="Tilde-expansion"></span><div class="header">
+</div>
+<div class="subsection" id="Tilde-expansion">
+<div class="header">
<p>
Next: <a href="#Brace-expansion" accesskey="n" rel="next">Brace expansion</a>, Previous: <a href="#Variable-expansion" accesskey="p" rel="prev">Variable expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1134,9 +1110,11 @@ is &lsquo;<samp>/</samp>&rsquo;, the path element &lsquo;<samp>~root/mymacros</s
</p>
<hr>
-<span id="Brace-expansion"></span><div class="header">
+</div>
+<div class="subsection" id="Brace-expansion">
+<div class="header">
<p>
-Next: <a href="#KPSE_005fDOT-expansion" accesskey="n" rel="next">KPSE_DOT expansion</a>, Previous: <a href="#Tilde-expansion" accesskey="p" rel="prev">Tilde expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#KPSE_005fDOT-expansion" accesskey="n" rel="next"><code>KPSE_DOT</code> expansion</a>, Previous: <a href="#Tilde-expansion" accesskey="p" rel="prev">Tilde expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Brace-expansion-1"></span><h4 class="subsection">5.3.4 Brace expansion</h4>
@@ -1175,7 +1153,9 @@ example could have been written &lsquo;<samp>x{A:B}{1:2}y</samp>&rsquo; (on Unix
</p>
<hr>
-<span id="KPSE_005fDOT-expansion"></span><div class="header">
+</div>
+<div class="subsection" id="KPSE_005fDOT-expansion">
+<div class="header">
<p>
Next: <a href="#Subdirectory-expansion" accesskey="n" rel="next">Subdirectory expansion</a>, Previous: <a href="#Brace-expansion" accesskey="p" rel="prev">Brace expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1186,14 +1166,16 @@ Next: <a href="#Subdirectory-expansion" accesskey="n" rel="next">Subdirectory ex
<p>When <code>KPSE_DOT</code> is defined in the environment, it names a directory
that should be considered the current directory for the purpose of
looking up files in the search paths. This feature is needed by the
-&lsquo;<samp>mktex&hellip;</samp>&rsquo; scripts <a href="#mktex-scripts">mktex scripts</a>, because these
+&lsquo;<samp>mktex&hellip;</samp>&rsquo; scripts <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>, because these
change the working directory. You should not ever define it yourself.
</p>
<hr>
-<span id="Subdirectory-expansion"></span><div class="header">
+</div>
+<div class="subsection" id="Subdirectory-expansion">
+<div class="header">
<p>
-Previous: <a href="#KPSE_005fDOT-expansion" accesskey="p" rel="prev">KPSE_DOT expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#KPSE_005fDOT-expansion" accesskey="p" rel="prev"><code>KPSE_DOT</code> expansion</a>, Up: <a href="#Path-expansion" accesskey="u" rel="up">Path expansion</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Subdirectory-expansion-1"></span><h4 class="subsection">5.3.6 Subdirectory expansion</h4>
@@ -1259,9 +1241,12 @@ know.
</p>
<hr>
-<span id="Casefolding-search"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Casefolding-search">
+<div class="header">
<p>
-Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database (<code>ls-R</code>)</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Casefolding-search-1"></span><h3 class="section">5.4 Casefolding search</h3>
@@ -1280,15 +1265,14 @@ runtime by setting the configuration variable
<code>texmf_casefold_search</code>, to a true value, e.g., &lsquo;<samp>1</samp>&rsquo;; this is
done by default in TeX Live.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Casefolding-rationale" accesskey="1">Rationale</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Casefolding-examples" accesskey="2">Examples</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Casefolding-rationale" accesskey="1">Casefolding rationale</a></li>
+<li><a href="#Casefolding-examples" accesskey="2">Casefolding examples</a></li>
+</ul>
<hr>
-<span id="Casefolding-rationale"></span><div class="header">
+<div class="subsection" id="Casefolding-rationale">
+<div class="header">
<p>
Next: <a href="#Casefolding-examples" accesskey="n" rel="next">Casefolding examples</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1327,7 +1311,9 @@ always been true.
</p>
<hr>
-<span id="Casefolding-examples"></span><div class="header">
+</div>
+<div class="subsection" id="Casefolding-examples">
+<div class="header">
<p>
Previous: <a href="#Casefolding-rationale" accesskey="p" rel="prev">Casefolding rationale</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1395,7 +1381,7 @@ case-sensitive systems), as it always has.
<span id="index-_0021_0021-and-casefolding"></span>
<p>The caveat about not searching the disk amounts to saying that
casefolding does not happen in the trees specified with &lsquo;<samp>!!</samp>&rsquo;
-(see <a href="#ls_002dR">ls-R</a>), that is, where only database (<samp>ls-R</samp>) searching
+(see <a href="#ls_002dR"><samp>ls-R</samp></a>), that is, where only database (<samp>ls-R</samp>) searching
is done. In TeX Live, that is the &lsquo;<samp>texmf-local</samp>&rsquo; and
&lsquo;<samp>texmf-dist</samp>&rsquo; trees (also <code>$TEXMFSYSCONFIG</code> and
<code>$TEXMFSYSVAR</code>, but those are rarely noticed). The rationale for
@@ -1444,9 +1430,12 @@ happens with the elements of the leaf directory.
<hr>
-<span id="Filename-database"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Filename-database">
+<div class="header">
<p>
-Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next">Invoking kpsewhich</a>, Previous: <a href="#Casefolding-search" accesskey="p" rel="prev">Casefolding search</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next"><code>kpsewhich</code>: Standalone path searching</a>, Previous: <a href="#Casefolding-search" accesskey="p" rel="prev">Casefolding search</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Filename-database-_0028ls_002dR_0029"></span><h3 class="section">5.5 Filename database (<code>ls-R</code>)</h3>
@@ -1469,20 +1458,18 @@ names to the files listed in <samp>ls-R</samp>.
<p>The <samp>ls-R</samp> and <samp>aliases</samp> features are implemented in the
source file <samp>kpathsea/db.c</samp>.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#ls_002dR" accesskey="1">ls-R</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The main filename database.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Filename-aliases" accesskey="2">Filename aliases</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Aliases for those names.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Database-format" accesskey="3">Database format</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Syntax details of the database file.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#ls_002dR" accesskey="1"><samp>ls-R</samp></a></li>
+<li><a href="#Filename-aliases" accesskey="2">Filename aliases</a></li>
+<li><a href="#Database-format" accesskey="3">Database format</a></li>
+</ul>
<hr>
-<span id="ls_002dR"></span><div class="header">
+<div class="subsection" id="ls_002dR">
+<div class="header">
<p>
-Next: <a href="#Filename-aliases" accesskey="n" rel="next">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Filename-aliases" accesskey="n" rel="next">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code>ls-R</code>)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="ls_002dR-1"></span><h4 class="subsection">5.5.1 <samp>ls-R</samp></h4>
@@ -1586,9 +1573,11 @@ found.
<hr>
-<span id="Filename-aliases"></span><div class="header">
+</div>
+<div class="subsection" id="Filename-aliases">
+<div class="header">
<p>
-Next: <a href="#Database-format" accesskey="n" rel="next">Database format</a>, Previous: <a href="#ls_002dR" accesskey="p" rel="prev">ls-R</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Database-format" accesskey="n" rel="next">Database format</a>, Previous: <a href="#ls_002dR" accesskey="p" rel="prev"><samp>ls-R</samp></a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code>ls-R</code>)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Filename-aliases-1"></span><h4 class="subsection">5.5.2 Filename aliases</h4>
@@ -1621,9 +1610,11 @@ aliases.
</p>
<hr>
-<span id="Database-format"></span><div class="header">
+</div>
+<div class="subsection" id="Database-format">
+<div class="header">
<p>
-Previous: <a href="#Filename-aliases" accesskey="p" rel="prev">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Filename-aliases" accesskey="p" rel="prev">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database (<code>ls-R</code>)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Database-format-1"></span><h4 class="subsection">5.5.3 Database format</h4>
@@ -1673,9 +1664,12 @@ btxdoc.bib
<hr>
-<span id="Invoking-kpsewhich"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Invoking-kpsewhich">
+<div class="header">
<p>
-Previous: <a href="#Filename-database" accesskey="p" rel="prev">Filename database</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Filename-database" accesskey="p" rel="prev">Filename database (<code>ls-R</code>)</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="kpsewhich_003a-Standalone-path-searching"></span><h3 class="section">5.6 <code>kpsewhich</code>: Standalone path searching</h3>
@@ -1699,22 +1693,19 @@ distributed &lsquo;<samp>mktex&hellip;</samp>&rsquo; scripts.
Options can start with either &lsquo;<samp>-</samp>&rsquo; or &lsquo;<samp>--</samp>&rsquo;, and any unambiguous
abbreviation is accepted.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Path-searching-options" accesskey="1">Path searching options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Changing the mode, resolution, etc.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Specially_002drecognized-files" accesskey="2">Specially-recognized files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Default formats for texmf.cnf, etc.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Auxiliary-tasks" accesskey="3">Auxiliary tasks</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Path and variable expansion, etc.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Standard-options" accesskey="4">Standard options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">&lsquo;<samp>--help</samp>&rsquo; and &lsquo;<samp>--version</samp>&rsquo;.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Path-searching-options" accesskey="1">Path searching options</a></li>
+<li><a href="#Specially_002drecognized-files" accesskey="2">Specially-recognized files for <code>kpsewhich</code></a></li>
+<li><a href="#Auxiliary-tasks" accesskey="3">Auxiliary tasks</a></li>
+<li><a href="#Standard-options" accesskey="4">Standard options</a></li>
+</ul>
<hr>
-<span id="Path-searching-options"></span><div class="header">
+<div class="subsection" id="Path-searching-options">
+<div class="header">
<p>
-Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files for <code>kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Path-searching-options-1"></span><h4 class="subsection">5.6.1 Path searching options</h4>
@@ -1726,19 +1717,17 @@ filename, and returns the first file found.
<p>Various options alter the path searching behavior:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>--all</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dall"></span>
-<span id="index-all-matches_002c-finding"></span>
+<dt id='index-_002d_002dall'><span>&lsquo;<samp>--all</samp>&rsquo;<a href='#index-_002d_002dall' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-all-matches_002c-finding"></span>
<p>Report all matches found, one per line. By default, if there is more
than one match, just one will be reported (chosen effectively at
random). Exception: with the glyph formats (<code>pk</code>, <code>gf</code>),
this option has no effect and only the first match is returned.
</p>
</dd>
-<dt>&lsquo;<samp>--casefold-search</samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--no-casefold-search</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dcasefold_002dsearch"></span>
-<span id="index-_002d_002dno_002dcasefold_002dsearch"></span>
+<dt id='index-_002d_002dcasefold_002dsearch'><span>&lsquo;<samp>--casefold-search</samp>&rsquo;<a href='#index-_002d_002dcasefold_002dsearch' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>--no-casefold-search</samp>&rsquo;</span></dt>
+<dd><span id="index-_002d_002dno_002dcasefold_002dsearch"></span>
<p>Explicitly enable or disable the fallback to a case-insensitive search
on Unix platforms (see <a href="#Casefolding-search">Casefolding search</a>); no effect on Windows.
The default is enabled, set in <code>texmf.cnf</code>. Disabling
@@ -1748,9 +1737,8 @@ case-insensitive, it merely means that Kpathsea does not do any
casefolding itself.
</p>
</dd>
-<dt>&lsquo;<samp>--cnf-line=<var>str</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dcnf_002dline"></span>
-<p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp>
+<dt id='index-_002d_002dcnf_002dline'><span>&lsquo;<samp>--cnf-line=<var>str</var></samp>&rsquo;<a href='#index-_002d_002dcnf_002dline' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Parse <var>str</var> as if it were a line in the <samp>texmf.cnf</samp>
configuration file (see <a href="#Config-files">Config files</a>), overriding settings in the
actual configuration files, and also in the environment (see <a href="#Path-sources">Path sources</a>). This is implemented by making any settings from <var>str</var>
in the environment, overwriting any value already there. Thus, an
@@ -1770,18 +1758,16 @@ behavior is for values set on the command line with <code>--cnf-line</code>
to override them.
</p>
</dd>
-<dt>&lsquo;<samp>--dpi=<var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002ddpi_003dnum"></span>
-<span id="index-_002dD-num"></span>
+<dt id='index-_002d_002ddpi_003dnum'><span>&lsquo;<samp>--dpi=<var>num</var></samp>&rsquo;<a href='#index-_002d_002ddpi_003dnum' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002dD-num"></span>
<span id="index-resolution_002c-setting"></span>
<p>Set the resolution to <var>num</var>; this only affects &lsquo;<samp>gf</samp>&rsquo; and
&lsquo;<samp>pk</samp>&rsquo; lookups. &lsquo;<samp>-D</samp>&rsquo; is a synonym, for compatibility with
Dvips. Default is 600.
</p>
</dd>
-<dt>&lsquo;<samp>--engine=<var>name</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dengine_003dname"></span>
-<span id="index-engine-name"></span>
+<dt id='index-_002d_002dengine_003dname'><span>&lsquo;<samp>--engine=<var>name</var></samp>&rsquo;<a href='#index-_002d_002dengine_003dname' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-engine-name"></span>
<p>Set the engine name to <var>name</var>. By default it is not set. The
engine name is used in some search paths to allow files with the same
name but used by different engines to coexist.
@@ -1799,9 +1785,8 @@ a normal recursive search along the path where the dumps are stored,
namely &lsquo;<samp>$TEXMF/web2c{/$engine,}</samp>&rsquo;.)
</p>
</dd>
-<dt>&lsquo;<samp>--format=<var>name</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dformat_003dname"></span>
-<p>Set the format for lookup to <var>name</var>. By default, the format is
+<dt id='index-_002d_002dformat_003dname'><span>&lsquo;<samp>--format=<var>name</var></samp>&rsquo;<a href='#index-_002d_002dformat_003dname' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set the format for lookup to <var>name</var>. By default, the format is
guessed from the filename, with &lsquo;<samp>tex</samp>&rsquo; being used if nothing else
fits. The recognized filename extensions (including any leading
&lsquo;<samp>.</samp>&rsquo;) are also allowable <var>name</var>s.
@@ -1884,40 +1869,35 @@ bltxml: .bltxml
<p>This option and &lsquo;<samp>--path</samp>&rsquo; are mutually exclusive.
</p>
</dd>
-<dt>&lsquo;<samp>--interactive</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dinteractive"></span>
-<span id="index-interactive-query"></span>
+<dt id='index-_002d_002dinteractive'><span>&lsquo;<samp>--interactive</samp>&rsquo;<a href='#index-_002d_002dinteractive' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-interactive-query"></span>
<p>After processing the command line, read additional filenames to look up
from standard input.
</p>
</dd>
-<dt>&lsquo;<samp>--mktex=<var>filetype</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--no-mktex=<var>filetype</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dmktex_003dfiletype"></span>
-<span id="index-_002d_002dno_002dmktex_003dfiletype"></span>
+<dt id='index-_002d_002dmktex_003dfiletype'><span>&lsquo;<samp>--mktex=<var>filetype</var></samp>&rsquo;<a href='#index-_002d_002dmktex_003dfiletype' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>--no-mktex=<var>filetype</var></samp>&rsquo;</span></dt>
+<dd><span id="index-_002d_002dno_002dmktex_003dfiletype"></span>
<p>Turn on or off the &lsquo;<samp>mktex</samp>&rsquo; script associated with <var>filetype</var>.
Usual values for <var>filetype</var> are &lsquo;<samp>pk</samp>&rsquo;, &lsquo;<samp>mf</samp>&rsquo;, &lsquo;<samp>tex</samp>&rsquo;,
and &lsquo;<samp>tfm</samp>&rsquo;. By default, all are off in Kpsewhich, even if they
are enabled for TeX. This option implies setting
-<code>--must-exist</code>. See <a href="#mktex-scripts">mktex scripts</a>.
+<code>--must-exist</code>. See <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--mode=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dmode_003dstring"></span>
-<p>Set the mode name to <var>string</var>; this also only affects &lsquo;<samp>gf</samp>&rsquo; and
-&lsquo;<samp>pk</samp>&rsquo; lookups. No default: any mode will be found. See <a href="#mktex-script-arguments">mktex script arguments</a>.
+<dt id='index-_002d_002dmode_003dstring'><span>&lsquo;<samp>--mode=<var>string</var></samp>&rsquo;<a href='#index-_002d_002dmode_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set the mode name to <var>string</var>; this also only affects &lsquo;<samp>gf</samp>&rsquo; and
+&lsquo;<samp>pk</samp>&rsquo; lookups. No default: any mode will be found. See <a href="#mktex-script-arguments"><samp>mktex</samp> script arguments</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--must-exist</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dmust_002dexist"></span>
-<p>Do everything possible to find the files, notably including searching
+<dt id='index-_002d_002dmust_002dexist'><span>&lsquo;<samp>--must-exist</samp>&rsquo;<a href='#index-_002d_002dmust_002dexist' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Do everything possible to find the files, notably including searching
the disk and running the &lsquo;<samp>mktex</samp>&rsquo; scripts. By default, only the
<samp>ls-R</samp> database is checked, in the interest of efficiency.
</p>
</dd>
-<dt>&lsquo;<samp>--path=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dpath_003dstring"></span>
-<p>Search along the path <var>string</var> (colon-separated as usual), instead
+<dt id='index-_002d_002dpath_003dstring'><span>&lsquo;<samp>--path=<var>string</var></samp>&rsquo;<a href='#index-_002d_002dpath_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Search along the path <var>string</var> (colon-separated as usual), instead
of guessing the search path from the filename. &lsquo;<samp>//</samp>&rsquo; and all the
usual expansions are supported (see <a href="#Path-expansion">Path expansion</a>). This option
and &lsquo;<samp>--format</samp>&rsquo; are mutually exclusive. To output the complete
@@ -1925,16 +1905,14 @@ directory expansion of a path, instead of doing a one-shot lookup, see
&lsquo;<samp>--expand-path</samp>&rsquo; and &lsquo;<samp>--show-path</samp>&rsquo; in the following section.
</p>
</dd>
-<dt>&lsquo;<samp>--progname=<var>name</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dprogname_003dname"></span>
-<p>Set the program name to <var>name</var>; default is &lsquo;<samp>kpsewhich</samp>&rsquo;. This
+<dt id='index-_002d_002dprogname_003dname'><span>&lsquo;<samp>--progname=<var>name</var></samp>&rsquo;<a href='#index-_002d_002dprogname_003dname' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set the program name to <var>name</var>; default is &lsquo;<samp>kpsewhich</samp>&rsquo;. This
can affect the search paths via the &lsquo;<samp>.<var>prognam</var></samp>&rsquo; feature in
configuration files (see <a href="#Config-files">Config files</a>).
</p>
</dd>
-<dt>&lsquo;<samp>--subdir=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dsubdir_003dstring"></span>
-<p>Report only those matches whose directory part <em>ends</em> with
+<dt id='index-_002d_002dsubdir_003dstring'><span>&lsquo;<samp>--subdir=<var>string</var></samp>&rsquo;<a href='#index-_002d_002dsubdir_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Report only those matches whose directory part <em>ends</em> with
<var>string</var> (compared literally, except case is ignored on a
case-insensitive operating system). For example, suppose there are
two matches for a given name:
@@ -2013,9 +1991,11 @@ in <samp>/some/coincidental/pkg1/path/</samp>, and we wouldn&rsquo;t want to mat
<hr>
-<span id="Specially_002drecognized-files"></span><div class="header">
+</div>
+<div class="subsection" id="Specially_002drecognized-files">
+<div class="header">
<p>
-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">Invoking kpsewhich</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+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>kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Specially_002drecognized-files-for-kpsewhich"></span><h4 class="subsection">5.6.2 Specially-recognized files for <code>kpsewhich</code></h4>
@@ -2033,49 +2013,49 @@ with their corresponding format:
<dd>
<span id="index-config_002eps"></span>
</dd>
-<dt><samp>config.ps</samp></dt>
+<dt><span><samp>config.ps</samp></span></dt>
<dd><p><code>dvips config</code>
</p>
<span id="index-dvipdfmx_002ecfg"></span>
</dd>
-<dt><samp>dvipdfmx.cfg</samp></dt>
+<dt><span><samp>dvipdfmx.cfg</samp></span></dt>
<dd><p>&lsquo;<samp>other text files</samp>&rsquo;
</p>
<span id="index-fmtutil_002ecnf"></span>
</dd>
-<dt><samp>fmtutil.cnf</samp></dt>
+<dt><span><samp>fmtutil.cnf</samp></span></dt>
<dd><p>&lsquo;<samp>web2c files</samp>&rsquo;
</p>
<span id="index-glyphlist_002etxt"></span>
</dd>
-<dt><samp>glyphlist.txt</samp></dt>
+<dt><span><samp>glyphlist.txt</samp></span></dt>
<dd><p>&lsquo;<samp>map</samp>&rsquo;
</p>
<span id="index-mktex_002ecnf"></span>
</dd>
-<dt><samp>mktex.cnf</samp></dt>
+<dt><span><samp>mktex.cnf</samp></span></dt>
<dd><p>&lsquo;<samp>web2c files</samp>&rsquo;
</p>
<span id="index-pdfglyphlist_002etxt"></span>
</dd>
-<dt><samp>pdfglyphlist.txt</samp></dt>
+<dt><span><samp>pdfglyphlist.txt</samp></span></dt>
<dd><p>&lsquo;<samp>map</samp>&rsquo;
</p>
<span id="index-pdftex_002ecfg"></span>
<span id="index-pdftexconfig_002etex"></span>
</dd>
-<dt><samp>pdftex.cfg</samp></dt>
+<dt><span><samp>pdftex.cfg</samp></span></dt>
<dd><p>&lsquo;<samp>pdftex config</samp>&rsquo; (although <samp>pdftex.cfg</samp> is not used any more;
look for the file <samp>pdftexconfig.tex</samp> instead.)
</p>
<span id="index-texmf_002ecnf"></span>
</dd>
-<dt><samp>texmf.cnf</samp></dt>
+<dt><span><samp>texmf.cnf</samp></span></dt>
<dd><p>&lsquo;<samp>cnf</samp>&rsquo;
</p>
<span id="index-XDvi"></span>
</dd>
-<dt><samp>XDvi</samp></dt>
+<dt><span><samp>XDvi</samp></span></dt>
<dd><p>&lsquo;<samp>other text files</samp>&rsquo;
</p>
</dd>
@@ -2090,9 +2070,11 @@ information about the above configuration files (among others).
</p>
<hr>
-<span id="Auxiliary-tasks"></span><div class="header">
+</div>
+<div class="subsection" id="Auxiliary-tasks">
+<div class="header">
<p>
-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</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+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>kpsewhich</code></a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Auxiliary-tasks-1"></span><h4 class="subsection">5.6.3 Auxiliary tasks</h4>
@@ -2101,20 +2083,17 @@ Next: <a href="#Standard-options" accesskey="n" rel="next">Standard options</a>,
<p>Kpsewhich provides some features in addition to path lookup as such:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>--debug=<var>num</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002ddebug_003dnum"></span>
-<p>Set debugging options to <var>num</var>. See <a href="#Debugging">Debugging</a>.
+<dt id='index-_002d_002ddebug_003dnum'><span>&lsquo;<samp>--debug=<var>num</var></samp>&rsquo;<a href='#index-_002d_002ddebug_003dnum' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Set debugging options to <var>num</var>. See <a href="#Debugging">Debugging</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--expand-braces=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dexpand_002dbraces_003dstring"></span>
-<p>Output variable, tilde, and brace expansion of <var>string</var>, which is
+<dt id='index-_002d_002dexpand_002dbraces_003dstring'><span>&lsquo;<samp>--expand-braces=<var>string</var></samp>&rsquo;<a href='#index-_002d_002dexpand_002dbraces_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Output variable, tilde, and brace expansion of <var>string</var>, which is
assumed to be a single path element. See <a href="#Path-expansion">Path expansion</a>.
</p>
</dd>
-<dt>&lsquo;<samp>--expand-path=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dexpand_002dpath_003dstring"></span>
-<p>Output the complete expansion of <var>string</var>, with each element
+<dt id='index-_002d_002dexpand_002dpath_003dstring'><span>&lsquo;<samp>--expand-path=<var>string</var></samp>&rsquo;<a href='#index-_002d_002dexpand_002dpath_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Output the complete expansion of <var>string</var>, with each element
separated by the usual path separator on the current system (&lsquo;<samp>;</samp>&rsquo;
on Windows, &lsquo;<samp>:</samp>&rsquo; otherwise). This may be useful to construct a
custom search path for a format not otherwise supported. To retrieve
@@ -2134,9 +2113,8 @@ $ kpsewhich --expand-path '/nonesuch'
&lsquo;<samp>--path</samp>&rsquo; (see <a href="#Path-searching-options">Path searching options</a>).
</p>
</dd>
-<dt>&lsquo;<samp>--expand-var=<var>string</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dexpand_002dvar_003dstring"></span>
-<p>Output the variable and tilde expansion of <var>string</var>. For example,
+<dt id='index-_002d_002dexpand_002dvar_003dstring'><span>&lsquo;<samp>--expand-var=<var>string</var></samp>&rsquo;<a href='#index-_002d_002dexpand_002dvar_003dstring' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Output the variable and tilde expansion of <var>string</var>. For example,
with the usual <samp>texmf.cnf</samp>, &lsquo;<samp>kpsewhich
--expand-var='$TEXMF'</samp>&rsquo; returns the TeX system hierarchy root(s).
See <a href="#Path-expansion">Path expansion</a>. The specified <var>string</var> can contain
@@ -2144,33 +2122,29 @@ anything, though, not just variable references. This calls
<code>kpse_var_expand</code> (see <a href="#Programming-with-config-files">Programming with config files</a>).
</p>
</dd>
-<dt>&lsquo;<samp>--help-formats</samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dhelp_002dformats"></span>
-<p>Output information about each supported format (see <a href="#Supported-file-formats">Supported file formats</a>), including the names and abbreviations, variables
+<dt id='index-_002d_002dhelp_002dformats'><span>&lsquo;<samp>--help-formats</samp>&rsquo;<a href='#index-_002d_002dhelp_002dformats' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Output information about each supported format (see <a href="#Supported-file-formats">Supported file formats</a>), including the names and abbreviations, variables
looked for, and the original path.
</p>
</dd>
-<dt>&lsquo;<samp>--safe-in-name=<var>name</var></samp>&rsquo;</dt>
-<dt>&lsquo;<samp>--safe-out-name=<var>name</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dsafe_002din_002dname_003dname"></span>
-<span id="index-_002d_002dsafe_002dout_002dname_003dname"></span>
+<dt id='index-_002d_002dsafe_002din_002dname_003dname'><span>&lsquo;<samp>--safe-in-name=<var>name</var></samp>&rsquo;<a href='#index-_002d_002dsafe_002din_002dname_003dname' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span>&lsquo;<samp>--safe-out-name=<var>name</var></samp>&rsquo;</span></dt>
+<dd><span id="index-_002d_002dsafe_002dout_002dname_003dname"></span>
<p>Exit successfully if <var>name</var> is safe to open for reading or
writing, respectively, else unsuccessfully. No output is written.
These tests take account of the related Kpathsea configuration
settings (see <a href="#Calling-sequence">Calling sequence</a>).
</p>
</dd>
-<dt>&lsquo;<samp>--show-path=<var>name</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dshow_002dpath_003dname"></span>
-<p>Show the path that would be used for file lookups of file type
+<dt id='index-_002d_002dshow_002dpath_003dname'><span>&lsquo;<samp>--show-path=<var>name</var></samp>&rsquo;<a href='#index-_002d_002dshow_002dpath_003dname' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Show the path that would be used for file lookups of file type
<var>name</var>. Either a filename extension (&lsquo;<samp>pk</samp>&rsquo;, &lsquo;<samp>.vf</samp>&rsquo;, etc.)
or an integer can be used, just as with &lsquo;<samp>--format</samp>&rsquo;, described in
the previous section.
</p>
</dd>
-<dt>&lsquo;<samp>--var-brace-value=<var>variable</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dvar_002dbrace_002dvalue_003dvariable"></span>
-<p>Like &lsquo;<samp>--var-value</samp>&rsquo; (next), but also expands &lsquo;<samp>{...}</samp>&rsquo;
+<dt id='index-_002d_002dvar_002dbrace_002dvalue_003dvariable'><span>&lsquo;<samp>--var-brace-value=<var>variable</var></samp>&rsquo;<a href='#index-_002d_002dvar_002dbrace_002dvalue_003dvariable' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Like &lsquo;<samp>--var-value</samp>&rsquo; (next), but also expands &lsquo;<samp>{...}</samp>&rsquo;
constructs. (see <a href="#Brace-expansion">Brace expansion</a>). Thus, the value is assumed to
possibly be several path elements, and &lsquo;<samp>~</samp>&rsquo; is expanded at the
beginning of each. The path separator is changed to that of the
@@ -2184,9 +2158,8 @@ value, as commonly used in <samp>texmf.cnf</samp>, has changed to a
Windows-ish system, the &lsquo;<samp>;</samp>&rsquo; would remain.
</p>
</dd>
-<dt>&lsquo;<samp>--var-value=<var>variable</var></samp>&rsquo;</dt>
-<dd><span id="index-_002d_002dvar_002dvalue_003dvariable"></span>
-<p>Outputs the value of <var>variable</var> (a simple identifier like
+<dt id='index-_002d_002dvar_002dvalue_003dvariable'><span>&lsquo;<samp>--var-value=<var>variable</var></samp>&rsquo;<a href='#index-_002d_002dvar_002dvalue_003dvariable' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>Outputs the value of <var>variable</var> (a simple identifier like
&lsquo;<samp>TEXMFDIST</samp>&rsquo;, with no &lsquo;<samp>$</samp>&rsquo; or other constructs), expanding
&lsquo;<samp>$</samp>&rsquo; (see <a href="#Variable-expansion">Variable expansion</a>) and &lsquo;<samp>~</samp>&rsquo; (see <a href="#Tilde-expansion">Tilde expansion</a>) constructs in the value. &lsquo;<samp>~</samp>&rsquo; expansion happens at the
beginning of the overall value and at the beginning of a variable
@@ -2204,9 +2177,11 @@ input value, on all systems.
<hr>
-<span id="Standard-options"></span><div class="header">
+</div>
+<div class="subsection" id="Standard-options">
+<div class="header">
<p>
-Previous: <a href="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up"><code>kpsewhich</code>: Standalone path searching</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Standard-options-1"></span><h4 class="subsection">5.6.4 Standard options</h4>
@@ -2225,9 +2200,13 @@ successfully.
<hr>
-<span id="TeX-support"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="chapter" id="TeX-support">
+<div class="header">
<p>
-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">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Programming" accesskey="n" rel="next">Programming</a>, Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="TeX-support-1"></span><h2 class="chapter">6 TeX support</h2>
@@ -2251,22 +2230,18 @@ rest. Searches are based solely on names of files, not their
contents&mdash;if a GF file is (mis)named <samp>cmr10.600pk</samp>, it will be
found as a PK file.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Supported-file-formats" accesskey="1">Supported file formats</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">File types Kpathsea knows about.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#File-lookup" accesskey="2">File lookup</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Searching for most kinds of files.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Glyph-lookup" accesskey="3">Glyph lookup</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Searching for bitmap fonts.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Suppressing-warnings" accesskey="4">Suppressing warnings</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Avoiding warnings via TEX_HUSH.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#mktex-scripts" accesskey="5">mktex scripts</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Generating files at runtime.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Supported-file-formats" accesskey="1">Supported file formats</a></li>
+<li><a href="#File-lookup" accesskey="2">File lookup</a></li>
+<li><a href="#Glyph-lookup" accesskey="3">Glyph lookup</a></li>
+<li><a href="#Suppressing-warnings" accesskey="4">Suppressing warnings</a></li>
+<li><a href="#mktex-scripts" accesskey="5"><samp>mktex</samp> scripts</a></li>
+</ul>
<hr>
-<span id="Supported-file-formats"></span><div class="header">
+<div class="section" id="Supported-file-formats">
+<div class="header">
<p>
Next: <a href="#File-lookup" accesskey="n" rel="next">File lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2295,77 +2270,68 @@ list by giving the &lsquo;<samp>--help-formats</samp>&rsquo; option to <code>kps
(see <a href="#Auxiliary-tasks">Auxiliary tasks</a>).
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>afm</samp>&rsquo;</dt>
-<dd><span id="index-_002eafm"></span>
-<span id="index-AFMFONTS"></span>
-<p>(Adobe font metrics, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
+<dt id='index-_002eafm'><span>&lsquo;<samp>afm</samp>&rsquo;<a href='#index-_002eafm' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-AFMFONTS"></span>
+<p>(Adobe font metrics, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
<code>AFMFONTS</code>;
suffix &lsquo;<samp>.afm</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>base</samp>&rsquo;</dt>
-<dd><span id="index-_002ebase"></span>
-<span id="index-MFBASES"></span>
+<dt id='index-_002ebase'><span>&lsquo;<samp>base</samp>&rsquo;<a href='#index-_002ebase' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MFBASES"></span>
<span id="index-TEXMFINI"></span>
-<p>(Metafont memory dump, see <a href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
+<p>(Metafont memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
<code>MFBASES</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp>.base</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>bib</samp>&rsquo;</dt>
-<dd><span id="index-_002ebib"></span>
-<span id="index-BIBINPUTS"></span>
+<dt id='index-_002ebib'><span>&lsquo;<samp>bib</samp>&rsquo;<a href='#index-_002ebib' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-BIBINPUTS"></span>
<span id="index-TEXBIB"></span>
-<p>(BibTeX bibliography source, see <a href="https://tug.org/texinfohtml/web2c.html#bibtex-invocation">bibtex invocation</a> in <cite>Web2c</cite>)
+<p>(BibTeX bibliography source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#bibtex-invocation">bibtex invocation</a> in <cite>Web2c</cite>)
<code>BIBINPUTS</code>, <code>TEXBIB</code>;
suffix &lsquo;<samp>.bib</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>bltxml</samp>&rsquo;</dt>
-<dd><span id="index-_002ebltxml"></span>
-<span id="index-BLTXMLINPUTS"></span>
+<dt id='index-_002ebltxml'><span>&lsquo;<samp>bltxml</samp>&rsquo;<a href='#index-_002ebltxml' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-BLTXMLINPUTS"></span>
<p>(BibLaTeXML bibliography files for Biber, <a href="https://ctan.org/pkg/biber">https://ctan.org/pkg/biber</a>)
<code>BLTXMLINPUTS</code>
suffix &lsquo;<samp>.bltxml</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>bst</samp>&rsquo;</dt>
-<dd><span id="index-_002ebst"></span>
-<span id="index-BSTINPUTS"></span>
-<p>(BibTeX style, see <a href="https://tug.org/texinfohtml/web2c.html#Basic-BibTeX-style-files">Basic BibTeX
+<dt id='index-_002ebst'><span>&lsquo;<samp>bst</samp>&rsquo;<a href='#index-_002ebst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-BSTINPUTS"></span>
+<p>(BibTeX style, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Basic-BibTeX-style-files">Basic BibTeX
style files</a> in <cite>Web2c</cite>)
<code>BSTINPUTS</code>;
suffix &lsquo;<samp>.bst</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>clua</samp>&rsquo;</dt>
-<dd><span id="index-_002edll"></span>
-<span id="index-_002eso"></span>
+<dt id='index-_002edll'><span>&lsquo;<samp>clua</samp>&rsquo;<a href='#index-_002edll' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002eso"></span>
<span id="index-CLUAINPUTS"></span>
<p>(dynamic libraries for Lua, <a href="https://ctan.org/pkg/luatex">https://ctan.org/pkg/luatex</a>)
<code>CLUAINPUTS</code>
suffixes &lsquo;<samp>.dll</samp>&rsquo; and &lsquo;<samp>.so</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>cmap</samp>&rsquo;</dt>
-<dd><span id="index-_002ecmap"></span>
-<span id="index-CMAPFONTS"></span>
+<dt id='index-_002ecmap'><span>&lsquo;<samp>cmap</samp>&rsquo;<a href='#index-_002ecmap' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-CMAPFONTS"></span>
<p>(character map files)
<code>CMAPFONTS</code>;
suffix &lsquo;<samp>.cmap</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>cnf</samp>&rsquo;</dt>
-<dd><span id="index-_002ecnf"></span>
-<span id="index-TEXMFCNF-1"></span>
+<dt id='index-_002ecnf'><span>&lsquo;<samp>cnf</samp>&rsquo;<a href='#index-_002ecnf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXMFCNF-1"></span>
<p>(Runtime configuration files, see <a href="#Config-files">Config files</a>)
<code>TEXMFCNF</code>;
suffix &lsquo;<samp>.cnf</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>cweb</samp>&rsquo;</dt>
-<dd><span id="index-_002ew"></span>
-<span id="index-_002eweb"></span>
+<dt id='index-_002ew'><span>&lsquo;<samp>cweb</samp>&rsquo;<a href='#index-_002ew' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002eweb"></span>
<span id="index-CWEBINPUTS"></span>
<p>(CWEB input files)
<code>CWEBINPUTS</code>;
@@ -2373,148 +2339,130 @@ suffixes &lsquo;<samp>.w</samp>&rsquo;, &lsquo;<samp>.web</samp>&rsquo;;
additional suffix &lsquo;<samp>.ch</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>dvips config</samp>&rsquo;</dt>
-<dd><span id="index-TEXCONFIG"></span>
-<span id="index-config_002eps_002c-search-path-for"></span>
-<p>(Dvips &lsquo;<samp>config.*</samp>&rsquo; files, such as <samp>config.ps</samp>, see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config
+<dt id='index-TEXCONFIG'><span>&lsquo;<samp>dvips config</samp>&rsquo;<a href='#index-TEXCONFIG' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-config_002eps_002c-search-path-for"></span>
+<p>(Dvips &lsquo;<samp>config.*</samp>&rsquo; files, such as <samp>config.ps</samp>, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config
files</a> in <cite>Dvips</cite>)
<code>TEXCONFIG</code>.
</p>
</dd>
-<dt>&lsquo;<samp>enc files</samp>&rsquo;</dt>
-<dd><span id="index-_002eenc"></span>
-<span id="index-ENCFONTS"></span>
+<dt id='index-_002eenc'><span>&lsquo;<samp>enc files</samp>&rsquo;<a href='#index-_002eenc' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-ENCFONTS"></span>
<p>(encoding vectors)
<code>ENCFONTS</code>;
suffix &lsquo;<samp>.enc</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>fmt</samp>&rsquo;</dt>
-<dd><span id="index-_002efmt"></span>
-<span id="index-TEXFORMATS"></span>
+<dt id='index-_002efmt'><span>&lsquo;<samp>fmt</samp>&rsquo;<a href='#index-_002efmt' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXFORMATS"></span>
<span id="index-TEXMFINI-1"></span>
-<p>(TeX memory dump, see <a href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
+<p>(TeX memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
<code>TEXFORMATS</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp>.fmt</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>font cid map</samp>&rsquo;</dt>
-<dd><span id="index-_002ecid"></span>
-<span id="index-FONTCIDMAPS"></span>
+<dt id='index-_002ecid'><span>&lsquo;<samp>font cid map</samp>&rsquo;<a href='#index-_002ecid' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-FONTCIDMAPS"></span>
<p>(CJK mapping)
<code>FONTCIDMAPS</code>
suffix &lsquo;<samp>.cid</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>font feature files</samp>&rsquo;</dt>
-<dd><span id="index-_002efea"></span>
-<span id="index-FONTFEATURES"></span>
+<dt id='index-_002efea'><span>&lsquo;<samp>font feature files</samp>&rsquo;<a href='#index-_002efea' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-FONTFEATURES"></span>
<p>(primarily for OpenType font features)
<code>FONTFEATURES</code>
suffix &lsquo;<samp>.fea</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>gf</samp>&rsquo;</dt>
-<dd><span id="index-gf"></span>
-<span id="index-GFFONTS"></span>
+<dt id='index-gf'><span>&lsquo;<samp>gf</samp>&rsquo;<a href='#index-gf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-GFFONTS"></span>
<span id="index-GLYPHFONTS"></span>
<span id="index-TEXFONTS"></span>
-<p>(generic font bitmap, see <a href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
+<p>(generic font bitmap, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
<code><var>program</var>FONTS</code>, <code>GFFONTS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>gf</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>graphic/figure</samp>&rsquo;</dt>
-<dd><span id="index-_002eeps"></span>
-<span id="index-_002eepsi"></span>
+<dt id='index-_002eeps'><span>&lsquo;<samp>graphic/figure</samp>&rsquo;<a href='#index-_002eeps' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002eepsi"></span>
<span id="index-TEXPICTS"></span>
<span id="index-TEXINPUTS"></span>
-<p>(Encapsulated PostScript figures, see <a href="https://tug.org/texinfohtml/dvips.html#PostScript-figures">PostScript figures</a> in <cite>Dvips</cite>)
+<p>(Encapsulated PostScript figures, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#PostScript-figures">PostScript figures</a> in <cite>Dvips</cite>)
<code>TEXPICTS</code>, <code>TEXINPUTS</code>;
additional suffixes: &lsquo;<samp>.eps</samp>&rsquo;, &lsquo;<samp>.epsi</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>ist</samp>&rsquo;</dt>
-<dd><span id="index-_002eist"></span>
-<span id="index-TEXINDEXSTYLE"></span>
+<dt id='index-_002eist'><span>&lsquo;<samp>ist</samp>&rsquo;<a href='#index-_002eist' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXINDEXSTYLE"></span>
<span id="index-INDEXSTYLE"></span>
<p>(makeindex style files)
<code>TEXINDEXSTYLE</code>, <code>INDEXSTYLE</code>;
suffix &lsquo;<samp>.ist</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>lig files</samp>&rsquo;</dt>
-<dd><span id="index-_002elig"></span>
-<span id="index-LIGFONTS"></span>
+<dt id='index-_002elig'><span>&lsquo;<samp>lig files</samp>&rsquo;<a href='#index-_002elig' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-LIGFONTS"></span>
<p>(ligature definition files)
<code>LIGFONTS</code>;
suffix &lsquo;<samp>.lig</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>ls-R</samp>&rsquo;</dt>
-<dd><span id="index-ls_002dR"></span>
-<span id="index-TEXMFDBS-1"></span>
-<p>(Filename databases, see <a href="#Filename-database">Filename database</a>)
+<dt id='index-ls_002dR'><span>&lsquo;<samp>ls-R</samp>&rsquo;<a href='#index-ls_002dR' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXMFDBS-1"></span>
+<p>(Filename databases, see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>)
<code>TEXMFDBS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>map</samp>&rsquo;</dt>
-<dd><span id="index-_002emap"></span>
-<span id="index-TEXFONTMAPS"></span>
+<dt id='index-_002emap'><span>&lsquo;<samp>map</samp>&rsquo;<a href='#index-_002emap' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXFONTMAPS"></span>
<p>(Fontmaps, see <a href="#Fontmap">Fontmap</a>)
<code>TEXFONTMAPS</code>;
suffix &lsquo;<samp>.map</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>mem</samp>&rsquo;</dt>
-<dd><span id="index-_002emem"></span>
-<span id="index-MPMEMS"></span>
+<dt id='index-_002emem'><span>&lsquo;<samp>mem</samp>&rsquo;<a href='#index-_002emem' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MPMEMS"></span>
<span id="index-TEXMFINI-2"></span>
-<p>(MetaPost memory dump, see <a href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
+<p>(MetaPost memory dump, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
<code>MPMEMS</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp>.mem</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp><span class="roman">MetaPost support</span></samp>&rsquo;</dt>
-<dd><span id="index-MPSUPPORT"></span>
-<p>(MetaPost support files, used by DMP; see <a href="https://tug.org/texinfohtml/web2c.html#dmp-invocation">dmp invocation</a> in <cite>Web2c</cite>)
+<dt id='index-MPSUPPORT'><span>&lsquo;<samp><span class="roman">MetaPost support</span></samp>&rsquo;<a href='#index-MPSUPPORT' class='copiable-anchor'> &para;</a></span></dt>
+<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>Web2c</cite>)
<code>MPSUPPORT</code>.
</p>
</dd>
-<dt>&lsquo;<samp>mf</samp>&rsquo;</dt>
-<dd><span id="index-_002emf"></span>
-<span id="index-MFINPUTS"></span>
-<p>(Metafont source, see <a href="https://tug.org/texinfohtml/web2c.html#mf-invocation">mf invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002emf'><span>&lsquo;<samp>mf</samp>&rsquo;<a href='#index-_002emf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MFINPUTS"></span>
+<p>(Metafont source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mf-invocation">mf invocation</a> in <cite>Web2c</cite>)
<code>MFINPUTS</code>;
suffix &lsquo;<samp>.mf</samp>&rsquo;;
dynamic creation program: <code>mktexmf</code>.
</p>
</dd>
-<dt>&lsquo;<samp>mfpool</samp>&rsquo;</dt>
-<dd><span id="index-_002epool"></span>
-<span id="index-MFPOOL"></span>
-<p>(Metafont program strings, see <a href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002epool'><span>&lsquo;<samp>mfpool</samp>&rsquo;<a href='#index-_002epool' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MFPOOL"></span>
+<p>(Metafont program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
<code>MFPOOL</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp>.pool</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>mft</samp>&rsquo;</dt>
-<dd><span id="index-_002emft"></span>
-<span id="index-MFTINPUTS"></span>
-<p>(<code>MFT</code> style file, see <a href="https://tug.org/texinfohtml/web2c.html#mft-invocation">mft invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002emft'><span>&lsquo;<samp>mft</samp>&rsquo;<a href='#index-_002emft' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MFTINPUTS"></span>
+<p>(<code>MFT</code> style file, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mft-invocation">mft invocation</a> in <cite>Web2c</cite>)
<code>MFTINPUTS</code>;
suffix &lsquo;<samp>.mft</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>misc fonts</samp>&rsquo;</dt>
-<dd><span id="index-MISCFONTS"></span>
-<p>(font-related files that don&rsquo;t fit the other categories)
+<dt id='index-MISCFONTS'><span>&lsquo;<samp>misc fonts</samp>&rsquo;<a href='#index-MISCFONTS' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(font-related files that don&rsquo;t fit the other categories)
<code>MISCFONTS</code>
</p>
</dd>
-<dt>&lsquo;<samp>mlbib</samp>&rsquo;</dt>
-<dd><span id="index-_002emlbib"></span>
-<span id="index-MLBIBINPUTS"></span>
+<dt id='index-_002emlbib'><span>&lsquo;<samp>mlbib</samp>&rsquo;<a href='#index-_002emlbib' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MLBIBINPUTS"></span>
<span id="index-BIBINPUTS-1"></span>
<span id="index-TEXBIB-1"></span>
<p>(MlBibTeX bibliography source)
@@ -2522,230 +2470,202 @@ suffix &lsquo;<samp>.mft</samp>&rsquo;.
suffixes &lsquo;<samp>.mlbib</samp>&rsquo;, &lsquo;<samp>.mlbib</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>mlbst</samp>&rsquo;</dt>
-<dd><span id="index-_002emlbst"></span>
-<span id="index-MLBSTINPUTS"></span>
+<dt id='index-_002emlbst'><span>&lsquo;<samp>mlbst</samp>&rsquo;<a href='#index-_002emlbst' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MLBSTINPUTS"></span>
<span id="index-BSTINPUTS-1"></span>
<p>(MlBibTeX style)
<code>MLBSTINPUTS</code>, <code>BSTINPUTS</code>;
suffixes &lsquo;<samp>.mlbst</samp>&rsquo;, &lsquo;<samp>.bst</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>mp</samp>&rsquo;</dt>
-<dd><span id="index-_002emp"></span>
-<span id="index-MPINPUTS"></span>
-<p>(MetaPost source, see <a href="https://tug.org/texinfohtml/web2c.html#mpost-invocation">mpost invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002emp'><span>&lsquo;<samp>mp</samp>&rsquo;<a href='#index-_002emp' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MPINPUTS"></span>
+<p>(MetaPost source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#mpost-invocation">mpost invocation</a> in <cite>Web2c</cite>)
<code>MPINPUTS</code>;
suffix &lsquo;<samp>.mp</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>mppool</samp>&rsquo;</dt>
-<dd><span id="index-_002epool-1"></span>
-<span id="index-MPPOOL"></span>
-<p>(MetaPost program strings, see <a href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002epool-1'><span>&lsquo;<samp>mppool</samp>&rsquo;<a href='#index-_002epool-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-MPPOOL"></span>
+<p>(MetaPost program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
<code>MPPOOL</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp>.pool</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>ocp</samp>&rsquo;</dt>
-<dd><span id="index-_002eocp"></span>
-<span id="index-OCPINPUTS"></span>
+<dt id='index-_002eocp'><span>&lsquo;<samp>ocp</samp>&rsquo;<a href='#index-_002eocp' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-OCPINPUTS"></span>
<p>(Omega compiled process files)
<code>OCPINPUTS</code>; <br>
suffix &lsquo;<samp>.ocp</samp>&rsquo;;
dynamic creation program: <code>MakeOmegaOCP</code>.
</p>
</dd>
-<dt>&lsquo;<samp>ofm</samp>&rsquo;</dt>
-<dd><span id="index-_002eofm"></span>
-<span id="index-OFMFONTS"></span>
+<dt id='index-_002eofm'><span>&lsquo;<samp>ofm</samp>&rsquo;<a href='#index-_002eofm' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-OFMFONTS"></span>
<p>(Omega font metrics)
<code>OFMFONTS</code>, <code>TEXFONTS</code>; <br>
suffixes &lsquo;<samp>.ofm</samp>&rsquo;, &lsquo;<samp>.tfm</samp>&rsquo;;
dynamic creation program: <code>MakeOmegaOFM</code>.
</p>
</dd>
-<dt>&lsquo;<samp>opentype fonts</samp>&rsquo;</dt>
-<dd><span id="index-OPENTYPEFONTS"></span>
-<p>(OpenType fonts)
+<dt id='index-OPENTYPEFONTS'><span>&lsquo;<samp>opentype fonts</samp>&rsquo;<a href='#index-OPENTYPEFONTS' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(OpenType fonts)
<code>OPENTYPEFONTS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>opl</samp>&rsquo;</dt>
-<dd><span id="index-_002eopl"></span>
-<p>(Omega property lists)
+<dt id='index-_002eopl'><span>&lsquo;<samp>opl</samp>&rsquo;<a href='#index-_002eopl' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(Omega property lists)
<code>OPLFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>.opl</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>otp</samp>&rsquo;</dt>
-<dd><span id="index-_002eotp"></span>
-<span id="index-OTPINPUTS"></span>
+<dt id='index-_002eotp'><span>&lsquo;<samp>otp</samp>&rsquo;<a href='#index-_002eotp' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-OTPINPUTS"></span>
<p>(Omega translation process files)
<code>OTPINPUTS</code>;
suffix &lsquo;<samp>.otp</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>ovf</samp>&rsquo;</dt>
-<dd><span id="index-_002eovf"></span>
-<span id="index-OVFFONTS"></span>
+<dt id='index-_002eovf'><span>&lsquo;<samp>ovf</samp>&rsquo;<a href='#index-_002eovf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-OVFFONTS"></span>
<p>(Omega virtual fonts)
<code>OVFFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>.ovf</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>ovp</samp>&rsquo;</dt>
-<dd><span id="index-_002eovp"></span>
-<span id="index-OVPFONTS"></span>
+<dt id='index-_002eovp'><span>&lsquo;<samp>ovp</samp>&rsquo;<a href='#index-_002eovp' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-OVPFONTS"></span>
<p>(Omega virtual property lists)
<code>OVPFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>.ovp</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>pdftex config</samp>&rsquo;</dt>
-<dd><span id="index-PDFTEXCONFIG"></span>
-<p>(PDFTeX-specific configuration files)
+<dt id='index-PDFTEXCONFIG'><span>&lsquo;<samp>pdftex config</samp>&rsquo;<a href='#index-PDFTEXCONFIG' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(PDFTeX-specific configuration files)
<code>PDFTEXCONFIG</code>.
</p>
</dd>
-<dt>&lsquo;<samp>pk</samp>&rsquo;</dt>
-<dd><span id="index-_002epk"></span>
-<span id="index-PKFONTS"></span>
+<dt id='index-_002epk'><span>&lsquo;<samp>pk</samp>&rsquo;<a href='#index-_002epk' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-PKFONTS"></span>
<span id="index-TEXPKS"></span>
<span id="index-GLYPHFONTS-1"></span>
<span id="index-TEXFONTS-1"></span>
-<p>(packed bitmap fonts, see <a href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
+<p>(packed bitmap fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
<code><var>PROGRAM</var>FONTS</code> (<var>program</var> being &lsquo;<samp>XDVI</samp>&rsquo;, etc.),
<code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>pk</samp>&rsquo;;
dynamic creation program: <code>mktexpk</code>.
</p>
</dd>
-<dt>&lsquo;<samp>PostScript header</samp>&rsquo;</dt>
-<dd><span id="index-_002epro"></span>
-<span id="index-TEXPSHEADERS"></span>
+<dt id='index-_002epro'><span>&lsquo;<samp>PostScript header</samp>&rsquo;<a href='#index-_002epro' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXPSHEADERS"></span>
<span id="index-PSHEADERS"></span>
-<p>(downloadable PostScript, see <a href="https://tug.org/texinfohtml/dvips.html#Header-files">Header files</a> in <cite>Dvips</cite>)
+<p>(downloadable PostScript, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Header-files">Header files</a> in <cite>Dvips</cite>)
<code>TEXPSHEADERS</code>, <code>PSHEADERS</code>;
additional suffix &lsquo;<samp>.pro</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>ris</samp>&rsquo;</dt>
-<dd><span id="index-_002eris"></span>
-<span id="index-RISINPUTS"></span>
+<dt id='index-_002eris'><span>&lsquo;<samp>ris</samp>&rsquo;<a href='#index-_002eris' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-RISINPUTS"></span>
<p>(RIS bibliography files, primarily for Biber, <a href="https://ctan.org/pkg/biber">https://ctan.org/pkg/biber</a>)
<code>RISINPUTS</code>
suffix &lsquo;<samp>.ris</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>subfont definition files</samp>&rsquo;</dt>
-<dd><span id="index-_002esfd"></span>
-<span id="index-SFDFONTS"></span>
+<dt id='index-_002esfd'><span>&lsquo;<samp>subfont definition files</samp>&rsquo;<a href='#index-_002esfd' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-SFDFONTS"></span>
<p>(subfont definition files)
<code>SFDFONTS</code>
suffix &lsquo;<samp>.sfd</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>tex</samp>&rsquo;</dt>
-<dd><span id="index-_002etex"></span>
-<span id="index-TEXINPUTS-1"></span>
-<p>(TeX source, see <a href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002etex'><span>&lsquo;<samp>tex</samp>&rsquo;<a href='#index-_002etex' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXINPUTS-1"></span>
+<p>(TeX source, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>)
<code>TEXINPUTS</code>;
suffix &lsquo;<samp>.tex</samp>&rsquo;;
additional suffixes: none, because such a list cannot be complete;
dynamic creation program: <code>mktextex</code>.
</p>
</dd>
-<dt>&lsquo;<samp>TeX system documentation</samp>&rsquo;</dt>
-<dd><span id="index-doc-files"></span>
-<span id="index-TEXDOCS"></span>
+<dt id='index-doc-files'><span>&lsquo;<samp>TeX system documentation</samp>&rsquo;<a href='#index-doc-files' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXDOCS"></span>
<p>(Documentation files for the TeX system)
<code>TEXDOCS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>TeX system sources</samp>&rsquo;</dt>
-<dd><span id="index-source-files"></span>
-<span id="index-TEXSOURCES"></span>
+<dt id='index-source-files'><span>&lsquo;<samp>TeX system sources</samp>&rsquo;<a href='#index-source-files' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXSOURCES"></span>
<p>(Source files for the TeX system)
<code>TEXSOURCES</code>.
</p>
</dd>
-<dt>&lsquo;<samp>texmfscripts</samp>&rsquo;</dt>
-<dd><span id="index-TEXMFSCRIPTS"></span>
-<p>(Architecture-independent executables distributed in the texmf trees)
+<dt id='index-TEXMFSCRIPTS'><span>&lsquo;<samp>texmfscripts</samp>&rsquo;<a href='#index-TEXMFSCRIPTS' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(Architecture-independent executables distributed in the texmf trees)
<code>TEXMFSCRIPTS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>texpool</samp>&rsquo;</dt>
-<dd><span id="index-_002epool-2"></span>
-<span id="index-TEXPOOL"></span>
-<p>(TeX program strings, see <a href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
+<dt id='index-_002epool-2'><span>&lsquo;<samp>texpool</samp>&rsquo;<a href='#index-_002epool-2' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TEXPOOL"></span>
+<p>(TeX program strings, see <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
<code>TEXPOOL</code>, <code>TEXMFINI</code>;
suffix &lsquo;<samp>.pool</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>tfm</samp>&rsquo;</dt>
-<dd><span id="index-_002etfm"></span>
-<span id="index-TFMFONTS"></span>
+<dt id='index-_002etfm'><span>&lsquo;<samp>tfm</samp>&rsquo;<a href='#index-_002etfm' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-TFMFONTS"></span>
<span id="index-TEXFONTS-2"></span>
-<p>(TeX font metrics, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
+<p>(TeX font metrics, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
<code>TFMFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>.tfm</samp>&rsquo;;
dynamic creation program: <code>mktextfm</code>.
</p>
</dd>
-<dt>&lsquo;<samp>Troff fonts</samp>&rsquo;</dt>
-<dd><span id="index-TRFONTS"></span>
-<p>(Troff fonts, used by DMP; see <a href="https://tug.org/texinfohtml/web2c.html#DMP-invocation">DMP invocation</a> in <cite>Web2c</cite>)
+<dt id='index-TRFONTS'><span>&lsquo;<samp>Troff fonts</samp>&rsquo;<a href='#index-TRFONTS' class='copiable-anchor'> &para;</a></span></dt>
+<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>Web2c</cite>)
<code>TRFONTS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>truetype fonts</samp>&rsquo;</dt>
-<dd><span id="index-_002ettf"></span>
-<span id="index-_002ettc"></span>
+<dt id='index-_002ettf'><span>&lsquo;<samp>truetype fonts</samp>&rsquo;<a href='#index-_002ettf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002ettc"></span>
<span id="index-TTFONTS"></span>
<p>(TrueType outline fonts) <code>TTFONTS</code>; suffixes &lsquo;<samp>.ttf</samp>&rsquo; and
&lsquo;<samp>.TTF</samp>&rsquo;, &lsquo;<samp>.ttc</samp>&rsquo; and &lsquo;<samp>.TTC</samp>&rsquo;, &lsquo;<samp>.dfont</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>type1 fonts</samp>&rsquo;</dt>
-<dd><span id="index-_002epfa"></span>
-<span id="index-_002epfb"></span>
+<dt id='index-_002epfa'><span>&lsquo;<samp>type1 fonts</samp>&rsquo;<a href='#index-_002epfa' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-_002epfb"></span>
<span id="index-T1FONTS"></span>
<span id="index-T1INPUTS"></span>
<span id="index-TEXPSHEADERS-1"></span>
<span id="index-DVIPSHEADERS"></span>
-<p>(Type 1 PostScript outline fonts, see <a href="https://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
+<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>Dvips</cite>)
<code>T1FONTS</code>, <code>T1INPUTS</code>, <code>TEXPSHEADERS</code>, <code>DVIPSHEADERS</code>;
suffixes &lsquo;<samp>.pfa</samp>&rsquo;, &lsquo;<samp>.pfb</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>type42 fonts</samp>&rsquo;</dt>
-<dd><span id="index-T42FONTS"></span>
-<p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>.
+<dt id='index-T42FONTS'><span>&lsquo;<samp>type42 fonts</samp>&rsquo;<a href='#index-T42FONTS' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>vf</samp>&rsquo;</dt>
-<dd><span id="index-_002evf"></span>
-<span id="index-VFFONTS"></span>
+<dt id='index-_002evf'><span>&lsquo;<samp>vf</samp>&rsquo;<a href='#index-_002evf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-VFFONTS"></span>
<span id="index-TEXFONTS-3"></span>
-<p>(virtual fonts, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>)
+<p>(virtual fonts, see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>)
<code>VFFONTS</code>, <code>TEXFONTS</code>;
suffix &lsquo;<samp>.vf</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>web</samp>&rsquo;</dt>
-<dd><span id="index-_002eweb-1"></span>
-<span id="index-WEBINPUTS"></span>
+<dt id='index-_002eweb-1'><span>&lsquo;<samp>web</samp>&rsquo;<a href='#index-_002eweb-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-WEBINPUTS"></span>
<p>(WEB input files)
<code>WEBINPUTS</code>;
suffix &lsquo;<samp>.web</samp>&rsquo;;
additional suffix &lsquo;<samp>.ch</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>web2c files</samp>&rsquo;</dt>
-<dd><span id="index-WEB2C"></span>
-<p>(files specific to the web2c implementation)
+<dt id='index-WEB2C'><span>&lsquo;<samp>web2c files</samp>&rsquo;<a href='#index-WEB2C' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(files specific to the web2c implementation)
<code>WEB2C</code>.
</p></dd>
</dl>
@@ -2757,15 +2677,13 @@ appending &lsquo;<samp>INPUTS</samp>&rsquo;. Assuming the program is called &ls
this gives us the following table.
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>other text files</samp>&rsquo;</dt>
-<dd><span id="index-FOOINPUTS"></span>
-<p>(text files used by &lsquo;<samp>foo</samp>&rsquo;)
+<dt id='index-FOOINPUTS'><span>&lsquo;<samp>other text files</samp>&rsquo;<a href='#index-FOOINPUTS' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(text files used by &lsquo;<samp>foo</samp>&rsquo;)
<code>FOOINPUTS</code>.
</p>
</dd>
-<dt>&lsquo;<samp>other binary files</samp>&rsquo;</dt>
-<dd><span id="index-FOOINPUTS-1"></span>
-<p>(binary files used by &lsquo;<samp>foo</samp>&rsquo;)
+<dt id='index-FOOINPUTS-1'><span>&lsquo;<samp>other binary files</samp>&rsquo;<a href='#index-FOOINPUTS-1' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(binary files used by &lsquo;<samp>foo</samp>&rsquo;)
<code>FOOINPUTS</code>.
</p></dd>
</dl>
@@ -2792,7 +2710,9 @@ Each program has its own font override path as well; e.g.,
<hr>
-<span id="File-lookup"></span><div class="header">
+</div>
+<div class="section" id="File-lookup">
+<div class="header">
<p>
Next: <a href="#Glyph-lookup" accesskey="n" rel="next">Glyph lookup</a>, Previous: <a href="#Supported-file-formats" accesskey="p" rel="prev">Supported file formats</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2819,7 +2739,7 @@ the fontmaps. Example: given &lsquo;<samp>foo.bar</samp>&rsquo;, we also look f
&lsquo;<samp>foo.bar</samp>&rsquo;.
</li><li> If the file format defines a program to invoke to create missing files,
-run it (see <a href="#mktex-scripts">mktex scripts</a>).
+run it (see <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>).
</li></ol>
<span id="index-extensions_002c-filename"></span>
@@ -2848,7 +2768,9 @@ debugging options (see <a href="#Debugging">Debugging</a>).
</p>
<hr>
-<span id="Glyph-lookup"></span><div class="header">
+</div>
+<div class="section" id="Glyph-lookup">
+<div class="header">
<p>
Next: <a href="#Suppressing-warnings" accesskey="n" rel="next">Suppressing warnings</a>, Previous: <a href="#File-lookup" accesskey="p" rel="prev">File lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2874,7 +2796,7 @@ specified format(s).
file <samp>texfonts.map</samp>, look for <var>f</var>.<var>dpi</var>.
</li><li> Run an external program (typically named &lsquo;<samp>mktexpk</samp>&rsquo;) to
-generate the font (see <a href="#mktex-scripts">mktex scripts</a>)
+generate the font (see <a href="#mktex-scripts"><samp>mktex</samp> scripts</a>)
</li><li> Look for <var>fallback</var>.<var>dpi</var>, where <var>fallback</var> is some
last-resort font (typically &lsquo;<samp>cmr10</samp>&rsquo;).
@@ -2885,18 +2807,16 @@ last-resort font (typically &lsquo;<samp>cmr10</samp>&rsquo;).
<p>This is implemented in <code>kpathsea_find_glyph</code> in
<samp>kpathsea/tex-glyph.c</samp>.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Basic-glyph-lookup" accesskey="1">Basic glyph lookup</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Features common to all glyph lookups.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Fontmap" accesskey="2">Fontmap</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Aliases for fonts.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Fallback-font" accesskey="3">Fallback font</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Resolutions and fonts of last resort.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Basic-glyph-lookup" accesskey="1">Basic glyph lookup</a></li>
+<li><a href="#Fontmap" accesskey="2">Fontmap</a></li>
+<li><a href="#Fallback-font" accesskey="3">Fallback font</a></li>
+</ul>
<hr>
-<span id="Basic-glyph-lookup"></span><div class="header">
+<div class="subsection" id="Basic-glyph-lookup">
+<div class="header">
<p>
Next: <a href="#Fontmap" accesskey="n" rel="next">Fontmap</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2926,7 +2846,9 @@ slightly more than the 0.2% minimum allowed by the DVI standard
</p>
<hr>
-<span id="Fontmap"></span><div class="header">
+</div>
+<div class="subsection" id="Fontmap">
+<div class="header">
<p>
Next: <a href="#Fallback-font" accesskey="n" rel="next">Fallback font</a>, Previous: <a href="#Basic-glyph-lookup" accesskey="p" rel="prev">Basic glyph lookup</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2962,7 +2884,7 @@ file is; TeX documents will find their favorite name.
</li></ol>
-<p>The format of fontmap files is straightforward:
+<p>The format of fontmap files:
</p>
<ul>
<li> <span id="index-comments_002c-in-fontmap-files"></span>
@@ -3009,11 +2931,13 @@ lcirc10 lcircle10
<p>Fontmaps are implemented in the file <samp>kpathsea/fontmap.c</samp>.
The Fontname distribution has much more information on font naming
-(see <cite><a href="fontname.html#Top">Filenames for TeX fonts</a></cite>).
+(see <cite><a data-manual="fontname" href="fontname.html#Top">Filenames for TeX fonts</a></cite>).
</p>
<hr>
-<span id="Fallback-font"></span><div class="header">
+</div>
+<div class="subsection" id="Fallback-font">
+<div class="header">
<p>
Previous: <a href="#Fontmap" accesskey="p" rel="prev">Fontmap</a>, Up: <a href="#Glyph-lookup" accesskey="u" rel="up">Glyph lookup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3048,9 +2972,12 @@ must enable this feature by calling <code>kpathsea_init_prog</code>
</p>
<hr>
-<span id="Suppressing-warnings"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Suppressing-warnings">
+<div class="header">
<p>
-Next: <a href="#mktex-scripts" accesskey="n" rel="next">mktex scripts</a>, Previous: <a href="#Glyph-lookup" accesskey="p" rel="prev">Glyph lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#mktex-scripts" accesskey="n" rel="next"><samp>mktex</samp> scripts</a>, Previous: <a href="#Glyph-lookup" accesskey="p" rel="prev">Glyph lookup</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Suppressing-warnings-1"></span><h3 class="section">6.4 Suppressing warnings</h3>
@@ -3066,44 +2993,32 @@ do this, you set the environment variable or configuration file value
possibilities:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>all</samp>&rsquo;
-<span id="index-all"></span>
-</dt>
+<dt id='index-all'><span>&lsquo;<samp>all</samp>&rsquo;<a href='#index-all' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Suppress everything possible.
</p>
</dd>
-<dt>&lsquo;<samp>checksum</samp>&rsquo;
-<span id="index-checksum"></span>
-</dt>
+<dt id='index-checksum'><span>&lsquo;<samp>checksum</samp>&rsquo;<a href='#index-checksum' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-mismatched-checksum-warnings"></span>
<p>Suppress mismatched font checksum warnings.
</p>
</dd>
-<dt>&lsquo;<samp>lostchar</samp>&rsquo;
-<span id="index-lostchar"></span>
-</dt>
+<dt id='index-lostchar'><span>&lsquo;<samp>lostchar</samp>&rsquo;<a href='#index-lostchar' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-missing-character-warnings"></span>
<p>Suppress warnings when a character is missing from a font that a DVI or
VF file tries to typeset.
</p>
</dd>
-<dt>&lsquo;<samp>none</samp>&rsquo;
-<span id="index-none"></span>
-</dt>
+<dt id='index-none'><span>&lsquo;<samp>none</samp>&rsquo;<a href='#index-none' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Don&rsquo;t suppress any warnings.
</p>
</dd>
-<dt>&lsquo;<samp>readable</samp>&rsquo;
-<span id="index-readable"></span>
-</dt>
+<dt id='index-readable'><span>&lsquo;<samp>readable</samp>&rsquo;<a href='#index-readable' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-unreadable-file-warnings"></span>
<p>Suppress warnings about attempts to access a file whose permissions
render it unreadable.
</p>
</dd>
-<dt>&lsquo;<samp>special</samp>&rsquo;
-<span id="index-special"></span>
-</dt>
+<dt id='index-special'><span>&lsquo;<samp>special</samp>&rsquo;<a href='#index-special' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-unknown-special-warnings"></span>
<span id="index-_005cspecial_002c-suppressing-warnings-about"></span>
<p>Suppresses warnings about an unimplemented or unparsable
@@ -3117,7 +3032,9 @@ appropriate.
</p>
<hr>
-<span id="mktex-scripts"></span><div class="header">
+</div>
+<div class="section" id="mktex-scripts">
+<div class="header">
<p>
Previous: <a href="#Suppressing-warnings" accesskey="p" rel="prev">Suppressing warnings</a>, Up: <a href="#TeX-support" accesskey="u" rel="up">TeX support</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3132,7 +3049,7 @@ Previous: <a href="#Suppressing-warnings" accesskey="p" rel="prev">Suppressing w
<span id="index-EC-fonts_002c-and-dynamic-source-creation"></span>
<p>If Kpathsea cannot otherwise find a file, for some file types it is
configured by default to invoke an external program to create it
-dynamically (see <a href="#mktex-configuration">mktex configuration</a>). These are collectively
+dynamically (see <a href="#mktex-configuration"><samp>mktex</samp> configuration</a>). These are collectively
known as <em><code>mktex</code> scripts</em>, since most of them are named
<code>mktex...</code>.
</p>
@@ -3143,7 +3060,7 @@ Building all fonts in advance is therefore impractical, if not
impossible.
</p>
<p>It is also useful for the TeX &lsquo;<samp>.fmt</samp>&rsquo; (and Metafont
-&lsquo;<samp>.base</samp>&rsquo; and Metapost &lsquo;<samp>.mem</samp>&rsquo; files, see <a href="Web2c.html#Memory-dumps">Memory
+&lsquo;<samp>.base</samp>&rsquo; and Metapost &lsquo;<samp>.mem</samp>&rsquo; files, see <a data-manual="Web2c" href="Web2c.html#Memory-dumps">Memory
dumps</a> in <cite>web2c</cite>), where pre-generating every format consumes a
lot of both time and space.
</p>
@@ -3152,20 +3069,18 @@ arguments, as explained below. It must echo the full pathname of the
file it created (and nothing else) to standard output; it can write
diagnostics to standard error.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#mktex-configuration" accesskey="1">config</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#mktex-script-names" accesskey="2">names</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#mktex-script-arguments" accesskey="3">args</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#mktex-configuration" accesskey="1"><samp>mktex</samp> configuration</a></li>
+<li><a href="#mktex-script-names" accesskey="2"><samp>mktex</samp> script names</a></li>
+<li><a href="#mktex-script-arguments" accesskey="3"><samp>mktex</samp> script arguments</a></li>
+</ul>
<hr>
-<span id="mktex-configuration"></span><div class="header">
+<div class="subsection" id="mktex-configuration">
+<div class="header">
<p>
-Next: <a href="#mktex-script-names" accesskey="n" rel="next">mktex script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up">mktex scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#mktex-script-names" accesskey="n" rel="next"><samp>mktex</samp> script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp>mktex</samp> scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="mktex-configuration-1"></span><h4 class="subsection">6.5.1 <samp>mktex</samp> configuration</h4>
@@ -3200,7 +3115,7 @@ options to change the defaults are:
<p>The <code>configure</code> setting is overridden if the environment variable
or configuration file value named for the script is set; e.g.,
-<samp>MKTEXPK</samp> (see <a href="#mktex-script-arguments">mktex script arguments</a>).
+<samp>MKTEXPK</samp> (see <a href="#mktex-script-arguments"><samp>mktex</samp> script arguments</a>).
</p>
<span id="index-fmtutils_002ecnf"></span>
<p><code>mktexfmt</code> reads a file <samp>fmtutil.cnf</samp>, typically located in
@@ -3251,21 +3166,17 @@ directory is used.
<p>The &lsquo;<samp>appendonlydir</samp>&rsquo; option is enabled by default.
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>appendonlydir</samp>&rsquo;
-<span id="index-appendonlydir"></span>
-</dt>
+<dt id='index-appendonlydir'><span>&lsquo;<samp>appendonlydir</samp>&rsquo;<a href='#index-appendonlydir' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-directories_002c-making-append_002donly"></span>
<span id="index-mktexdir"></span>
<p>Tell <code>mktexdir</code> to create directories append-only, i.e., set
-their sticky bit (see <a href="https://www.gnu.org/software/coreutils/manual/coreutils#Mode-Structure">Mode Structure</a> in <cite>GNU Core
+their sticky bit (see <a data-manual="coreutils" href="https://www.gnu.org/software/coreutils/manual/coreutils#Mode-Structure">Mode Structure</a> in <cite>GNU Core
Utilities</cite>). This feature is silently ignored on non-Unix platforms
(e.g. Windows/NT and MS-DOS) which don&rsquo;t support similar functionality.
This feature is enabled by default.
</p>
</dd>
-<dt>&lsquo;<samp>dosnames</samp>&rsquo;
-<span id="index-dosnames"></span>
-</dt>
+<dt id='index-dosnames'><span>&lsquo;<samp>dosnames</samp>&rsquo;<a href='#index-dosnames' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-8_002e3-filenames_002c-using"></span>
<span id="index-DOS-compatible-names"></span>
<span id="index-dpinnn-directories"></span>
@@ -3288,59 +3199,45 @@ TeX-related files and are therefore unchanged.
the emulation programs don&rsquo;t consult <samp>mktex.opt</samp>.
</p>
</dd>
-<dt>&lsquo;<samp>fontmaps</samp>&rsquo;
-<span id="index-fontmaps-1"></span>
-</dt>
+<dt id='index-fontmaps-1'><span>&lsquo;<samp>fontmaps</samp>&rsquo;<a href='#index-fontmaps-1' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-fontmaps"></span>
<span id="index-fontname"></span>
<p>Instead of deriving the location of a font in the destination tree from
the location of the sources, the aliases and directory names from the
-Fontname distribution are used. (see <a href="fontname.html#Top">Introduction</a> in <cite>Fontname</cite>).
+Fontname distribution are used. (see <a data-manual="fontname" href="fontname.html#Top">Introduction</a> in <cite>Fontname</cite>).
</p>
</dd>
-<dt>&lsquo;<samp>nomfdrivers</samp>&rsquo;
-<span id="index-nomfdrivers"></span>
-</dt>
+<dt id='index-nomfdrivers'><span>&lsquo;<samp>nomfdrivers</samp>&rsquo;<a href='#index-nomfdrivers' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-metafont-driver-files"></span>
<p>Let mktexpk and mktextfm create metafont driver files in a temporary
directory. These will be used for just one metafont run and not
installed permanently.
</p>
</dd>
-<dt>&lsquo;<samp>nomode</samp>&rsquo;
-<span id="index-nomode"></span>
-</dt>
+<dt id='index-nomode'><span>&lsquo;<samp>nomode</samp>&rsquo;<a href='#index-nomode' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-mode-directory_002c-omitting"></span>
<p>Omit the directory level for the mode name; this is fine as long as
you generate fonts for only one mode.
</p>
</dd>
-<dt>&lsquo;<samp>stripsupplier</samp>&rsquo;
-<span id="index-stripsupplier"></span>
-</dt>
+<dt id='index-stripsupplier'><span>&lsquo;<samp>stripsupplier</samp>&rsquo;<a href='#index-stripsupplier' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-supplier-directory_002c-omitting"></span>
<p>Omit the font supplier name directory level.
</p>
</dd>
-<dt>&lsquo;<samp>striptypeface</samp>&rsquo;
-<span id="index-striptypeface"></span>
-</dt>
+<dt id='index-striptypeface'><span>&lsquo;<samp>striptypeface</samp>&rsquo;<a href='#index-striptypeface' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-typeface-directory_002c-omitting"></span>
<p>Omit the font typeface name directory level.
</p>
</dd>
-<dt>&lsquo;<samp>strip</samp>&rsquo;
-<span id="index-strip"></span>
-</dt>
+<dt id='index-strip'><span>&lsquo;<samp>strip</samp>&rsquo;<a href='#index-strip' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-supplier-directory_002c-omitting-1"></span>
<span id="index-typeface-directory_002c-omitting-1"></span>
<p>Omit the font supplier and typeface name directory levels. This feature
is deprecated in favour of &lsquo;<samp>stripsupplier</samp>&rsquo; and &lsquo;<samp>striptypeface</samp>&rsquo;.
</p>
</dd>
-<dt>&lsquo;<samp>varfonts</samp>&rsquo;
-<span id="index-varfonts"></span>
-</dt>
+<dt id='index-varfonts'><span>&lsquo;<samp>varfonts</samp>&rsquo;<a href='#index-varfonts' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-_002fvar_002ftmp_002ftexfonts"></span>
<span id="index-VARTEXFONTS"></span>
<span id="index-Linux-File-System-Standard"></span>
@@ -3356,9 +3253,7 @@ recommends <samp>/var/tex/fonts</samp>.
feature is enabled, and if set to &lsquo;<samp>0</samp>&rsquo;, the feature is disabled.
</p>
</dd>
-<dt>&lsquo;<samp>texmfvar</samp>&rsquo;
-<span id="index-texmfvar"></span>
-</dt>
+<dt id='index-texmfvar'><span>&lsquo;<samp>texmfvar</samp>&rsquo;<a href='#index-texmfvar' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-TEXMFVAR"></span>
<p>Force generated files that would go into a system tree (as defined by
<code>SYSTEXMF</code>) into <code>TEXMFVAR</code>. Starting with teTeX-3.0, the
@@ -3374,9 +3269,11 @@ feature is enabled, and if set to &lsquo;<samp>0</samp>&rsquo;, the feature is d
<hr>
-<span id="mktex-script-names"></span><div class="header">
+</div>
+<div class="subsection" id="mktex-script-names">
+<div class="header">
<p>
-Next: <a href="#mktex-script-arguments" accesskey="n" rel="next">mktex script arguments</a>, Previous: <a href="#mktex-configuration" accesskey="p" rel="prev">mktex configuration</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up">mktex scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#mktex-script-arguments" accesskey="n" rel="next"><samp>mktex</samp> script arguments</a>, Previous: <a href="#mktex-configuration" accesskey="p" rel="prev"><samp>mktex</samp> configuration</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp>mktex</samp> scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="mktex-script-names-1"></span><h4 class="subsection">6.5.2 <samp>mktex</samp> script names</h4>
@@ -3387,42 +3284,35 @@ Next: <a href="#mktex-script-arguments" accesskey="n" rel="next">mktex script ar
of the file types which support runtime generation.
</p>
<dl compact="compact">
-<dt><samp>mktexfmt</samp></dt>
-<dd><span id="index-mktexfmt"></span>
-<span id="index-fmtutil"></span>
+<dt id='index-mktexfmt'><span><samp>mktexfmt</samp><a href='#index-mktexfmt' class='copiable-anchor'> &para;</a></span></dt>
+<dd><span id="index-fmtutil"></span>
<p>(&lsquo;<samp>.fmt</samp>&rsquo;, &lsquo;<samp>.base</samp>&rsquo;, &lsquo;<samp>.mem</samp>&rsquo;) TeX/Metafont/MetaPost
formats. This script is also named <code>fmtutil</code>, and reads
<samp>fmtutil.cnf</samp> for configuration information.
</p>
</dd>
-<dt><samp>mktexmf</samp></dt>
-<dd><span id="index-mktexmf"></span>
-<p>(&lsquo;<samp>.mf</samp>&rsquo;) Metafont input files.
+<dt id='index-mktexmf'><span><samp>mktexmf</samp><a href='#index-mktexmf' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(&lsquo;<samp>.mf</samp>&rsquo;) Metafont input files.
</p>
</dd>
-<dt><samp>mkocp</samp></dt>
-<dd><span id="index-mkocp"></span>
-<p>(&lsquo;<samp>.ocp</samp>&rsquo;) Omega compiled process files.
+<dt id='index-mkocp'><span><samp>mkocp</samp><a href='#index-mkocp' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(&lsquo;<samp>.ocp</samp>&rsquo;) Omega compiled process files.
</p>
</dd>
-<dt><samp>mkofm</samp></dt>
-<dd><span id="index-mkofm"></span>
-<p>(&lsquo;<samp>.ofm</samp>&rsquo;) Omega font metric files.
+<dt id='index-mkofm'><span><samp>mkofm</samp><a href='#index-mkofm' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(&lsquo;<samp>.ofm</samp>&rsquo;) Omega font metric files.
</p>
</dd>
-<dt><samp>mktexpk</samp></dt>
-<dd><span id="index-mktexpk"></span>
-<p>(&lsquo;<samp>pk</samp>&rsquo;) Glyph fonts.
+<dt id='index-mktexpk'><span><samp>mktexpk</samp><a href='#index-mktexpk' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(&lsquo;<samp>pk</samp>&rsquo;) Glyph fonts.
</p>
</dd>
-<dt><samp>mktextex</samp></dt>
-<dd><span id="index-mktextex"></span>
-<p>(&lsquo;<samp>.tex</samp>&rsquo;) TeX input files (disabled by default).
+<dt id='index-mktextex'><span><samp>mktextex</samp><a href='#index-mktextex' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(&lsquo;<samp>.tex</samp>&rsquo;) TeX input files (disabled by default).
</p>
</dd>
-<dt><samp>mktextfm</samp></dt>
-<dd><span id="index-mktextfm"></span>
-<p>(&lsquo;<samp>.tfm</samp>&rsquo;) TFM files.
+<dt id='index-mktextfm'><span><samp>mktextfm</samp><a href='#index-mktextfm' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>(&lsquo;<samp>.tfm</samp>&rsquo;) TFM files.
</p></dd>
</dl>
@@ -3449,9 +3339,11 @@ configuration file value.
</p>
<hr>
-<span id="mktex-script-arguments"></span><div class="header">
+</div>
+<div class="subsection" id="mktex-script-arguments">
+<div class="header">
<p>
-Previous: <a href="#mktex-script-names" accesskey="p" rel="prev">mktex script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up">mktex scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#mktex-script-names" accesskey="p" rel="prev"><samp>mktex</samp> script names</a>, Up: <a href="#mktex-scripts" accesskey="u" rel="up"><samp>mktex</samp> scripts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="mktex-script-arguments-1"></span><h4 class="subsection">6.5.3 <samp>mktex</samp> script arguments</h4>
@@ -3464,21 +3356,21 @@ of the file to be created.
also be passed:
</p>
<dl compact="compact">
-<dt>&lsquo;<samp>--dpi <var>num</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--dpi <var>num</var></samp>&rsquo;</span></dt>
<dd><p>Sets the resolution of the generated font to <var>num</var>.
</p></dd>
-<dt>&lsquo;<samp>--mfmode <var>name</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--mfmode <var>name</var></samp>&rsquo;</span></dt>
<dd><p>Sets the Metafont mode to <var>name</var>.
</p></dd>
-<dt>&lsquo;<samp>--bdpi <var>num</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--bdpi <var>num</var></samp>&rsquo;</span></dt>
<dd><p>Sets the &ldquo;base dpi&rdquo; for the font. This must match the mode being
used.
</p></dd>
-<dt>&lsquo;<samp>--mag <var>string</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--mag <var>string</var></samp>&rsquo;</span></dt>
<dd><p>A &ldquo;magstep&rdquo; string suitable for the Metafont <code>mag</code> variable.
This must match the combination of <var>bdpi</var> and <var>dpi</var> being used.
</p></dd>
-<dt>&lsquo;<samp>--destdir <var>string</var></samp>&rsquo;</dt>
+<dt><span>&lsquo;<samp>--destdir <var>string</var></samp>&rsquo;</span></dt>
<dd><p>A directory name. If the directory is absolute, it is used as-is.
Otherwise, it is appended to the root destination directory set in the
script.
@@ -3487,9 +3379,13 @@ script.
<hr>
-<span id="Programming"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="chapter" id="Programming">
+<div class="header">
<p>
-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">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Previous: <a href="#TeX-support" accesskey="p" rel="prev">TeX support</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Programming-1"></span><h2 class="chapter">7 Programming</h2>
@@ -3497,20 +3393,17 @@ Next: <a href="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Pre
See <a href="#Introduction">Introduction</a>, for the conditions under which you may do so (in
short, it is released under LGPLv2.1 or later).
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Programming-overview" accesskey="1">Overview</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Introduction.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Calling-sequence" accesskey="2">Calling sequence</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Specifics of what to call.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Program_002dspecific-files" accesskey="3">Program-specific files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How to handle these.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Programming-with-config-files" accesskey="4">Config</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Getting info from texmf.cnf.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Programming-overview" accesskey="1">Programming overview</a></li>
+<li><a href="#Calling-sequence" accesskey="2">Calling sequence</a></li>
+<li><a href="#Program_002dspecific-files" accesskey="3">Program-specific files</a></li>
+<li><a href="#Programming-with-config-files" accesskey="4">Programming with config files</a></li>
+</ul>
<hr>
-<span id="Programming-overview"></span><div class="header">
+<div class="section" id="Programming-overview">
+<div class="header">
<p>
Next: <a href="#Calling-sequence" accesskey="n" rel="next">Calling sequence</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3579,7 +3472,9 @@ above, of course.
</p>
<hr>
-<span id="Calling-sequence"></span><div class="header">
+</div>
+<div class="section" id="Calling-sequence">
+<div class="header">
<p>
Next: <a href="#Program_002dspecific-files" accesskey="n" rel="next">Program-specific files</a>, Previous: <a href="#Programming-overview" accesskey="p" rel="prev">Programming overview</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3741,7 +3636,9 @@ They are available from <a href="https://gnu.org/software">https://gnu.org/softw
</p>
<hr>
-<span id="Program_002dspecific-files"></span><div class="header">
+</div>
+<div class="section" id="Program_002dspecific-files">
+<div class="header">
<p>
Next: <a href="#Programming-with-config-files" accesskey="n" rel="next">Programming with config files</a>, Previous: <a href="#Calling-sequence" accesskey="p" rel="prev">Calling sequence</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3749,7 +3646,7 @@ Next: <a href="#Programming-with-config-files" accesskey="n" rel="next">Programm
<p>Many programs will need to find some configuration files. Kpathsea
contains some support to make it easy to place them in their own
-directories. The Standard TeX directory structure (see <a href="tds.html#Top">Introduction</a> in <cite>A Directory Structure for TeX files</cite>), specifies
+directories. The Standard TeX directory structure (see <a data-manual="tds" href="tds.html#Top">Introduction</a> in <cite>A Directory Structure for TeX files</cite>), specifies
that such files should go into a subdirectory named after the program,
like &lsquo;<samp>texmf/ttf2pk</samp>&rsquo;.
</p>
@@ -3767,7 +3664,9 @@ mode.
</p>
<hr>
-<span id="Programming-with-config-files"></span><div class="header">
+</div>
+<div class="section" id="Programming-with-config-files">
+<div class="header">
<p>
Previous: <a href="#Program_002dspecific-files" accesskey="p" rel="prev">Program-specific files</a>, Up: <a href="#Programming" accesskey="u" rel="up">Programming</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3813,9 +3712,12 @@ with the string <var>var</var>.
</p>
<hr>
-<span id="Reporting-bugs"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Reporting-bugs">
+<div class="header">
<p>
-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">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Programming" accesskey="p" rel="prev">Programming</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Reporting-bugs-1"></span><h2 class="chapter">8 Reporting bugs</h2>
@@ -3831,22 +3733,18 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#P
inconsistent behavior, but unclear or incomplete explanations, typos,
wrong fonts, &hellip;
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Bug-checklist" accesskey="1">Bug checklist</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">What to include in a good bug report.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Mailing-lists" accesskey="2">Mailing lists</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Joining the bugs or announcements mailing lists.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Debugging" accesskey="3">Debugging</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Analyzing runtime problems.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Logging" accesskey="4">Logging</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Recording searches.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Common-problems" accesskey="5">Common problems</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">When things go wrong.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Bug-checklist" accesskey="1">Bug checklist</a></li>
+<li><a href="#Mailing-lists" accesskey="2">Mailing lists</a></li>
+<li><a href="#Debugging" accesskey="3">Debugging</a></li>
+<li><a href="#Logging" accesskey="4">Logging</a></li>
+<li><a href="#Common-problems" accesskey="5">Common problems</a></li>
+</ul>
<hr>
-<span id="Bug-checklist"></span><div class="header">
+<div class="section" id="Bug-checklist">
+<div class="header">
<p>
Next: <a href="#Mailing-lists" accesskey="n" rel="next">Mailing lists</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3939,7 +3837,9 @@ diagnosing, or fixing the bug.
<hr>
-<span id="Mailing-lists"></span><div class="header">
+</div>
+<div class="section" id="Mailing-lists">
+<div class="header">
<p>
Next: <a href="#Debugging" accesskey="n" rel="next">Debugging</a>, Previous: <a href="#Bug-checklist" accesskey="p" rel="prev">Bug checklist</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3965,7 +3865,9 @@ full TeX system or how to use LaTeX, please see
</p>
<hr>
-<span id="Debugging"></span><div class="header">
+</div>
+<div class="section" id="Debugging">
+<div class="header">
<p>
Next: <a href="#Logging" accesskey="n" rel="next">Logging</a>, Previous: <a href="#Mailing-lists" accesskey="p" rel="prev">Mailing lists</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4011,7 +3913,7 @@ easily. For example, in Bourne-compatible shells:
<span id="index-Kpsewhich_002c-and-debugging"></span>
<p>It is sometimes helpful to run the standalone Kpsewhich utility
-(see <a href="#Invoking-kpsewhich">Invoking kpsewhich</a>), instead of the original program.
+(see <a href="#Invoking-kpsewhich"><code>kpsewhich</code>: Standalone path searching</a>), instead of the original program.
</p>
<span id="index-numeric-debugging-values"></span>
<p>In any case, you cannot use the names below; you must always use
@@ -4019,29 +3921,23 @@ somebody&rsquo;s numbers. (Sorry.) To set more than one option, just sum
the corresponding numbers.
</p>
<dl compact="compact">
-<dt><code>KPSE_DEBUG_STAT <span class="roman">(1)</span></code>
-<span id="index-KPSE_005fDEBUG_005fSTAT-_00281_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fSTAT-_00281_0029'><span><code>KPSE_DEBUG_STAT <span class="roman">(1)</span></code><a href='#index-KPSE_005fDEBUG_005fSTAT-_00281_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Report &lsquo;<samp>stat</samp>&rsquo;(2) calls. This is useful for verifying that your
directory structure is not forcing Kpathsea to do many additional file
tests (see <a href="#Slow-path-searching">Slow path searching</a>, and see <a href="#Subdirectory-expansion">Subdirectory expansion</a>). If you are using an up-to-date <samp>ls-R</samp> database
-(see <a href="#Filename-database">Filename database</a>), this should produce no output unless a
+(see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>), this should produce no output unless a
nonexistent file that must exist is searched for.
</p>
</dd>
-<dt><code>KPSE_DEBUG_HASH <span class="roman">(2)</span></code>
-<span id="index-KPSE_005fDEBUG_005fHASH-_00282_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fHASH-_00282_0029'><span><code>KPSE_DEBUG_HASH <span class="roman">(2)</span></code><a href='#index-KPSE_005fDEBUG_005fHASH-_00282_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Report lookups in all hash tables: <samp>ls-R</samp> and <samp>aliases</samp>
-(see <a href="#Filename-database">Filename database</a>); font aliases (see <a href="#Fontmap">Fontmap</a>); and config
+(see <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>); font aliases (see <a href="#Fontmap">Fontmap</a>); and config
file values (see <a href="#Config-files">Config files</a>). Useful when expected values are not
being found, e.g.., file searches are looking at the disk instead of
using <samp>ls-R</samp>.
</p>
</dd>
-<dt><code>KPSE_DEBUG_FOPEN <span class="roman">(4)</span></code>
-<span id="index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fFOPEN-_00284_0029'><span><code>KPSE_DEBUG_FOPEN <span class="roman">(4)</span></code><a href='#index-KPSE_005fDEBUG_005fFOPEN-_00284_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-fopen_002c-redefined"></span>
<p>Report file openings and closings. Especially useful when your system&rsquo;s
file table is full, for seeing which files have been opened but never
@@ -4050,9 +3946,7 @@ redefining &lsquo;<samp>fopen</samp>&rsquo; (&lsquo;<samp>fclose</samp>&rsquo;)
(&lsquo;<samp>kpse_fclose_trace</samp>&rsquo;).
</p>
</dd>
-<dt><code>KPSE_DEBUG_PATHS <span class="roman">(8)</span></code>
-<span id="index-KPSE_005fDEBUG_005fPATHS-_00288_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fPATHS-_00288_0029'><span><code>KPSE_DEBUG_PATHS <span class="roman">(8)</span></code><a href='#index-KPSE_005fDEBUG_005fPATHS-_00288_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-kpse_005fformat_005finfo_005ftype"></span>
<p>Report general path information for each file type Kpathsea is asked to
search. This is useful when you are trying to track down how a
@@ -4062,17 +3956,13 @@ contents of the <code>kpse_format_info_type</code> structure defined in
<samp>tex-file.h</samp>.
</p>
</dd>
-<dt><code>KPSE_DEBUG_EXPAND <span class="roman">(16)</span></code>
-<span id="index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fEXPAND-_002816_0029'><span><code>KPSE_DEBUG_EXPAND <span class="roman">(16)</span></code><a href='#index-KPSE_005fDEBUG_005fEXPAND-_002816_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Report the directory list corresponding to each path element Kpathsea
searches. This is only relevant when Kpathsea searches the disk, since
<samp>ls-R</samp> searches don&rsquo;t look through directory lists in this way.
</p>
</dd>
-<dt><code>KPSE_DEBUG_SEARCH <span class="roman">(32)</span></code>
-<span id="index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fSEARCH-_002832_0029'><span><code>KPSE_DEBUG_SEARCH <span class="roman">(32)</span></code><a href='#index-KPSE_005fDEBUG_005fSEARCH-_002832_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Report on each file search: the name of the file searched for, the path
searched in, whether or not the file must exist (when drivers search for
<samp>cmr10.vf</samp>, it need not exist), and whether or not we are
@@ -4082,22 +3972,16 @@ most lookups). This can help you correlate what Kpathsea is doing with
what is in your input file.
</p>
</dd>
-<dt><code>KPSE_DEBUG_VARS <span class="roman">(64)</span></code>
-<span id="index-KPSE_005fDEBUG_005fVARS-_002864_0029"></span>
-</dt>
+<dt id='index-KPSE_005fDEBUG_005fVARS-_002864_0029'><span><code>KPSE_DEBUG_VARS <span class="roman">(64)</span></code><a href='#index-KPSE_005fDEBUG_005fVARS-_002864_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Report the value of each variable Kpathsea looks up. This is useful for
verifying that variables do indeed obtain their correct values.
</p>
</dd>
-<dt><code>GSFTOPK_DEBUG <span class="roman">(128)</span></code>
-<span id="index-GSFTOPK_005fDEBUG-_0028128_0029"></span>
-</dt>
+<dt id='index-GSFTOPK_005fDEBUG-_0028128_0029'><span><code>GSFTOPK_DEBUG <span class="roman">(128)</span></code><a href='#index-GSFTOPK_005fDEBUG-_0028128_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Activates debugging printout specific to <code>gsftopk</code> program.
</p>
</dd>
-<dt><code>MAKETEX_DEBUG <span class="roman">(512)</span></code>
-<span id="index-MAKETEX_005fDEBUG-_0028512_0029"></span>
-</dt>
+<dt id='index-MAKETEX_005fDEBUG-_0028512_0029'><span><code>MAKETEX_DEBUG <span class="roman">(512)</span></code><a href='#index-MAKETEX_005fDEBUG-_0028512_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>If you use the optional <code>mktex</code> programs instead of the
traditional shell scripts, this will report the name of the site file
(<samp>mktex.cnf</samp> by default) which is read, directories created by
@@ -4107,9 +3991,7 @@ parameters from <code>mktexnam</code>, filenames added by
<code>mktexupd</code>, and some subsidiary commands run by the programs.
</p>
</dd>
-<dt><code>MAKETEX_FINE_DEBUG <span class="roman">(1024)</span></code>
-<span id="index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"></span>
-</dt>
+<dt id='index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029'><span><code>MAKETEX_FINE_DEBUG <span class="roman">(1024)</span></code><a href='#index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>When the optional <code>mktex</code> programs are used, this will print
additional debugging info from functions internal to these programs.
</p></dd>
@@ -4126,7 +4008,9 @@ variable in <samp>kpathsea/db.c</samp>.)
</p>
<hr>
-<span id="Logging"></span><div class="header">
+</div>
+<div class="section" id="Logging">
+<div class="header">
<p>
Next: <a href="#Common-problems" accesskey="n" rel="next">Common problems</a>, Previous: <a href="#Debugging" accesskey="p" rel="prev">Debugging</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4185,7 +4069,9 @@ else.
</p>
<hr>
-<span id="Common-problems"></span><div class="header">
+</div>
+<div class="section" id="Common-problems">
+<div class="header">
<p>
Previous: <a href="#Logging" accesskey="p" rel="prev">Logging</a>, Up: <a href="#Reporting-bugs" accesskey="u" rel="up">Reporting bugs</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4198,19 +4084,16 @@ Previous: <a href="#Logging" accesskey="p" rel="prev">Logging</a>, Up: <a href="
<p>Here are some common problems with configuration, compilation, linking,
execution, &hellip;
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Unable-to-find-files" accesskey="1">Unable to find files</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If your program can&rsquo;t find fonts (or whatever).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Slow-path-searching" accesskey="2">Slow path searching</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If it takes forever to find anything.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Unable-to-generate-fonts" accesskey="3">Unable to generate fonts</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If mktexpk fails.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#TeX-or-Metafont-failing" accesskey="4">TeX or Metafont failing</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Likely compiler bugs.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Unable-to-find-files" accesskey="1">Unable to find files</a></li>
+<li><a href="#Slow-path-searching" accesskey="2">Slow path searching</a></li>
+<li><a href="#Unable-to-generate-fonts" accesskey="3">Unable to generate fonts</a></li>
+<li><a href="#TeX-or-Metafont-failing" accesskey="4">TeX or Metafont failing</a></li>
+</ul>
<hr>
-<span id="Unable-to-find-files"></span><div class="header">
+<div class="subsection" id="Unable-to-find-files">
+<div class="header">
<p>
Next: <a href="#Slow-path-searching" accesskey="n" rel="next">Slow path searching</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4226,7 +4109,7 @@ debugging options helpful. See <a href="#Debugging">Debugging</a>.
<ul>
<li> Perhaps you simply haven&rsquo;t installed all the necessary files; the basic
fonts and input files are distributed separately from the programs.
-See <a href="#unixtex_002eftp">unixtex.ftp</a>.
+See <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>.
</li><li> <span id="index-_002fetc_002fprofile"></span>
<span id="index-environment-variables_002c-old"></span>
@@ -4263,14 +4146,16 @@ error message saying something like &lsquo;<samp>Can't find font
<var>fontname</var></samp>&rsquo;. The best solution is to fix (or at least report) the
bug in <code>mktexpk</code>; the workaround is to generate the necessary
fonts by hand with Metafont, or to grab them from a CTAN site
-(see <a href="#unixtex_002eftp">unixtex.ftp</a>).
+(see <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>).
</li><li> There is a bug in the library. See <a href="#Reporting-bugs">Reporting bugs</a>.
</li></ul>
<hr>
-<span id="Slow-path-searching"></span><div class="header">
+</div>
+<div class="subsection" id="Slow-path-searching">
+<div class="header">
<p>
Next: <a href="#Unable-to-generate-fonts" accesskey="n" rel="next">Unable to generate fonts</a>, Previous: <a href="#Unable-to-find-files" accesskey="p" rel="prev">Unable to find files</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4287,7 +4172,7 @@ input files, but does eventually succeed, here are some possible culprits:
<li> Most likely, you just have a lot of directories to search, and that
takes a noticeable time. The solution is to create and maintain a
separate <samp>ls-R</samp> file that lists all the files in your main TeX
-hierarchy. See <a href="#Filename-database">Filename database</a>. Kpathsea always uses <samp>ls-R</samp>
+hierarchy. See <a href="#Filename-database">Filename database (<code>ls-R</code>)</a>. Kpathsea always uses <samp>ls-R</samp>
if it&rsquo;s present; there&rsquo;s no need to recompile or reconfigure any of the
programs.
@@ -4307,7 +4192,9 @@ precisely when the disk or network is being pounded. See <a href="#Debugging">D
</p>
<hr>
-<span id="Unable-to-generate-fonts"></span><div class="header">
+</div>
+<div class="subsection" id="Unable-to-generate-fonts">
+<div class="header">
<p>
Next: <a href="#TeX-or-Metafont-failing" accesskey="n" rel="next">TeX or Metafont failing</a>, Previous: <a href="#Slow-path-searching" accesskey="p" rel="prev">Slow path searching</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4332,7 +4219,7 @@ mktexpk: Use a config file to specify the mode, or update me.
specifying the resolution, as in <code>-D 360</code>, is not enough.
</p>
<p>You can specify the mode name with the <code>-mode</code> option on the
-Dvips command line, or in a Dvips configuration file (see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config
+Dvips command line, or in a Dvips configuration file (see <a data-manual="dvips" href="https://tug.org/texinfohtml/dvips.html#Config-files">Config
files</a> in <cite>Dvips</cite>), such as <samp>config.ps</samp> in your document
directory, <samp>~/.dvipsrc</samp> in your home directory, or in a system
directory (again named <samp>config.ps</samp>). (Other drivers use other
@@ -4377,15 +4264,17 @@ the base files are stored on your system
(<samp>/usr/local/share/texmf/web2c</samp> by default), and make a link
(either hard or soft) from <samp>plain.base</samp> to <samp>mf.base</samp> in that
directory.
-See <a href="https://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite>Web2c</cite>.
+See <a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite>Web2c</cite>.
</p>
<span id="index-Metafont-installation"></span>
<p>If <code>mf</code> is a command not found at all by <code>mktexpk</code>, then you
-need to install Metafont (see <a href="#unixtex_002eftp">unixtex.ftp</a>).
+need to install Metafont (see <a href="#unixtex_002eftp"><samp>unixtex.ftp</samp>: Obtaining TeX</a>).
</p>
<hr>
-<span id="TeX-or-Metafont-failing"></span><div class="header">
+</div>
+<div class="subsection" id="TeX-or-Metafont-failing">
+<div class="header">
<p>
Previous: <a href="#Unable-to-generate-fonts" accesskey="p" rel="prev">Unable to generate fonts</a>, Up: <a href="#Common-problems" accesskey="u" rel="up">Common problems</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -4409,7 +4298,7 @@ to run the program under the debugger and see where it&rsquo;s failing.
<span id="index-system-C-compiler-bugs"></span>
<p>Also, if you have trouble with a system C compiler, I advise trying the
GNU C compiler. And vice versa, unfortunately; but in that case I also
-recommend reporting a bug to the GCC mailing list; see <a href="https://gcc.gnu.org/onlinedocs/gcc/Bugs.html#Bugs">Bugs</a> in <cite>Using and Porting GNU CC</cite>.
+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>Using and Porting GNU CC</cite>.
</p>
<span id="index-compiler-bugs_002c-finding"></span>
<p>To report compiler bugs effectively requires perseverance and
@@ -4419,9 +4308,13 @@ through TeX&rsquo;s (or whatever program&rsquo;s) data structures. Good luck.
</p>
<hr>
-<span id="Index"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="unnumbered" id="Index">
+<div class="header">
<p>
-Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, Up: <a href="#Top" accesskey="u" rel="up">Kpathsea library</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
@@ -4722,7 +4615,6 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>,
<tr><td></td><td valign="top"><a href="#index-config_002estatus"><code>config.status</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configuration-bugs">configuration bugs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configuration-file_002c-source-for-path">configuration file, source for path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Path-sources">Path sources</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-configuration-files-as-shell-scripts_002e">configuration files as shell scripts.</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Config-files">Config files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configuration-of-mktex-scripts">configuration of <samp>mktex</samp> scripts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-options-for-mktex-scripts"><code>configure</code> options for <samp>mktex</samp> scripts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-context-diff">context diff</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr>
@@ -5072,7 +4964,6 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>,
<tr><td></td><td valign="top"><a href="#index-sending-patches">sending patches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-setgid-scripts">setgid scripts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Security">Security</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SFDFONTS"><code>SFDFONTS</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-shell-scripts-as-configuration-files">shell scripts as configuration files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Config-files">Config files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shell-variables">shell variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Variable-expansion">Variable expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shell_005fescape_002c-example-for-code"><code>shell_escape<span class="roman">, example for code</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programming-with-config-files">Programming with config files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-site-overrides-for-mktex_2026">site overrides for <code>mktex&hellip;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
@@ -5312,7 +5203,8 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>,
&nbsp;
</td></tr></table>
-<hr>
+</div>
+</div>