diff options
author | Norbert Preining <norbert@preining.info> | 2022-03-05 03:00:46 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-03-05 03:00:46 +0000 |
commit | 19a90b19f6ec33aec1291be08fecfece45735a22 (patch) | |
tree | 5280534c654589edee14cba9c39981c452a7a0e3 /systems/doc/kpathsea/kpathsea.html | |
parent | 575ab7d0e7534edd510bbc89a2ef4b04582af591 (diff) |
CTAN sync 202203050300
Diffstat (limited to 'systems/doc/kpathsea/kpathsea.html')
-rw-r--r-- | systems/doc/kpathsea/kpathsea.html | 1252 |
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> [<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> [<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">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </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">• <a href="#unixtex_002eftp" accesskey="2">unixtex.ftp</a></td><td> </td><td align="left" valign="top">Obtaining TeX software. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Security" accesskey="3">Security</a></td><td> </td><td align="left" valign="top">Who can write what files, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-directory-structure" accesskey="4">TeX directory structure</a></td><td> </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">• <a href="#Path-searching" accesskey="5">Path searching</a></td><td> </td><td align="left" valign="top">How filename lookups work. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-support" accesskey="6">TeX support</a></td><td> </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">• <a href="#Programming" accesskey="7">Programming</a></td><td> </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">• <a href="#Reporting-bugs" accesskey="8">Reporting bugs</a></td><td> </td><td align="left" valign="top">Where and how to report bugs. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Index" rel="index" accesskey="9">Index</a></td><td> </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> [<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> [<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’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 ‘<samp>dvilj</samp>’ 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 ‘<samp>xdvi</samp>’ 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’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">• <a href="#History" accesskey="1">History</a></td><td> </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> [<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> [<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> [<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> [<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> [<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 ‘<samp>-R</samp>’ 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 ‘<samp>-R</samp>’ 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> [<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> [<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> [<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> [<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, …) 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">• <a href="#Searching-overview" accesskey="1">Searching overview</a></td><td> </td><td align="left" valign="top">Basic scheme for searching. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Path-sources" accesskey="2">Path sources</a></td><td> </td><td align="left" valign="top">Where search paths can be defined. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Path-expansion" accesskey="3">Path expansion</a></td><td> </td><td align="left" valign="top">Special constructs in search paths. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Casefolding-search" accesskey="4">Casefolding search</a></td><td> </td><td align="left" valign="top">Fallback to case-insensitive search. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Filename-database" accesskey="5">Filename database</a></td><td> </td><td align="left" valign="top">Using an externally-built list to search. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-kpsewhich" accesskey="6">Invoking kpsewhich</a></td><td> </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> [<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’ 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> [<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 ‘<samp>latex</samp>’. </p> </li><li> A program-specific configuration file, e.g., an ‘<samp>S /a:/b</samp>’ line in -Dvips’ <samp>config.ps</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>). +Dvips’ <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">• <a href="#Config-files" accesskey="1">Config files</a></td><td> </td><td align="left" valign="top">Kpathsea’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> [<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 ‘<samp>%</samp>’, 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 ‘<samp>%</samp>’ in the “middle” of a value does not -start a comment. Examples: +Comments start with ‘<samp>%</samp>’ or ‘<samp>#</samp>’, 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 “middle” +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—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’t affect its -parent’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 ‘<samp>=</samp>’ 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> [<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">• <a href="#Default-expansion" accesskey="1">Default expansion</a></td><td> </td><td align="left" valign="top">a: or :a or a::b expands to a default. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Variable-expansion" accesskey="2">Variable expansion</a></td><td> </td><td align="left" valign="top">$foo and ${foo} expand to environment values. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Tilde-expansion" accesskey="3">Tilde expansion</a></td><td> </td><td align="left" valign="top">~ and ~user expand to home directories. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Brace-expansion" accesskey="4">Brace expansion</a></td><td> </td><td align="left" valign="top">a{foo,bar}b expands to afoob abarb. -</td></tr> -<tr><td align="left" valign="top">• <a href="#KPSE_005fDOT-expansion" accesskey="5">KPSE_DOT expansion</a></td><td> </td><td align="left" valign="top">. is replaced with $KPSE_DOT if it is defined. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Subdirectory-expansion" accesskey="6">Subdirectory expansion</a></td><td> </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> [<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> [<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> [<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 ‘<samp>/</samp>’, the path element ‘<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> [<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> [<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 ‘<samp>x{A:B}{1:2}y</samp>’ (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> [<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 -‘<samp>mktex…</samp>’ scripts <a href="#mktex-scripts">mktex scripts</a>, because these +‘<samp>mktex…</samp>’ 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> [<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> [<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> [<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> [<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., ‘<samp>1</samp>’; this is done by default in TeX Live. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Casefolding-rationale" accesskey="1">Rationale</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#Casefolding-examples" accesskey="2">Examples</a></td><td> </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> [<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> [<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 ‘<samp>!!</samp>’ -(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 ‘<samp>texmf-local</samp>’ and ‘<samp>texmf-dist</samp>’ 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> [<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> [<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">• <a href="#ls_002dR" accesskey="1">ls-R</a></td><td> </td><td align="left" valign="top">The main filename database. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Filename-aliases" accesskey="2">Filename aliases</a></td><td> </td><td align="left" valign="top">Aliases for those names. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Database-format" accesskey="3">Database format</a></td><td> </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> [<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> [<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> [<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> [<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> [<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> [<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> [<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> [<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 ‘<samp>mktex…</samp>’ scripts. Options can start with either ‘<samp>-</samp>’ or ‘<samp>--</samp>’, and any unambiguous abbreviation is accepted. </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Path-searching-options" accesskey="1">Path searching options</a></td><td> </td><td align="left" valign="top">Changing the mode, resolution, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Specially_002drecognized-files" accesskey="2">Specially-recognized files</a></td><td> </td><td align="left" valign="top">Default formats for texmf.cnf, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Auxiliary-tasks" accesskey="3">Auxiliary tasks</a></td><td> </td><td align="left" valign="top">Path and variable expansion, etc. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Standard-options" accesskey="4">Standard options</a></td><td> </td><td align="left" valign="top">‘<samp>--help</samp>’ and ‘<samp>--version</samp>’. -</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> [<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> [<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>‘<samp>--all</samp>’</dt> -<dd><span id="index-_002d_002dall"></span> -<span id="index-all-matches_002c-finding"></span> +<dt id='index-_002d_002dall'><span>‘<samp>--all</samp>’<a href='#index-_002d_002dall' class='copiable-anchor'> ¶</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>‘<samp>--casefold-search</samp>’</dt> -<dt>‘<samp>--no-casefold-search</samp>’</dt> -<dd><span id="index-_002d_002dcasefold_002dsearch"></span> -<span id="index-_002d_002dno_002dcasefold_002dsearch"></span> +<dt id='index-_002d_002dcasefold_002dsearch'><span>‘<samp>--casefold-search</samp>’<a href='#index-_002d_002dcasefold_002dsearch' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>--no-casefold-search</samp>’</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>‘<samp>--cnf-line=<var>str</var></samp>’</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>‘<samp>--cnf-line=<var>str</var></samp>’<a href='#index-_002d_002dcnf_002dline' class='copiable-anchor'> ¶</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>‘<samp>--dpi=<var>num</var></samp>’</dt> -<dd><span id="index-_002d_002ddpi_003dnum"></span> -<span id="index-_002dD-num"></span> +<dt id='index-_002d_002ddpi_003dnum'><span>‘<samp>--dpi=<var>num</var></samp>’<a href='#index-_002d_002ddpi_003dnum' class='copiable-anchor'> ¶</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 ‘<samp>gf</samp>’ and ‘<samp>pk</samp>’ lookups. ‘<samp>-D</samp>’ is a synonym, for compatibility with Dvips. Default is 600. </p> </dd> -<dt>‘<samp>--engine=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dengine_003dname"></span> -<span id="index-engine-name"></span> +<dt id='index-_002d_002dengine_003dname'><span>‘<samp>--engine=<var>name</var></samp>’<a href='#index-_002d_002dengine_003dname' class='copiable-anchor'> ¶</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 ‘<samp>$TEXMF/web2c{/$engine,}</samp>’.) </p> </dd> -<dt>‘<samp>--format=<var>name</var></samp>’</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>‘<samp>--format=<var>name</var></samp>’<a href='#index-_002d_002dformat_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the format for lookup to <var>name</var>. By default, the format is guessed from the filename, with ‘<samp>tex</samp>’ being used if nothing else fits. The recognized filename extensions (including any leading ‘<samp>.</samp>’) are also allowable <var>name</var>s. @@ -1884,40 +1869,35 @@ bltxml: .bltxml <p>This option and ‘<samp>--path</samp>’ are mutually exclusive. </p> </dd> -<dt>‘<samp>--interactive</samp>’</dt> -<dd><span id="index-_002d_002dinteractive"></span> -<span id="index-interactive-query"></span> +<dt id='index-_002d_002dinteractive'><span>‘<samp>--interactive</samp>’<a href='#index-_002d_002dinteractive' class='copiable-anchor'> ¶</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>‘<samp>--mktex=<var>filetype</var></samp>’</dt> -<dt>‘<samp>--no-mktex=<var>filetype</var></samp>’</dt> -<dd><span id="index-_002d_002dmktex_003dfiletype"></span> -<span id="index-_002d_002dno_002dmktex_003dfiletype"></span> +<dt id='index-_002d_002dmktex_003dfiletype'><span>‘<samp>--mktex=<var>filetype</var></samp>’<a href='#index-_002d_002dmktex_003dfiletype' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>--no-mktex=<var>filetype</var></samp>’</span></dt> +<dd><span id="index-_002d_002dno_002dmktex_003dfiletype"></span> <p>Turn on or off the ‘<samp>mktex</samp>’ script associated with <var>filetype</var>. Usual values for <var>filetype</var> are ‘<samp>pk</samp>’, ‘<samp>mf</samp>’, ‘<samp>tex</samp>’, and ‘<samp>tfm</samp>’. 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>‘<samp>--mode=<var>string</var></samp>’</dt> -<dd><span id="index-_002d_002dmode_003dstring"></span> -<p>Set the mode name to <var>string</var>; this also only affects ‘<samp>gf</samp>’ and -‘<samp>pk</samp>’ 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>‘<samp>--mode=<var>string</var></samp>’<a href='#index-_002d_002dmode_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the mode name to <var>string</var>; this also only affects ‘<samp>gf</samp>’ and +‘<samp>pk</samp>’ lookups. No default: any mode will be found. See <a href="#mktex-script-arguments"><samp>mktex</samp> script arguments</a>. </p> </dd> -<dt>‘<samp>--must-exist</samp>’</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>‘<samp>--must-exist</samp>’<a href='#index-_002d_002dmust_002dexist' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Do everything possible to find the files, notably including searching the disk and running the ‘<samp>mktex</samp>’ scripts. By default, only the <samp>ls-R</samp> database is checked, in the interest of efficiency. </p> </dd> -<dt>‘<samp>--path=<var>string</var></samp>’</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>‘<samp>--path=<var>string</var></samp>’<a href='#index-_002d_002dpath_003dstring' class='copiable-anchor'> ¶</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. ‘<samp>//</samp>’ and all the usual expansions are supported (see <a href="#Path-expansion">Path expansion</a>). This option and ‘<samp>--format</samp>’ are mutually exclusive. To output the complete @@ -1925,16 +1905,14 @@ directory expansion of a path, instead of doing a one-shot lookup, see ‘<samp>--expand-path</samp>’ and ‘<samp>--show-path</samp>’ in the following section. </p> </dd> -<dt>‘<samp>--progname=<var>name</var></samp>’</dt> -<dd><span id="index-_002d_002dprogname_003dname"></span> -<p>Set the program name to <var>name</var>; default is ‘<samp>kpsewhich</samp>’. This +<dt id='index-_002d_002dprogname_003dname'><span>‘<samp>--progname=<var>name</var></samp>’<a href='#index-_002d_002dprogname_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set the program name to <var>name</var>; default is ‘<samp>kpsewhich</samp>’. This can affect the search paths via the ‘<samp>.<var>prognam</var></samp>’ feature in configuration files (see <a href="#Config-files">Config files</a>). </p> </dd> -<dt>‘<samp>--subdir=<var>string</var></samp>’</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>‘<samp>--subdir=<var>string</var></samp>’<a href='#index-_002d_002dsubdir_003dstring' class='copiable-anchor'> ¶</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’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> [<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> [<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>‘<samp>other text files</samp>’ </p> <span id="index-fmtutil_002ecnf"></span> </dd> -<dt><samp>fmtutil.cnf</samp></dt> +<dt><span><samp>fmtutil.cnf</samp></span></dt> <dd><p>‘<samp>web2c files</samp>’ </p> <span id="index-glyphlist_002etxt"></span> </dd> -<dt><samp>glyphlist.txt</samp></dt> +<dt><span><samp>glyphlist.txt</samp></span></dt> <dd><p>‘<samp>map</samp>’ </p> <span id="index-mktex_002ecnf"></span> </dd> -<dt><samp>mktex.cnf</samp></dt> +<dt><span><samp>mktex.cnf</samp></span></dt> <dd><p>‘<samp>web2c files</samp>’ </p> <span id="index-pdfglyphlist_002etxt"></span> </dd> -<dt><samp>pdfglyphlist.txt</samp></dt> +<dt><span><samp>pdfglyphlist.txt</samp></span></dt> <dd><p>‘<samp>map</samp>’ </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>‘<samp>pdftex config</samp>’ (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>‘<samp>cnf</samp>’ </p> <span id="index-XDvi"></span> </dd> -<dt><samp>XDvi</samp></dt> +<dt><span><samp>XDvi</samp></span></dt> <dd><p>‘<samp>other text files</samp>’ </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> [<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> [<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>‘<samp>--debug=<var>num</var></samp>’</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>‘<samp>--debug=<var>num</var></samp>’<a href='#index-_002d_002ddebug_003dnum' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Set debugging options to <var>num</var>. See <a href="#Debugging">Debugging</a>. </p> </dd> -<dt>‘<samp>--expand-braces=<var>string</var></samp>’</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>‘<samp>--expand-braces=<var>string</var></samp>’<a href='#index-_002d_002dexpand_002dbraces_003dstring' class='copiable-anchor'> ¶</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>‘<samp>--expand-path=<var>string</var></samp>’</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>‘<samp>--expand-path=<var>string</var></samp>’<a href='#index-_002d_002dexpand_002dpath_003dstring' class='copiable-anchor'> ¶</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 (‘<samp>;</samp>’ on Windows, ‘<samp>:</samp>’ 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' ‘<samp>--path</samp>’ (see <a href="#Path-searching-options">Path searching options</a>). </p> </dd> -<dt>‘<samp>--expand-var=<var>string</var></samp>’</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>‘<samp>--expand-var=<var>string</var></samp>’<a href='#index-_002d_002dexpand_002dvar_003dstring' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Output the variable and tilde expansion of <var>string</var>. For example, with the usual <samp>texmf.cnf</samp>, ‘<samp>kpsewhich --expand-var='$TEXMF'</samp>’ 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>‘<samp>--help-formats</samp>’</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>‘<samp>--help-formats</samp>’<a href='#index-_002d_002dhelp_002dformats' class='copiable-anchor'> ¶</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>‘<samp>--safe-in-name=<var>name</var></samp>’</dt> -<dt>‘<samp>--safe-out-name=<var>name</var></samp>’</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>‘<samp>--safe-in-name=<var>name</var></samp>’<a href='#index-_002d_002dsafe_002din_002dname_003dname' class='copiable-anchor'> ¶</a></span></dt> +<dt><span>‘<samp>--safe-out-name=<var>name</var></samp>’</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>‘<samp>--show-path=<var>name</var></samp>’</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>‘<samp>--show-path=<var>name</var></samp>’<a href='#index-_002d_002dshow_002dpath_003dname' class='copiable-anchor'> ¶</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 (‘<samp>pk</samp>’, ‘<samp>.vf</samp>’, etc.) or an integer can be used, just as with ‘<samp>--format</samp>’, described in the previous section. </p> </dd> -<dt>‘<samp>--var-brace-value=<var>variable</var></samp>’</dt> -<dd><span id="index-_002d_002dvar_002dbrace_002dvalue_003dvariable"></span> -<p>Like ‘<samp>--var-value</samp>’ (next), but also expands ‘<samp>{...}</samp>’ +<dt id='index-_002d_002dvar_002dbrace_002dvalue_003dvariable'><span>‘<samp>--var-brace-value=<var>variable</var></samp>’<a href='#index-_002d_002dvar_002dbrace_002dvalue_003dvariable' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Like ‘<samp>--var-value</samp>’ (next), but also expands ‘<samp>{...}</samp>’ constructs. (see <a href="#Brace-expansion">Brace expansion</a>). Thus, the value is assumed to possibly be several path elements, and ‘<samp>~</samp>’ 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 ‘<samp>;</samp>’ would remain. </p> </dd> -<dt>‘<samp>--var-value=<var>variable</var></samp>’</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>‘<samp>--var-value=<var>variable</var></samp>’<a href='#index-_002d_002dvar_002dvalue_003dvariable' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>Outputs the value of <var>variable</var> (a simple identifier like ‘<samp>TEXMFDIST</samp>’, with no ‘<samp>$</samp>’ or other constructs), expanding ‘<samp>$</samp>’ (see <a href="#Variable-expansion">Variable expansion</a>) and ‘<samp>~</samp>’ (see <a href="#Tilde-expansion">Tilde expansion</a>) constructs in the value. ‘<samp>~</samp>’ 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> [<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> [<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> [<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> [<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—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">• <a href="#Supported-file-formats" accesskey="1">Supported file formats</a></td><td> </td><td align="left" valign="top">File types Kpathsea knows about. -</td></tr> -<tr><td align="left" valign="top">• <a href="#File-lookup" accesskey="2">File lookup</a></td><td> </td><td align="left" valign="top">Searching for most kinds of files. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Glyph-lookup" accesskey="3">Glyph lookup</a></td><td> </td><td align="left" valign="top">Searching for bitmap fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Suppressing-warnings" accesskey="4">Suppressing warnings</a></td><td> </td><td align="left" valign="top">Avoiding warnings via TEX_HUSH. -</td></tr> -<tr><td align="left" valign="top">• <a href="#mktex-scripts" accesskey="5">mktex scripts</a></td><td> </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> [<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 ‘<samp>--help-formats</samp>’ option to <code>kps (see <a href="#Auxiliary-tasks">Auxiliary tasks</a>). </p> <dl compact="compact"> -<dt>‘<samp>afm</samp>’</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>‘<samp>afm</samp>’<a href='#index-_002eafm' class='copiable-anchor'> ¶</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 ‘<samp>.afm</samp>’. </p> </dd> -<dt>‘<samp>base</samp>’</dt> -<dd><span id="index-_002ebase"></span> -<span id="index-MFBASES"></span> +<dt id='index-_002ebase'><span>‘<samp>base</samp>’<a href='#index-_002ebase' class='copiable-anchor'> ¶</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 ‘<samp>.base</samp>’. </p> </dd> -<dt>‘<samp>bib</samp>’</dt> -<dd><span id="index-_002ebib"></span> -<span id="index-BIBINPUTS"></span> +<dt id='index-_002ebib'><span>‘<samp>bib</samp>’<a href='#index-_002ebib' class='copiable-anchor'> ¶</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 ‘<samp>.bib</samp>’. </p> </dd> -<dt>‘<samp>bltxml</samp>’</dt> -<dd><span id="index-_002ebltxml"></span> -<span id="index-BLTXMLINPUTS"></span> +<dt id='index-_002ebltxml'><span>‘<samp>bltxml</samp>’<a href='#index-_002ebltxml' class='copiable-anchor'> ¶</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 ‘<samp>.bltxml</samp>’. </p> </dd> -<dt>‘<samp>bst</samp>’</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>‘<samp>bst</samp>’<a href='#index-_002ebst' class='copiable-anchor'> ¶</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 ‘<samp>.bst</samp>’. </p> </dd> -<dt>‘<samp>clua</samp>’</dt> -<dd><span id="index-_002edll"></span> -<span id="index-_002eso"></span> +<dt id='index-_002edll'><span>‘<samp>clua</samp>’<a href='#index-_002edll' class='copiable-anchor'> ¶</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 ‘<samp>.dll</samp>’ and ‘<samp>.so</samp>’. </p> </dd> -<dt>‘<samp>cmap</samp>’</dt> -<dd><span id="index-_002ecmap"></span> -<span id="index-CMAPFONTS"></span> +<dt id='index-_002ecmap'><span>‘<samp>cmap</samp>’<a href='#index-_002ecmap' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-CMAPFONTS"></span> <p>(character map files) <code>CMAPFONTS</code>; suffix ‘<samp>.cmap</samp>’. </p> </dd> -<dt>‘<samp>cnf</samp>’</dt> -<dd><span id="index-_002ecnf"></span> -<span id="index-TEXMFCNF-1"></span> +<dt id='index-_002ecnf'><span>‘<samp>cnf</samp>’<a href='#index-_002ecnf' class='copiable-anchor'> ¶</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 ‘<samp>.cnf</samp>’. </p> </dd> -<dt>‘<samp>cweb</samp>’</dt> -<dd><span id="index-_002ew"></span> -<span id="index-_002eweb"></span> +<dt id='index-_002ew'><span>‘<samp>cweb</samp>’<a href='#index-_002ew' class='copiable-anchor'> ¶</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 ‘<samp>.w</samp>’, ‘<samp>.web</samp>’; additional suffix ‘<samp>.ch</samp>’. </p> </dd> -<dt>‘<samp>dvips config</samp>’</dt> -<dd><span id="index-TEXCONFIG"></span> -<span id="index-config_002eps_002c-search-path-for"></span> -<p>(Dvips ‘<samp>config.*</samp>’ files, such as <samp>config.ps</samp>, see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config +<dt id='index-TEXCONFIG'><span>‘<samp>dvips config</samp>’<a href='#index-TEXCONFIG' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-config_002eps_002c-search-path-for"></span> +<p>(Dvips ‘<samp>config.*</samp>’ 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>‘<samp>enc files</samp>’</dt> -<dd><span id="index-_002eenc"></span> -<span id="index-ENCFONTS"></span> +<dt id='index-_002eenc'><span>‘<samp>enc files</samp>’<a href='#index-_002eenc' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-ENCFONTS"></span> <p>(encoding vectors) <code>ENCFONTS</code>; suffix ‘<samp>.enc</samp>’. </p> </dd> -<dt>‘<samp>fmt</samp>’</dt> -<dd><span id="index-_002efmt"></span> -<span id="index-TEXFORMATS"></span> +<dt id='index-_002efmt'><span>‘<samp>fmt</samp>’<a href='#index-_002efmt' class='copiable-anchor'> ¶</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 ‘<samp>.fmt</samp>’. </p> </dd> -<dt>‘<samp>font cid map</samp>’</dt> -<dd><span id="index-_002ecid"></span> -<span id="index-FONTCIDMAPS"></span> +<dt id='index-_002ecid'><span>‘<samp>font cid map</samp>’<a href='#index-_002ecid' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-FONTCIDMAPS"></span> <p>(CJK mapping) <code>FONTCIDMAPS</code> suffix ‘<samp>.cid</samp>’. </p> </dd> -<dt>‘<samp>font feature files</samp>’</dt> -<dd><span id="index-_002efea"></span> -<span id="index-FONTFEATURES"></span> +<dt id='index-_002efea'><span>‘<samp>font feature files</samp>’<a href='#index-_002efea' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-FONTFEATURES"></span> <p>(primarily for OpenType font features) <code>FONTFEATURES</code> suffix ‘<samp>.fea</samp>’. </p> </dd> -<dt>‘<samp>gf</samp>’</dt> -<dd><span id="index-gf"></span> -<span id="index-GFFONTS"></span> +<dt id='index-gf'><span>‘<samp>gf</samp>’<a href='#index-gf' class='copiable-anchor'> ¶</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 ‘<samp>gf</samp>’. </p> </dd> -<dt>‘<samp>graphic/figure</samp>’</dt> -<dd><span id="index-_002eeps"></span> -<span id="index-_002eepsi"></span> +<dt id='index-_002eeps'><span>‘<samp>graphic/figure</samp>’<a href='#index-_002eeps' class='copiable-anchor'> ¶</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: ‘<samp>.eps</samp>’, ‘<samp>.epsi</samp>’. </p> </dd> -<dt>‘<samp>ist</samp>’</dt> -<dd><span id="index-_002eist"></span> -<span id="index-TEXINDEXSTYLE"></span> +<dt id='index-_002eist'><span>‘<samp>ist</samp>’<a href='#index-_002eist' class='copiable-anchor'> ¶</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 ‘<samp>.ist</samp>’. </p> </dd> -<dt>‘<samp>lig files</samp>’</dt> -<dd><span id="index-_002elig"></span> -<span id="index-LIGFONTS"></span> +<dt id='index-_002elig'><span>‘<samp>lig files</samp>’<a href='#index-_002elig' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-LIGFONTS"></span> <p>(ligature definition files) <code>LIGFONTS</code>; suffix ‘<samp>.lig</samp>’. </p> </dd> -<dt>‘<samp>ls-R</samp>’</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>‘<samp>ls-R</samp>’<a href='#index-ls_002dR' class='copiable-anchor'> ¶</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>‘<samp>map</samp>’</dt> -<dd><span id="index-_002emap"></span> -<span id="index-TEXFONTMAPS"></span> +<dt id='index-_002emap'><span>‘<samp>map</samp>’<a href='#index-_002emap' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXFONTMAPS"></span> <p>(Fontmaps, see <a href="#Fontmap">Fontmap</a>) <code>TEXFONTMAPS</code>; suffix ‘<samp>.map</samp>’. </p> </dd> -<dt>‘<samp>mem</samp>’</dt> -<dd><span id="index-_002emem"></span> -<span id="index-MPMEMS"></span> +<dt id='index-_002emem'><span>‘<samp>mem</samp>’<a href='#index-_002emem' class='copiable-anchor'> ¶</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 ‘<samp>.mem</samp>’. </p> </dd> -<dt>‘<samp><span class="roman">MetaPost support</span></samp>’</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>‘<samp><span class="roman">MetaPost support</span></samp>’<a href='#index-MPSUPPORT' class='copiable-anchor'> ¶</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>‘<samp>mf</samp>’</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>‘<samp>mf</samp>’<a href='#index-_002emf' class='copiable-anchor'> ¶</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 ‘<samp>.mf</samp>’; dynamic creation program: <code>mktexmf</code>. </p> </dd> -<dt>‘<samp>mfpool</samp>’</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>‘<samp>mfpool</samp>’<a href='#index-_002epool' class='copiable-anchor'> ¶</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 ‘<samp>.pool</samp>’. </p> </dd> -<dt>‘<samp>mft</samp>’</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>‘<samp>mft</samp>’<a href='#index-_002emft' class='copiable-anchor'> ¶</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 ‘<samp>.mft</samp>’. </p> </dd> -<dt>‘<samp>misc fonts</samp>’</dt> -<dd><span id="index-MISCFONTS"></span> -<p>(font-related files that don’t fit the other categories) +<dt id='index-MISCFONTS'><span>‘<samp>misc fonts</samp>’<a href='#index-MISCFONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(font-related files that don’t fit the other categories) <code>MISCFONTS</code> </p> </dd> -<dt>‘<samp>mlbib</samp>’</dt> -<dd><span id="index-_002emlbib"></span> -<span id="index-MLBIBINPUTS"></span> +<dt id='index-_002emlbib'><span>‘<samp>mlbib</samp>’<a href='#index-_002emlbib' class='copiable-anchor'> ¶</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 ‘<samp>.mft</samp>’. suffixes ‘<samp>.mlbib</samp>’, ‘<samp>.mlbib</samp>’. </p> </dd> -<dt>‘<samp>mlbst</samp>’</dt> -<dd><span id="index-_002emlbst"></span> -<span id="index-MLBSTINPUTS"></span> +<dt id='index-_002emlbst'><span>‘<samp>mlbst</samp>’<a href='#index-_002emlbst' class='copiable-anchor'> ¶</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 ‘<samp>.mlbst</samp>’, ‘<samp>.bst</samp>’. </p> </dd> -<dt>‘<samp>mp</samp>’</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>‘<samp>mp</samp>’<a href='#index-_002emp' class='copiable-anchor'> ¶</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 ‘<samp>.mp</samp>’. </p> </dd> -<dt>‘<samp>mppool</samp>’</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>‘<samp>mppool</samp>’<a href='#index-_002epool-1' class='copiable-anchor'> ¶</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 ‘<samp>.pool</samp>’. </p> </dd> -<dt>‘<samp>ocp</samp>’</dt> -<dd><span id="index-_002eocp"></span> -<span id="index-OCPINPUTS"></span> +<dt id='index-_002eocp'><span>‘<samp>ocp</samp>’<a href='#index-_002eocp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OCPINPUTS"></span> <p>(Omega compiled process files) <code>OCPINPUTS</code>; <br> suffix ‘<samp>.ocp</samp>’; dynamic creation program: <code>MakeOmegaOCP</code>. </p> </dd> -<dt>‘<samp>ofm</samp>’</dt> -<dd><span id="index-_002eofm"></span> -<span id="index-OFMFONTS"></span> +<dt id='index-_002eofm'><span>‘<samp>ofm</samp>’<a href='#index-_002eofm' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OFMFONTS"></span> <p>(Omega font metrics) <code>OFMFONTS</code>, <code>TEXFONTS</code>; <br> suffixes ‘<samp>.ofm</samp>’, ‘<samp>.tfm</samp>’; dynamic creation program: <code>MakeOmegaOFM</code>. </p> </dd> -<dt>‘<samp>opentype fonts</samp>’</dt> -<dd><span id="index-OPENTYPEFONTS"></span> -<p>(OpenType fonts) +<dt id='index-OPENTYPEFONTS'><span>‘<samp>opentype fonts</samp>’<a href='#index-OPENTYPEFONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(OpenType fonts) <code>OPENTYPEFONTS</code>. </p> </dd> -<dt>‘<samp>opl</samp>’</dt> -<dd><span id="index-_002eopl"></span> -<p>(Omega property lists) +<dt id='index-_002eopl'><span>‘<samp>opl</samp>’<a href='#index-_002eopl' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Omega property lists) <code>OPLFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.opl</samp>’. </p> </dd> -<dt>‘<samp>otp</samp>’</dt> -<dd><span id="index-_002eotp"></span> -<span id="index-OTPINPUTS"></span> +<dt id='index-_002eotp'><span>‘<samp>otp</samp>’<a href='#index-_002eotp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OTPINPUTS"></span> <p>(Omega translation process files) <code>OTPINPUTS</code>; suffix ‘<samp>.otp</samp>’. </p> </dd> -<dt>‘<samp>ovf</samp>’</dt> -<dd><span id="index-_002eovf"></span> -<span id="index-OVFFONTS"></span> +<dt id='index-_002eovf'><span>‘<samp>ovf</samp>’<a href='#index-_002eovf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OVFFONTS"></span> <p>(Omega virtual fonts) <code>OVFFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.ovf</samp>’. </p> </dd> -<dt>‘<samp>ovp</samp>’</dt> -<dd><span id="index-_002eovp"></span> -<span id="index-OVPFONTS"></span> +<dt id='index-_002eovp'><span>‘<samp>ovp</samp>’<a href='#index-_002eovp' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-OVPFONTS"></span> <p>(Omega virtual property lists) <code>OVPFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>.ovp</samp>’. </p> </dd> -<dt>‘<samp>pdftex config</samp>’</dt> -<dd><span id="index-PDFTEXCONFIG"></span> -<p>(PDFTeX-specific configuration files) +<dt id='index-PDFTEXCONFIG'><span>‘<samp>pdftex config</samp>’<a href='#index-PDFTEXCONFIG' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(PDFTeX-specific configuration files) <code>PDFTEXCONFIG</code>. </p> </dd> -<dt>‘<samp>pk</samp>’</dt> -<dd><span id="index-_002epk"></span> -<span id="index-PKFONTS"></span> +<dt id='index-_002epk'><span>‘<samp>pk</samp>’<a href='#index-_002epk' class='copiable-anchor'> ¶</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 ‘<samp>XDVI</samp>’, etc.), <code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, <code>TEXFONTS</code>; suffix ‘<samp>pk</samp>’; dynamic creation program: <code>mktexpk</code>. </p> </dd> -<dt>‘<samp>PostScript header</samp>’</dt> -<dd><span id="index-_002epro"></span> -<span id="index-TEXPSHEADERS"></span> +<dt id='index-_002epro'><span>‘<samp>PostScript header</samp>’<a href='#index-_002epro' class='copiable-anchor'> ¶</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 ‘<samp>.pro</samp>’. </p> </dd> -<dt>‘<samp>ris</samp>’</dt> -<dd><span id="index-_002eris"></span> -<span id="index-RISINPUTS"></span> +<dt id='index-_002eris'><span>‘<samp>ris</samp>’<a href='#index-_002eris' class='copiable-anchor'> ¶</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 ‘<samp>.ris</samp>’. </p> </dd> -<dt>‘<samp>subfont definition files</samp>’</dt> -<dd><span id="index-_002esfd"></span> -<span id="index-SFDFONTS"></span> +<dt id='index-_002esfd'><span>‘<samp>subfont definition files</samp>’<a href='#index-_002esfd' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-SFDFONTS"></span> <p>(subfont definition files) <code>SFDFONTS</code> suffix ‘<samp>.sfd</samp>’. </p> </dd> -<dt>‘<samp>tex</samp>’</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>‘<samp>tex</samp>’<a href='#index-_002etex' class='copiable-anchor'> ¶</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 ‘<samp>.tex</samp>’; additional suffixes: none, because such a list cannot be complete; dynamic creation program: <code>mktextex</code>. </p> </dd> -<dt>‘<samp>TeX system documentation</samp>’</dt> -<dd><span id="index-doc-files"></span> -<span id="index-TEXDOCS"></span> +<dt id='index-doc-files'><span>‘<samp>TeX system documentation</samp>’<a href='#index-doc-files' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXDOCS"></span> <p>(Documentation files for the TeX system) <code>TEXDOCS</code>. </p> </dd> -<dt>‘<samp>TeX system sources</samp>’</dt> -<dd><span id="index-source-files"></span> -<span id="index-TEXSOURCES"></span> +<dt id='index-source-files'><span>‘<samp>TeX system sources</samp>’<a href='#index-source-files' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-TEXSOURCES"></span> <p>(Source files for the TeX system) <code>TEXSOURCES</code>. </p> </dd> -<dt>‘<samp>texmfscripts</samp>’</dt> -<dd><span id="index-TEXMFSCRIPTS"></span> -<p>(Architecture-independent executables distributed in the texmf trees) +<dt id='index-TEXMFSCRIPTS'><span>‘<samp>texmfscripts</samp>’<a href='#index-TEXMFSCRIPTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Architecture-independent executables distributed in the texmf trees) <code>TEXMFSCRIPTS</code>. </p> </dd> -<dt>‘<samp>texpool</samp>’</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>‘<samp>texpool</samp>’<a href='#index-_002epool-2' class='copiable-anchor'> ¶</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 ‘<samp>.pool</samp>’. </p> </dd> -<dt>‘<samp>tfm</samp>’</dt> -<dd><span id="index-_002etfm"></span> -<span id="index-TFMFONTS"></span> +<dt id='index-_002etfm'><span>‘<samp>tfm</samp>’<a href='#index-_002etfm' class='copiable-anchor'> ¶</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 ‘<samp>.tfm</samp>’; dynamic creation program: <code>mktextfm</code>. </p> </dd> -<dt>‘<samp>Troff fonts</samp>’</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>‘<samp>Troff fonts</samp>’<a href='#index-TRFONTS' class='copiable-anchor'> ¶</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>‘<samp>truetype fonts</samp>’</dt> -<dd><span id="index-_002ettf"></span> -<span id="index-_002ettc"></span> +<dt id='index-_002ettf'><span>‘<samp>truetype fonts</samp>’<a href='#index-_002ettf' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-_002ettc"></span> <span id="index-TTFONTS"></span> <p>(TrueType outline fonts) <code>TTFONTS</code>; suffixes ‘<samp>.ttf</samp>’ and ‘<samp>.TTF</samp>’, ‘<samp>.ttc</samp>’ and ‘<samp>.TTC</samp>’, ‘<samp>.dfont</samp>’. </p> </dd> -<dt>‘<samp>type1 fonts</samp>’</dt> -<dd><span id="index-_002epfa"></span> -<span id="index-_002epfb"></span> +<dt id='index-_002epfa'><span>‘<samp>type1 fonts</samp>’<a href='#index-_002epfa' class='copiable-anchor'> ¶</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 ‘<samp>.pfa</samp>’, ‘<samp>.pfb</samp>’. </p> </dd> -<dt>‘<samp>type42 fonts</samp>’</dt> -<dd><span id="index-T42FONTS"></span> -<p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>. +<dt id='index-T42FONTS'><span>‘<samp>type42 fonts</samp>’<a href='#index-T42FONTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>. </p> </dd> -<dt>‘<samp>vf</samp>’</dt> -<dd><span id="index-_002evf"></span> -<span id="index-VFFONTS"></span> +<dt id='index-_002evf'><span>‘<samp>vf</samp>’<a href='#index-_002evf' class='copiable-anchor'> ¶</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 ‘<samp>.vf</samp>’. </p> </dd> -<dt>‘<samp>web</samp>’</dt> -<dd><span id="index-_002eweb-1"></span> -<span id="index-WEBINPUTS"></span> +<dt id='index-_002eweb-1'><span>‘<samp>web</samp>’<a href='#index-_002eweb-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><span id="index-WEBINPUTS"></span> <p>(WEB input files) <code>WEBINPUTS</code>; suffix ‘<samp>.web</samp>’; additional suffix ‘<samp>.ch</samp>’. </p> </dd> -<dt>‘<samp>web2c files</samp>’</dt> -<dd><span id="index-WEB2C"></span> -<p>(files specific to the web2c implementation) +<dt id='index-WEB2C'><span>‘<samp>web2c files</samp>’<a href='#index-WEB2C' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(files specific to the web2c implementation) <code>WEB2C</code>. </p></dd> </dl> @@ -2757,15 +2677,13 @@ appending ‘<samp>INPUTS</samp>’. Assuming the program is called &ls this gives us the following table. </p> <dl compact="compact"> -<dt>‘<samp>other text files</samp>’</dt> -<dd><span id="index-FOOINPUTS"></span> -<p>(text files used by ‘<samp>foo</samp>’) +<dt id='index-FOOINPUTS'><span>‘<samp>other text files</samp>’<a href='#index-FOOINPUTS' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(text files used by ‘<samp>foo</samp>’) <code>FOOINPUTS</code>. </p> </dd> -<dt>‘<samp>other binary files</samp>’</dt> -<dd><span id="index-FOOINPUTS-1"></span> -<p>(binary files used by ‘<samp>foo</samp>’) +<dt id='index-FOOINPUTS-1'><span>‘<samp>other binary files</samp>’<a href='#index-FOOINPUTS-1' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(binary files used by ‘<samp>foo</samp>’) <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> [<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 ‘<samp>foo.bar</samp>’, we also look f ‘<samp>foo.bar</samp>’. </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> [<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 ‘<samp>mktexpk</samp>’) 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 ‘<samp>cmr10</samp>’). @@ -2885,18 +2807,16 @@ last-resort font (typically ‘<samp>cmr10</samp>’). <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">• <a href="#Basic-glyph-lookup" accesskey="1">Basic glyph lookup</a></td><td> </td><td align="left" valign="top">Features common to all glyph lookups. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fontmap" accesskey="2">Fontmap</a></td><td> </td><td align="left" valign="top">Aliases for fonts. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Fallback-font" accesskey="3">Fallback font</a></td><td> </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> [<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> [<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> [<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> [<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> [<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>‘<samp>all</samp>’ -<span id="index-all"></span> -</dt> +<dt id='index-all'><span>‘<samp>all</samp>’<a href='#index-all' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Suppress everything possible. </p> </dd> -<dt>‘<samp>checksum</samp>’ -<span id="index-checksum"></span> -</dt> +<dt id='index-checksum'><span>‘<samp>checksum</samp>’<a href='#index-checksum' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-mismatched-checksum-warnings"></span> <p>Suppress mismatched font checksum warnings. </p> </dd> -<dt>‘<samp>lostchar</samp>’ -<span id="index-lostchar"></span> -</dt> +<dt id='index-lostchar'><span>‘<samp>lostchar</samp>’<a href='#index-lostchar' class='copiable-anchor'> ¶</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>‘<samp>none</samp>’ -<span id="index-none"></span> -</dt> +<dt id='index-none'><span>‘<samp>none</samp>’<a href='#index-none' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Don’t suppress any warnings. </p> </dd> -<dt>‘<samp>readable</samp>’ -<span id="index-readable"></span> -</dt> +<dt id='index-readable'><span>‘<samp>readable</samp>’<a href='#index-readable' class='copiable-anchor'> ¶</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>‘<samp>special</samp>’ -<span id="index-special"></span> -</dt> +<dt id='index-special'><span>‘<samp>special</samp>’<a href='#index-special' class='copiable-anchor'> ¶</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> [<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 ‘<samp>.fmt</samp>’ (and Metafont -‘<samp>.base</samp>’ and Metapost ‘<samp>.mem</samp>’ files, see <a href="Web2c.html#Memory-dumps">Memory +‘<samp>.base</samp>’ and Metapost ‘<samp>.mem</samp>’ 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">• <a href="#mktex-configuration" accesskey="1">config</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#mktex-script-names" accesskey="2">names</a></td><td> </td><td align="left" valign="top"> -</td></tr> -<tr><td align="left" valign="top">• <a href="#mktex-script-arguments" accesskey="3">args</a></td><td> </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> [<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> [<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 ‘<samp>appendonlydir</samp>’ option is enabled by default. </p> <dl compact="compact"> -<dt>‘<samp>appendonlydir</samp>’ -<span id="index-appendonlydir"></span> -</dt> +<dt id='index-appendonlydir'><span>‘<samp>appendonlydir</samp>’<a href='#index-appendonlydir' class='copiable-anchor'> ¶</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’t support similar functionality. This feature is enabled by default. </p> </dd> -<dt>‘<samp>dosnames</samp>’ -<span id="index-dosnames"></span> -</dt> +<dt id='index-dosnames'><span>‘<samp>dosnames</samp>’<a href='#index-dosnames' class='copiable-anchor'> ¶</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’t consult <samp>mktex.opt</samp>. </p> </dd> -<dt>‘<samp>fontmaps</samp>’ -<span id="index-fontmaps-1"></span> -</dt> +<dt id='index-fontmaps-1'><span>‘<samp>fontmaps</samp>’<a href='#index-fontmaps-1' class='copiable-anchor'> ¶</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>‘<samp>nomfdrivers</samp>’ -<span id="index-nomfdrivers"></span> -</dt> +<dt id='index-nomfdrivers'><span>‘<samp>nomfdrivers</samp>’<a href='#index-nomfdrivers' class='copiable-anchor'> ¶</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>‘<samp>nomode</samp>’ -<span id="index-nomode"></span> -</dt> +<dt id='index-nomode'><span>‘<samp>nomode</samp>’<a href='#index-nomode' class='copiable-anchor'> ¶</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>‘<samp>stripsupplier</samp>’ -<span id="index-stripsupplier"></span> -</dt> +<dt id='index-stripsupplier'><span>‘<samp>stripsupplier</samp>’<a href='#index-stripsupplier' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-supplier-directory_002c-omitting"></span> <p>Omit the font supplier name directory level. </p> </dd> -<dt>‘<samp>striptypeface</samp>’ -<span id="index-striptypeface"></span> -</dt> +<dt id='index-striptypeface'><span>‘<samp>striptypeface</samp>’<a href='#index-striptypeface' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-typeface-directory_002c-omitting"></span> <p>Omit the font typeface name directory level. </p> </dd> -<dt>‘<samp>strip</samp>’ -<span id="index-strip"></span> -</dt> +<dt id='index-strip'><span>‘<samp>strip</samp>’<a href='#index-strip' class='copiable-anchor'> ¶</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 ‘<samp>stripsupplier</samp>’ and ‘<samp>striptypeface</samp>’. </p> </dd> -<dt>‘<samp>varfonts</samp>’ -<span id="index-varfonts"></span> -</dt> +<dt id='index-varfonts'><span>‘<samp>varfonts</samp>’<a href='#index-varfonts' class='copiable-anchor'> ¶</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 ‘<samp>0</samp>’, the feature is disabled. </p> </dd> -<dt>‘<samp>texmfvar</samp>’ -<span id="index-texmfvar"></span> -</dt> +<dt id='index-texmfvar'><span>‘<samp>texmfvar</samp>’<a href='#index-texmfvar' class='copiable-anchor'> ¶</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 ‘<samp>0</samp>’, 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> [<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> [<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'> ¶</a></span></dt> +<dd><span id="index-fmtutil"></span> <p>(‘<samp>.fmt</samp>’, ‘<samp>.base</samp>’, ‘<samp>.mem</samp>’) 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>(‘<samp>.mf</samp>’) Metafont input files. +<dt id='index-mktexmf'><span><samp>mktexmf</samp><a href='#index-mktexmf' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.mf</samp>’) Metafont input files. </p> </dd> -<dt><samp>mkocp</samp></dt> -<dd><span id="index-mkocp"></span> -<p>(‘<samp>.ocp</samp>’) Omega compiled process files. +<dt id='index-mkocp'><span><samp>mkocp</samp><a href='#index-mkocp' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.ocp</samp>’) Omega compiled process files. </p> </dd> -<dt><samp>mkofm</samp></dt> -<dd><span id="index-mkofm"></span> -<p>(‘<samp>.ofm</samp>’) Omega font metric files. +<dt id='index-mkofm'><span><samp>mkofm</samp><a href='#index-mkofm' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.ofm</samp>’) Omega font metric files. </p> </dd> -<dt><samp>mktexpk</samp></dt> -<dd><span id="index-mktexpk"></span> -<p>(‘<samp>pk</samp>’) Glyph fonts. +<dt id='index-mktexpk'><span><samp>mktexpk</samp><a href='#index-mktexpk' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>pk</samp>’) Glyph fonts. </p> </dd> -<dt><samp>mktextex</samp></dt> -<dd><span id="index-mktextex"></span> -<p>(‘<samp>.tex</samp>’) TeX input files (disabled by default). +<dt id='index-mktextex'><span><samp>mktextex</samp><a href='#index-mktextex' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.tex</samp>’) TeX input files (disabled by default). </p> </dd> -<dt><samp>mktextfm</samp></dt> -<dd><span id="index-mktextfm"></span> -<p>(‘<samp>.tfm</samp>’) TFM files. +<dt id='index-mktextfm'><span><samp>mktextfm</samp><a href='#index-mktextfm' class='copiable-anchor'> ¶</a></span></dt> +<dd><p>(‘<samp>.tfm</samp>’) 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> [<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> [<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>‘<samp>--dpi <var>num</var></samp>’</dt> +<dt><span>‘<samp>--dpi <var>num</var></samp>’</span></dt> <dd><p>Sets the resolution of the generated font to <var>num</var>. </p></dd> -<dt>‘<samp>--mfmode <var>name</var></samp>’</dt> +<dt><span>‘<samp>--mfmode <var>name</var></samp>’</span></dt> <dd><p>Sets the Metafont mode to <var>name</var>. </p></dd> -<dt>‘<samp>--bdpi <var>num</var></samp>’</dt> +<dt><span>‘<samp>--bdpi <var>num</var></samp>’</span></dt> <dd><p>Sets the “base dpi” for the font. This must match the mode being used. </p></dd> -<dt>‘<samp>--mag <var>string</var></samp>’</dt> +<dt><span>‘<samp>--mag <var>string</var></samp>’</span></dt> <dd><p>A “magstep” 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>‘<samp>--destdir <var>string</var></samp>’</dt> +<dt><span>‘<samp>--destdir <var>string</var></samp>’</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> [<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> [<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">• <a href="#Programming-overview" accesskey="1">Overview</a></td><td> </td><td align="left" valign="top">Introduction. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Calling-sequence" accesskey="2">Calling sequence</a></td><td> </td><td align="left" valign="top">Specifics of what to call. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Program_002dspecific-files" accesskey="3">Program-specific files</a></td><td> </td><td align="left" valign="top">How to handle these. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Programming-with-config-files" accesskey="4">Config</a></td><td> </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> [<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> [<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> [<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 ‘<samp>texmf/ttf2pk</samp>’. </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> [<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> [<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> [<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, … </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Bug-checklist" accesskey="1">Bug checklist</a></td><td> </td><td align="left" valign="top">What to include in a good bug report. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Mailing-lists" accesskey="2">Mailing lists</a></td><td> </td><td align="left" valign="top">Joining the bugs or announcements mailing lists. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Debugging" accesskey="3">Debugging</a></td><td> </td><td align="left" valign="top">Analyzing runtime problems. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Logging" accesskey="4">Logging</a></td><td> </td><td align="left" valign="top">Recording searches. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Common-problems" accesskey="5">Common problems</a></td><td> </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> [<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> [<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> [<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’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'> ¶</a></span></dt> <dd><p>Report ‘<samp>stat</samp>’(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'> ¶</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'> ¶</a></span></dt> <dd><span id="index-fopen_002c-redefined"></span> <p>Report file openings and closings. Especially useful when your system’s file table is full, for seeing which files have been opened but never @@ -4050,9 +3946,7 @@ redefining ‘<samp>fopen</samp>’ (‘<samp>fclose</samp>’) (‘<samp>kpse_fclose_trace</samp>’). </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'> ¶</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'> ¶</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’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'> ¶</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'> ¶</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'> ¶</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'> ¶</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'> ¶</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> [<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> [<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, … </p> -<table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Unable-to-find-files" accesskey="1">Unable to find files</a></td><td> </td><td align="left" valign="top">If your program can’t find fonts (or whatever). -</td></tr> -<tr><td align="left" valign="top">• <a href="#Slow-path-searching" accesskey="2">Slow path searching</a></td><td> </td><td align="left" valign="top">If it takes forever to find anything. -</td></tr> -<tr><td align="left" valign="top">• <a href="#Unable-to-generate-fonts" accesskey="3">Unable to generate fonts</a></td><td> </td><td align="left" valign="top">If mktexpk fails. -</td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-or-Metafont-failing" accesskey="4">TeX or Metafont failing</a></td><td> </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> [<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’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 ‘<samp>Can't find font <var>fontname</var></samp>’. 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> [<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’s present; there’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> [<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> [<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’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’s (or whatever program’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> [<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> [<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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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…</code></a>:</td><td> </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>, </td></tr></table> -<hr> +</div> +</div> |