texlive[50170] Master: tl19 texinfo update
commits+karl at tug.org
commits+karl at tug.org
Thu Feb 28 20:14:14 CET 2019
Revision: 50170
http://tug.org/svn/texlive?view=revision&revision=50170
Author: karl
Date: 2019-02-28 20:14:13 +0100 (Thu, 28 Feb 2019)
Log Message:
-----------
tl19 texinfo update
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/dvipng/dvipng.html
trunk/Master/texmf-dist/doc/dvipng/dvipng.pdf
trunk/Master/texmf-dist/doc/dvips/dvips.html
trunk/Master/texmf-dist/doc/dvips/dvips.pdf
trunk/Master/texmf-dist/doc/info/dvips.info
trunk/Master/texmf-dist/doc/info/kpathsea.info
trunk/Master/texmf-dist/doc/info/tlbuild.info
trunk/Master/texmf-dist/doc/info/web2c.info
trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html
trunk/Master/texmf-dist/doc/kpathsea/kpathsea.pdf
trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
trunk/Master/texmf-dist/doc/web2c/web2c.html
trunk/Master/texmf-dist/doc/web2c/web2c.pdf
trunk/Master/tlpkg/doc/releng.txt
Modified: trunk/Master/texmf-dist/doc/dvipng/dvipng.html
===================================================================
--- trunk/Master/texmf-dist/doc/dvipng/dvipng.html 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/dvipng/dvipng.html 2019-02-28 19:14:13 UTC (rev 50170)
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>A DVI-to-PNG translator</title>
@@ -18,23 +18,14 @@
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
-blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
-blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
-div.smalldisplay {margin-left: 3.2em}
-div.smallexample {margin-left: 3.2em}
-div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
-pre.smalldisplay {font-family: inherit; font-size: smaller}
-pre.smallexample {font-size: smaller}
-pre.smallformat {font-family: inherit; font-size: smaller}
-pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
@@ -54,57 +45,55 @@
-<a name="SEC_Contents"></a>
+<span id="SEC_Contents"></span>
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="no-bullet">
- <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
- <li><a name="toc-Installation-1" href="#Installation">2 Installation</a>
+ <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
+ <li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
<ul class="no-bullet">
- <li><a name="toc-Prerequisites-1" href="#Prerequisites">2.1 Prerequisites</a></li>
- <li><a name="toc-Configure-1" href="#Configure">2.2 Configure</a></li>
- <li><a name="toc-Build_002finstall-1" href="#Build_002finstall">2.3 Build/install</a></li>
- <li><a name="toc-Installation-outside-the-texmf-tree-1" href="#Installation-outside-the-texmf-tree">2.4 Installation outside the texmf tree</a></li>
- <li><a name="toc-Installation-for-non_002dprivileged-users" href="#Advice-for-non_002dprivileged-users">2.5 Installation for non-privileged users</a></li>
+ <li><a id="toc-Prerequisites-1" href="#Prerequisites">2.1 Prerequisites</a></li>
+ <li><a id="toc-Configure-1" href="#Configure">2.2 Configure</a></li>
+ <li><a id="toc-Build_002finstall-1" href="#Build_002finstall">2.3 Build/install</a></li>
+ <li><a id="toc-Installation-outside-the-texmf-tree-1" href="#Installation-outside-the-texmf-tree">2.4 Installation outside the texmf tree</a></li>
+ <li><a id="toc-Installation-for-non_002dprivileged-users" href="#Advice-for-non_002dprivileged-users">2.5 Installation for non-privileged users</a></li>
</ul></li>
- <li><a name="toc-Basic-usage-of-dvipng" href="#Basic-usage">3 Basic usage of dvipng</a></li>
- <li><a name="toc-Command_002dline-options-1" href="#Command_002dline-options">4 Command-line options</a>
+ <li><a id="toc-Basic-usage-of-dvipng" href="#Basic-usage">3 Basic usage of dvipng</a></li>
+ <li><a id="toc-Command_002dline-options-1" href="#Command_002dline-options">4 Command-line options</a>
<ul class="no-bullet">
- <li><a name="toc-Option-summary-1" href="#Option-summary">4.1 Option summary</a></li>
- <li><a name="toc-Option-details-1" href="#Option-details">4.2 Option details</a></li>
+ <li><a id="toc-Option-summary-1" href="#Option-summary">4.1 Option summary</a></li>
+ <li><a id="toc-Option-details-1" href="#Option-details">4.2 Option details</a></li>
</ul></li>
- <li><a name="toc-Graphics-1" href="#Graphics">5 Graphics</a>
+ <li><a id="toc-Graphics-1" href="#Graphics">5 Graphics</a>
<ul class="no-bullet">
- <li><a name="toc-Encapsulated-PostScript-1" href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a></li>
- <li><a name="toc-Bitmapped-graphics-1" href="#Bitmapped-graphics">5.2 Bitmapped graphics</a></li>
- <li><a name="toc-Raw-PostScript-1" href="#Raw-PostScript">5.3 Raw PostScript</a></li>
+ <li><a id="toc-Encapsulated-PostScript-1" href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a></li>
+ <li><a id="toc-Bitmapped-graphics-1" href="#Bitmapped-graphics">5.2 Bitmapped graphics</a></li>
+ <li><a id="toc-Raw-PostScript-1" href="#Raw-PostScript">5.3 Raw PostScript</a></li>
</ul></li>
- <li><a name="toc-Color-1" href="#Color">6 Color</a>
+ <li><a id="toc-Color-1" href="#Color">6 Color</a>
<ul class="no-bullet">
- <li><a name="toc-Color-specifications-1" href="#Color-specifications">6.1 Color specifications</a></li>
- <li><a name="toc-Color-specials-1" href="#Color-specials">6.2 Color specials</a></li>
+ <li><a id="toc-Color-specifications-1" href="#Color-specifications">6.1 Color specifications</a></li>
+ <li><a id="toc-Color-specials-1" href="#Color-specials">6.2 Color specials</a></li>
</ul></li>
- <li><a name="toc-Diagnosing-problems-1" href="#Diagnosing-problems">7 Diagnosing problems</a>
+ <li><a id="toc-Diagnosing-problems-1" href="#Diagnosing-problems">7 Diagnosing problems</a>
<ul class="no-bullet">
- <li><a name="toc-Contact-information-1" href="#Contact-information">7.1 Contact information</a></li>
- <li><a name="toc-Debug-options-1" href="#Debug-options">7.2 Debug options</a></li>
+ <li><a id="toc-Contact-information-1" href="#Contact-information">7.1 Contact information</a></li>
+ <li><a id="toc-Debug-options-1" href="#Debug-options">7.2 Debug options</a></li>
</ul></li>
- <li><a name="toc-Credits-1" href="#Credits">8 Credits</a></li>
- <li><a name="toc-Copying-1" href="#Copying">9 Copying</a></li>
- <li><a name="toc-Index-1" href="#Index">Index</a></li>
+ <li><a id="toc-Credits-1" href="#Credits">8 Credits</a></li>
+ <li><a id="toc-Copying-1" href="#Copying">9 Copying</a></li>
+ <li><a id="toc-Index-1" href="#Index">Index</a></li>
</ul>
</div>
-<a name="Top"></a>
-<div class="header">
+<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>
-<a name="dvipng"></a>
-<h1 class="top">dvipng</h1>
+<span id="dvipng"></span><h1 class="top">dvipng</h1>
<p>This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
@@ -117,25 +106,25 @@
</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">Introduction
+<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">Introduction
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a>:</td><td> </td><td align="left" valign="top">How to compile and install dvipng
+<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a></td><td> </td><td align="left" valign="top">How to compile and install dvipng
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="3">Basic usage</a>:</td><td> </td><td align="left" valign="top">First things first
+<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="3">Basic usage</a></td><td> </td><td align="left" valign="top">First things first
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="4">Command-line options</a>:</td><td> </td><td align="left" valign="top">Advanced usage
+<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="4">Command-line options</a></td><td> </td><td align="left" valign="top">Advanced usage
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Graphics" accesskey="5">Graphics</a>:</td><td> </td><td align="left" valign="top">Including PostScript and/or bitmaps
+<tr><td align="left" valign="top">• <a href="#Graphics" accesskey="5">Graphics</a></td><td> </td><td align="left" valign="top">Including PostScript and/or bitmaps
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color" accesskey="6">Color</a>:</td><td> </td><td align="left" valign="top">Using color with dvipng
+<tr><td align="left" valign="top">• <a href="#Color" accesskey="6">Color</a></td><td> </td><td align="left" valign="top">Using color with dvipng
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="7">Diagnosing problems</a>:</td><td> </td><td align="left" valign="top">Problems?
+<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="7">Diagnosing problems</a></td><td> </td><td align="left" valign="top">Problems?
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Credits" accesskey="8">Credits</a>:</td><td> </td><td align="left" valign="top">People who have contributed
+<tr><td align="left" valign="top">• <a href="#Credits" accesskey="8">Credits</a></td><td> </td><td align="left" valign="top">People who have contributed
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Copying" accesskey="9">Copying</a>:</td><td> </td><td align="left" valign="top">GNU Lesser General Public License
+<tr><td align="left" valign="top">• <a href="#Copying" accesskey="9">Copying</a></td><td> </td><td align="left" valign="top">GNU Lesser General Public License
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Index">Index</a>:</td><td> </td><td align="left" valign="top">General index
+<tr><td align="left" valign="top">• <a href="#Index">Index</a></td><td> </td><td align="left" valign="top">General index
</td></tr>
</table>
@@ -142,13 +131,11 @@
<hr>
-<a name="Introduction"></a>
-<div class="header">
+<span id="Introduction"></span><div class="header">
<p>
Next: <a href="#Installation" accesskey="n" rel="next">Installation</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>
</div>
-<a name="Introduction-1"></a>
-<h2 class="chapter">1 Introduction</h2>
+<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
@@ -207,17 +194,15 @@
<hr>
-<a name="Installation"></a>
-<div class="header">
+<span id="Installation"></span><div class="header">
<p>
Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage</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>
</div>
-<a name="Installation-1"></a>
-<h2 class="chapter">2 Installation</h2>
+<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2>
-<a name="index-configuration_002c-of-dvipng"></a>
-<a name="index-compilation"></a>
-<a name="index-installation_002c-of-dvipng"></a>
+<span id="index-configuration_002c-of-dvipng"></span>
+<span id="index-compilation"></span>
+<span id="index-installation_002c-of-dvipng"></span>
@@ -225,26 +210,24 @@
<code>make</code>, and <code>make install</code>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="1">Prerequisites</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="1">Prerequisites</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure" accesskey="2">Configure</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure" accesskey="2">Configure</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Build_002finstall" accesskey="3">Build/install</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Build_002finstall" accesskey="3">Build/install</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Installation-outside-the-texmf-tree" accesskey="4">Installation outside the texmf tree</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Installation-outside-the-texmf-tree" accesskey="4">Installation outside the texmf tree</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Advice-for-non_002dprivileged-users" accesskey="5">Advice for non-privileged users</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Advice-for-non_002dprivileged-users" accesskey="5">Advice for non-privileged users</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Prerequisites"></a>
-<div class="header">
+<span id="Prerequisites"></span><div class="header">
<p>
Next: <a href="#Configure" accesskey="n" rel="next">Configure</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Prerequisites-1"></a>
-<h3 class="section">2.1 Prerequisites</h3>
+<span id="Prerequisites-1"></span><h3 class="section">2.1 Prerequisites</h3>
<ul>
<li> The GD Graphics Draw library, libgd
@@ -291,13 +274,11 @@
</p></li></ul>
<hr>
-<a name="Configure"></a>
-<div class="header">
+<span id="Configure"></span><div class="header">
<p>
Next: <a href="#Build_002finstall" accesskey="n" rel="next">Build/install</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-1"></a>
-<h3 class="section">2.2 Configure</h3>
+<span id="Configure-1"></span><h3 class="section">2.2 Configure</h3>
<p>The first step is to configure the source code, telling it where
various files will be. To do so, run
@@ -360,13 +341,11 @@
<p>where the backslash denotes a continuation of the line.
</p>
<hr>
-<a name="Build_002finstall"></a>
-<div class="header">
+<span id="Build_002finstall"></span><div class="header">
<p>
Next: <a href="#Installation-outside-the-texmf-tree" accesskey="n" rel="next">Installation outside the texmf tree</a>, Previous: <a href="#Configure" accesskey="p" rel="prev">Configure</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build_002finstall-1"></a>
-<h3 class="section">2.3 Build/install</h3>
+<span id="Build_002finstall-1"></span><h3 class="section">2.3 Build/install</h3>
<p>Once <samp>configure</samp> has been run, simply enter
</p>
@@ -385,13 +364,11 @@
into system directories.
</p>
<hr>
-<a name="Installation-outside-the-texmf-tree"></a>
-<div class="header">
+<span id="Installation-outside-the-texmf-tree"></span><div class="header">
<p>
Next: <a href="#Advice-for-non_002dprivileged-users" accesskey="n" rel="next">Advice for non-privileged users</a>, Previous: <a href="#Build_002finstall" accesskey="p" rel="prev">Build/install</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Installation-outside-the-texmf-tree-1"></a>
-<h3 class="section">2.4 Installation outside the texmf tree</h3>
+<span id="Installation-outside-the-texmf-tree-1"></span><h3 class="section">2.4 Installation outside the texmf tree</h3>
<p>In some cases, a dvipng binary installed outside the texmf tree will
not be able to find virtual fonts, or the PostScript font maps
@@ -403,13 +380,11 @@
dvipng <em>is</em> installed in the texmf tree.
</p>
<hr>
-<a name="Advice-for-non_002dprivileged-users"></a>
-<div class="header">
+<span id="Advice-for-non_002dprivileged-users"></span><div class="header">
<p>
Previous: <a href="#Installation-outside-the-texmf-tree" accesskey="p" rel="prev">Installation outside the texmf tree</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Installation-for-non_002dprivileged-users"></a>
-<h3 class="section">2.5 Installation for non-privileged users</h3>
+<span id="Installation-for-non_002dprivileged-users"></span><h3 class="section">2.5 Installation for non-privileged users</h3>
<p>Often people without system administration privileges want to install
software for their private use. In that case you need to specify more
@@ -428,15 +403,13 @@
</p>
<hr>
-<a name="Basic-usage"></a>
-<div class="header">
+<span id="Basic-usage"></span><div class="header">
<p>
Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</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>
</div>
-<a name="Basic-usage-of-dvipng"></a>
-<h2 class="chapter">3 Basic usage of dvipng</h2>
+<span id="Basic-usage-of-dvipng"></span><h2 class="chapter">3 Basic usage of dvipng</h2>
-<a name="index-invoking-dvipng"></a>
+<span id="index-invoking-dvipng"></span>
<p>To use dvipng at its simplest, simply type
</p>
@@ -456,7 +429,7 @@
can take a few minutes, so progress reports appear by default. The next
time the same font is used, it will have been saved on disk, so
rendering will go much faster. (If dvipng tries to endlessly generate
-the same fonts over and over again, something is wrong. See <a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to
+the same fonts over and over again, something is wrong. See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to
generate fonts</a> in <cite>Kpathsea</cite>.)
</p>
<p>Many options are available (see the next section). For a brief summary
@@ -467,38 +440,34 @@
</pre></div>
<hr>
-<a name="Command_002dline-options"></a>
-<div class="header">
+<span id="Command_002dline-options"></span><div class="header">
<p>
Next: <a href="#Graphics" accesskey="n" rel="next">Graphics</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage</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>
</div>
-<a name="Command_002dline-options-1"></a>
-<h2 class="chapter">4 Command-line options</h2>
+<span id="Command_002dline-options-1"></span><h2 class="chapter">4 Command-line options</h2>
-<a name="index-command_002dline-options"></a>
-<a name="index-options_002c-dvipng"></a>
+<span id="index-command_002dline-options"></span>
+<span id="index-options_002c-dvipng"></span>
<p>dvipng has a plethora of command line options. Reading through this
section will give a good idea of the capabilities of the driver.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Option-summary" accesskey="1">Option summary</a>:</td><td> </td><td align="left" valign="top">Quick listing, from dvipng –help.
+<tr><td align="left" valign="top">• <a href="#Option-summary" accesskey="1">Option summary</a></td><td> </td><td align="left" valign="top">Quick listing, from dvipng –help.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Option-details" accesskey="2">Option details</a>:</td><td> </td><td align="left" valign="top">More information about each option.
+<tr><td align="left" valign="top">• <a href="#Option-details" accesskey="2">Option details</a></td><td> </td><td align="left" valign="top">More information about each option.
</td></tr>
</table>
<hr>
-<a name="Option-summary"></a>
-<div class="header">
+<span id="Option-summary"></span><div class="header">
<p>
Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Option-summary-1"></a>
-<h3 class="section">4.1 Option summary</h3>
+<span id="Option-summary-1"></span><h3 class="section">4.1 Option summary</h3>
-<a name="index-options_002c-summary"></a>
+<span id="index-options_002c-summary"></span>
<p>Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard ‘<samp>--help</samp>’ option.
</p>
@@ -550,15 +519,13 @@
<hr>
-<a name="Option-details"></a>
-<div class="header">
+<span id="Option-details"></span><div class="header">
<p>
Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Option-details-1"></a>
-<h3 class="section">4.2 Option details</h3>
+<span id="Option-details-1"></span><h3 class="section">4.2 Option details</h3>
-<a name="index-option_002c-details-of"></a>
+<span id="index-option_002c-details-of"></span>
<p>Many of the parameterless options listed here can be turned off by
suffixing the option with a zero (‘<samp>0</samp>’); for instance, to turn off
@@ -567,8 +534,8 @@
</p>
<dl compact="compact">
<dt>‘<samp>-</samp>’</dt>
-<dd><a name="index-options_002c-reading-from-standard-input"></a>
-<a name="index-standard-input_002c-reading-options-from"></a>
+<dd><span id="index-options_002c-reading-from-standard-input"></span>
+<span id="index-standard-input_002c-reading-options-from"></span>
<p>Read additional options from standard input after processing the command
line.
</p>
@@ -584,8 +551,8 @@
<dt>‘<samp>-bd <var>num</var></samp>’</dt>
<dt>‘<samp>-bd <var>color_spec</var></samp>’</dt>
<dt>‘<samp>-bd '<var>num</var> <var>color_spec</var>'</samp>’</dt>
-<dd><a name="index-transparent-border-width"></a>
-<a name="index-transparent-border-fallback-color"></a>
+<dd><span id="index-transparent-border-width"></span>
+<span id="index-transparent-border-fallback-color"></span>
<p>Set the pixel width of the transparent border (default 0). Using this
option will make the image edges transparent, but it only affects pixels
with the background color. Giving a <var>color_spec</var> will set the
@@ -596,7 +563,7 @@
</p>
</dd>
<dt>‘<samp>--bdpi <var>num</var></samp>’</dt>
-<dd><a name="index-base-resolution_002c-setting"></a>
+<dd><span id="index-base-resolution_002c-setting"></span>
<p>This option only has an effect when using bitmapped (PK) fonts. The
option sets the base (Metafont) resolution, both horizontal and
vertical, to <var>num</var> dpi (dots per inch). This option is necessary
@@ -605,7 +572,7 @@
</p>
</dd>
<dt>‘<samp>-bg <var>color_spec</var></samp>’</dt>
-<dd><a name="index-background-color-_0028option_0029"></a>
+<dd><span id="index-background-color-_0028option_0029"></span>
<p>Choose background color for the images. This option will be ignored if
there is a background color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’. You can
@@ -620,7 +587,7 @@
</p>
</dd>
<dt>‘<samp>-d <var>num</var></samp>’</dt>
-<dd><a name="index-debugging"></a>
+<dd><span id="index-debugging"></span>
<p>Set the debug flags, showing what dvipng (thinks it) is doing. This will
work unless dvipng has been compiled without the <code>DEBUG</code> option
(not recommended). Set the flags as you need them, use ‘<samp>-d -1</samp>’ as
@@ -628,7 +595,7 @@
</p>
</dd>
<dt>‘<samp>-D <var>num</var></samp>’</dt>
-<dd><a name="index-output-resolution_002c-setting"></a>
+<dd><span id="index-output-resolution_002c-setting"></span>
<p>Set the output resolution, both horizontal and vertical, to <var>num</var>
dpi (dots per inch).
</p>
@@ -650,8 +617,8 @@
</p>
</dd>
<dt>‘<samp>--depth*</samp>’</dt>
-<dd><a name="index-baseline-reporting"></a>
-<a name="index-depth-reporting"></a>
+<dd><span id="index-baseline-reporting"></span>
+<span id="index-depth-reporting"></span>
<p>Report the depth of the image. This only works reliably when the
LaTeX style <samp>preview.sty</samp> from preview-latex is used with
the ‘<samp>active</samp>’ option. It reports the number of pixels from the
@@ -672,7 +639,7 @@
</dd>
<dt>‘<samp>-fg <var>color_spec</var></samp>’</dt>
-<dd><a name="index-foreground-color-_0028option_0029"></a>
+<dd><span id="index-foreground-color-_0028option_0029"></span>
<p>Choose foreground color for the images. This option will be ignored if
there is a foreground color \special in the DVI. The color spec should
be in TeX color \special syntax, e.g., ’rgb 1.0 0.0 0.0’.
@@ -680,7 +647,7 @@
</p>
</dd>
<dt>‘<samp>--follow*</samp>’</dt>
-<dd><a name="index-follow-mode"></a>
+<dd><span id="index-follow-mode"></span>
<p>Wait for data at end-of-file. One of the benefits of dvipng is that it
does not read the postamble, so it can be started before TeX
finishes. This switch makes dvipng wait at end-of-file for further
@@ -689,7 +656,7 @@
</p>
</dd>
<dt>‘<samp>--freetype*</samp>’</dt>
-<dd><a name="index-FreeType-font-rendering"></a>
+<dd><span id="index-FreeType-font-rendering"></span>
<p>Enable/disable FreeType font rendering (default on). This option is
available if the FreeType2 font library was present at compilation time.
If this is the case, dvipng will have direct support for PostScript
@@ -702,10 +669,10 @@
</p>
</dd>
<dt>‘<samp>--gamma <var>num</var></samp>’</dt>
-<dd><a name="index-gamma"></a>
-<a name="index-dark-fonts"></a>
-<a name="index-light-fonts"></a>
-<a name="index-fuzzy-images"></a>
+<dd><span id="index-gamma"></span>
+<span id="index-dark-fonts"></span>
+<span id="index-light-fonts"></span>
+<span id="index-fuzzy-images"></span>
<p>Control the interpolation of colors in the greyscale anti-aliasing
color palette. Default value is 1.0. For 0 < <var>num</var> < 1, the
fonts will be lighter (more like the background), and for <var>num</var> >
@@ -713,7 +680,7 @@
</p>
</dd>
<dt>‘<samp>--gif*</samp>’</dt>
-<dd><a name="index-GIF-image-format"></a>
+<dd><span id="index-GIF-image-format"></span>
<p>The images are output in the GIF format, if GIF support is enabled.
This is the default for the ‘<samp>dvigif</samp>’ binary, which only will be
available when GIF support is enabled. GIF images are palette images
@@ -723,8 +690,8 @@
</p>
</dd>
<dt>‘<samp>--height*</samp>’</dt>
-<dd><a name="index-baseline-reporting-1"></a>
-<a name="index-height-reporting"></a>
+<dd><span id="index-baseline-reporting-1"></span>
+<span id="index-height-reporting"></span>
<p>Report the height of the image. This only works reliably when the
LaTeX style <samp>preview.sty</samp> from preview-latex is used with
the ‘<samp>active</samp>’ option. It reports the number of pixels from the top
@@ -734,10 +701,10 @@
</p>
</dd>
<dt>‘<samp>-l [=]<var>num</var></samp>’</dt>
-<dd><a name="index-last-page-printed"></a>
-<a name="index-page_002c-last-printed"></a>
-<a name="index-physical-page-number_002c-and-_002dl"></a>
-<a name="index-absolute-page-number_002c-and-_002dl"></a>
+<dd><span id="index-last-page-printed"></span>
+<span id="index-page_002c-last-printed"></span>
+<span id="index-physical-page-number_002c-and-_002dl"></span>
+<span id="index-absolute-page-number_002c-and-_002dl"></span>
<p>The last page printed will be the first one numbered <var>num</var>. Default
is the last page in the document. If <var>num</var> is prefixed by an equals
sign, then it (and the argument to the ‘<samp>-p</samp>’ option, if specified)
@@ -748,32 +715,32 @@
</p>
</dd>
<dt>‘<samp>--mode <var>mode</var></samp>’</dt>
-<dd><a name="index-mode-name_002c-specifying"></a>
-<a name="index-Metafont-mode_002c-specifying"></a>
+<dd><span id="index-mode-name_002c-specifying"></span>
+<span id="index-Metafont-mode_002c-specifying"></span>
<p>This option only has an effect when using bitmapped (PK) fonts. Use
<var>mode</var> as the Metafont device name for the PK fonts (both for path
searching and font generation). This needs to be augmented with the base
device resolution, given with the ‘<samp>--bdpi</samp>’ option. See the file
<a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a> for a list of resolutions and mode
-names for most devices. See <a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
+names for most devices. See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt>‘<samp>-M*</samp>’</dt>
-<dd><a name="index-font-generation_002c-avoiding"></a>
-<a name="index-mktexpk_002c-avoiding"></a>
+<dd><span id="index-font-generation_002c-avoiding"></span>
+<span id="index-mktexpk_002c-avoiding"></span>
<p>This option only has an effect when using bitmapped (PK) fonts. It turns
off automatic PK font generation (<samp>mktexpk</samp>).
</p>
</dd>
<dt>‘<samp>--nogs*</samp>’</dt>
-<dd><a name="index-GhostScript_002c-turning-off"></a>
+<dd><span id="index-GhostScript_002c-turning-off"></span>
<p>This switch prohibits the internal call to GhostScript for displaying
PostScript specials. ‘<samp>--nogs0</samp>’ turns the call back on.
</p>
</dd>
<dt>‘<samp>--nogssafer*</samp>’</dt>
-<dd><a name="index-GhostScript-and-_002ddSAFER"></a>
-<a name="index-_002ddSAFER"></a>
+<dd><span id="index-GhostScript-and-_002ddSAFER"></span>
+<span id="index-_002ddSAFER"></span>
<p>Normally, if GhostScript is used to render PostScript specials, the
GhostScript interpreter is run with the option ‘<samp>-dSAFER</samp>’. The
‘<samp>--nogssafer</samp>’ option runs GhostScript without ‘<samp>-dSAFER</samp>’. The
@@ -783,7 +750,7 @@
</p>
</dd>
<dt>‘<samp>--norawps*</samp>’</dt>
-<dd><a name="index-PostScript_002c-turning-off-raw-PostScript-specials"></a>
+<dd><span id="index-PostScript_002c-turning-off-raw-PostScript-specials"></span>
<p>Some packages generate raw PostScript specials, even non-rendering such
specials. This switch turns off the internal call to GhostScript
intended to display these raw PostScript specials. ‘<samp>--norawps0</samp>’
@@ -791,8 +758,8 @@
</p>
</dd>
<dt>‘<samp>-o <var>name</var></samp>’</dt>
-<dd><a name="index-output_002c-redirecting"></a>
-<a name="index-standard-output_002c-output-to"></a>
+<dd><span id="index-output_002c-redirecting"></span>
+<span id="index-standard-output_002c-output-to"></span>
<p>Send output to the file <var>name</var>. A single occurrence of ‘<samp>%d</samp>’ or
‘<samp>%01d</samp>’, …, ‘<samp>%09d</samp>’ will be exchanged for the physical
page number (this can be changed, see the ‘<samp>--dvinum</samp>’ switch). The
@@ -801,7 +768,7 @@
</p>
</dd>
<dt>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’</dt>
-<dd><a name="index-offset-pages"></a>
+<dd><span id="index-offset-pages"></span>
<p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’.
The origin of the page is shifted from the default position
@@ -810,10 +777,10 @@
</p>
</dd>
<dt>‘<samp>-p [=]<var>num</var></samp>’</dt>
-<dd><a name="index-first-page-printed"></a>
-<a name="index-page_002c-first-printed"></a>
-<a name="index-physical-page-number_002c-and-_002dp"></a>
-<a name="index-absolute-page-number_002c-and-_002dp"></a>
+<dd><span id="index-first-page-printed"></span>
+<span id="index-page_002c-first-printed"></span>
+<span id="index-physical-page-number_002c-and-_002dp"></span>
+<span id="index-absolute-page-number_002c-and-_002dp"></span>
<p>The first page printed will be the first one numbered <var>num</var>. Default
is the first page in the document. If <var>num</var> is prefixed by an
equals sign, then it (and the argument to the ‘<samp>-l</samp>’ option, if
@@ -824,7 +791,7 @@
</p>
</dd>
<dt>‘<samp>--palette*</samp>’</dt>
-<dd><a name="index-forcing-palette-output"></a>
+<dd><span id="index-forcing-palette-output"></span>
<p>When an external image is included, ‘<samp>dvipng</samp>’ will automatically
switch to truecolor mode, to avoid unnecessary delay and quality
reduction, and enable the EPS translator to draw on a transparent
@@ -835,7 +802,7 @@
</p>
</dd>
<dt>‘<samp>--picky*</samp>’</dt>
-<dd><a name="index-no-erroneous-images"></a>
+<dd><span id="index-no-erroneous-images"></span>
<p>No images are output when a warning occurs. Normally, dvipng will
output an image in spite of a warning, but there may be something
missing in this image. One reason to use this option would be if you
@@ -846,13 +813,13 @@
</p>
</dd>
<dt>‘<samp>--png*</samp>’</dt>
-<dd><a name="index-PNG-image-format"></a>
+<dd><span id="index-PNG-image-format"></span>
<p>The images are output in the PNG format. This is the default for the
‘<samp>dvipng</samp>’ binary. See also the ‘<samp>--gif</samp>’ option.
</p>
</dd>
<dt>‘<samp>-pp <var>firstpage</var>-<var>lastpage</var></samp>’</dt>
-<dd><a name="index-page-range"></a>
+<dd><span id="index-page-range"></span>
<p>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite
equivalent to ‘<samp>-p <var>firstpage</var> -l <var>lastpage</var></samp>’. For example,
when rendering a book, there may be several instances of a page in the
@@ -873,16 +840,16 @@
</p>
</dd>
<dt>‘<samp>-q*</samp>’</dt>
-<dd><a name="index-quiet-operation"></a>
-<a name="index-silent-operation"></a>
-<a name="index-warnings_002c-suppressing"></a>
+<dd><span id="index-quiet-operation"></span>
+<span id="index-silent-operation"></span>
+<span id="index-warnings_002c-suppressing"></span>
<p>Run quietly. Don’t chatter about pages converted, etc. to standard
output; report no warnings (only errors) to standard error.
</p>
</dd>
<dt>‘<samp>-Q <var>num</var></samp>’</dt>
-<dd><a name="index-antialiasing-levels_002c-number-of"></a>
-<a name="index-quality"></a>
+<dd><span id="index-antialiasing-levels_002c-number-of"></span>
+<span id="index-quality"></span>
<p>Set the quality to <var>num</var>. That is, choose the number of antialiasing
levels for bitmapped fonts (PK), to be
<var>num</var>*<var>num</var>+1. The default value is 4 which gives 17 levels of
@@ -891,7 +858,7 @@
</p>
</dd>
<dt>‘<samp>-r*</samp>’</dt>
-<dd><a name="index-reverse-pagination"></a>
+<dd><span id="index-reverse-pagination"></span>
<p>Toggle output of pages in reverse/forward order. By default, the first
page in the DVI is output first.
</p>
@@ -898,7 +865,7 @@
</dd>
<dt>‘<samp>--strict*</samp>’</dt>
-<dd><a name="index-exit-on-erroneous-images"></a>
+<dd><span id="index-exit-on-erroneous-images"></span>
<p>The program exits when a warning occurs. Normally, dvipng will output
an image in spite of a warning, but there may be something missing in
this image. One reason to use this option would be if you have a more
@@ -918,7 +885,7 @@
</p>
</dd>
<dt>‘<samp>--truecolor*</samp>’</dt>
-<dd><a name="index-truecolor-output"></a>
+<dd><span id="index-truecolor-output"></span>
<p>This will make ‘<samp>dvipng</samp>’ generate truecolor output. Note that
truecolor output is automatic if you include an external image in your
DVI, e.g., via a PostScript special (i.e., the ‘<samp>graphics</samp>’ or
@@ -932,13 +899,13 @@
</p>
</dd>
<dt>‘<samp>--width*</samp>’</dt>
-<dd><a name="index-width-reporting"></a>
+<dd><span id="index-width-reporting"></span>
<p>Report the width of the image. See also ‘<samp>--height</samp>’ and
‘<samp>--depth</samp>’.
</p>
</dd>
<dt>‘<samp>-x <var>num</var></samp>’</dt>
-<dd><a name="index-magnification_002c-overriding-DVI"></a>
+<dd><span id="index-magnification_002c-overriding-DVI"></span>
<p>This option is deprecated; it should not be used. It is much better to
select the output resolution directly with the ‘<samp>-D</samp>’ option. This
option sets the magnification ratio to <em><var>num</var>/1000</em> and
@@ -950,7 +917,7 @@
</p>
</dd>
<dt>‘<samp>-z <var>num</var></samp>’</dt>
-<dd><a name="index-compression"></a>
+<dd><span id="index-compression"></span>
<p>Set the PNG compression level to <var>num</var>. This option is enabled if
your ‘<samp>libgd</samp>’ is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
@@ -968,13 +935,11 @@
</dl>
<hr>
-<a name="Graphics"></a>
-<div class="header">
+<span id="Graphics"></span><div class="header">
<p>
Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</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>
</div>
-<a name="Graphics-1"></a>
-<h2 class="chapter">5 Graphics</h2>
+<span id="Graphics-1"></span><h2 class="chapter">5 Graphics</h2>
<p>‘<samp>dvipng</samp>’ attempts to handle graphics as included by the
‘<samp>graphicx</samp>’ and ‘<samp>graphics</samp>’ packages, without the need of
@@ -985,22 +950,20 @@
packages. Some of the possibilities and problems are mentioned below.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a>:</td><td> </td><td align="left" valign="top">An internal call to GhostScript
+<tr><td align="left" valign="top">• <a href="#Encapsulated-PostScript" accesskey="1">Encapsulated PostScript</a></td><td> </td><td align="left" valign="top">An internal call to GhostScript
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a>:</td><td> </td><td align="left" valign="top">PNG, JPEG and GIF
+<tr><td align="left" valign="top">• <a href="#Bitmapped-graphics" accesskey="2">Bitmapped graphics</a></td><td> </td><td align="left" valign="top">PNG, JPEG and GIF
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Raw-PostScript" accesskey="3">Raw PostScript</a>:</td><td> </td><td align="left" valign="top">Ignore or give to GhostScript
+<tr><td align="left" valign="top">• <a href="#Raw-PostScript" accesskey="3">Raw PostScript</a></td><td> </td><td align="left" valign="top">Ignore or give to GhostScript
</td></tr>
</table>
<hr>
-<a name="Encapsulated-PostScript"></a>
-<div class="header">
+<span id="Encapsulated-PostScript"></span><div class="header">
<p>
Next: <a href="#Bitmapped-graphics" accesskey="n" rel="next">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Encapsulated-PostScript-1"></a>
-<h3 class="section">5.1 Encapsulated PostScript</h3>
+<span id="Encapsulated-PostScript-1"></span><h3 class="section">5.1 Encapsulated PostScript</h3>
<p>When an EPS file is included, a call to GhostScript is performed to
produce a bitmapped image that can be included. The default is to
@@ -1017,7 +980,7 @@
inclusion. Other relevant switches are ‘<samp>--noghostscript</samp>’ and
‘<samp>--nogssafer</samp>’. See <a href="#Option-details">Option details</a>.
</p>
-<a name="index-PostScript-inclusion-problems"></a>
+<span id="index-PostScript-inclusion-problems"></span>
<p>The most common problem with including graphics is an incorrect
bounding box. Complain to whoever wrote the software that generated
the file if the bounding box is indeed incorrect. An adjusted
@@ -1030,13 +993,11 @@
<hr>
-<a name="Bitmapped-graphics"></a>
-<div class="header">
+<span id="Bitmapped-graphics"></span><div class="header">
<p>
Next: <a href="#Raw-PostScript" accesskey="n" rel="next">Raw PostScript</a>, Previous: <a href="#Encapsulated-PostScript" accesskey="p" rel="prev">Encapsulated PostScript</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Bitmapped-graphics-1"></a>
-<h3 class="section">5.2 Bitmapped graphics</h3>
+<span id="Bitmapped-graphics-1"></span><h3 class="section">5.2 Bitmapped graphics</h3>
<p>dvipng can include PNG, JPEG and GIF graphics. When including such
images via ‘<samp>\includegraphics</samp>’ you need to specify the bounding
@@ -1066,13 +1027,11 @@
</pre></div>
<hr>
-<a name="Raw-PostScript"></a>
-<div class="header">
+<span id="Raw-PostScript"></span><div class="header">
<p>
Previous: <a href="#Bitmapped-graphics" accesskey="p" rel="prev">Bitmapped graphics</a>, Up: <a href="#Graphics" accesskey="u" rel="up">Graphics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Raw-PostScript-1"></a>
-<h3 class="section">5.3 Raw PostScript</h3>
+<span id="Raw-PostScript-1"></span><h3 class="section">5.3 Raw PostScript</h3>
<p>dvipng attempts to handle raw PostScript. Rendering raw PostScript
specials is done on top of the page by including a transparent image
@@ -1112,13 +1071,11 @@
the slower fallback for these pages.
</p>
<hr>
-<a name="Color"></a>
-<div class="header">
+<span id="Color"></span><div class="header">
<p>
Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#Graphics" accesskey="p" rel="prev">Graphics</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>
</div>
-<a name="Color-1"></a>
-<h2 class="chapter">6 Color</h2>
+<span id="Color-1"></span><h2 class="chapter">6 Color</h2>
<p>To support color, dvipng recognizes a certain set of specials as
generated by the ‘<samp>color</samp>’ and ‘<samp>xcolor</samp>’ style files. These
@@ -1126,23 +1083,21 @@
‘<samp>background</samp>’, followed by a color specification.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Color-specifications" accesskey="1">Color specifications</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Color-specifications" accesskey="1">Color specifications</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color-specials" accesskey="2">Color specials</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Color-specials" accesskey="2">Color specials</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Color-specifications"></a>
-<div class="header">
+<span id="Color-specifications"></span><div class="header">
<p>
Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-specifications-1"></a>
-<h3 class="section">6.1 Color specifications</h3>
+<span id="Color-specifications-1"></span><h3 class="section">6.1 Color specifications</h3>
-<a name="index-color-specifications"></a>
+<span id="index-color-specifications"></span>
<p>The color specification supported by dvipng is by-value or by-name. The
by-value spec starts with the name of a color model (one of ‘<samp>rgb</samp>’,
@@ -1165,13 +1120,11 @@
See <a href="#Option-details">Option details</a>.
</p>
<hr>
-<a name="Color-specials"></a>
-<div class="header">
+<span id="Color-specials"></span><div class="header">
<p>
Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-specials-1"></a>
-<h3 class="section">6.2 Color specials</h3>
+<span id="Color-specials-1"></span><h3 class="section">6.2 Color specials</h3>
<p>We will describe ‘<samp>background</samp>’ first, since it is the simplest. The
‘<samp>background</samp>’ keyword must be followed by a color specification.
@@ -1200,17 +1153,15 @@
the pages are rendered repeatedly or in reverse order.
</p>
<hr>
-<a name="Diagnosing-problems"></a>
-<div class="header">
+<span id="Diagnosing-problems"></span><div class="header">
<p>
Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, Previous: <a href="#Color" accesskey="p" rel="prev">Color</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>
</div>
-<a name="Diagnosing-problems-1"></a>
-<h2 class="chapter">7 Diagnosing problems</h2>
+<span id="Diagnosing-problems-1"></span><h2 class="chapter">7 Diagnosing problems</h2>
-<a name="index-problems"></a>
-<a name="index-trouble"></a>
-<a name="index-debugging-1"></a>
+<span id="index-problems"></span>
+<span id="index-trouble"></span>
+<span id="index-debugging-1"></span>
<p>You’ve gone through all the trouble of installing dvipng, carefully read
all the instructions in this manual, and still can’t get something to
@@ -1218,20 +1169,18 @@
yourself in such a situation.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Contact-information" accesskey="1">Contact information</a>:</td><td> </td><td align="left" valign="top">Who to ask.
+<tr><td align="left" valign="top">• <a href="#Contact-information" accesskey="1">Contact information</a></td><td> </td><td align="left" valign="top">Who to ask.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="2">Debug options</a>:</td><td> </td><td align="left" valign="top">Getting diagnostics.
+<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="2">Debug options</a></td><td> </td><td align="left" valign="top">Getting diagnostics.
</td></tr>
</table>
<hr>
-<a name="Contact-information"></a>
-<div class="header">
+<span id="Contact-information"></span><div class="header">
<p>
Next: <a href="#Debug-options" accesskey="n" rel="next">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Contact-information-1"></a>
-<h3 class="section">7.1 Contact information</h3>
+<span id="Contact-information-1"></span><h3 class="section">7.1 Contact information</h3>
<p>Bug reports should be sent to
<a href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>.
@@ -1246,17 +1195,15 @@
access, ask on <a href="mailto:dvipng at nongnu.org">dvipng at nongnu.org</a>.
</p>
<p>For details on the TeX path-searching library, and <code>mktexpk</code>
-problems, see <a href="http://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>.
+problems, see <a href="https://tug.org/texinfohtml/kpathsea.html#Common-problems">Common problems</a> in <cite>Kpathsea</cite>.
</p>
<hr>
-<a name="Debug-options"></a>
-<div class="header">
+<span id="Debug-options"></span><div class="header">
<p>
Previous: <a href="#Contact-information" accesskey="p" rel="prev">Contact information</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Debug-options-1"></a>
-<h3 class="section">7.2 Debug options</h3>
+<span id="Debug-options-1"></span><h3 class="section">7.2 Debug options</h3>
<p>The ‘<samp>-d</samp>’ flag to dvipng helps in tracking down certain errors. The
parameter to this flag is an integer that tells what errors are
@@ -1266,7 +1213,7 @@
track all classes, you can use <code>-1</code>.
</p>
<p>Some of these debugging options are actually provided by Kpathsea
-(see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
+(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
</p>
<p>The classes are:
</p><dl compact="compact">
@@ -1313,13 +1260,11 @@
</dl>
<hr>
-<a name="Credits"></a>
-<div class="header">
+<span id="Credits"></span><div class="header">
<p>
Next: <a href="#Copying" accesskey="n" rel="next">Copying</a>, Previous: <a href="#Diagnosing-problems" accesskey="p" rel="prev">Diagnosing problems</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>
</div>
-<a name="Credits-1"></a>
-<h2 class="chapter">8 Credits</h2>
+<span id="Credits-1"></span><h2 class="chapter">8 Credits</h2>
<p>A number of persons have contributed, if I forget to mention someone,
I apologize. First and foremost we have David Kastrup whose
@@ -1341,13 +1286,11 @@
</p>
<hr>
-<a name="Copying"></a>
-<div class="header">
+<span id="Copying"></span><div class="header">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Credits" accesskey="p" rel="prev">Credits</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>
</div>
-<a name="Copying-1"></a>
-<h2 class="chapter">9 Copying</h2>
+<span id="Copying-1"></span><h2 class="chapter">9 Copying</h2>
<p>This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
@@ -1368,13 +1311,11 @@
<p>Copyright © 2002-2015 Jan-Åke Larsson
</p>
<hr>
-<a name="Index"></a>
-<div class="header">
+<span id="Index"></span><div class="header">
<p>
Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</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>
</div>
-<a name="Index-1"></a>
-<h2 class="unnumbered">Index</h2>
+<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a>
@@ -1421,21 +1362,21 @@
<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-1">-</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-1">-</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002ddSAFER">-dSAFER</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dl">absolute page number, and ‘<samp>-l</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-absolute-page-number_002c-and-_002dp">absolute page number, and ‘<samp>-p</samp>’</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-antialiasing-levels_002c-number-of">antialiasing levels<span class="roman">, number of</span></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-B">B</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-background-color-_0028option_0029">background color (option)</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-base-resolution_002c-setting">base resolution, setting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-baseline-reporting">baseline reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-baseline-reporting-1">baseline reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-C">C</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-color-specifications">color specifications</a>:</td><td> </td><td valign="top"><a href="#Color-specifications">Color specifications</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-command_002dline-options">command-line options</a>:</td><td> </td><td valign="top"><a href="#Command_002dline-options">Command-line options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-compilation">compilation</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
@@ -1442,16 +1383,16 @@
<tr><td></td><td valign="top"><a href="#index-compression">compression</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configuration_002c-of-dvipng">configuration, of dvipng</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-D">D</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-dark-fonts">dark fonts</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-debugging">debugging</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-debugging-1">debugging</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-depth-reporting">depth reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-exit-on-erroneous-images">exit on erroneous images</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-F">F</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-first-page-printed">first page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-follow-mode">follow mode</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-font-generation_002c-avoiding">font generation, avoiding</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -1460,33 +1401,33 @@
<tr><td></td><td valign="top"><a href="#index-FreeType-font-rendering">FreeType font rendering</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fuzzy-images">fuzzy images</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-G">G</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-gamma">gamma</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GhostScript-and-_002ddSAFER">GhostScript and -dSAFER</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GhostScript_002c-turning-off">GhostScript, turning off</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GIF-image-format">GIF image format</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-H">H</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-H">H</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-height-reporting">height reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-I">I</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-installation_002c-of-dvipng">installation, of dvipng</a>:</td><td> </td><td valign="top"><a href="#Installation">Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-invoking-dvipng">invoking dvipng</a>:</td><td> </td><td valign="top"><a href="#Basic-usage">Basic usage</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-L">L</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-last-page-printed">last page printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-light-fonts">light fonts</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-magnification_002c-overriding-DVI">magnification, overriding DVI</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Metafont-mode_002c-specifying">Metafont mode, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mktexpk_002c-avoiding"><code>mktexpk<span class="roman">, avoiding</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mode-name_002c-specifying">mode name, specifying</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-N">N</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-no-erroneous-images">no erroneous images</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-O">O</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-offset-pages">offset pages</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-option_002c-details-of">option, details of</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-options_002c-dvipng">options, dvipng</a>:</td><td> </td><td valign="top"><a href="#Command_002dline-options">Command-line options</a></td></tr>
@@ -1495,7 +1436,7 @@
<tr><td></td><td valign="top"><a href="#index-output-resolution_002c-setting">output resolution, setting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-output_002c-redirecting">output, redirecting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-P">P</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-page-range">page range</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page_002c-first-printed">page, first printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page_002c-last-printed">page, last printed</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -1506,25 +1447,25 @@
<tr><td></td><td valign="top"><a href="#index-PostScript_002c-turning-off-raw-PostScript-specials">PostScript, turning off raw PostScript specials</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-problems">problems</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Q">Q</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Q">Q</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-quality">quality</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-quiet-operation">quiet operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-reverse-pagination">reverse pagination</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-S">S</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-silent-operation">silent operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-standard-input_002c-reading-options-from">standard input, reading options from</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-standard-output_002c-output-to">standard output, output to</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-transparent-border-fallback-color">transparent border fallback color</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-transparent-border-width">transparent border width</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-trouble">trouble</a>:</td><td> </td><td valign="top"><a href="#Diagnosing-problems">Diagnosing problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-truecolor-output">truecolor output</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-W">W</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-W">W</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-width-reporting">width reporting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
Modified: trunk/Master/texmf-dist/doc/dvipng/dvipng.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/dvips/dvips.html
===================================================================
--- trunk/Master/texmf-dist/doc/dvips/dvips.html 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/dvips/dvips.html 2019-02-28 19:14:13 UTC (rev 50170)
@@ -1,9 +1,9 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
-<!-- This manual documents Dvips version 5.998
-(February 2018), a program to translate a DVI file into
+<!-- This manual documents Dvips version 5.999
+(February 2019), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file. -->
-<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Dvips: A DVI-to-PostScript translator</title>
@@ -21,23 +21,14 @@
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
-blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
-blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
-div.smalldisplay {margin-left: 3.2em}
-div.smallexample {margin-left: 3.2em}
-div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
-pre.smalldisplay {font-family: inherit; font-size: smaller}
-pre.smallexample {font-size: smaller}
-pre.smallformat {font-family: inherit; font-size: smaller}
-pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
@@ -57,185 +48,180 @@
-<a name="SEC_Overview"></a>
+<span id="SEC_Overview"></span>
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
<ul class="no-bullet">
-<li><a name="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li>
-<li><a name="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li>
-<li><a name="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li>
-<li><a name="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li>
-<li><a name="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li>
-<li><a name="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li>
-<li><a name="stoc-Color-1" href="#toc-Color-1">7 Color</a></li>
-<li><a name="stoc-Index-1" href="#toc-Index-1">Index</a></li>
+<li><a id="stoc-Why-use-Dvips_003f" href="#toc-Why-use-Dvips_003f">1 Why use Dvips?</a></li>
+<li><a id="stoc-Installation-1" href="#toc-Installation-1">2 Installation</a></li>
+<li><a id="stoc-Invoking-Dvips-1" href="#toc-Invoking-Dvips-1">3 Invoking Dvips</a></li>
+<li><a id="stoc-Paper-size-and-landscape-orientation" href="#toc-Paper-size-and-landscape-orientation">4 Paper size and landscape orientation</a></li>
+<li><a id="stoc-Interaction-with-PostScript-1" href="#toc-Interaction-with-PostScript-1">5 Interaction with PostScript</a></li>
+<li><a id="stoc-PostScript-fonts-1" href="#toc-PostScript-fonts-1">6 PostScript fonts</a></li>
+<li><a id="stoc-Color-1" href="#toc-Color-1">7 Color</a></li>
+<li><a id="stoc-Index-1" href="#toc-Index-1">Index</a></li>
</ul>
</div>
-<a name="SEC_Contents"></a>
+<span id="SEC_Contents"></span>
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="no-bullet">
- <li><a name="toc-Why-use-Dvips_003f" href="#Why-Dvips">1 Why use Dvips?</a></li>
- <li><a name="toc-Installation-1" href="#Installation">2 Installation</a>
+ <li><a id="toc-Why-use-Dvips_003f" href="#Why-Dvips">1 Why use Dvips?</a></li>
+ <li><a id="toc-Installation-1" href="#Installation">2 Installation</a>
<ul class="no-bullet">
- <li><a name="toc-config_002eps-installation-1" href="#config_002eps-installation">2.1 <samp>config.ps</samp> installation</a></li>
- <li><a name="toc-PostScript-font-installation-1" href="#PostScript-font-installation">2.2 PostScript font installation</a></li>
- <li><a name="toc-Ghostscript-installation-1" href="#Ghostscript-installation">2.3 Ghostscript installation</a></li>
- <li><a name="toc-Diagnosing-problems-1" href="#Diagnosing-problems">2.4 Diagnosing problems</a>
+ <li><a id="toc-config_002eps-installation-1" href="#config_002eps-installation">2.1 <samp>config.ps</samp> installation</a></li>
+ <li><a id="toc-PostScript-font-installation-1" href="#PostScript-font-installation">2.2 PostScript font installation</a></li>
+ <li><a id="toc-Ghostscript-installation-1" href="#Ghostscript-installation">2.3 Ghostscript installation</a></li>
+ <li><a id="toc-Diagnosing-problems-1" href="#Diagnosing-problems">2.4 Diagnosing problems</a>
<ul class="no-bullet">
- <li><a name="toc-Debug-options-1" href="#Debug-options">2.4.1 Debug options</a></li>
- <li><a name="toc-No-output-at-all" href="#No-output">2.4.2 No output at all</a></li>
- <li><a name="toc-Output-too-small-or-inverted" href="#Small-or-inverted">2.4.3 Output too small or inverted</a></li>
- <li><a name="toc-Error-messages-from-printer" href="#Printer-errors">2.4.4 Error messages from printer</a></li>
- <li><a name="toc-Long-documents-fail-to-print" href="#Long-documents-fail">2.4.5 Long documents fail to print</a></li>
- <li><a name="toc-Including-graphics-fails-1" href="#Including-graphics-fails">2.4.6 Including graphics fails</a></li>
+ <li><a id="toc-Debug-options-1" href="#Debug-options">2.4.1 Debug options</a></li>
+ <li><a id="toc-No-output-at-all" href="#No-output">2.4.2 No output at all</a></li>
+ <li><a id="toc-Output-too-small-or-inverted" href="#Small-or-inverted">2.4.3 Output too small or inverted</a></li>
+ <li><a id="toc-Error-messages-from-printer" href="#Printer-errors">2.4.4 Error messages from printer</a></li>
+ <li><a id="toc-Long-documents-fail-to-print" href="#Long-documents-fail">2.4.5 Long documents fail to print</a></li>
+ <li><a id="toc-Including-graphics-fails-1" href="#Including-graphics-fails">2.4.6 Including graphics fails</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Invoking-Dvips-1" href="#Invoking-Dvips">3 Invoking Dvips</a>
+ <li><a id="toc-Invoking-Dvips-1" href="#Invoking-Dvips">3 Invoking Dvips</a>
<ul class="no-bullet">
- <li><a name="toc-Basic-usage-of-Dvips" href="#Basic-usage">3.1 Basic usage of Dvips</a></li>
- <li><a name="toc-Command_002dline-options-1" href="#Command_002dline-options">3.2 Command-line options</a>
+ <li><a id="toc-Basic-usage-of-Dvips" href="#Basic-usage">3.1 Basic usage of Dvips</a></li>
+ <li><a id="toc-Command_002dline-options-1" href="#Command_002dline-options">3.2 Command-line options</a>
<ul class="no-bullet">
- <li><a name="toc-Option-summary-1" href="#Option-summary">3.2.1 Option summary</a></li>
- <li><a name="toc-Option-details-1" href="#Option-details">3.2.2 Option details</a></li>
+ <li><a id="toc-Option-summary-1" href="#Option-summary">3.2.1 Option summary</a></li>
+ <li><a id="toc-Option-details-1" href="#Option-details">3.2.2 Option details</a></li>
</ul></li>
- <li><a name="toc-Environment-variables-1" href="#Environment-variables">3.3 Environment variables</a></li>
- <li><a name="toc-Dvips-configuration-files" href="#Config-files">3.4 Dvips configuration files</a>
+ <li><a id="toc-Environment-variables-1" href="#Environment-variables">3.3 Environment variables</a></li>
+ <li><a id="toc-Dvips-configuration-files" href="#Config-files">3.4 Dvips configuration files</a>
<ul class="no-bullet">
- <li><a name="toc-Configuration-file-searching-1" href="#Configuration-file-searching">3.4.1 Configuration file searching</a></li>
- <li><a name="toc-Configuration-file-commands-1" href="#Configuration-file-commands">3.4.2 Configuration file commands</a></li>
+ <li><a id="toc-Configuration-file-searching-1" href="#Configuration-file-searching">3.4.1 Configuration file searching</a></li>
+ <li><a id="toc-Configuration-file-commands-1" href="#Configuration-file-commands">3.4.2 Configuration file commands</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Paper-size-and-landscape-orientation" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a>
+ <li><a id="toc-Paper-size-and-landscape-orientation" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a>
<ul class="no-bullet">
- <li><a name="toc-papersize-special-1" href="#papersize-special">4.1 ‘<samp>papersize</samp>’ special</a></li>
- <li><a name="toc-Configuration-file-paper-size-command" href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a></li>
- <li><a name="toc-Paper-trays-1" href="#Paper-trays">4.3 Paper trays</a></li>
+ <li><a id="toc-papersize-special-1" href="#papersize-special">4.1 ‘<samp>papersize</samp>’ special</a></li>
+ <li><a id="toc-Configuration-file-paper-size-command" href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a></li>
+ <li><a id="toc-Paper-trays-1" href="#Paper-trays">4.3 Paper trays</a></li>
</ul></li>
- <li><a name="toc-Interaction-with-PostScript-1" href="#Interaction-with-PostScript">5 Interaction with PostScript</a>
+ <li><a id="toc-Interaction-with-PostScript-1" href="#Interaction-with-PostScript">5 Interaction with PostScript</a>
<ul class="no-bullet">
- <li><a name="toc-PostScript-figures-1" href="#PostScript-figures">5.1 PostScript figures</a>
+ <li><a id="toc-PostScript-figures-1" href="#PostScript-figures">5.1 PostScript figures</a>
<ul class="no-bullet">
- <li><a name="toc-The-bounding-box-comment" href="#Bounding-box">5.1.1 The bounding box comment</a></li>
- <li><a name="toc-The-_005cincludegraphics-macro-for-LaTeX" href="#g_t_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a></li>
- <li><a name="toc-Using-the-EPSF-macros" href="#EPSF-macros">5.1.3 Using the EPSF macros</a>
+ <li><a id="toc-The-bounding-box-comment" href="#Bounding-box">5.1.1 The bounding box comment</a></li>
+ <li><a id="toc-The-_005cincludegraphics-macro-for-LaTeX" href="#g_t_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a></li>
+ <li><a id="toc-Using-the-EPSF-macros" href="#EPSF-macros">5.1.3 Using the EPSF macros</a>
<ul class="no-bullet">
- <li><a name="toc-EPSF-scaling-1" href="#EPSF-scaling">5.1.3.1 EPSF scaling</a></li>
- <li><a name="toc-EPSF-clipping-1" href="#EPSF-clipping">5.1.3.2 EPSF clipping</a></li>
+ <li><a id="toc-EPSF-scaling-1" href="#EPSF-scaling">5.1.3.1 EPSF scaling</a></li>
+ <li><a id="toc-EPSF-clipping-1" href="#EPSF-clipping">5.1.3.2 EPSF clipping</a></li>
</ul></li>
- <li><a name="toc-psfile-special-1" href="#psfile-special">5.1.4 ‘<samp>psfile</samp>’ special</a></li>
- <li><a name="toc-Dynamic-creation-of-PostScript-graphics-files" href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a></li>
- <li><a name="toc-Fonts-in-figures-1" href="#Fonts-in-figures">5.1.6 Fonts in figures</a></li>
+ <li><a id="toc-psfile-special-1" href="#psfile-special">5.1.4 ‘<samp>psfile</samp>’ special</a></li>
+ <li><a id="toc-Dynamic-creation-of-PostScript-graphics-files" href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a></li>
+ <li><a id="toc-Fonts-in-figures-1" href="#Fonts-in-figures">5.1.6 Fonts in figures</a></li>
</ul></li>
- <li><a name="toc-PostScript-header-files" href="#Header-files">5.2 PostScript header files</a>
+ <li><a id="toc-PostScript-header-files" href="#Header-files">5.2 PostScript header files</a>
<ul class="no-bullet">
- <li><a name="toc-Including-headers-from-TeX-1" href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a></li>
- <li><a name="toc-Including-headers-from-the-command-line-1" href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a></li>
- <li><a name="toc-Headers-and-memory-usage-1" href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a></li>
+ <li><a id="toc-Including-headers-from-TeX-1" href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a></li>
+ <li><a id="toc-Including-headers-from-the-command-line-1" href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a></li>
+ <li><a id="toc-Headers-and-memory-usage-1" href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a></li>
</ul></li>
- <li><a name="toc-Literal-PostScript" href="#Literal-PS">5.3 Literal PostScript</a>
+ <li><a id="toc-Literal-PostScript" href="#Literal-PS">5.3 Literal PostScript</a>
<ul class="no-bullet">
- <li><a name="toc-_0022-special_003a-Literal-PostScript" href="#g_t_0022-special">5.3.1 <code>"</code> special: Literal PostScript</a></li>
- <li><a name="toc-ps-special-1" href="#ps-special">5.3.2 ‘<samp>ps</samp>’ special</a></li>
- <li><a name="toc-Literal-headers_003a-_0021-_005cspecial" href="#Literal-headers">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></a></li>
- <li><a name="toc-PostScript-hooks-1" href="#PostScript-hooks">5.3.4 PostScript hooks</a></li>
- <li><a name="toc-Literal-examples-1" href="#Literal-examples">5.3.5 Literal examples</a></li>
+ <li><a id="toc-_0022-special_003a-Literal-PostScript" href="#g_t_0022-special">5.3.1 <code>"</code> special: Literal PostScript</a></li>
+ <li><a id="toc-ps-special-1" href="#ps-special">5.3.2 ‘<samp>ps</samp>’ special</a></li>
+ <li><a id="toc-Literal-headers_003a-_0021-_005cspecial" href="#Literal-headers">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></a></li>
+ <li><a id="toc-PostScript-hooks-1" href="#PostScript-hooks">5.3.4 PostScript hooks</a></li>
+ <li><a id="toc-Literal-examples-1" href="#Literal-examples">5.3.5 Literal examples</a></li>
</ul></li>
- <li><a name="toc-HyperTeXt" href="#Hypertext">5.4 HyperTeXt</a>
+ <li><a id="toc-HyperTeXt" href="#Hypertext">5.4 HyperTeXt</a>
<ul class="no-bullet">
- <li><a name="toc-Hypertext-caveats-1" href="#Hypertext-caveats">5.4.1 Hypertext caveats</a></li>
- <li><a name="toc-Hypertext-specials-1" href="#Hypertext-specials">5.4.2 Hypertext specials</a></li>
+ <li><a id="toc-Hypertext-caveats-1" href="#Hypertext-caveats">5.4.1 Hypertext caveats</a></li>
+ <li><a id="toc-Hypertext-specials-1" href="#Hypertext-specials">5.4.2 Hypertext specials</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-PostScript-fonts-1" href="#PostScript-fonts">6 PostScript fonts</a>
+ <li><a id="toc-PostScript-fonts-1" href="#PostScript-fonts">6 PostScript fonts</a>
<ul class="no-bullet">
- <li><a name="toc-Font-concepts-1" href="#Font-concepts">6.1 Font concepts</a>
+ <li><a id="toc-Font-concepts-1" href="#Font-concepts">6.1 Font concepts</a>
<ul class="no-bullet">
- <li><a name="toc-Metric-files-1" href="#Metric-files">6.1.1 Metric files</a></li>
- <li><a name="toc-Glyph-files-1" href="#Glyph-files">6.1.2 Glyph files</a></li>
- <li><a name="toc-Virtual-fonts-1" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li>
- <li><a name="toc-Encodings-1" href="#Encodings">6.1.4 Encodings</a></li>
- <li><a name="toc-How-PostScript-typesets-a-character" href="#PostScript-typesetting">6.1.5 How PostScript typesets a character</a></li>
+ <li><a id="toc-Metric-files-1" href="#Metric-files">6.1.1 Metric files</a></li>
+ <li><a id="toc-Glyph-files-1" href="#Glyph-files">6.1.2 Glyph files</a></li>
+ <li><a id="toc-Virtual-fonts-1" href="#Virtual-fonts">6.1.3 Virtual fonts</a></li>
+ <li><a id="toc-Encodings-1" href="#Encodings">6.1.4 Encodings</a></li>
+ <li><a id="toc-How-PostScript-typesets-a-character" href="#PostScript-typesetting">6.1.5 How PostScript typesets a character</a></li>
</ul></li>
- <li><a name="toc-Making-a-PostScript-font-available" href="#Making-a-font-available">6.2 Making a PostScript font available</a></li>
- <li><a name="toc-Invoking-Afm2tfm" href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a>
+ <li><a id="toc-Making-a-PostScript-font-available" href="#Making-a-font-available">6.2 Making a PostScript font available</a></li>
+ <li><a id="toc-Invoking-Afm2tfm" href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a>
<ul class="no-bullet">
- <li><a name="toc-Changing-font-encodings-1" href="#Changing-font-encodings">6.3.1 Changing font encodings</a>
+ <li><a id="toc-Changing-font-encodings-1" href="#Changing-font-encodings">6.3.1 Changing font encodings</a>
<ul class="no-bullet">
- <li><a name="toc-_002dt_003a-Changing-TeX-encodings" href="#Changing-TeX-encodings">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</a></li>
- <li><a name="toc-_002dp_003a-Changing-PostScript-encodings" href="#Changing-PostScript-encodings">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</a></li>
- <li><a name="toc-_002dT_003a-Changing-both-TeX-and-PostScript-encodings" href="#Changing-both-encodings">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a></li>
- <li><a name="toc-Reencoding-with-Afm2tfm-1" href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a></li>
- <li><a name="toc-Encoding-file-format-1" href="#Encoding-file-format">6.3.1.5 Encoding file format</a></li>
+ <li><a id="toc-_002dt_003a-Changing-TeX-encodings" href="#Changing-TeX-encodings">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</a></li>
+ <li><a id="toc-_002dp_003a-Changing-PostScript-encodings" href="#Changing-PostScript-encodings">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</a></li>
+ <li><a id="toc-_002dT_003a-Changing-both-TeX-and-PostScript-encodings" href="#Changing-both-encodings">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</a></li>
+ <li><a id="toc-Reencoding-with-Afm2tfm-1" href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a></li>
+ <li><a id="toc-Encoding-file-format-1" href="#Encoding-file-format">6.3.1.5 Encoding file format</a></li>
</ul></li>
- <li><a name="toc-Special-font-effects-1" href="#Special-font-effects">6.3.2 Special font effects</a></li>
- <li><a name="toc-Afm2tfm-options-1" href="#Afm2tfm-options">6.3.3 Afm2tfm options</a></li>
+ <li><a id="toc-Special-font-effects-1" href="#Special-font-effects">6.3.2 Special font effects</a></li>
+ <li><a id="toc-Afm2tfm-options-1" href="#Afm2tfm-options">6.3.3 Afm2tfm options</a></li>
</ul></li>
- <li><a name="toc-psfonts_002emap_003a-PostScript-font-catalog" href="#psfonts_002emap">6.4 <samp>psfonts.map</samp>: PostScript font catalog</a></li>
+ <li><a id="toc-psfonts_002emap_003a-PostScript-font-catalog" href="#psfonts_002emap">6.4 <samp>psfonts.map</samp>: PostScript font catalog</a></li>
</ul></li>
- <li><a name="toc-Color-1" href="#Color">7 Color</a>
+ <li><a id="toc-Color-1" href="#Color">7 Color</a>
<ul class="no-bullet">
- <li><a name="toc-Color-macro-files-1" href="#Color-macro-files">7.1 Color macro files</a></li>
- <li><a name="toc-User_002ddefinable-colors-1" href="#User_002ddefinable-colors">7.2 User-definable colors</a></li>
- <li><a name="toc-Color-subtleties-1" href="#Color-subtleties">7.3 Color subtleties</a></li>
- <li><a name="toc-Printing-in-black_002fwhite-after-colorizing" href="#Ted-Turner">7.4 Printing in black/white after colorizing</a></li>
- <li><a name="toc-Color-device-configuration-1" href="#Color-device-configuration">7.5 Color device configuration</a></li>
- <li><a name="toc-Color-support-details-1" href="#Color-support-details">7.6 Color support details</a>
+ <li><a id="toc-Color-macro-files-1" href="#Color-macro-files">7.1 Color macro files</a></li>
+ <li><a id="toc-User_002ddefinable-colors-1" href="#User_002ddefinable-colors">7.2 User-definable colors</a></li>
+ <li><a id="toc-Color-subtleties-1" href="#Color-subtleties">7.3 Color subtleties</a></li>
+ <li><a id="toc-Printing-in-black_002fwhite-after-colorizing" href="#Ted-Turner">7.4 Printing in black/white after colorizing</a></li>
+ <li><a id="toc-Color-device-configuration-1" href="#Color-device-configuration">7.5 Color device configuration</a></li>
+ <li><a id="toc-Color-support-details-1" href="#Color-support-details">7.6 Color support details</a>
<ul class="no-bullet">
- <li><a name="toc-Color-specifications-1" href="#Color-specifications">7.6.1 Color specifications</a></li>
- <li><a name="toc-Color-specials-1" href="#Color-specials">7.6.2 Color specials</a></li>
+ <li><a id="toc-Color-specifications-1" href="#Color-specifications">7.6.1 Color specifications</a></li>
+ <li><a id="toc-Color-specials-1" href="#Color-specials">7.6.2 Color specials</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Index-1" href="#Index">Index</a></li>
+ <li><a id="toc-Index-1" href="#Index">Index</a></li>
</ul>
</div>
-<a name="Top"></a>
-<div class="header">
+<span id="Top"></span><div class="header">
<p>
Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</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>
-<a name="Dvips"></a>
-<h1 class="top">Dvips</h1>
+<span id="Dvips"></span><h1 class="top">Dvips</h1>
-<p>This manual documents Dvips version 5.998
-(February 2018), a program to translate a DVI file into
+<p>This manual documents Dvips version 5.999
+(February 2019), a program to translate a DVI file into
PostScript. You may freely use, modify and/or distribute this file.
</p>
-
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Why-Dvips" accesskey="1">Why Dvips</a>:</td><td> </td><td align="left" valign="top">Why use Dvips?
+<tr><td align="left" valign="top">• <a href="#Why-Dvips" accesskey="1">Why Dvips</a></td><td> </td><td align="left" valign="top">Why use Dvips?
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a>:</td><td> </td><td align="left" valign="top">How to compile and install Dvips.
+<tr><td align="left" valign="top">• <a href="#Installation" accesskey="2">Installation</a></td><td> </td><td align="left" valign="top">How to compile and install Dvips.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Invoking-Dvips" accesskey="3">Invoking Dvips</a>:</td><td> </td><td align="left" valign="top">Command-line options, configuration files, etc.
+<tr><td align="left" valign="top">• <a href="#Invoking-Dvips" accesskey="3">Invoking Dvips</a></td><td> </td><td align="left" valign="top">Command-line options, configuration files, etc.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Paper-size-and-landscape" accesskey="4">Paper size and landscape</a>:</td><td> </td><td align="left" valign="top">Changing the paper dimensions.
+<tr><td align="left" valign="top">• <a href="#Paper-size-and-landscape" accesskey="4">Paper size and landscape</a></td><td> </td><td align="left" valign="top">Changing the paper dimensions.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Interaction-with-PostScript" accesskey="5">Interaction with PostScript</a>:</td><td> </td><td align="left" valign="top">TeX meets Dvips meets PostScript.
+<tr><td align="left" valign="top">• <a href="#Interaction-with-PostScript" accesskey="5">Interaction with PostScript</a></td><td> </td><td align="left" valign="top">TeX meets Dvips meets PostScript.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#PostScript-fonts" accesskey="6">PostScript fonts</a>:</td><td> </td><td align="left" valign="top">Installing and using PostScript fonts.
+<tr><td align="left" valign="top">• <a href="#PostScript-fonts" accesskey="6">PostScript fonts</a></td><td> </td><td align="left" valign="top">Installing and using PostScript fonts.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color" accesskey="7">Color</a>:</td><td> </td><td align="left" valign="top">Using color with Dvips.
+<tr><td align="left" valign="top">• <a href="#Color" accesskey="7">Color</a></td><td> </td><td align="left" valign="top">Using color with Dvips.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Index" accesskey="8">Index</a>:</td><td> </td><td align="left" valign="top">General index.
+<tr><td align="left" valign="top">• <a href="#Index" accesskey="8">Index</a></td><td> </td><td align="left" valign="top">General index.
</td></tr>
</table>
<hr>
-<a name="Why-Dvips"></a>
-<div class="header">
+<span id="Why-Dvips"></span><div class="header">
<p>
Next: <a href="#Installation" accesskey="n" rel="next">Installation</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>
</div>
-<a name="Why-use-Dvips_003f"></a>
-<h2 class="chapter">1 Why use Dvips?</h2>
+<span id="Why-use-Dvips_003f"></span><h2 class="chapter">1 Why use Dvips?</h2>
<p>The Dvips program has a number of features that set it apart from
other PostScript drivers for TeX. This rather long section describes
@@ -291,30 +277,28 @@
more time will be available to create beautiful documents.
So if you don’t use Dvips on your system, get it today.
</p>
-<a name="index-Rokicki_002c-Tomas"></a>
+<span id="index-Rokicki_002c-Tomas"></span>
<p>Tom Rokicki wrote and maintains the original Dvips program.
</p>
<hr>
-<a name="Installation"></a>
-<div class="header">
+<span id="Installation"></span><div class="header">
<p>
Next: <a href="#Invoking-Dvips" accesskey="n" rel="next">Invoking Dvips</a>, Previous: <a href="#Why-Dvips" accesskey="p" rel="prev">Why Dvips</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>
</div>
-<a name="Installation-1"></a>
-<h2 class="chapter">2 Installation</h2>
+<span id="Installation-1"></span><h2 class="chapter">2 Installation</h2>
-<a name="index-configuration_002c-of-Dvips"></a>
-<a name="index-compilation"></a>
-<a name="index-installation_002c-of-Dvips"></a>
+<span id="index-configuration_002c-of-Dvips"></span>
+<span id="index-compilation"></span>
+<span id="index-installation_002c-of-Dvips"></span>
<p>Installing Dvips is mostly the same as installing any Kpathsea-using
program. Therefore, for the basic steps involved,
-see <a href="http://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>.
+see <a href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>.
</p>
<p>For solutions to common installation problems and information on how to
-report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems,
+report a bug, see the file <samp>kpathsea/BUGS</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>). For solutions to Dvips-specific problems,
see <a href="#Debug-options">Debug options</a>. Also see the Dvips home page at
<a href="http://www.radicaleye.com/dvips">http://www.radicaleye.com/dvips</a>.
</p>
@@ -322,31 +306,29 @@
sections below. Also, to configure color devices, see <a href="#Color-device-configuration">Color device configuration</a>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#config_002eps-installation" accesskey="1">config.ps installation</a>:</td><td> </td><td align="left" valign="top">Printer and site Dvips configuration.
+<tr><td align="left" valign="top">• <a href="#config_002eps-installation" accesskey="1">config.ps installation</a></td><td> </td><td align="left" valign="top">Printer and site Dvips configuration.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a>:</td><td> </td><td align="left" valign="top">Many PostScript fonts are freely available.
+<tr><td align="left" valign="top">• <a href="#PostScript-font-installation" accesskey="2">PostScript font installation</a></td><td> </td><td align="left" valign="top">Many PostScript fonts are freely available.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a>:</td><td> </td><td align="left" valign="top">A free PostScript interpreter.
+<tr><td align="left" valign="top">• <a href="#Ghostscript-installation" accesskey="3">Ghostscript installation</a></td><td> </td><td align="left" valign="top">A free PostScript interpreter.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a>:</td><td> </td><td align="left" valign="top">Some common runtime difficulties.
+<tr><td align="left" valign="top">• <a href="#Diagnosing-problems" accesskey="4">Diagnosing problems</a></td><td> </td><td align="left" valign="top">Some common runtime difficulties.
</td></tr>
</table>
<hr>
-<a name="config_002eps-installation"></a>
-<div class="header">
+<span id="config_002eps-installation"></span><div class="header">
<p>
Next: <a href="#PostScript-font-installation" accesskey="n" rel="next">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="config_002eps-installation-1"></a>
-<h3 class="section">2.1 <samp>config.ps</samp> installation</h3>
+<span id="config_002eps-installation-1"></span><h3 class="section">2.1 <samp>config.ps</samp> installation</h3>
-<a name="index-config_002eps-installation"></a>
-<a name="index-installation-of-config_002eps"></a>
-<a name="index-printer-configuration"></a>
-<a name="index-paper-size_002c-default"></a>
-<a name="index-configuration-files_002c-creating"></a>
+<span id="index-config_002eps-installation"></span>
+<span id="index-installation-of-config_002eps"></span>
+<span id="index-printer-configuration"></span>
+<span id="index-paper-size_002c-default"></span>
+<span id="index-configuration-files_002c-creating"></span>
<p>Dvips has its own configuration files: a file <samp>config.ps</samp> for
sitewide defaults, and a file <samp>config.<var>printer</var></samp> for each
@@ -354,12 +336,12 @@
install</code> does not create them; you must create them yourself.
</p>
<p>(These Dvips configuration files are independent of the Kpathsea
-configuration file <samp>texmf.cnf</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+configuration file <samp>texmf.cnf</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
</p>
-<a name="index-config_002eproto"></a>
-<a name="index-prototype-printer-configuration-file"></a>
-<a name="index-printer-configuration-file_002c-prototype"></a>
-<a name="index-configuration-files_002c-prototype"></a>
+<span id="index-config_002eproto"></span>
+<span id="index-prototype-printer-configuration-file"></span>
+<span id="index-printer-configuration-file_002c-prototype"></span>
+<span id="index-configuration-files_002c-prototype"></span>
<p>Dvips configuration files contents and searching are described fully in
<a href="#Config-files">Config files</a>. The simplest way to create a new configuration file
is to copy and modify the file <samp>dvipsk/contrib/config.proto</samp>,
@@ -420,17 +402,15 @@
<hr>
-<a name="PostScript-font-installation"></a>
-<div class="header">
+<span id="PostScript-font-installation"></span><div class="header">
<p>
Next: <a href="#Ghostscript-installation" accesskey="n" rel="next">Ghostscript installation</a>, Previous: <a href="#config_002eps-installation" accesskey="p" rel="prev">config.ps installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="PostScript-font-installation-1"></a>
-<h3 class="section">2.2 PostScript font installation</h3>
+<span id="PostScript-font-installation-1"></span><h3 class="section">2.2 PostScript font installation</h3>
-<a name="index-installation-of-PostScript-fonts"></a>
-<a name="index-fonts_002c-installation-of-PostScript"></a>
-<a name="index-PostScript-fonts_002c-installing"></a>
+<span id="index-installation-of-PostScript-fonts"></span>
+<span id="index-fonts_002c-installation-of-PostScript"></span>
+<span id="index-PostScript-fonts_002c-installing"></span>
<p>To use PostScript fonts with TeX and Dvips, you need both metric
files (<samp>.tfm</samp> and <samp>.vf</samp>) and the outlines (<samp>.pfa</samp> or
@@ -437,9 +417,9 @@
<samp>.pfb</samp>). See <a href="#Font-concepts">Font concepts</a>. Current TeX systems
come with support for 35 base PostScript fonts and many more.
</p>
-<a name="index-fonts_002c-system-PostScript"></a>
-<a name="index-PostScript-fonts_002c-on-your-system"></a>
-<a name="index-psfonts_002emap"></a>
+<span id="index-fonts_002c-system-PostScript"></span>
+<span id="index-PostScript-fonts_002c-on-your-system"></span>
+<span id="index-psfonts_002emap"></span>
<p>If you have additional PostScript fonts, you can make them available
to Dvips by (1) giving them appropriate filenames; and
(2) running Afm2tfm (see <a href="#Making-a-font-available">Making a font available</a>) to make TFM
@@ -451,23 +431,21 @@
</p>
<hr>
-<a name="Ghostscript-installation"></a>
-<div class="header">
+<span id="Ghostscript-installation"></span><div class="header">
<p>
Next: <a href="#Diagnosing-problems" accesskey="n" rel="next">Diagnosing problems</a>, Previous: <a href="#PostScript-font-installation" accesskey="p" rel="prev">PostScript font installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Ghostscript-installation-1"></a>
-<h3 class="section">2.3 Ghostscript installation</h3>
+<span id="Ghostscript-installation-1"></span><h3 class="section">2.3 Ghostscript installation</h3>
-<a name="index-Ghostscript-installation"></a>
-<a name="index-gs-installation"></a>
+<span id="index-Ghostscript-installation"></span>
+<span id="index-gs-installation"></span>
-<a name="index-Deutsch_002c-Peter"></a>
-<a name="index-Epson-printers"></a>
-<a name="index-previewing-Dvips-output"></a>
-<a name="index-PostScript-previewers"></a>
-<a name="index-PDF-files_002c-making"></a>
-<a name="index-Aladdin-Ghostscript"></a>
+<span id="index-Deutsch_002c-Peter"></span>
+<span id="index-Epson-printers"></span>
+<span id="index-previewing-Dvips-output"></span>
+<span id="index-PostScript-previewers"></span>
+<span id="index-PDF-files_002c-making"></span>
+<span id="index-Aladdin-Ghostscript"></span>
<p>Ghostscript is a PostScript interpreter freely available to end-users,
originally written by Peter Deutsch. It can read the PostScript
produced by Dvips and render it on your monitor, or for another device
@@ -475,12 +453,12 @@
format. The latest version is available via
<a href="http://ghostscript.com">http://ghostscript.com</a>.
</p>
-<a name="index-Theisen_002c-Tim"></a>
-<a name="index-ghostview"></a>
-<a name="index-Ghostview_002c-and-no-N"></a>
-<a name="index-EPS_002c-and-Ghostview"></a>
-<a name="index-standard-PostScript_002c-required-by-Ghostview"></a>
-<a name="index-_0025_0025Page_002c-required-by-Ghostview"></a>
+<span id="index-Theisen_002c-Tim"></span>
+<span id="index-ghostview"></span>
+<span id="index-Ghostview_002c-and-no-N"></span>
+<span id="index-EPS_002c-and-Ghostview"></span>
+<span id="index-standard-PostScript_002c-required-by-Ghostview"></span>
+<span id="index-_0025_0025Page_002c-required-by-Ghostview"></span>
<p>The program Ghostview, originally written by Johannes Plass and Tim
Theisen, provides typical previewing capabilities (next page/previous
page, magnification, etc.). It requires Ghostscript to run, and files
@@ -490,17 +468,15 @@
</p>
<hr>
-<a name="Diagnosing-problems"></a>
-<div class="header">
+<span id="Diagnosing-problems"></span><div class="header">
<p>
Previous: <a href="#Ghostscript-installation" accesskey="p" rel="prev">Ghostscript installation</a>, Up: <a href="#Installation" accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Diagnosing-problems-1"></a>
-<h3 class="section">2.4 Diagnosing problems</h3>
+<span id="Diagnosing-problems-1"></span><h3 class="section">2.4 Diagnosing problems</h3>
-<a name="index-problems"></a>
-<a name="index-trouble"></a>
-<a name="index-debugging"></a>
+<span id="index-problems"></span>
+<span id="index-trouble"></span>
+<span id="index-debugging"></span>
<p>You’ve gone through all the trouble of installing Dvips, carefully read
all the instructions in this manual, and still can’t get something to
@@ -508,7 +484,7 @@
yourself in such a situation.
</p>
<p>For details on effective bug reporting, common installation problems,
-and <code>mktexpk</code> problems, see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>.
+and <code>mktexpk</code> problems, see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>.
</p>
<p>A good first debugging operation is to set the environment variable
<code>DVIPSDEBUG</code>, which will display any configuration and map files
@@ -516,32 +492,30 @@
settings you expect.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="1">Debug options</a>:</td><td> </td><td align="left" valign="top">Getting diagnostics.
+<tr><td align="left" valign="top">• <a href="#Debug-options" accesskey="1">Debug options</a></td><td> </td><td align="left" valign="top">Getting diagnostics.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#No-output" accesskey="2">No output</a>:</td><td> </td><td align="left" valign="top">No output at all.
+<tr><td align="left" valign="top">• <a href="#No-output" accesskey="2">No output</a></td><td> </td><td align="left" valign="top">No output at all.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Small-or-inverted" accesskey="3">Small or inverted</a>:</td><td> </td><td align="left" valign="top">Output too small or inverted.
+<tr><td align="left" valign="top">• <a href="#Small-or-inverted" accesskey="3">Small or inverted</a></td><td> </td><td align="left" valign="top">Output too small or inverted.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Printer-errors" accesskey="4">Printer errors</a>:</td><td> </td><td align="left" valign="top">The printer sends back errors.
+<tr><td align="left" valign="top">• <a href="#Printer-errors" accesskey="4">Printer errors</a></td><td> </td><td align="left" valign="top">The printer sends back errors.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Long-documents-fail" accesskey="5">Long documents fail</a>:</td><td> </td><td align="left" valign="top">Long documents fail to print.
+<tr><td align="left" valign="top">• <a href="#Long-documents-fail" accesskey="5">Long documents fail</a></td><td> </td><td align="left" valign="top">Long documents fail to print.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a>:</td><td> </td><td align="left" valign="top">Figures don’t work.
+<tr><td align="left" valign="top">• <a href="#Including-graphics-fails" accesskey="6">Including graphics fails</a></td><td> </td><td align="left" valign="top">Figures don’t work.
</td></tr>
</table>
<hr>
-<a name="Debug-options"></a>
-<div class="header">
+<span id="Debug-options"></span><div class="header">
<p>
Next: <a href="#No-output" accesskey="n" rel="next">No output</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Debug-options-1"></a>
-<h4 class="subsection">2.4.1 Debug options</h4>
+<span id="Debug-options-1"></span><h4 class="subsection">2.4.1 Debug options</h4>
-<a name="index-debugging-options"></a>
-<a name="index-options_002c-debugging"></a>
+<span id="index-debugging-options"></span>
+<span id="index-options_002c-debugging"></span>
<p>The ‘<samp>-d</samp>’ flag to Dvips helps in tracking down certain errors.
The parameter to this flag is an integer that tells what errors are
@@ -552,7 +526,7 @@
</p>
<p>You can also set the environment variable <code>KPATHSEA_DEBUG</code> instead
of using ‘<samp>-d</samp>’. Some of these debugging options are actually
-provided by Kpathsea (see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
+provided by Kpathsea (see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>).
</p>
<p>The classes are:
</p>
@@ -600,17 +574,15 @@
<hr>
-<a name="No-output"></a>
-<div class="header">
+<span id="No-output"></span><div class="header">
<p>
Next: <a href="#Small-or-inverted" accesskey="n" rel="next">Small or inverted</a>, Previous: <a href="#Debug-options" accesskey="p" rel="prev">Debug options</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="No-output-at-all"></a>
-<h4 class="subsection">2.4.2 No output at all</h4>
+<span id="No-output-at-all"></span><h4 class="subsection">2.4.2 No output at all</h4>
-<a name="index-output_002c-none"></a>
-<a name="index-no-output-at-all"></a>
-<a name="index-failure_002c-to-print-at-all"></a>
+<span id="index-output_002c-none"></span>
+<span id="index-no-output-at-all"></span>
+<span id="index-failure_002c-to-print-at-all"></span>
<p>If you are not getting any output at all, even from the simplest
one-character file (for instance, ‘<samp>\ \bye</samp>’), then something is very
@@ -619,11 +591,11 @@
occurred, if any. Talk to your system administrator about downloading a
PostScript error handler. (Adobe distributes a good one called
‘<samp>ehandler.ps</samp>’.)
-<a name="index-ehandler_002eps"></a>
+<span id="index-ehandler_002eps"></span>
</p>
-<a name="index-PowerPage-PostScript-implementation"></a>
-<a name="index-Shinko-CHC_002dS446i-printer"></a>
-<a name="index-Mitsubishi-Shinko-CHC_002dS446i-printer"></a>
+<span id="index-PowerPage-PostScript-implementation"></span>
+<span id="index-Shinko-CHC_002dS446i-printer"></span>
+<span id="index-Mitsubishi-Shinko-CHC_002dS446i-printer"></span>
<p>It is possible, especially if you are using non-Adobe PostScript, that
your PostScript interpreter is broken. Even then it should generate an
error message. Dvips tries to work around as many bugs as possible in
@@ -643,20 +615,18 @@
</p>
<hr>
-<a name="Small-or-inverted"></a>
-<div class="header">
+<span id="Small-or-inverted"></span><div class="header">
<p>
Next: <a href="#Printer-errors" accesskey="n" rel="next">Printer errors</a>, Previous: <a href="#No-output" accesskey="p" rel="prev">No output</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Output-too-small-or-inverted"></a>
-<h4 class="subsection">2.4.3 Output too small or inverted</h4>
+<span id="Output-too-small-or-inverted"></span><h4 class="subsection">2.4.3 Output too small or inverted</h4>
-<a name="index-output_002c-too-small"></a>
-<a name="index-output_002c-inverted"></a>
-<a name="index-inverted-output"></a>
-<a name="index-too_002dsmall-output"></a>
+<span id="index-output_002c-too-small"></span>
+<span id="index-output_002c-inverted"></span>
+<span id="index-inverted-output"></span>
+<span id="index-too_002dsmall-output"></span>
-<a name="index-save_002frestore_002c-and-inverted-output"></a>
+<span id="index-save_002frestore_002c-and-inverted-output"></span>
<p>If some documents come out inverted or too small, probably your spooler
is not supplying an end of job indicator at the end of each file. (This
commonly happens on small machines that don’t have spoolers.) You can
@@ -668,19 +638,17 @@
</p>
<hr>
-<a name="Printer-errors"></a>
-<div class="header">
+<span id="Printer-errors"></span><div class="header">
<p>
Next: <a href="#Long-documents-fail" accesskey="n" rel="next">Long documents fail</a>, Previous: <a href="#Small-or-inverted" accesskey="p" rel="prev">Small or inverted</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Error-messages-from-printer"></a>
-<h4 class="subsection">2.4.4 Error messages from printer</h4>
+<span id="Error-messages-from-printer"></span><h4 class="subsection">2.4.4 Error messages from printer</h4>
-<a name="index-printer-errors"></a>
-<a name="index-error-messages-from-printer"></a>
-<a name="index-failure_002c-and-printer-errors"></a>
+<span id="index-printer-errors"></span>
+<span id="index-error-messages-from-printer"></span>
+<span id="index-failure_002c-and-printer-errors"></span>
-<a name="index-bop-undefined-error"></a>
+<span id="index-bop-undefined-error"></span>
<p>If your printer returns error messages, the error message gives very
good information on what might be going wrong. One of the most common
error messages is ‘<samp>bop undefined</samp>’. This is caused by old versions
@@ -689,9 +657,9 @@
with the ‘<samp>-N</samp>’ option, but it’d be best to get your spooling
software updated.
</p>
-<a name="index-VM-exhausted"></a>
-<a name="index-printer-memory-exhausted"></a>
-<a name="index-memory-of-printer-exhausted"></a>
+<span id="index-VM-exhausted"></span>
+<span id="index-printer-memory-exhausted"></span>
+<span id="index-memory-of-printer-exhausted"></span>
<p>Another error message is ‘<samp>VM exhausted</samp>’. Some printers indicate
this error by locking up, others quietly reset. This is caused by Dvips
thinking that the printer has more memory than it actually does, and
@@ -707,16 +675,14 @@
</p>
<hr>
-<a name="Long-documents-fail"></a>
-<div class="header">
+<span id="Long-documents-fail"></span><div class="header">
<p>
Next: <a href="#Including-graphics-fails" accesskey="n" rel="next">Including graphics fails</a>, Previous: <a href="#Printer-errors" accesskey="p" rel="prev">Printer errors</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Long-documents-fail-to-print"></a>
-<h4 class="subsection">2.4.5 Long documents fail to print</h4>
+<span id="Long-documents-fail-to-print"></span><h4 class="subsection">2.4.5 Long documents fail to print</h4>
-<a name="index-long-documents-not-printing"></a>
-<a name="index-failure_002c-of-long-documents"></a>
+<span id="index-long-documents-not-printing"></span>
+<span id="index-failure_002c-of-long-documents"></span>
<p>This is usually caused by incorrectly specifying the amount of memory
the printer has in the configuration file; see the previous section.
@@ -723,23 +689,21 @@
</p>
<hr>
-<a name="Including-graphics-fails"></a>
-<div class="header">
+<span id="Including-graphics-fails"></span><div class="header">
<p>
Previous: <a href="#Long-documents-fail" accesskey="p" rel="prev">Long documents fail</a>, Up: <a href="#Diagnosing-problems" accesskey="u" rel="up">Diagnosing 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>
-<a name="Including-graphics-fails-1"></a>
-<h4 class="subsection">2.4.6 Including graphics fails</h4>
+<span id="Including-graphics-fails-1"></span><h4 class="subsection">2.4.6 Including graphics fails</h4>
-<a name="index-including-graphics-fails"></a>
-<a name="index-graphics-inclusion-fails"></a>
-<a name="index-failure_002c-to-include-graphics"></a>
+<span id="index-including-graphics-fails"></span>
+<span id="index-graphics-inclusion-fails"></span>
+<span id="index-failure_002c-to-include-graphics"></span>
<p>The most common problem with including graphics is an incorrect bounding
box (see <a href="#Bounding-box">Bounding box</a>). Complain to whoever wrote the software that
generated the file if the bounding box is indeed incorrect.
</p>
-<a name="index-Illustrator_002c-workaround-for"></a>
+<span id="index-Illustrator_002c-workaround-for"></span>
<p>Another possible problem is that the figure you are trying to include
does not nest properly; there are certain rules PostScript applications
must follow when generating files to be included. The Dvips program
@@ -753,23 +717,21 @@
some applications read the PostScript file from the input stream,
looking for a particular comment.
</p>
-<a name="index-binary-files_002c-not-supported"></a>
+<span id="index-binary-files_002c-not-supported"></span>
<p>Any application which generates graphics output containing raw binary
(not ASCII hex) will probably fail with Dvips.
</p>
<hr>
-<a name="Invoking-Dvips"></a>
-<div class="header">
+<span id="Invoking-Dvips"></span><div class="header">
<p>
Next: <a href="#Paper-size-and-landscape" accesskey="n" rel="next">Paper size and landscape</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</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>
</div>
-<a name="Invoking-Dvips-1"></a>
-<h2 class="chapter">3 Invoking Dvips</h2>
+<span id="Invoking-Dvips-1"></span><h2 class="chapter">3 Invoking Dvips</h2>
-<a name="index-command_002dline-options"></a>
-<a name="index-options_002c-Dvips"></a>
-<a name="index-invoking-Dvips"></a>
+<span id="index-command_002dline-options"></span>
+<span id="index-options_002c-Dvips"></span>
+<span id="index-invoking-Dvips"></span>
<p>Dvips reads a DVI file as output by (for example) TeX, and converts
it to PostScript, taking care of builtin or downloaded PostScript fonts,
@@ -780,27 +742,25 @@
environment variables, and command-line options.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="1">Basic usage</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Basic-usage" accesskey="1">Basic usage</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="2">Command-line options</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Command_002dline-options" accesskey="2">Command-line options</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Environment-variables" accesskey="3">Environment variables</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Environment-variables" accesskey="3">Environment variables</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Config-files" accesskey="4">Config files</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Config-files" accesskey="4">Config files</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Basic-usage"></a>
-<div class="header">
+<span id="Basic-usage"></span><div class="header">
<p>
Next: <a href="#Command_002dline-options" accesskey="n" rel="next">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Basic-usage-of-Dvips"></a>
-<h3 class="section">3.1 Basic usage of Dvips</h3>
+<span id="Basic-usage-of-Dvips"></span><h3 class="section">3.1 Basic usage of Dvips</h3>
-<a name="index-usage_002c-basic"></a>
+<span id="index-usage_002c-basic"></span>
<p>To use Dvips at its simplest, simply type
</p>
@@ -819,7 +779,7 @@
printed, these fonts will have been saved in the proper directories, so
printing will go much faster. (If Dvips tries to endlessly generate the
same fonts over and over again, it hasn’t been installed properly.
-See <a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.)
+See <a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.)
</p>
<p>Many options are available (see the next section). For a brief summary
of available options, just type
@@ -830,38 +790,34 @@
<hr>
-<a name="Command_002dline-options"></a>
-<div class="header">
+<span id="Command_002dline-options"></span><div class="header">
<p>
Next: <a href="#Environment-variables" accesskey="n" rel="next">Environment variables</a>, Previous: <a href="#Basic-usage" accesskey="p" rel="prev">Basic usage</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Command_002dline-options-1"></a>
-<h3 class="section">3.2 Command-line options</h3>
+<span id="Command_002dline-options-1"></span><h3 class="section">3.2 Command-line options</h3>
<p>Dvips has a plethora of command line options. Reading through this
section will give a good idea of the capabilities of the driver.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Option-summary" accesskey="1">Option summary</a>:</td><td> </td><td align="left" valign="top">Quick listing, from Dvips –help.
+<tr><td align="left" valign="top">• <a href="#Option-summary" accesskey="1">Option summary</a></td><td> </td><td align="left" valign="top">Quick listing, from Dvips –help.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Option-details" accesskey="2">Option details</a>:</td><td> </td><td align="left" valign="top">More information about each option.
+<tr><td align="left" valign="top">• <a href="#Option-details" accesskey="2">Option details</a></td><td> </td><td align="left" valign="top">More information about each option.
</td></tr>
</table>
<hr>
-<a name="Option-summary"></a>
-<div class="header">
+<span id="Option-summary"></span><div class="header">
<p>
Next: <a href="#Option-details" accesskey="n" rel="next">Option details</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Option-summary-1"></a>
-<h4 class="subsection">3.2.1 Option summary</h4>
+<span id="Option-summary-1"></span><h4 class="subsection">3.2.1 Option summary</h4>
-<a name="index-options_002c-summary"></a>
+<span id="index-options_002c-summary"></span>
<p>Here is a handy summary of the options; it is printed out when you run
Dvips with no arguments or with the standard ‘<samp>--help</samp>’ option.
-<a name="index-_002d_002dhelp"></a>
+<span id="index-_002d_002dhelp"></span>
</p>
<pre class="verbatim">Usage: dvips [OPTION]... FILENAME[.dvi]
Convert DVI input files to PostScript.
@@ -905,15 +861,13 @@
</pre>
<hr>
-<a name="Option-details"></a>
-<div class="header">
+<span id="Option-details"></span><div class="header">
<p>
Previous: <a href="#Option-summary" accesskey="p" rel="prev">Option summary</a>, Up: <a href="#Command_002dline-options" accesskey="u" rel="up">Command-line options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Option-details-1"></a>
-<h4 class="subsection">3.2.2 Option details</h4>
+<span id="Option-details-1"></span><h4 class="subsection">3.2.2 Option details</h4>
-<a name="index-option_002c-details-of"></a>
+<span id="index-option_002c-details-of"></span>
<p>Many of the parameterless options listed here can be turned off by
suffixing the option with a zero (‘<samp>0</samp>’); for instance, to turn off
@@ -922,26 +876,26 @@
</p>
<dl compact="compact">
<dt>‘<samp>-</samp>’</dt>
-<dd><a name="index-_002d"></a>
-<a name="index-options_002c-reading-from-standard-input"></a>
-<a name="index-standard-input_002c-reading-options-from"></a>
+<dd><span id="index-_002d"></span>
+<span id="index-options_002c-reading-from-standard-input"></span>
+<span id="index-standard-input_002c-reading-options-from"></span>
<p>Read additional options from standard input after processing the command
line.
</p>
</dd>
<dt>‘<samp>--help</samp>’</dt>
-<dd><a name="index-_002d_002dhelp-1"></a>
+<dd><span id="index-_002d_002dhelp-1"></span>
<p>Print a usage message and exit.
</p>
</dd>
<dt>‘<samp>--version</samp>’</dt>
-<dd><a name="index-_002d_002dversion"></a>
+<dd><span id="index-_002d_002dversion"></span>
<p>Print the version number and exit.
</p>
</dd>
<dt>‘<samp>-a*</samp>’</dt>
-<dd><a name="index-_002da"></a>
-<a name="index-memory_002c-conserving"></a>
+<dd><span id="index-_002da"></span>
+<span id="index-memory_002c-conserving"></span>
<p>Conserve memory by making three passes over the DVI file instead
of two and only loading those characters actually used. Generally only
useful on machines with a very limited amount of memory, like some PCs.
@@ -948,17 +902,17 @@
</p>
</dd>
<dt>‘<samp>-A</samp>’</dt>
-<dd><a name="index-_002dA"></a>
-<a name="index-odd-pages-only"></a>
+<dd><span id="index-_002dA"></span>
+<span id="index-odd-pages-only"></span>
<p>Print only the odd pages. This option uses TeX
page numbers, not physical page numbers.
</p>
</dd>
<dt>‘<samp>-b <var>num</var></samp>’</dt>
-<dd><a name="index-_002db-num"></a>
-<a name="index-_002f_0023copies"></a>
-<a name="index-copies_002c-duplicated-page-bodies"></a>
-<a name="index-color-separations"></a>
+<dd><span id="index-_002db-num"></span>
+<span id="index-_002f_0023copies"></span>
+<span id="index-copies_002c-duplicated-page-bodies"></span>
+<span id="index-color-separations"></span>
<p>Generate <var>num</var> copies of each page, but duplicating the page body
rather than using the ‘<samp>/#copies</samp>’ PostScript variable. This can
be useful in conjunction with a header file setting ‘<samp>bop-hook</samp>’ to
@@ -966,18 +920,18 @@
</p>
</dd>
<dt>‘<samp>-B</samp>’</dt>
-<dd><a name="index-_002dB"></a>
-<a name="index-even-pages-only"></a>
-<a name="index-double_002dsided-printing"></a>
+<dd><span id="index-_002dB"></span>
+<span id="index-even-pages-only"></span>
+<span id="index-double_002dsided-printing"></span>
<p>Print only the even pages. This option uses TeX page numbers, not
physical page numbers.
</p>
</dd>
<dt>‘<samp>-c <var>num</var></samp>’</dt>
-<dd><a name="index-_002dc-num"></a>
-<a name="index-_002f_0023copies-1"></a>
-<a name="index-copies_002c-uncollated"></a>
-<a name="index-uncollated-copies"></a>
+<dd><span id="index-_002dc-num"></span>
+<span id="index-_002f_0023copies-1"></span>
+<span id="index-copies_002c-uncollated"></span>
+<span id="index-uncollated-copies"></span>
<p>Generate <var>num</var> consecutive copies of every page, i.e., the output is
uncollated. This merely sets the builtin PostScript variable
‘<samp>/#copies</samp>’.
@@ -984,9 +938,9 @@
</p>
</dd>
<dt>‘<samp>-C <var>num</var></samp>’</dt>
-<dd><a name="index-_002dC-num"></a>
-<a name="index-copies_002c-collated"></a>
-<a name="index-collated-copies"></a>
+<dd><span id="index-_002dC-num"></span>
+<span id="index-copies_002c-collated"></span>
+<span id="index-collated-copies"></span>
<p>Generate <var>num</var> copies, but collated (by replicating the data in the
PostScript file). Slower than the ‘<samp>-c</samp>’ option, but easier on the
hands, and faster than resubmitting the same PostScript file multiple
@@ -994,8 +948,8 @@
</p>
</dd>
<dt>‘<samp>-d <var>num</var></samp>’</dt>
-<dd><a name="index-_002dd-num"></a>
-<a name="index-debugging-1"></a>
+<dd><span id="index-_002dd-num"></span>
+<span id="index-debugging-1"></span>
<p>Set the debug flags, showing what Dvips (thinks it) is doing. This will
work unless Dvips has been compiled without the ‘<samp>DEBUG</samp>’ option (not
recommended). See <a href="#Debug-options">Debug options</a>, for the possible values of
@@ -1003,8 +957,8 @@
</p>
</dd>
<dt>‘<samp>-D <var>num</var></samp>’</dt>
-<dd><a name="index-_002dD-num"></a>
-<a name="index-resolution_002c-setting"></a>
+<dd><span id="index-_002dD-num"></span>
+<span id="index-resolution_002c-setting"></span>
<p>Set both the horizontal and vertical resolution to <var>num</var>, given in
dpi (dots per inch). This affects the choice of bitmap fonts that are
loaded and also the positioning of letters in resident PostScript
@@ -1019,10 +973,10 @@
</p>
</dd>
<dt>‘<samp>-e <var>num</var></samp>’</dt>
-<dd><a name="index-_002de-num"></a>
-<a name="index-maxdrift"></a>
-<a name="index-accuracy-in-positioning"></a>
-<a name="index-positioning-accuracy"></a>
+<dd><span id="index-_002de-num"></span>
+<span id="index-maxdrift"></span>
+<span id="index-accuracy-in-positioning"></span>
+<span id="index-positioning-accuracy"></span>
<p>Maximum drift in pixels of each character from its ‘true’
resolution-independent position on the page. The default value of this
parameter is resolution dependent (it is the number of entries in the
@@ -1035,10 +989,10 @@
</p>
</dd>
<dt>‘<samp>-E*</samp>’</dt>
-<dd><a name="index-_002dE"></a>
-<a name="index-EPSF_002c-generating"></a>
-<a name="index-tight-bounding-box_002c-finding"></a>
-<a name="index-bounding-box_002c-finding-tight"></a>
+<dd><span id="index-_002dE"></span>
+<span id="index-EPSF_002c-generating"></span>
+<span id="index-tight-bounding-box_002c-finding"></span>
+<span id="index-bounding-box_002c-finding-tight"></span>
<p>Generate an EPSF file with a tight bounding box. This only looks at
marks made by characters and rules, not by any included graphics. In
addition, it gets the glyph metrics from the TFM file, so characters
@@ -1055,11 +1009,11 @@
</p>
</dd>
<dt>‘<samp>-f*</samp>’</dt>
-<dd><a name="index-_002df"></a>
-<a name="index-filter_002c-running-as-a"></a>
-<a name="index-standard-I_002fO"></a>
-<a name="index-pipes_002c-not-readable"></a>
-<a name="index-PRINTER_002c-avoided-with-_002df"></a>
+<dd><span id="index-_002df"></span>
+<span id="index-filter_002c-running-as-a"></span>
+<span id="index-standard-I_002fO"></span>
+<span id="index-pipes_002c-not-readable"></span>
+<span id="index-PRINTER_002c-avoided-with-_002df"></span>
<p>Run as a filter. Read the DVI file from standard input and write the
PostScript to standard output. The standard input must be seekable, so
it cannot be a pipe. If your input must be a pipe, write a shell script
@@ -1072,11 +1026,11 @@
</p>
</dd>
<dt>‘<samp>-F*</samp>’</dt>
-<dd><a name="index-_002dF"></a>
-<a name="index-EOF"></a>
-<a name="index-control_002dD"></a>
-<a name="index-printer_002c-driving-directly"></a>
-<a name="index-spooler_002c-lacking"></a>
+<dd><span id="index-_002dF"></span>
+<span id="index-EOF"></span>
+<span id="index-control_002dD"></span>
+<span id="index-printer_002c-driving-directly"></span>
+<span id="index-spooler_002c-lacking"></span>
<p>Write control-D (ASCII code 4) as the very last character of the
PostScript file. This is useful when Dvips is driving the printer
directly instead of working through a spooler, as is common on personal
@@ -1085,9 +1039,9 @@
</p>
</dd>
<dt>‘<samp>-G*</samp>’</dt>
-<dd><a name="index-_002dG"></a>
-<a name="index-low-characters_002c-shifting"></a>
-<a name="index-non_002dprinting-characters_002c-shifting"></a>
+<dd><span id="index-_002dG"></span>
+<span id="index-low-characters_002c-shifting"></span>
+<span id="index-non_002dprinting-characters_002c-shifting"></span>
<p>Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions.
This was useful to work around bugs in old versions of Adobe’s PDF
reader. It’s more likely to cause problems nowadays.
@@ -1094,9 +1048,9 @@
</p>
</dd>
<dt>‘<samp>-h <var>name</var></samp>’</dt>
-<dd><a name="index-_002dh-name"></a>
-<a name="index-header-file_002c-downloading"></a>
-<a name="index-userdict_002c-used-for-header-files"></a>
+<dd><span id="index-_002dh-name"></span>
+<span id="index-header-file_002c-downloading"></span>
+<span id="index-userdict_002c-used-for-header-files"></span>
<p>Prepend <var>name</var> as an additional header file, or, if <var>name</var> is
‘<samp>-</samp>’, suppress all header files. Any definitions in the header file
get added to the PostScript ‘<samp>userdict</samp>’.
@@ -1103,10 +1057,10 @@
</p>
</dd>
<dt>‘<samp>-i*</samp>’</dt>
-<dd><a name="index-_002di"></a>
-<a name="index-sections-output_002c-in-separate-files"></a>
-<a name="index-multiple-output-files"></a>
-<a name="index-output-files_002c-multiple"></a>
+<dd><span id="index-_002di"></span>
+<span id="index-sections-output_002c-in-separate-files"></span>
+<span id="index-multiple-output-files"></span>
+<span id="index-output-files_002c-multiple"></span>
<p>Make each section be a separate file; a <em>section</em> is a part of the
document processed independently, most often created to avoid memory
overflow. The filenames are created replacing the suffix of the
@@ -1125,7 +1079,7 @@
</p>
</dd>
<dt>‘<samp>-j*</samp>’</dt>
-<dd><a name="index-_002dj-for-partial-font-downloading"></a>
+<dd><span id="index-_002dj-for-partial-font-downloading"></span>
<p>Download only needed characters from Type 1 fonts. This is the
default in the current release. Some debugging flags trace this operation
(see <a href="#Debug-options">Debug options</a>). You can also control partial downloading on a
@@ -1133,9 +1087,9 @@
</p>
</dd>
<dt>‘<samp>-k*</samp>’</dt>
-<dd><a name="index-_002dk-for-cropmarks"></a>
-<a name="index-cropmarks"></a>
-<a name="index-crop_002epro"></a>
+<dd><span id="index-_002dk-for-cropmarks"></span>
+<span id="index-cropmarks"></span>
+<span id="index-crop_002epro"></span>
<p>Print crop marks. This option increases the paper size (which should be
specified, either with a paper size special or with the ‘<samp>-T</samp>’
option) by a half inch in each dimension. It translates each page by a
@@ -1145,9 +1099,9 @@
</p>
</dd>
<dt>‘<samp>-K*</samp>’</dt>
-<dd><a name="index-_002dK"></a>
-<a name="index-comments_002c-removing-included"></a>
-<a name="index-_0025_0025Page_002c-removing"></a>
+<dd><span id="index-_002dK"></span>
+<span id="index-comments_002c-removing-included"></span>
+<span id="index-_0025_0025Page_002c-removing"></span>
<p>Remove comments in included PostScript graphics, font files, and
headers; only necessary to get around bugs in spoolers or PostScript
post-processing programs. Specifically, the ‘<samp>%%Page</samp>’
@@ -1158,11 +1112,11 @@
</p>
</dd>
<dt>‘<samp>-l [=]<var>num</var></samp>’</dt>
-<dd><a name="index-_002dl-_005b_003d_005dnum"></a>
-<a name="index-last-page-printed"></a>
-<a name="index-page_002c-last-printed"></a>
-<a name="index-physical-page-number_002c-and-_002dl"></a>
-<a name="index-absolute-page-number_002c-and-_002dl"></a>
+<dd><span id="index-_002dl-_005b_003d_005dnum"></span>
+<span id="index-last-page-printed"></span>
+<span id="index-page_002c-last-printed"></span>
+<span id="index-physical-page-number_002c-and-_002dl"></span>
+<span id="index-absolute-page-number_002c-and-_002dl"></span>
<p>The last page printed will be the first one numbered <var>num</var>. Default
is the last page in the document. If <var>num</var> is prefixed by an equals
sign, then it (and the argument to the ‘<samp>-p</samp>’ option, if specified)
@@ -1173,43 +1127,43 @@
</p>
</dd>
<dt>‘<samp>-L*</samp>’</dt>
-<dd><a name="index-_002dL"></a>
-<a name="index-papersize-special_002c-first-vs_002e-last"></a>
+<dd><span id="index-_002dL"></span>
+<span id="index-papersize-special_002c-first-vs_002e-last"></span>
<p>By default or with <code>-L1</code>, the last ‘<samp>papersize</samp>’ special wins;
with <code>-L0</code>, the first special wins. See <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>.
</p>
</dd>
<dt>‘<samp>-m*</samp>’</dt>
-<dd><a name="index-_002dm"></a>
-<a name="index-manual-feed"></a>
+<dd><span id="index-_002dm"></span>
+<span id="index-manual-feed"></span>
<p>Specify manual feed, if supported by the output device.
</p>
</dd>
<dt>‘<samp>-mode <var>mode</var></samp>’</dt>
-<dd><a name="index-_002dmode-mode"></a>
-<a name="index-_002dmode"></a>
-<a name="index-mode-name_002c-specifying"></a>
-<a name="index-Metafont-mode_002c-specifying"></a>
+<dd><span id="index-_002dmode-mode"></span>
+<span id="index-_002dmode"></span>
+<span id="index-mode-name_002c-specifying"></span>
+<span id="index-Metafont-mode_002c-specifying"></span>
<p>Use <var>mode</var> as the Metafont device name for path searching and font
generation. This overrides any value from configuration files. With
the default paths, explicitly specifying the mode also makes the program
assume the fonts are in a subdirectory named <var>mode</var>.
-See <a href="http://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see
-<a href="http://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
+See <a href="https://tug.org/texinfohtml/kpathsea.html#TeX-directory-structure">TeX directory structure</a> in <cite>Kpathsea</cite>. If Metafont does not understand the <var>mode</var> name, see
+<a href="https://tug.org/texinfohtml/kpathsea.html#Unable-to-generate-fonts">Unable to generate fonts</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt>‘<samp>-M*</samp>’</dt>
-<dd><a name="index-_002dM"></a>
-<a name="index-font-generation_002c-avoiding"></a>
-<a name="index-mktexpk_002c-avoiding"></a>
-<a name="index-missfont_002elog"></a>
+<dd><span id="index-_002dM"></span>
+<span id="index-font-generation_002c-avoiding"></span>
+<span id="index-mktexpk_002c-avoiding"></span>
+<span id="index-missfont_002elog"></span>
<p>Turns off automatic font generation (<samp>mktexpk</samp>). If
<code>mktexpk</code>, the invocation is appended to a file
<samp>missfont.log</samp> (by default) in the current directory. You can then
execute the log file to create the missing files after fixing the
problem.
-<a name="index-TEXMFOUTPUT"></a>
-<a name="index-MISSFONT_005fLOG"></a>
+<span id="index-TEXMFOUTPUT"></span>
+<span id="index-MISSFONT_005fLOG"></span>
If the current directory is not writable and the environment variable or
configuration file value ‘<samp>TEXMFOUTPUT</samp>’ is set, its value is used.
Otherwise, nothing is written. The name ‘<samp>missfont.log</samp>’ is
@@ -1218,17 +1172,17 @@
</p>
</dd>
<dt>‘<samp>-n <var>num</var></samp>’</dt>
-<dd><a name="index-_002dn-num"></a>
-<a name="index-maximum-pages-printed"></a>
-<a name="index-pages_002c-maximum-printed"></a>
+<dd><span id="index-_002dn-num"></span>
+<span id="index-maximum-pages-printed"></span>
+<span id="index-pages_002c-maximum-printed"></span>
<p>Print at most <var>num</var> pages. Default is 100000.
</p>
</dd>
<dt>‘<samp>-N*</samp>’</dt>
-<dd><a name="index-_002dN"></a>
-<a name="index-structured-comments"></a>
-<a name="index-TranScript"></a>
-<a name="index-_0025_0025Page_002c-not-generating"></a>
+<dd><span id="index-_002dN"></span>
+<span id="index-structured-comments"></span>
+<span id="index-TranScript"></span>
+<span id="index-_0025_0025Page_002c-not-generating"></span>
<p>Turns off generation of structured comments such as ‘<samp>%%Page</samp>’; this
may be necessary on some systems that try to interpret PostScript
comments in weird ways, or on some PostScript printers. Old versions of
@@ -1238,9 +1192,9 @@
</p>
</dd>
<dt>‘<samp>-noomega</samp>’</dt>
-<dd><a name="index-_002dnoomega"></a>
-<a name="index-Omega-extensions"></a>
-<a name="index-pTeX-extensions"></a>
+<dd><span id="index-_002dnoomega"></span>
+<span id="index-Omega-extensions"></span>
+<span id="index-pTeX-extensions"></span>
<p>Disable the use of Omega extensions when interpreting DVI
files. By default, the additional opcodes ‘<samp>129</samp>’ and ‘<samp>134</samp>’
are recognized by Dvips as Omega or pTeX extensions and interpreted as
@@ -1248,8 +1202,8 @@
</p>
</dd>
<dt>‘<samp>-noptex</samp>’</dt>
-<dd><a name="index-_002dnoptex"></a>
-<a name="index-pTeX-extensions-1"></a>
+<dd><span id="index-_002dnoptex"></span>
+<span id="index-pTeX-extensions-1"></span>
<p>Disable the use of pTeX extensions when interpreting DVI files. By
default, the additional opcodes ‘<samp>130</samp>’ and ‘<samp>135</samp>’ are
recognized by Dvips as Omega extensions and interpreted as requests to
@@ -1263,13 +1217,13 @@
with the Omega or pTeX extensions, you can switch off the pTeX
extension by using ‘<samp>-noptex</samp>’, or both by using ‘<samp>-noomega</samp>’
(but please do send a bug report if you find such problems,
-see <a href="http://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>).
+see <a href="https://tug.org/texinfohtml/kpathsea.html#Bugs">Bugs</a> in <cite>Kpathsea</cite>).
</p>
</dd>
<dt>‘<samp>-o <var>name</var></samp>’</dt>
-<dd><a name="index-_002do-name"></a>
-<a name="index-output_002c-redirecting"></a>
-<a name="index-standard-output_002c-output-to"></a>
+<dd><span id="index-_002do-name"></span>
+<span id="index-output_002c-redirecting"></span>
+<span id="index-standard-output_002c-output-to"></span>
<p>Send output to the file <var>name</var>. If ‘<samp>-o</samp>’ is specified without
<var>name</var> (i.e., it is the last thing on the command line), the
default is ‘<samp><var>file</var>.ps</samp>’ where the input DVI file was
@@ -1276,12 +1230,12 @@
‘<samp><var>file</var>.dvi</samp>’. If ‘<samp>-o</samp>’ isn’t given at all, the
configuration file default is used.
</p>
-<a name="index-popen-for-output"></a>
-<a name="index-_002d-as-output-filename"></a>
-<a name="index-_0021-starting-output-filename"></a>
-<a name="index-_007c-starting-output-filename"></a>
-<a name="index-lpr-spooler_002c-MS_002dDOS-emulation"></a>
-<a name="index-spooling-to-lpr-on-MS_002dDOS"></a>
+<span id="index-popen-for-output"></span>
+<span id="index-_002d-as-output-filename"></span>
+<span id="index-_0021-starting-output-filename"></span>
+<span id="index-_007c-starting-output-filename"></span>
+<span id="index-lpr-spooler_002c-MS_002dDOS-emulation"></span>
+<span id="index-spooling-to-lpr-on-MS_002dDOS"></span>
<p>If <var>name</var> is ‘<samp>-</samp>’, output goes to standard output. If the first
character of <var>name</var> is ‘<samp>!</samp>’ or ‘<samp>|</samp>’, then the remainder will
be used as an argument to <code>popen</code>; thus, specifying ‘<samp>|lpr</samp>’ as
@@ -1296,9 +1250,9 @@
</p>
</dd>
<dt>‘<samp>-O <var>x-offset</var>,<var>y-offset</var></samp>’</dt>
-<dd><a name="index-_002dO-x_002doffset_002cy_002doffset"></a>
-<a name="index-offset-pages"></a>
-<a name="index-printer-offset"></a>
+<dd><span id="index-_002dO-x_002doffset_002cy_002doffset"></span>
+<span id="index-offset-pages"></span>
+<span id="index-printer-offset"></span>
<p>Move the origin by <var>x-offset</var>,<var>y-offset</var>, a comma-separated
pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). The origin of the page is shifted from the default position
(of one inch down, one inch to the right from the upper left corner of
@@ -1305,23 +1259,23 @@
the paper) by this amount. This is usually best specified in the
printer-specific configuration file.
</p>
-<a name="index-testpage_002etex"></a>
+<span id="index-testpage_002etex"></span>
<p>This is useful for a printer that consistently offsets output pages by a
certain amount. You can use the file <samp>testpage.tex</samp> to determine
the correct value for your printer. Be sure to do several runs with the
same <code>O</code> value—some printers vary widely from run to run.
</p>
-<a name="index-bop_002dhook_002c-and-offset-pages"></a>
+<span id="index-bop_002dhook_002c-and-offset-pages"></span>
<p>If your printer offsets every other page consistently, instead of every
page, your best recourse is to use ‘<samp>bop-hook</samp>’ (see <a href="#PostScript-hooks">PostScript hooks</a>).
</p>
</dd>
<dt>‘<samp>-p [=]<var>num</var></samp>’</dt>
-<dd><a name="index-_002dp-_005b_003d_005dnum"></a>
-<a name="index-first-page-printed"></a>
-<a name="index-page_002c-first-printed"></a>
-<a name="index-physical-page-number_002c-and-_002dp"></a>
-<a name="index-absolute-page-number_002c-and-_002dp"></a>
+<dd><span id="index-_002dp-_005b_003d_005dnum"></span>
+<span id="index-first-page-printed"></span>
+<span id="index-page_002c-first-printed"></span>
+<span id="index-physical-page-number_002c-and-_002dp"></span>
+<span id="index-absolute-page-number_002c-and-_002dp"></span>
<p>The first page printed will be the first one numbered <var>num</var>. Default
is the first page in the document. If <var>num</var> is prefixed by an
equals sign, then it (and the argument to the ‘<samp>-l</samp>’ option, if
@@ -1332,9 +1286,9 @@
</p>
</dd>
<dt>‘<samp>-pp <var>first</var>-<var>last</var></samp>’</dt>
-<dd><a name="index-_002dpp-first_002dlast"></a>
-<a name="index-page-range"></a>
-<a name="index-_002dpp-range"></a>
+<dd><span id="index-_002dpp-first_002dlast"></span>
+<span id="index-page-range"></span>
+<span id="index-_002dpp-range"></span>
<p>Print pages <var>first</var> through <var>last</var>; equivalent to ‘<samp>-p
<var>first</var> -l <var>last</var></samp>’, except that multiple ‘<samp>-pp</samp>’ options
accumulate, unlike ‘<samp>-p</samp>’ and ‘<samp>-l</samp>’. The ‘<samp>-</samp>’ separator can
@@ -1342,8 +1296,8 @@
</p>
</dd>
<dt>‘<samp>-P <var>printer</var></samp>’</dt>
-<dd><a name="index-_002dP-printer"></a>
-<a name="index-config_002eps"></a>
+<dd><span id="index-_002dP-printer"></span>
+<span id="index-config_002eps"></span>
<p>Read the configuration file <samp>config.<var>printer</var></samp>
(<samp><var>printer</var>.cfg</samp> on MS-DOS), which typically sets the output
name (most likely ‘<samp>o |lpr -P<var>printer</var></samp>’), resolution, Metafont
@@ -1366,26 +1320,26 @@
</p>
</dd>
<dt>‘<samp>-q*</samp>’</dt>
-<dd><a name="index-_002dq"></a>
-<a name="index-quiet-operation"></a>
-<a name="index-silent-operation"></a>
-<a name="index-warnings_002c-suppressing"></a>
+<dd><span id="index-_002dq"></span>
+<span id="index-quiet-operation"></span>
+<span id="index-silent-operation"></span>
+<span id="index-warnings_002c-suppressing"></span>
<p>Run quietly. Don’t chatter about pages converted, etc.,
and report no warnings (only errors) to standard error.
</p>
</dd>
<dt>‘<samp>-r*</samp>’</dt>
-<dd><a name="index-_002dr"></a>
-<a name="index-reverse-pagination"></a>
+<dd><span id="index-_002dr"></span>
+<span id="index-reverse-pagination"></span>
<p>Output pages in reverse order. By default, page 1 is output first.
</p>
</dd>
<dt>‘<samp>-R</samp>’</dt>
-<dd><a name="index-_002dR"></a>
-<a name="index-security"></a>
-<a name="index-shell-command-execution_002c-disabling"></a>
-<a name="index-absolute-filenames_002c-disabling"></a>
-<a name="index-_002e_002e_002drelative-filenames"></a>
+<dd><span id="index-_002dR"></span>
+<span id="index-security"></span>
+<span id="index-shell-command-execution_002c-disabling"></span>
+<span id="index-absolute-filenames_002c-disabling"></span>
+<span id="index-_002e_002e_002drelative-filenames"></span>
<p>Run securely. ‘<samp>-R2</samp>’ disables both shell command execution in
<code>\special</code> (via ‘<samp>`</samp>’, see <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>)
and config files (via the ‘<samp>E</samp>’ option, see <a href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute or <samp>..</samp>-relative
@@ -1394,8 +1348,8 @@
</p>
</dd>
<dt>‘<samp>-s*</samp>’</dt>
-<dd><a name="index-_002ds"></a>
-<a name="index-save_002frestore_002c-generating-global"></a>
+<dd><span id="index-_002ds"></span>
+<span id="index-save_002frestore_002c-generating-global"></span>
<p>Enclose the output in a global save/restore pair. This causes the file
to not be truly conformant, and is thus not recommended, but is useful
if you are driving a deficient printer directly and thus don’t care too
@@ -1403,7 +1357,7 @@
</p>
</dd>
<dt>‘<samp>-S <var>num</var></samp>’</dt>
-<dd><a name="index-_002dS-num"></a>
+<dd><span id="index-_002dS-num"></span>
<p>Set the maximum number of pages in each ‘section’. This option is most
commonly used with the ‘<samp>-i</samp>’ option; see its description above for
more information.
@@ -1410,16 +1364,16 @@
</p>
</dd>
<dt>‘<samp>-t <var>papertype</var></samp>’</dt>
-<dd><a name="index-_002dt-papertype"></a>
-<a name="index-paper-type"></a>
-<a name="index-media"></a>
-<a name="index-letter-papertype"></a>
-<a name="index-legal-papertype"></a>
-<a name="index-ledger-papertype"></a>
-<a name="index-a4-papertype"></a>
-<a name="index-a3-papertype"></a>
-<a name="index-landscape-papertype"></a>
-<a name="index-papersize-special_002c-and-no-_002dt"></a>
+<dd><span id="index-_002dt-papertype"></span>
+<span id="index-paper-type"></span>
+<span id="index-media"></span>
+<span id="index-letter-papertype"></span>
+<span id="index-legal-papertype"></span>
+<span id="index-ledger-papertype"></span>
+<span id="index-a4-papertype"></span>
+<span id="index-a3-papertype"></span>
+<span id="index-landscape-papertype"></span>
+<span id="index-papersize-special_002c-and-no-_002dt"></span>
<p>Set the paper type to <var>papertype</var>, usually defined in one of the
configuration files, along with the appropriate PostScript code to
select it (see <a href="#Config-file-paper-sizes">Config file paper sizes</a>).
@@ -1443,7 +1397,7 @@
</dd>
<dt>‘<samp>-T <var>hsize</var>,<var>vsize</var></samp>’</dt>
-<dd><a name="index-_002dT-hsize_002cvsize"></a>
+<dd><span id="index-_002dT-hsize_002cvsize"></span>
<p>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated
pair of dimensions such as ‘<samp>.1in,-.3cm</samp>’ (see <a href="#papersize-special">‘<samp>papersize</samp>’ special</a>). It overrides any paper size special in the DVI file. Be
careful, as the paper size will stick to a predefined size if there is
@@ -1451,9 +1405,9 @@
</p>
</dd>
<dt>‘<samp>-u <var>psmapfile</var></samp>’</dt>
-<dd><a name="index-_002du-psmapfile"></a>
-<a name="index-PostScript-font-alias-file"></a>
-<a name="index-resident-fonts_002c-different-in-different-printers"></a>
+<dd><span id="index-_002du-psmapfile"></span>
+<span id="index-PostScript-font-alias-file"></span>
+<span id="index-resident-fonts_002c-different-in-different-printers"></span>
<p>Set <var>psmapfile</var> to be the file that dvips uses for looking up
PostScript font aliases. If <var>psmapfile</var> begins with a ‘<samp>+</samp>’
character, then the rest of the name is used as the name of the map file,
@@ -1463,8 +1417,8 @@
</p>
</dd>
<dt>‘<samp>-U*</samp>’</dt>
-<dd><a name="index-_002dU"></a>
-<a name="index-Xerox-4045"></a>
+<dd><span id="index-_002dU"></span>
+<span id="index-Xerox-4045"></span>
<p>Disable a PostScript virtual memory-saving optimization that stores the
character metric information in the same string that is used to store
the bitmap information. This is only necessary when driving the Xerox
@@ -1474,16 +1428,16 @@
</p>
</dd>
<dt>‘<samp>-v</samp>’</dt>
-<dd><a name="index-_002dv"></a>
+<dd><span id="index-_002dv"></span>
<p>Print the dvips version number and exit.
</p>
</dd>
<dt>‘<samp>-V*</samp>’</dt>
-<dd><a name="index-_002dV"></a>
+<dd><span id="index-_002dV"></span>
<p>Download non-resident PostScript fonts as bitmaps. This requires use
-<a name="index-mtpk"></a>
-<a name="index-gsftopk"></a>
-<a name="index-pstopk"></a>
+<span id="index-mtpk"></span>
+<span id="index-gsftopk"></span>
+<span id="index-pstopk"></span>
of <code>mtpk</code> or <code>gsftopk</code> or <code>pstopk</code> or some combination
thereof to generate the required bitmap fonts; these programs are
supplied with Dvips. The bitmap must be put into <samp>psfonts.map</samp> as
@@ -1494,8 +1448,8 @@
</dd>
<dt>‘<samp>-x <var>num</var></samp>’</dt>
-<dd><a name="index-_002dx-num"></a>
-<a name="index-magnification_002c-overriding-DVI"></a>
+<dd><span id="index-_002dx-num"></span>
+<span id="index-magnification_002c-overriding-DVI"></span>
<p>Set the magnification ratio to <em><var>num</var>/1000</em>. Overrides
the magnification specified in the DVI file. Must be between 10 and
100000. It is recommended that you use standard magstep values (1095,
@@ -1505,13 +1459,13 @@
</p>
</dd>
<dt>‘<samp>-X <var>num</var></samp>’</dt>
-<dd><a name="index-_002dX-num"></a>
-<a name="index-resolution"></a>
+<dd><span id="index-_002dX-num"></span>
+<span id="index-resolution"></span>
<p>Set the horizontal resolution in dots per inch to <var>num</var>.
</p>
</dd>
<dt>‘<samp>-y <var>num</var></samp>’</dt>
-<dd><a name="index-magnification_002c-vertical"></a>
+<dd><span id="index-magnification_002c-vertical"></span>
<p>Set the magnification ratio to <em><var>num</var>/1000</em> times the
magnification specified in the DVI file. See
‘<samp>-x</samp>’ above.
@@ -1518,17 +1472,17 @@
</p>
</dd>
<dt>‘<samp>-Y <var>num</var></samp>’</dt>
-<dd><a name="index-_002dY-num"></a>
+<dd><span id="index-_002dY-num"></span>
<p>Set the vertical resolution in dots per inch to <var>num.</var>
-<a name="index-resolution-1"></a>
+<span id="index-resolution-1"></span>
</p>
</dd>
<dt>‘<samp>-z*</samp>’</dt>
-<dd><a name="index-_002dz-for-recognizing-hyperdvi"></a>
-<a name="index-hyperdvi-extensions_002c-enabling"></a>
-<a name="index-distillation_002c-and-_002dz"></a>
-<a name="index-PDF-files_002c-option-for"></a>
-<a name="index-html-specials_002c-and-_002dz"></a>
+<dd><span id="index-_002dz-for-recognizing-hyperdvi"></span>
+<span id="index-hyperdvi-extensions_002c-enabling"></span>
+<span id="index-distillation_002c-and-_002dz"></span>
+<span id="index-PDF-files_002c-option-for"></span>
+<span id="index-html-specials_002c-and-_002dz"></span>
<p>Pass ‘<samp>html</samp>’ hyperdvi specials through to the output for eventual
distillation into PDF. This is not enabled by default to avoid
including the header files unnecessarily, and use of temporary files in
@@ -1536,8 +1490,8 @@
</p>
</dd>
<dt>‘<samp>-Z*</samp>’</dt>
-<dd><a name="index-_002dZ-for-compressing-bitmap-fonts"></a>
-<a name="index-compressing-bitmap-fonts"></a>
+<dd><span id="index-_002dZ-for-compressing-bitmap-fonts"></span>
+<span id="index-compressing-bitmap-fonts"></span>
<p>Compress bitmap fonts in the output file, thereby reducing the size of
what gets downloaded. Especially useful at high resolutions or when
very large fonts are used. May slow down printing, especially on early
@@ -1549,15 +1503,13 @@
<hr>
-<a name="Environment-variables"></a>
-<div class="header">
+<span id="Environment-variables"></span><div class="header">
<p>
Next: <a href="#Config-files" accesskey="n" rel="next">Config files</a>, Previous: <a href="#Command_002dline-options" accesskey="p" rel="prev">Command-line options</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Environment-variables-1"></a>
-<h3 class="section">3.3 Environment variables</h3>
+<span id="Environment-variables-1"></span><h3 class="section">3.3 Environment variables</h3>
-<a name="index-environment-variables"></a>
+<span id="index-environment-variables"></span>
<p>Dvips looks for many environment variables, to define search paths and
other things. The path variables are read as needed, after all
@@ -1565,7 +1517,7 @@
configuration files. (Except for <code>TEXCONFIG</code>, which defines where
the configuration files themselves are found.)
</p>
-<p>See <a href="http://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of
+<p>See <a href="https://tug.org/texinfohtml/kpathsea.html#Path-specifications">Path specifications</a> in <cite>Kpathsea</cite>, for details of
interpretation of path and other environment variables common to all
Kpathsea-using programs. Only the environment variables specific to
Dvips are mentioned here.
@@ -1572,28 +1524,28 @@
</p>
<dl compact="compact">
<dt><code>DVIPSDEBUG</code>
-<a name="index-DVIPSDEBUG"></a>
+<span id="index-DVIPSDEBUG"></span>
</dt>
-<dd><a name="index-KPATHSEA_005fDEBUG"></a>
+<dd><span id="index-KPATHSEA_005fDEBUG"></span>
<p>Write the absolute path names of any configuration or map files to
standard output, for debugging. This isn’t done by default because
these files are read even before the banner is printed. For
voluminous additional debugging, set the environment variable
<code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’
-(see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is
+(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). (If <code>KPATHSEA_DEBUG</code> is
set to any value, it automatically turns on <code>DVIPSDEBUG</code>.)
</p>
</dd>
<dt><code>DVIPSFONTS</code>
-<a name="index-DVIPSFONTS"></a>
+<span id="index-DVIPSFONTS"></span>
</dt>
<dd><p>Default path to search for all fonts. Overrides all the font path
-config file options and other environment variables (see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported
+config file options and other environment variables (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported
file formats</a> in <cite>Kpathsea</cite>).
</p>
</dd>
<dt><code>DVIPSHEADERS</code>
-<a name="index-DVIPSHEADERS"></a>
+<span id="index-DVIPSHEADERS"></span>
</dt>
<dd><p>Default path to search for PostScript header files. Overrides the ‘<samp>H</samp>’
config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>).
@@ -1600,17 +1552,17 @@
</p>
</dd>
<dt><code>DVIPSMAKEPK</code>
-<a name="index-DVIPSMAKEPK"></a>
+<span id="index-DVIPSMAKEPK"></span>
</dt>
-<dd><a name="index-mktexpk_002c-changing-name"></a>
+<dd><span id="index-mktexpk_002c-changing-name"></span>
<p>Overrides ‘<samp>mktexpk</samp>’ as the name of the program to invoke to
create missing PK fonts. You can change the arguments passed to the
<code>mktexpk</code> program with the <code>MAKETEXPK</code> environment
-variable; see <a href="http://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>.
+variable; see <a href="https://tug.org/texinfohtml/kpathsea.html#MakeTeX-script-arguments">MakeTeX script arguments</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt><code>DVIPSRC</code>
-<a name="index-DVIPSRC"></a>
+<span id="index-DVIPSRC"></span>
</dt>
<dd><p>Specifies the name of the startup file (see <a href="#Configuration-file-searching">Configuration file searching</a>) which is read after <samp>config.ps</samp> but before any
printer-specific configuration files.
@@ -1617,15 +1569,15 @@
</p>
</dd>
<dt><code>DVIPSSIZES</code>
-<a name="index-DVIPSSIZES"></a>
+<span id="index-DVIPSSIZES"></span>
</dt>
-<dd><a name="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></a>
+<dd><span id="index-last_002dresort-font-scaling_002c-with-DVIPSSIZES"></span>
<p>Last-resort sizes for scaling of unfound fonts. Overrides the ‘<samp>R</samp>’
definition in config files (see <a href="#Configuration-file-commands">Configuration file commands</a>).
</p>
</dd>
<dt><code>PRINTER</code>
-<a name="index-PRINTER"></a>
+<span id="index-PRINTER"></span>
</dt>
<dd><p>Determine the default printer configuration file. (Dvips itself does
not use <code>PRINTER</code> to determine the output destination in any way.)
@@ -1632,9 +1584,9 @@
</p>
</dd>
<dt><code>TEXCONFIG</code>
-<a name="index-TEXCONFIG"></a>
+<span id="index-TEXCONFIG"></span>
</dt>
-<dd><a name="index-configuration-file-path"></a>
+<dd><span id="index-configuration-file-path"></span>
<p>Path to search for Dvips’ <samp>config.<var>printer</var></samp> configuration
files, including the base <samp>config.ps</samp>. Using this single
environment variable, you can override everything else. (The
@@ -1644,11 +1596,11 @@
</p>
</dd>
<dt><code>TEXPICTS</code>
-<a name="index-TEXPICTS"></a>
+<span id="index-TEXPICTS"></span>
</dt>
<dd><p>Path to search for included graphics files. Overrides the ‘<samp>S</samp>’
config file option (see <a href="#Configuration-file-commands">Configuration file commands</a>). If not set,
-<code>TEXINPUTS</code> is looked for. See <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+<code>TEXINPUTS</code> is looked for. See <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
</p>
</dd>
</dl>
@@ -1655,44 +1607,40 @@
<hr>
-<a name="Config-files"></a>
-<div class="header">
+<span id="Config-files"></span><div class="header">
<p>
Previous: <a href="#Environment-variables" accesskey="p" rel="prev">Environment variables</a>, Up: <a href="#Invoking-Dvips" accesskey="u" rel="up">Invoking Dvips</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Dvips-configuration-files"></a>
-<h3 class="section">3.4 Dvips configuration files</h3>
+<span id="Dvips-configuration-files"></span><h3 class="section">3.4 Dvips configuration files</h3>
-<a name="index-configuration-files"></a>
+<span id="index-configuration-files"></span>
<p>This section describes in detail the Dvips-specific <samp>config.*</samp>
device configuration files (called <samp>*.cfg</samp> on MS-DOS), which
override the <samp>texmf.cnf</samp>
configuration files generic to Kpathsea which Dvips also reads
-(see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
+(see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>).
</p>
<p>For information about installing these files, including a prototype file
you can copy, see <a href="#config_002eps-installation">config.ps installation</a>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a>:</td><td> </td><td align="left" valign="top">Where config.* files are searched for.
+<tr><td align="left" valign="top">• <a href="#Configuration-file-searching" accesskey="1">Configuration file searching</a></td><td> </td><td align="left" valign="top">Where config.* files are searched for.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a>:</td><td> </td><td align="left" valign="top">What can go in a config.* file.
+<tr><td align="left" valign="top">• <a href="#Configuration-file-commands" accesskey="2">Configuration file commands</a></td><td> </td><td align="left" valign="top">What can go in a config.* file.
</td></tr>
</table>
<hr>
-<a name="Configuration-file-searching"></a>
-<div class="header">
+<span id="Configuration-file-searching"></span><div class="header">
<p>
Next: <a href="#Configuration-file-commands" accesskey="n" rel="next">Configuration file commands</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Config files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configuration-file-searching-1"></a>
-<h4 class="subsection">3.4.1 Configuration file searching</h4>
+<span id="Configuration-file-searching-1"></span><h4 class="subsection">3.4.1 Configuration file searching</h4>
-<a name="index-configuration-file-searching"></a>
-<a name="index-searching-config-files_002c-order-of"></a>
+<span id="index-configuration-file-searching"></span>
+<span id="index-searching-config-files_002c-order-of"></span>
<p>The Dvips program loads many different configuration files, so that
parameters can be set globally across the system, on a per-device basis,
@@ -1699,12 +1647,12 @@
or individually by each user.
</p>
<ol>
-<li> <a name="index-config_002eps_002c-searched-for"></a>
+<li> <span id="index-config_002eps_002c-searched-for"></span>
Dvips first reads (if it exists) <samp>config.ps</samp>; it is searched for
along the path for Dvips configuration files, as described in
-<a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+<a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
-</li><li> <a name="index-_002edvipsrc_002c-searched-for"></a>
+</li><li> <span id="index-_002edvipsrc_002c-searched-for"></span>
A user-specific startup file is loaded, so individual users can override
any options set in the global file. The environment variable
<code>DVIPSRC</code>, if defined, is used as the specification of the startup
@@ -1714,10 +1662,10 @@
On MS-DOS and MS-Windows, where users generally don’t have their private
directories, the startup file is called <samp>dvips.ini</samp> and it is
searched for along the path for Dvips configuration files (as described
-in <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are
+in <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.); users are
expected to set this path as they see fit for their taste.
-</li><li> <a name="index-_002dPprinter_002c-and-config-file-searching"></a>
+</li><li> <span id="index-_002dPprinter_002c-and-config-file-searching"></span>
The command line is read and parsed: if the ‘<samp>-P<var>device</var></samp>’ option
is encountered, at that point <samp>config.<var>device</var></samp> is loaded.
Thus, the printer configuration file can override anything in the
@@ -1727,7 +1675,7 @@
<samp><var>device</var>.cfg</samp>, since DOS doesn’t allow more than 3 characters
after the dot in filenames.)
-</li><li> <a name="index-PRINTER_002c-and-config-file-searching"></a>
+</li><li> <span id="index-PRINTER_002c-and-config-file-searching"></span>
If no ‘<samp>-P</samp>’ option was specified, and also the ‘<samp>-o</samp>’ and
‘<samp>-f</samp>’ command line options were not used, Dvips checks the
environment variable <code>PRINTER</code>. If it exists, then
@@ -1771,16 +1719,14 @@
</p>
<hr>
-<a name="Configuration-file-commands"></a>
-<div class="header">
+<span id="Configuration-file-commands"></span><div class="header">
<p>
Previous: <a href="#Configuration-file-searching" accesskey="p" rel="prev">Configuration file searching</a>, Up: <a href="#Config-files" accesskey="u" rel="up">Config files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configuration-file-commands-1"></a>
-<h4 class="subsection">3.4.2 Configuration file commands</h4>
+<span id="Configuration-file-commands-1"></span><h4 class="subsection">3.4.2 Configuration file commands</h4>
-<a name="index-configuration-file-options"></a>
-<a name="index-Dvips-configuration-file-options"></a>
+<span id="index-configuration-file-options"></span>
+<span id="index-Dvips-configuration-file-options"></span>
<p>Most of the configuration file commands are similar to corresponding
command line options, but there are a few exceptions. When they are the
@@ -1789,8 +1735,8 @@
<p>As with command line options, many may be turned off by suffixing the
letter with a zero (‘<samp>0</samp>’).
</p>
-<a name="index-comments_002c-in-configuration-files"></a>
-<a name="index-continuation-lines_002c-not-supported"></a>
+<span id="index-comments_002c-in-configuration-files"></span>
+<span id="index-continuation-lines_002c-not-supported"></span>
<p>Within a configuration file, empty lines, and lines starting with a
space, asterisk, equal sign, percent sign, or pound sign are ignored.
There is no provision for continuation lines.
@@ -1797,41 +1743,41 @@
</p>
<dl compact="compact">
<dt>‘<samp>@ <var>name hsize vsize</var></samp>’</dt>
-<dd><a name="index-_0040-config-command-_0028define-paper-sizes_0029"></a>
+<dd><span id="index-_0040-config-command-_0028define-paper-sizes_0029"></span>
<p>Define paper sizes. See <a href="#Config-file-paper-sizes">Config file paper sizes</a>.
</p>
</dd>
<dt>‘<samp>a*</samp>’</dt>
-<dd><a name="index-a-config-command-_0028conserve-memory_0029"></a>
+<dd><span id="index-a-config-command-_0028conserve-memory_0029"></span>
<p>Memory conservation. Same as ‘<samp>-a</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>b <var>#copies</var></samp>’</dt>
-<dd><a name="index-b-config-command-_0028_0023copies_0029"></a>
+<dd><span id="index-b-config-command-_0028_0023copies_0029"></span>
<p>Multiple copies. Same as ‘<samp>-b</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>c <var>filename</var></samp>’</dt>
-<dd><a name="index-c-config-command-_0028include-another-config-file_0029"></a>
+<dd><span id="index-c-config-command-_0028include-another-config-file_0029"></span>
<p>Include <var>filename</var> as an additional configuration file, read
immediately.
</p>
</dd>
<dt>‘<samp>D <var>dpi</var></samp>’</dt>
-<dd><a name="index-D-config-command-_0028dpi_0029"></a>
+<dd><span id="index-D-config-command-_0028dpi_0029"></span>
<p>Output resolution. Same as ‘<samp>-D</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>e <var>num</var></samp>’</dt>
-<dd><a name="index-e-config-command-_0028maxdrift_0029"></a>
+<dd><span id="index-e-config-command-_0028maxdrift_0029"></span>
<p>Max drift. Same as ‘<samp>-e</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>E <var>command</var></samp>’</dt>
-<dd><a name="index-E-config-command-_0028shell-escape_0029"></a>
-<a name="index-system-in-config-file"></a>
-<a name="index-datestamp_002c-in-output"></a>
-<a name="index-shell-escape_002c-in-config-file"></a>
+<dd><span id="index-E-config-command-_0028shell-escape_0029"></span>
+<span id="index-system-in-config-file"></span>
+<span id="index-datestamp_002c-in-output"></span>
+<span id="index-shell-escape_002c-in-config-file"></span>
<p>Executes the command listed with <code>system</code>(3); can be used to get
the current date into a header file for inclusion, for instance.
Possibly dangerous; this may be disabled, in which case a warning will
@@ -1840,56 +1786,56 @@
</dd>
<dt>‘<samp>f*</samp>’</dt>
<dt>‘<samp>F</samp>’</dt>
-<dd><a name="index-f-config-command-_0028filter_0029"></a>
-<a name="index-F-config-command-_0028filter_0029"></a>
+<dd><span id="index-f-config-command-_0028filter_0029"></span>
+<span id="index-F-config-command-_0028filter_0029"></span>
<p>Run as a filter. Same as ‘<samp>-f</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>G*</samp>’</dt>
-<dd><a name="index-G-config-command-_0028character-shifting_0029"></a>
+<dd><span id="index-G-config-command-_0028character-shifting_0029"></span>
<p>Shift low-numbered characters; obsolete. Same as ‘<samp>-G</samp>’,
see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>h <var>header</var></samp>’</dt>
-<dd><a name="index-h-config-command-_0028download-additional-header_0029"></a>
+<dd><span id="index-h-config-command-_0028download-additional-header_0029"></span>
<p>Prepend <var>header</var> to output. Same as ‘<samp>h-</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>H <var>path</var></samp>’</dt>
-<dd><a name="index-H-config-command-_0028PostScript-header-path_0029"></a>
-<a name="index-header-path_002c-defining"></a>
-<a name="index-DVIPSHEADERS_002c-overrides-H"></a>
+<dd><span id="index-H-config-command-_0028PostScript-header-path_0029"></span>
+<span id="index-header-path_002c-defining"></span>
+<span id="index-DVIPSHEADERS_002c-overrides-H"></span>
<p>Use <var>path</var> to search for PostScript header files. The environment
variable <code>DVIPSHEADERS</code> overrides this.
</p>
</dd>
<dt>‘<samp>i <var>n</var></samp>’</dt>
-<dd><a name="index-i-config-command-_0028pages_002fsection_0029"></a>
+<dd><span id="index-i-config-command-_0028pages_002fsection_0029"></span>
<p>Make multiple output files. Same as ‘<samp>-i -S <var>n</var></samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>j*</samp>’</dt>
-<dd><a name="index-j-config-command-_0028partial-font-downloading_0029"></a>
+<dd><span id="index-j-config-command-_0028partial-font-downloading_0029"></span>
<p>Partially download Type 1 fonts. Same as ‘<samp>-j</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>K*</samp>’</dt>
-<dd><a name="index-K-config-command-_0028comment-removal_0029"></a>
+<dd><span id="index-K-config-command-_0028comment-removal_0029"></span>
<p>Remove comments from included PostScript files. Same as ‘<samp>-K</samp>’,
see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>L*</samp>’</dt>
-<dd><a name="index-L-config-command-_0028last-paper-size-wins_0029"></a>
+<dd><span id="index-L-config-command-_0028last-paper-size-wins_0029"></span>
<p>If zero, the first paper size specified is effective, else the last.
Same as ‘<samp>-L</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>m <var>num</var></samp>’</dt>
-<dd><a name="index-m-config-command-_0028available-memory_0029"></a>
-<a name="index-memory-available"></a>
-<a name="index-printer-memory"></a>
+<dd><span id="index-m-config-command-_0028available-memory_0029"></span>
+<span id="index-memory-available"></span>
+<span id="index-printer-memory"></span>
<p>Declare <var>num</var> as the memory available for fonts and strings in the
printer. The compile-time default is 180000, but this is typically
overridden by <samp>config.ps</samp> or other configuration files. This
@@ -1921,12 +1867,12 @@
</p>
</dd>
<dt>‘<samp>M <var>mode</var></samp>’</dt>
-<dd><a name="index-M-config-command-_0028mf-mode_0029"></a>
+<dd><span id="index-M-config-command-_0028mf-mode_0029"></span>
<p>Metafont mode. Same as ‘<samp>-mode</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>N*</samp>’</dt>
-<dd><a name="index-N--config-command-_0028disable-EPS_0029"></a>
+<dd><span id="index-N--config-command-_0028disable-EPS_0029"></span>
<p>Disable structured comments. Beware: This also turns off displaying
page numbers or changing to specific pagenumbers in PostScript viewers.
Same as ‘<samp>-N</samp>’, see <a href="#Option-details">Option details</a>.
@@ -1933,8 +1879,8 @@
</p>
</dd>
<dt>‘<samp>o <var>name</var></samp>’</dt>
-<dd><a name="index-o-config-command-_0028output-destination_0029"></a>
-<a name="index-output-file_002c-setting"></a>
+<dd><span id="index-o-config-command-_0028output-destination_0029"></span>
+<span id="index-output-file_002c-setting"></span>
<p>Send output to <var>name</var>. Same as ‘<samp>-o</samp>’, see <a href="#Option-details">Option details</a>.
In the file <samp>config.foo</samp>, a setting like this is probably
appropriate:
@@ -1947,15 +1893,15 @@
</p>
</dd>
<dt>‘<samp>O <var>xoff</var>,<var>yoff</var></samp>’</dt>
-<dd><a name="index-O-config-command-_0028page-offsets_0029"></a>
+<dd><span id="index-O-config-command-_0028page-offsets_0029"></span>
<p>Origin offset. Same as ‘<samp>-O</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>p <span class="roman">[+]</span><var>name</var></samp>’</dt>
-<dd><a name="index-p-config-command-_0028font-aliases_0029"></a>
-<a name="index-PostScript-font-alias-file-1"></a>
-<a name="index-resident-fonts_002c-different-in-different-printers-1"></a>
-<a name="index-_002bpsmapfile"></a>
+<dd><span id="index-p-config-command-_0028font-aliases_0029"></span>
+<span id="index-PostScript-font-alias-file-1"></span>
+<span id="index-resident-fonts_002c-different-in-different-printers-1"></span>
+<span id="index-_002bpsmapfile"></span>
<p>Examine <var>name</var> for PostScript font aliases. Default is
<samp>psfonts.map</samp>. This option allows you to specify different resident
fonts that different printers may have. If <var>name</var> starts with a
@@ -1966,33 +1912,33 @@
</p>
</dd>
<dt>‘<samp>P <var>path</var></samp>’</dt>
-<dd><a name="index-P-config-command-_0028PK-path_0029"></a>
-<a name="index-PKFONTS_002c-overrides-P"></a>
-<a name="index-TEXPKS_002c-overrides-P"></a>
-<a name="index-GLYPHFONTS_002c-overrides-P"></a>
-<a name="index-TEXFONTS_002c-overrides-P"></a>
+<dd><span id="index-P-config-command-_0028PK-path_0029"></span>
+<span id="index-PKFONTS_002c-overrides-P"></span>
+<span id="index-TEXPKS_002c-overrides-P"></span>
+<span id="index-GLYPHFONTS_002c-overrides-P"></span>
+<span id="index-TEXFONTS_002c-overrides-P"></span>
<p>Use <var>path</var> to search for bitmap PK font files is <var>path</var>. The
<code>PKFONTS</code>, <code>TEXPKS</code>, <code>GLYPHFONTS</code>, and <code>TEXFONTS</code>
-environment variables override this. See <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
+environment variables override this. See <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>.
</p>
</dd>
<dt>‘<samp>q*</samp>’</dt>
<dt>‘<samp>Q</samp>’</dt>
-<dd><a name="index-q-config-command-_0028quiet_0029"></a>
-<a name="index-Q-config-command-_0028quiet_0029"></a>
+<dd><span id="index-q-config-command-_0028quiet_0029"></span>
+<span id="index-Q-config-command-_0028quiet_0029"></span>
<p>Run quietly. Same as ‘<samp>-q</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>r*</samp>’</dt>
-<dd><a name="index-r-config-command-_0028page-reversal_0029"></a>
+<dd><span id="index-r-config-command-_0028page-reversal_0029"></span>
<p>Page reversal. Same as ‘<samp>-r</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>R <var>num1 num2 …</var></samp>’</dt>
-<dd><a name="index-R-config-command-_0028fallback-resolution_0029"></a>
-<a name="index-fallback-resolutions"></a>
-<a name="index-default-resolutions"></a>
-<a name="index-last_002dresort-scaling_002c-with-R"></a>
+<dd><span id="index-R-config-command-_0028fallback-resolution_0029"></span>
+<span id="index-fallback-resolutions"></span>
+<span id="index-default-resolutions"></span>
+<span id="index-last_002dresort-scaling_002c-with-R"></span>
<p>Define the list of default resolutions for PK fonts. If a font size
actually used in a document is not available and cannot be created,
Dvips will scale the font found at the closest of these resolutions to
@@ -2005,12 +1951,12 @@
scale a font up than down; scaling down can obliterate small features in
the character shape.
</p>
-<a name="index-DVIPSSIZES_002c-overrides-R"></a>
-<a name="index-TEXSIZES_002c-overrides-R"></a>
+<span id="index-DVIPSSIZES_002c-overrides-R"></span>
+<span id="index-TEXSIZES_002c-overrides-R"></span>
<p>The environment and config file values ‘<samp>DVIPSSIZES</samp>’ or
‘<samp>TEXSIZES</samp>’ override this configuration file setting.
</p>
-<a name="index-default_005ftexsizes-Make-variable"></a>
+<span id="index-default_005ftexsizes-Make-variable"></span>
<p>If no ‘<samp>R</samp>’ settings or environment variables are specified, a list
compiled in during installation is used. This default list is defined by
the Makefile variable ‘<samp>default_texsizes</samp>’, defined in the file
@@ -2018,14 +1964,14 @@
</p>
</dd>
<dt>‘<samp>s*</samp>’</dt>
-<dd><a name="index-s-config-command-_0028global-save_002frestore_0029"></a>
+<dd><span id="index-s-config-command-_0028global-save_002frestore_0029"></span>
<p>Output global save/restore. Same as ‘<samp>-s</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>S <var>path</var></samp>’</dt>
-<dd><a name="index-S-config-command-_0028pict-path_0029"></a>
-<a name="index-TEXPICTS_002c-overrides-S"></a>
-<a name="index-TEXINPUTS_002c-overrides-S"></a>
+<dd><span id="index-S-config-command-_0028pict-path_0029"></span>
+<span id="index-TEXPICTS_002c-overrides-S"></span>
+<span id="index-TEXINPUTS_002c-overrides-S"></span>
<p>Use <var>path</var> to search for special illustrations (Encapsulated
PostScript files or psfiles). The <code>TEXPICTS</code> and then
<code>TEXINPUTS</code> environment variables override this.
@@ -2032,9 +1978,9 @@
</p>
</dd>
<dt>‘<samp>T <var>path</var></samp>’</dt>
-<dd><a name="index-T-config-command-_0028TFM-path_0029"></a>
-<a name="index-TFMFONTS_002c-overrides-T"></a>
-<a name="index-TEXFONTS_002c-overrides-T"></a>
+<dd><span id="index-T-config-command-_0028TFM-path_0029"></span>
+<span id="index-TFMFONTS_002c-overrides-T"></span>
+<span id="index-TEXFONTS_002c-overrides-T"></span>
<p>Use <var>path</var> to search for TFM files. The <code>TFMFONTS</code> and then
<code>TEXFONTS</code> environment variables overrides this. This path is used
for resident fonts and fonts that can’t otherwise be found.
@@ -2041,14 +1987,14 @@
</p>
</dd>
<dt>‘<samp>U*</samp>’</dt>
-<dd><a name="index-U-config-command-_0028Xerox-4045_0029"></a>
+<dd><span id="index-U-config-command-_0028Xerox-4045_0029"></span>
<p>Work around bug in Xerox 4045 printer. Same as ‘<samp>-U</samp>’, see <a href="#Option-details">Option details</a>.
</p>
</dd>
<dt>‘<samp>V <var>path</var></samp>’</dt>
-<dd><a name="index-V-config-command-_0028vf-path_0029"></a>
-<a name="index-virtual-font-path"></a>
-<a name="index-device-dependency_002c-and-virtual-fonts"></a>
+<dd><span id="index-V-config-command-_0028vf-path_0029"></span>
+<span id="index-virtual-font-path"></span>
+<span id="index-device-dependency_002c-and-virtual-fonts"></span>
<p>Use <var>path</var> to search for virtual font files. This may be
device-dependent if you use virtual fonts to simulate actual fonts on
different devices.
@@ -2055,8 +2001,8 @@
</p>
</dd>
<dt>‘<samp>W <span class="roman">[<var>string</var>]</span></samp>’</dt>
-<dd><a name="index-W-config-command-_0028emit-warning_0029"></a>
-<a name="index-warning-messages_002c-defining"></a>
+<dd><span id="index-W-config-command-_0028emit-warning_0029"></span>
+<span id="index-warning-messages_002c-defining"></span>
<p>If <var>string</var> is supplied, write it to standard error after reading
all the configuration files; with no <var>string</var>, cancel any previous
‘<samp>W</samp>’ message. This is useful in the default configuration file to
@@ -2065,22 +2011,22 @@
</p>
</dd>
<dt>‘<samp>X <var>num</var></samp>’</dt>
-<dd><a name="index-X-config-command-_0028horizontal-resolution_0029"></a>
+<dd><span id="index-X-config-command-_0028horizontal-resolution_0029"></span>
<p>Horizontal resolution. Same as ‘<samp>-X</samp>’ (see <a href="#Option-details">Option details</a>).
</p>
</dd>
<dt>‘<samp>Y <var>num</var></samp>’</dt>
-<dd><a name="index-Y-config-command-_0028vertical-resolution_0029"></a>
+<dd><span id="index-Y-config-command-_0028vertical-resolution_0029"></span>
<p>Vertical resolution. Same as ‘<samp>-Y</samp>’ (see <a href="#Option-details">Option details</a>).
</p>
</dd>
<dt>‘<samp>Z*</samp>’</dt>
-<dd><a name="index-Z-config-command-_0028compress-fonts_0029"></a>
+<dd><span id="index-Z-config-command-_0028compress-fonts_0029"></span>
<p>Compress bitmap fonts. Same as ‘<samp>-Z</samp>’ (see <a href="#Option-details">Option details</a>).
</p>
</dd>
<dt>‘<samp>z*</samp>’</dt>
-<dd><a name="index-z-config-command-_0028secure-mode_0029"></a>
+<dd><span id="index-z-config-command-_0028secure-mode_0029"></span>
<p>Disables execution of system commands, like ‘<samp>-R</samp>’
(see <a href="#Option-details">Option details</a>). If ‘<samp>-R</samp>’ is specified
on the command line, that takes precedence.
@@ -2090,15 +2036,13 @@
<hr>
-<a name="Paper-size-and-landscape"></a>
-<div class="header">
+<span id="Paper-size-and-landscape"></span><div class="header">
<p>
Next: <a href="#Interaction-with-PostScript" accesskey="n" rel="next">Interaction with PostScript</a>, Previous: <a href="#Invoking-Dvips" accesskey="p" rel="prev">Invoking Dvips</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>
</div>
-<a name="Paper-size-and-landscape-orientation"></a>
-<h2 class="chapter">4 Paper size and landscape orientation</h2>
+<span id="Paper-size-and-landscape-orientation"></span><h2 class="chapter">4 Paper size and landscape orientation</h2>
-<a name="index-paper-size_002c-general"></a>
+<span id="index-paper-size_002c-general"></span>
<p>Most TeX documents at a particular site are designed to use the
local standard paper size (letter size in the United States, A4
@@ -2105,8 +2049,8 @@
elsewhere). The Dvips program can be customized either sitewide or
for a particular printer.
</p>
-<a name="index-landscape-orientation_002c-defined"></a>
-<a name="index-portrait-orientation_002c-defined"></a>
+<span id="index-landscape-orientation_002c-defined"></span>
+<span id="index-portrait-orientation_002c-defined"></span>
<p>On the other hand, plenty of documents are designed for other paper
sizes. For instance, you may want to design a document that has the
long edge of the paper horizontal. This can be useful when
@@ -2127,25 +2071,23 @@
not and should not attempt to override it manually.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a>:</td><td> </td><td align="left" valign="top">Specifying the paper size in TeX.
+<tr><td align="left" valign="top">• <a href="#papersize-special" accesskey="1">‘<samp>papersize</samp>’ special</a></td><td> </td><td align="left" valign="top">Specifying the paper size in TeX.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Config-file-paper-sizes" accesskey="2">Config file paper sizes</a>:</td><td> </td><td align="left" valign="top">Specifying printer- and site-specific sizes.
+<tr><td align="left" valign="top">• <a href="#Config-file-paper-sizes" accesskey="2">Config file paper sizes</a></td><td> </td><td align="left" valign="top">Specifying printer- and site-specific sizes.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Paper-trays" accesskey="3">Paper trays</a>:</td><td> </td><td align="left" valign="top">Changing paper trays automatically.
+<tr><td align="left" valign="top">• <a href="#Paper-trays" accesskey="3">Paper trays</a></td><td> </td><td align="left" valign="top">Changing paper trays automatically.
</td></tr>
</table>
<hr>
-<a name="papersize-special"></a>
-<div class="header">
+<span id="papersize-special"></span><div class="header">
<p>
Next: <a href="#Config-file-paper-sizes" accesskey="n" rel="next">Config file paper sizes</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="papersize-special-1"></a>
-<h3 class="section">4.1 ‘<samp>papersize</samp>’ special</h3>
+<span id="papersize-special-1"></span><h3 class="section">4.1 ‘<samp>papersize</samp>’ special</h3>
-<a name="index-papersize-special"></a>
+<span id="index-papersize-special"></span>
<p>The format of the ‘<samp>papersize</samp>’ special is
</p>
@@ -2159,7 +2101,7 @@
(scaled points), bp (big points, the same as the default PostScript
unit), pc (picas), dd (didot points), and cc (ciceros).
</p>
-<a name="index-landscape_002c-as-_005cspecial"></a>
+<span id="index-landscape_002c-as-_005cspecial"></span>
<p>For a US letter size landscape document, the ‘<samp>papersize</samp>’ would be:
</p><div class="example">
<pre class="example">\special{papersize=11in,8.5in}
@@ -2177,7 +2119,7 @@
paper size; you must also adjust <code>\hsize</code> and <code>\vsize</code> in your
TeX document typeset to those dimensions.
</p>
-<a name="index-unknown_002c-paper-format-for-_002dt"></a>
+<span id="index-unknown_002c-paper-format-for-_002dt"></span>
<p>When using the ‘<samp>papersize</samp>’ special, you generally should not also
specify <code>-t</code> on the command line (see <a href="#Option-details">Option details</a>). The
exception is when using a nonstandard paper size that isn’t
@@ -2194,16 +2136,14 @@
</p>
<hr>
-<a name="Config-file-paper-sizes"></a>
-<div class="header">
+<span id="Config-file-paper-sizes"></span><div class="header">
<p>
Next: <a href="#Paper-trays" accesskey="n" rel="next">Paper trays</a>, Previous: <a href="#papersize-special" accesskey="p" rel="prev">‘<samp>papersize</samp>’ special</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configuration-file-paper-size-command"></a>
-<h3 class="section">4.2 Configuration file paper size command</h3>
+<span id="Configuration-file-paper-size-command"></span><h3 class="section">4.2 Configuration file paper size command</h3>
-<a name="index-paper-size-configuration-file-command"></a>
-<a name="index-configuration-file-paper-size-command"></a>
+<span id="index-paper-size-configuration-file-command"></span>
+<span id="index-configuration-file-paper-size-command"></span>
<p>The ‘<samp>@</samp>’ command in a configuration file sets the paper size
defaults and options. The first ‘<samp>@</samp>’ command defines the default
@@ -2278,7 +2218,7 @@
they will handle setting the paper size. So paper size entries should
typically specify both.
</p>
-<a name="index-unknown_002c-paper-format-for-_002dt-1"></a>
+<span id="index-unknown_002c-paper-format-for-_002dt-1"></span>
<p>When using a paper size that is not already defined in
<samp>config.ps</samp>, you probably want to say ‘<samp>-t unknown</samp>’ on
the command line; the <code>unknown</code> paper size definition in
@@ -2285,20 +2225,20 @@
<samp>config.ps</samp> has the requisite PostScript incantation to set the
PostScript page size, as just described.
</p>
-<a name="index-nopaper_002c-paper-format-for-_002dt"></a>
+<span id="index-nopaper_002c-paper-format-for-_002dt"></span>
<p>If you want no paper size information in the output at all, use
‘<samp>-t nopaper</samp>’. This is useful with multi-page output that
will be processed further. If you just have a single page document,
you can use ‘<samp>-E</samp>’ to get pure EPSF output.
</p>
-<a name="index-mkdvipspapers"></a>
+<span id="index-mkdvipspapers"></span>
<p>The Perl 5 script <samp>contrib/configs/mkdvipspapers</samp> in the
distribution directory may help in determining appropriate paper size
definitions.
</p>
-<a name="index-config_002eps-paper-sizes"></a>
-<a name="index-letter-paper-size"></a>
-<a name="index-a4-paper-size"></a>
+<span id="index-config_002eps-paper-sizes"></span>
+<span id="index-letter-paper-size"></span>
+<span id="index-a4-paper-size"></span>
<p>Notwithstanding the above, the default <code>letter</code> and <code>a4</code>
paper size definitions in <samp>config.ps</samp> execute the
<code>setpagedevice</code> operator if it exists (it was defined in
@@ -2308,32 +2248,30 @@
at all confuses PostScript conversion programs such as
<code>ps2pdf</code>, so we want to execute one if we can.
</p>
-<a name="index-letterSize-paper-size"></a>
-<a name="index-A4size-paper-size"></a>
+<span id="index-letterSize-paper-size"></span>
+<span id="index-A4size-paper-size"></span>
<p>The <code>letterSize</code> and <code>A4Size</code> paper size definitions are now
synonyms for <code>letter</code> and <code>a4</code>.
</p>
<hr>
-<a name="Paper-trays"></a>
-<div class="header">
+<span id="Paper-trays"></span><div class="header">
<p>
Previous: <a href="#Config-file-paper-sizes" accesskey="p" rel="prev">Config file paper sizes</a>, Up: <a href="#Paper-size-and-landscape" accesskey="u" rel="up">Paper size and landscape</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Paper-trays-1"></a>
-<h3 class="section">4.3 Paper trays</h3>
+<span id="Paper-trays-1"></span><h3 class="section">4.3 Paper trays</h3>
-<a name="index-paper-trays"></a>
-<a name="index-dual-paper-trays"></a>
-<a name="index-multiple-paper-trays"></a>
-<a name="index-HP4Si-printer-and-paper-trays"></a>
+<span id="index-paper-trays"></span>
+<span id="index-dual-paper-trays"></span>
+<span id="index-multiple-paper-trays"></span>
+<span id="index-HP4Si-printer-and-paper-trays"></span>
-<a name="index-bop_002dhook"></a>
+<span id="index-bop_002dhook"></span>
<p>Some printers, such as the Hewlett-Packard HP4si, have multiple paper
trays. You can set up Dvips to take advantage of this using the
<code>bop-hook</code> PostScript variable (see <a href="#PostScript-hooks">PostScript hooks</a>).
</p>
-<a name="index-letterhead-tray"></a>
+<span id="index-letterhead-tray"></span>
<p>For example, suppose you have an alternate tray stocked with letterhead
paper; the usual tray has the usual paper. You have a document where
you want the first page printed on letterhead, and the remaining pages
@@ -2364,16 +2302,14 @@
<hr>
-<a name="Interaction-with-PostScript"></a>
-<div class="header">
+<span id="Interaction-with-PostScript"></span><div class="header">
<p>
Next: <a href="#PostScript-fonts" accesskey="n" rel="next">PostScript fonts</a>, Previous: <a href="#Paper-size-and-landscape" accesskey="p" rel="prev">Paper size and landscape</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>
</div>
-<a name="Interaction-with-PostScript-1"></a>
-<h2 class="chapter">5 Interaction with PostScript</h2>
+<span id="Interaction-with-PostScript-1"></span><h2 class="chapter">5 Interaction with PostScript</h2>
-<a name="index-interaction-with-PostScript"></a>
-<a name="index-PostScript-interaction"></a>
+<span id="index-interaction-with-PostScript"></span>
+<span id="index-PostScript-interaction"></span>
<p>Dvips supports inclusion of PostScript figure files (e.g., Encapsulated
PostScript), downloading other header files (e.g., fonts), including
@@ -2380,25 +2316,23 @@
literal PostScript code, and hypertext.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#PostScript-figures" accesskey="1">PostScript figures</a>:</td><td> </td><td align="left" valign="top">Including an Encapsulated PostScript figure.
+<tr><td align="left" valign="top">• <a href="#PostScript-figures" accesskey="1">PostScript figures</a></td><td> </td><td align="left" valign="top">Including an Encapsulated PostScript figure.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Header-files" accesskey="2">Header files</a>:</td><td> </td><td align="left" valign="top">Downloading extra definitions.
+<tr><td align="left" valign="top">• <a href="#Header-files" accesskey="2">Header files</a></td><td> </td><td align="left" valign="top">Downloading extra definitions.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Literal-PS" accesskey="3">Literal PS</a>:</td><td> </td><td align="left" valign="top">Writing literal PostScript code.
+<tr><td align="left" valign="top">• <a href="#Literal-PS" accesskey="3">Literal PS</a></td><td> </td><td align="left" valign="top">Writing literal PostScript code.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Hypertext" accesskey="4">Hypertext</a>:</td><td> </td><td align="left" valign="top">Producing HyperPostScript to make PDF.
+<tr><td align="left" valign="top">• <a href="#Hypertext" accesskey="4">Hypertext</a></td><td> </td><td align="left" valign="top">Producing HyperPostScript to make PDF.
</td></tr>
</table>
<hr>
-<a name="PostScript-figures"></a>
-<div class="header">
+<span id="PostScript-figures"></span><div class="header">
<p>
Next: <a href="#Header-files" accesskey="n" rel="next">Header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="PostScript-figures-1"></a>
-<h3 class="section">5.1 PostScript figures</h3>
+<span id="PostScript-figures-1"></span><h3 class="section">5.1 PostScript figures</h3>
<p>Scaling and including PostScript graphics is a breeze—if the PostScript
file is correctly formed. Even if it is not, however, the file can usually
@@ -2405,31 +2339,29 @@
be accommodated with just a little more work.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Bounding-box" accesskey="1">Bounding box</a>:</td><td> </td><td align="left" valign="top">The %%BoundingBox EPS comment.
+<tr><td align="left" valign="top">• <a href="#Bounding-box" accesskey="1">Bounding box</a></td><td> </td><td align="left" valign="top">The %%BoundingBox EPS comment.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cincludegraphics" accesskey="2">\includegraphics</a>:</td><td> </td><td align="left" valign="top">The LaTeX \includegraphics macro.
+<tr><td align="left" valign="top">• <a href="#g_t_005cincludegraphics" accesskey="2">\includegraphics</a></td><td> </td><td align="left" valign="top">The LaTeX \includegraphics macro.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#EPSF-macros" accesskey="3">EPSF macros</a>:</td><td> </td><td align="left" valign="top">Including the file in TeX.
+<tr><td align="left" valign="top">• <a href="#EPSF-macros" accesskey="3">EPSF macros</a></td><td> </td><td align="left" valign="top">Including the file in TeX.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#psfile-special" accesskey="4">psfile special</a>:</td><td> </td><td align="left" valign="top">The basic special.
+<tr><td align="left" valign="top">• <a href="#psfile-special" accesskey="4">psfile special</a></td><td> </td><td align="left" valign="top">The basic special.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of graphics</a>:</td><td> </td><td align="left" valign="top">Handling compressed or generated figures.
+<tr><td align="left" valign="top">• <a href="#Dynamic-creation-of-graphics" accesskey="5">Dynamic creation of graphics</a></td><td> </td><td align="left" valign="top">Handling compressed or generated figures.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a>:</td><td> </td><td align="left" valign="top">The %*Font comment.
+<tr><td align="left" valign="top">• <a href="#Fonts-in-figures" accesskey="6">Fonts in figures</a></td><td> </td><td align="left" valign="top">The %*Font comment.
</td></tr>
</table>
<hr>
-<a name="Bounding-box"></a>
-<div class="header">
+<span id="Bounding-box"></span><div class="header">
<p>
Next: <a href="#g_t_005cincludegraphics" accesskey="n" rel="next">\includegraphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-bounding-box-comment"></a>
-<h4 class="subsection">5.1.1 The bounding box comment</h4>
+<span id="The-bounding-box-comment"></span><h4 class="subsection">5.1.1 The bounding box comment</h4>
-<a name="index-bounding-box_002c-comment-for"></a>
+<span id="index-bounding-box_002c-comment-for"></span>
<p>The most important feature of a good PostScript file from the standpoint
of including it in another document is an accurate bounding box comment.
@@ -2436,9 +2368,9 @@
Every well-formed PostScript file has a comment describing where on the
page the graphic is located, and how big that graphic is.
</p>
-<a name="index-big-points"></a>
-<a name="index-PostScript-units"></a>
-<a name="index-bounding-box_002c-defined"></a>
+<span id="index-big-points"></span>
+<span id="index-PostScript-units"></span>
+<span id="index-bounding-box_002c-defined"></span>
<p>This information is given as the lower left and upper right corners of
the box just enclosing the graphic, and is thus referred to as the
<em>bounding box</em>. These coordinates are given in the default
@@ -2446,7 +2378,7 @@
like TeX big points) with respect to the lower left corner of the
sheet of paper.
</p>
-<a name="index-_0025_0025BoundingBox"></a>
+<span id="index-_0025_0025BoundingBox"></span>
<p>To see if a PostScript file has a bounding box comment, just look at the
first few lines of the file. PostScript files are standard ASCII, so
you can use any text editor to do this. If within the first few dozen
@@ -2460,8 +2392,8 @@
Encapsulated PostScript and will work easily with Dvips. If the file
contains instead a line like
</p>
-<a name="index-atend_002c-bounding-box-specification"></a>
-<a name="index-_0028atend_0029_002c-bounding-box-specification"></a>
+<span id="index-atend_002c-bounding-box-specification"></span>
+<span id="index-_0028atend_0029_002c-bounding-box-specification"></span>
<div class="example">
<pre class="example">%%BoundingBox: (atend)
</pre></div>
@@ -2473,8 +2405,8 @@
PostScript couldn’t know the size in advance, or was too lazy to compute
it.)
</p>
-<a name="index-bbfig"></a>
-<a name="index-bounding-box_002c-determining"></a>
+<span id="index-bbfig"></span>
+<span id="index-bounding-box_002c-determining"></span>
<p>If the document lacks a ‘<samp>%%BoundingBox:</samp>’ altogether, you can
determine one in a couple of ways. One is to use the ‘<samp>bbfig</samp>’
program distributed with Dvips in the <samp>contrib</samp> directory. This can
@@ -2481,7 +2413,7 @@
usually find the correct bounding box automatically; it works best with
Ghostscript.
</p>
-<a name="index-612-792-bounding-box-size"></a>
+<span id="index-612-792-bounding-box-size"></span>
<p>If the comment looks like this:
</p><div class="example">
<pre class="example">%%BoundingBox: 0 0 612 792
@@ -2520,16 +2452,14 @@
</p>
<hr>
-<a name="g_t_005cincludegraphics"></a>
-<div class="header">
+<span id="g_t_005cincludegraphics"></span><div class="header">
<p>
Next: <a href="#EPSF-macros" accesskey="n" rel="next">EPSF macros</a>, Previous: <a href="#Bounding-box" accesskey="p" rel="prev">Bounding box</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-_005cincludegraphics-macro-for-LaTeX"></a>
-<h4 class="subsection">5.1.2 The \includegraphics macro for LaTeX</h4>
+<span id="The-_005cincludegraphics-macro-for-LaTeX"></span><h4 class="subsection">5.1.2 The \includegraphics macro for LaTeX</h4>
-<a name="index-_005cincludegraphics-LaTeX-macro"></a>
-<a name="index-macros-for-epsf-inclusion"></a>
+<span id="index-_005cincludegraphics-LaTeX-macro"></span>
+<span id="index-macros-for-epsf-inclusion"></span>
<p>Once the figure file has a bounding box comment (see the previous
section) you are ready to import the graphic into a LaTeX
@@ -2568,7 +2498,7 @@
suitable graphics files for them, e.g., <samp>foo.pdf</samp> or
<samp>foo.png</samp>.
</p>
-<a name="index-bounding-box_002c-supplying-to-TeX"></a>
+<span id="index-bounding-box_002c-supplying-to-TeX"></span>
<p>The \includegraphics command has many options, specified in
‘<samp>key=value</samp>’ syntax, to allow you to resize, rotate or trim the
included graphic—see <samp>grfguide</samp> or <samp>epslatex</samp>. If your
@@ -2593,16 +2523,14 @@
</p>
<hr>
-<a name="EPSF-macros"></a>
-<div class="header">
+<span id="EPSF-macros"></span><div class="header">
<p>
Next: <a href="#psfile-special" accesskey="n" rel="next">psfile special</a>, Previous: <a href="#g_t_005cincludegraphics" accesskey="p" rel="prev">\includegraphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Using-the-EPSF-macros"></a>
-<h4 class="subsection">5.1.3 Using the EPSF macros</h4>
+<span id="Using-the-EPSF-macros"></span><h4 class="subsection">5.1.3 Using the EPSF macros</h4>
-<a name="index-EPSF-macros"></a>
-<a name="index-macros-for-epsf-inclusion-1"></a>
+<span id="index-EPSF-macros"></span>
+<span id="index-macros-for-epsf-inclusion-1"></span>
<p>If you are using LaTeX 2e, use the ‘<samp>graphics</samp>’ or ‘<samp>graphicx</samp>’
package. See <a href="#g_t_005cincludegraphics">\includegraphics</a>.
@@ -2611,12 +2539,12 @@
(for plain TeX) and <samp>epsf.sty</samp> (for LaTeX). For plain
TeX, add a line like this near the top of your input file:
</p>
-<a name="index-epsf_002etex"></a>
+<span id="index-epsf_002etex"></span>
<div class="example">
<pre class="example">\input epsf
</pre></div>
-<p><a name="index-epsf_002esty"></a>
+<p><span id="index-epsf_002esty"></span>
If you are using LaTeX 2.09, add the ‘<samp>epsf</samp>’ style option, as in:
</p>
<div class="example">
@@ -2632,8 +2560,8 @@
<pre class="example">\epsffile{foo.eps}
</pre></div>
-<a name="index-_005cleavevmode"></a>
-<a name="index-bounding-box_002c-supplying-to-TeX-1"></a>
+<span id="index-_005cleavevmode"></span>
+<span id="index-bounding-box_002c-supplying-to-TeX-1"></span>
<p>If you are using LaTeX, you may need to add <code>\leavevmode</code>
immediately before the <code>\epsffile</code> command to get certain
environments to work correctly. If your file does not have a bounding
@@ -2649,8 +2577,8 @@
your graphic positioned at precisely the point you indicated, occupying
the proper amount of space.
</p>
-<a name="index-_005cepsffile-macro"></a>
-<a name="index-figures_002c-natural-size"></a>
+<span id="index-_005cepsffile-macro"></span>
+<span id="index-figures_002c-natural-size"></span>
<p>The <code>\epsffile</code> macro typesets the figure as a TeX <code>\vbox</code>
at the point of the page that the command is executed. By default, the
graphic will have its ‘natural’ width (namely, the width of its bounding
@@ -2659,8 +2587,8 @@
just as is everything else in your document. See the next section for
more information on scaling.
</p>
-<a name="index-_005cepsfverbosetrue"></a>
-<a name="index-verbose-EPSF-processing"></a>
+<span id="index-_005cepsfverbosetrue"></span>
+<span id="index-verbose-EPSF-processing"></span>
<p>If you want TeX to report the size of the figure as a message on your
terminal when it processes each figure, give the command:
</p>
@@ -2669,24 +2597,22 @@
</pre></div>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#EPSF-scaling" accesskey="1">EPSF scaling</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#EPSF-scaling" accesskey="1">EPSF scaling</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#EPSF-clipping" accesskey="2">EPSF clipping</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#EPSF-clipping" accesskey="2">EPSF clipping</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="EPSF-scaling"></a>
-<div class="header">
+<span id="EPSF-scaling"></span><div class="header">
<p>
Next: <a href="#EPSF-clipping" accesskey="n" rel="next">EPSF clipping</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="EPSF-scaling-1"></a>
-<h4 class="subsubsection">5.1.3.1 EPSF scaling</h4>
+<span id="EPSF-scaling-1"></span><h4 class="subsubsection">5.1.3.1 EPSF scaling</h4>
-<a name="index-scaling-of-figures"></a>
-<a name="index-figures_002c-scaling"></a>
+<span id="index-scaling-of-figures"></span>
+<span id="index-figures_002c-scaling"></span>
<p>Usually, you will want to scale an EPSF figure to some size appropriate
for your document, since its natural size is determined by the creator
@@ -2696,7 +2622,7 @@
<code>\epsfxsize</code> or <code>\epsfysize</code> variables, whichever is more
convenient for you. That is, put
</p>
-<a name="index-_005cepsfxsize"></a>
+<span id="index-_005cepsfxsize"></span>
<div class="example">
<pre class="example">\epsfxsize=<var>dimen</var>
</pre></div>
@@ -2705,7 +2631,7 @@
box will be <var>dimen</var> and its height will be scaled proportionately.
Similarly, you can set the vertical size with
</p>
-<a name="index-_005cepsfysize"></a>
+<span id="index-_005cepsfysize"></span>
<div class="example">
<pre class="example">\epsfysize=<var>dimen</var>
</pre></div>
@@ -2717,7 +2643,7 @@
included graphic may necessarily be distorted, i.e., its contents
stretched in one direction or the other.
</p>
-<a name="index-_005cepsfsize"></a>
+<span id="index-_005cepsfsize"></span>
<p>You can resize graphics in a more general way by redefining the
<code>\epsfsize</code> macro. <code>\epsffile</code> calls this with two
parameters: the natural horizontal and vertical sizes of the PostScript
@@ -2762,14 +2688,14 @@
</dd>
</dl>
-<a name="index-DVI-magnification"></a>
-<a name="index-magnification_002c-DVI"></a>
-<a name="index-_005cmagnification"></a>
+<span id="index-DVI-magnification"></span>
+<span id="index-magnification_002c-DVI"></span>
+<span id="index-_005cmagnification"></span>
<p>For compatibility with other PostScript drivers, it is possible to turn
off the default scaling of included figures by the DVI magnification
with the following TeX command:
</p>
-<a name="index-_002fmagscale"></a>
+<span id="index-_002fmagscale"></span>
<div class="example">
<pre class="example">\special{! /magscale false def}
</pre></div>
@@ -2780,24 +2706,22 @@
improperly scaled and out of position if a DVI to DVI program is used to
scale or otherwise modify the document.
</p>
-<a name="index-bop_002dhook-1"></a>
+<span id="index-bop_002dhook-1"></span>
<p>DVI magnification is not applied to any output from code you write in
‘<samp>bop-hook</samp>’ or its ilk (see <a href="#PostScript-hooks">PostScript hooks</a>),
</p>
<hr>
-<a name="EPSF-clipping"></a>
-<div class="header">
+<span id="EPSF-clipping"></span><div class="header">
<p>
Previous: <a href="#EPSF-scaling" accesskey="p" rel="prev">EPSF scaling</a>, Up: <a href="#EPSF-macros" accesskey="u" rel="up">EPSF macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="EPSF-clipping-1"></a>
-<h4 class="subsubsection">5.1.3.2 EPSF clipping</h4>
+<span id="EPSF-clipping-1"></span><h4 class="subsubsection">5.1.3.2 EPSF clipping</h4>
-<a name="index-clipping-of-EPSF"></a>
-<a name="index-bounding-box_002c-inaccurate"></a>
-<a name="index-text-in-figures_002c-chopped-off"></a>
-<a name="index-lines-in-figures_002c-wrong-width"></a>
+<span id="index-clipping-of-EPSF"></span>
+<span id="index-bounding-box_002c-inaccurate"></span>
+<span id="index-text-in-figures_002c-chopped-off"></span>
+<span id="index-lines-in-figures_002c-wrong-width"></span>
<p>By default, clipping is disabled for included EPSF images. This is
because clipping to the bounding box dimensions often cuts off a
@@ -2819,15 +2743,13 @@
<hr>
-<a name="psfile-special"></a>
-<div class="header">
+<span id="psfile-special"></span><div class="header">
<p>
Next: <a href="#Dynamic-creation-of-graphics" accesskey="n" rel="next">Dynamic creation of graphics</a>, Previous: <a href="#EPSF-macros" accesskey="p" rel="prev">EPSF macros</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="psfile-special-1"></a>
-<h4 class="subsection">5.1.4 ‘<samp>psfile</samp>’ special</h4>
+<span id="psfile-special-1"></span><h4 class="subsection">5.1.4 ‘<samp>psfile</samp>’ special</h4>
-<a name="index-psfile-special"></a>
+<span id="index-psfile-special"></span>
<p>The basic special for file inclusion is as follows:
</p>
@@ -2844,57 +2766,57 @@
</p>
<dl compact="compact">
<dt>‘<samp>hoffset</samp>’</dt>
-<dd><a name="index-hoffset-_0028psfile-special-option_0029"></a>
+<dd><span id="index-hoffset-_0028psfile-special-option_0029"></span>
<p>The horizontal offset (default 0).
</p>
</dd>
<dt>‘<samp>voffset</samp>’</dt>
-<dd><a name="index-voffset-_0028psfile-special-option_0029"></a>
+<dd><span id="index-voffset-_0028psfile-special-option_0029"></span>
<p>The vertical offset (default 0).
</p>
</dd>
<dt>‘<samp>hsize</samp>’</dt>
-<dd><a name="index-hsize-_0028psfile-special-option_0029"></a>
+<dd><span id="index-hsize-_0028psfile-special-option_0029"></span>
<p>The horizontal clipping size (default 612).
</p>
</dd>
<dt>‘<samp>vsize</samp>’</dt>
-<dd><a name="index-vsize-_0028psfile-special-option_0029"></a>
+<dd><span id="index-vsize-_0028psfile-special-option_0029"></span>
<p>The vertical clipping size (default 792).
</p>
</dd>
<dt>‘<samp>hscale</samp>’</dt>
-<dd><a name="index-hscale-_0028psfile-special-option_0029"></a>
+<dd><span id="index-hscale-_0028psfile-special-option_0029"></span>
<p>The horizontal scaling factor, as a percentage (default 100).
</p>
</dd>
<dt>‘<samp>vscale</samp>’</dt>
-<dd><a name="index-vscale-_0028psfile-special-option_0029"></a>
+<dd><span id="index-vscale-_0028psfile-special-option_0029"></span>
<p>The vertical scaling factor, as a percentage (default 100).
</p>
</dd>
<dt>‘<samp>angle</samp>’</dt>
-<dd><a name="index-angle-_0028psfile-special-option_0029"></a>
+<dd><span id="index-angle-_0028psfile-special-option_0029"></span>
<p>The rotation, in degrees (default 0).
</p>
</dd>
<dt>‘<samp>clip</samp>’</dt>
-<dd><a name="index-clip-_0028psfile-special-option_0029"></a>
+<dd><span id="index-clip-_0028psfile-special-option_0029"></span>
<p>Enable clipping to the bounding box (default disabled).
</p>
</dd>
<dt>‘<samp>llx, lly, urx, ury</samp>’</dt>
-<dd><a name="index-llx-_0028psfile-special-option_0029"></a>
-<a name="index-lly-_0028psfile-special-option_0029"></a>
-<a name="index-urx-_0028psfile-special-option_0029"></a>
-<a name="index-ury-_0028psfile-special-option_0029"></a>
+<dd><span id="index-llx-_0028psfile-special-option_0029"></span>
+<span id="index-lly-_0028psfile-special-option_0029"></span>
+<span id="index-urx-_0028psfile-special-option_0029"></span>
+<span id="index-ury-_0028psfile-special-option_0029"></span>
<p>Bounding box of the included image, just as in a <code>%%BoundingBox</code>
comment. Values are in big points, and may be fractional.
</p>
</dd>
<dt>‘<samp>rhi, rwi</samp>’</dt>
-<dd><a name="index-rhi-_0028psfile-special-option_0029"></a>
-<a name="index-rwi-_0028psfile-special-option_0029"></a>
+<dd><span id="index-rhi-_0028psfile-special-option_0029"></span>
+<span id="index-rwi-_0028psfile-special-option_0029"></span>
<p>Desired width and height of the resulting figure in the output, in
tenths of big points (720 to the inch); may be fractional.
</p>
@@ -2921,9 +2843,9 @@
<p>For compatibility with older PostScript drivers, it is possible to change
the units that ‘<samp>hscale</samp>’ and ‘<samp>vscale</samp>’ are given in. This can be
done by redefining ‘<samp>@scaleunit</samp>’
-<a name="index-scaleunit"></a>
+<span id="index-scaleunit"></span>
in ‘<samp>SDict</samp>’
-<a name="index-SDict"></a>
+<span id="index-SDict"></span>
by a TeX command such as
</p>
<div class="example">
@@ -2936,17 +2858,15 @@
</p>
<hr>
-<a name="Dynamic-creation-of-graphics"></a>
-<div class="header">
+<span id="Dynamic-creation-of-graphics"></span><div class="header">
<p>
Next: <a href="#Fonts-in-figures" accesskey="n" rel="next">Fonts in figures</a>, Previous: <a href="#psfile-special" accesskey="p" rel="prev">psfile special</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Dynamic-creation-of-PostScript-graphics-files"></a>
-<h4 class="subsection">5.1.5 Dynamic creation of PostScript graphics files</h4>
+<span id="Dynamic-creation-of-PostScript-graphics-files"></span><h4 class="subsection">5.1.5 Dynamic creation of PostScript graphics files</h4>
-<a name="index-dynamic-creation-of-graphics"></a>
-<a name="index-compressed-PostScript"></a>
-<a name="index-uncompressing-PostScript"></a>
+<span id="index-dynamic-creation-of-graphics"></span>
+<span id="index-compressed-PostScript"></span>
+<span id="index-uncompressing-PostScript"></span>
<p>PostScript is an excellent page description language—but it does tend
to be rather verbose. Compressing PostScript graphics files can reduce
@@ -2971,7 +2891,7 @@
<pre class="example">\special{psfile="`gnuplot foo"}
</pre></div>
-<p><a name="index-gnuplot"></a>
+<p><span id="index-gnuplot"></span>
to include the file <samp>foo</samp>. Of course, the command to be executed
can be anything, including using a file conversion utility such as
<samp>tek2ps</samp> or whatever is appropriate. This feature can be disabled
@@ -2979,17 +2899,15 @@
</p>
<hr>
-<a name="Fonts-in-figures"></a>
-<div class="header">
+<span id="Fonts-in-figures"></span><div class="header">
<p>
Previous: <a href="#Dynamic-creation-of-graphics" accesskey="p" rel="prev">Dynamic creation of graphics</a>, Up: <a href="#PostScript-figures" accesskey="u" rel="up">PostScript figures</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Fonts-in-figures-1"></a>
-<h4 class="subsection">5.1.6 Fonts in figures</h4>
+<span id="Fonts-in-figures-1"></span><h4 class="subsection">5.1.6 Fonts in figures</h4>
-<a name="index-figures-and-fonts"></a>
-<a name="index-fonts_002c-in-PostScript-figures"></a>
-<a name="index-_0025_002aFont"></a>
+<span id="index-figures-and-fonts"></span>
+<span id="index-fonts_002c-in-PostScript-figures"></span>
+<span id="index-_0025_002aFont"></span>
<p>You can use any font available to TeX and Dvips within a graphics
file by putting a <code>%*Font:</code> line in the leading commentary of the
@@ -3038,20 +2956,18 @@
</dl>
<p>MetaPost’s output figures contain lines like this for bitmap fonts used
-in a MetaPost label (see <a href="http://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>).
+in a MetaPost label (see <a href="https://tug.org/texinfohtml/web2c.html#MetaPost">MetaPost</a> in <cite>Web2c</cite>).
</p>
<hr>
-<a name="Header-files"></a>
-<div class="header">
+<span id="Header-files"></span><div class="header">
<p>
Next: <a href="#Literal-PS" accesskey="n" rel="next">Literal PS</a>, Previous: <a href="#PostScript-figures" accesskey="p" rel="prev">PostScript figures</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="PostScript-header-files"></a>
-<h3 class="section">5.2 PostScript header files</h3>
+<span id="PostScript-header-files"></span><h3 class="section">5.2 PostScript header files</h3>
-<a name="index-header-files_002c-defined"></a>
-<a name="index-PostScript-header-files"></a>
+<span id="index-header-files_002c-defined"></span>
+<span id="index-PostScript-header-files"></span>
<p><em>Header files</em> are bits of PostScript included in the output file;
generally they provide support for special features, rather than
@@ -3059,9 +2975,9 @@
downloading header files if necessary for some figure, or to achieve
some special effect.
</p>
-<a name="index-psheaderdir"></a>
-<a name="index-_002epro-prologue-files"></a>
-<a name="index-_002elpro-long-prologue-files"></a>
+<span id="index-psheaderdir"></span>
+<span id="index-_002epro-prologue-files"></span>
+<span id="index-_002elpro-long-prologue-files"></span>
<p>Dvips includes some headers on its own initiative, to implement features
such as PostScript font reencoding, bitmap font downloading, handling of
<code>\special</code>’s, and so on. These standard headers are the
@@ -3072,35 +2988,33 @@
want to peruse one of the standard header files, read the <samp>.lpro</samp>
version.
</p>
-<a name="index-userdict_002c-and-dictionary-files"></a>
-<a name="index-dictionary_002c-userdict"></a>
+<span id="index-userdict_002c-and-dictionary-files"></span>
+<span id="index-dictionary_002c-userdict"></span>
<p>The PostScript dictionary stack will be at the ‘<samp>userdict</samp>’ level
when header files are included.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Including-headers-from-TeX" accesskey="1">Including headers from TeX</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Including-headers-from-the-command-line" accesskey="2">Including headers from the command line</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Headers-and-memory-usage" accesskey="3">Headers and memory usage</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Including-headers-from-TeX"></a>
-<div class="header">
+<span id="Including-headers-from-TeX"></span><div class="header">
<p>
Next: <a href="#Including-headers-from-the-command-line" accesskey="n" rel="next">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Including-headers-from-TeX-1"></a>
-<h4 class="subsection">5.2.1 Including headers from TeX</h4>
+<span id="Including-headers-from-TeX-1"></span><h4 class="subsection">5.2.1 Including headers from TeX</h4>
-<a name="index-including-headers-in-TeX"></a>
-<a name="index-header_003dfile-_005cspecial"></a>
-<a name="index-TeX_002c-including-headers-in"></a>
+<span id="index-including-headers-in-TeX"></span>
+<span id="index-header_003dfile-_005cspecial"></span>
+<span id="index-TeX_002c-including-headers-in"></span>
-<a name="index-headers_002c-including-in-TeX"></a>
+<span id="index-headers_002c-including-in-TeX"></span>
<p>In order to get a particular graphic file to work, a certain font or
header file might need to be sent first. The Dvips program provides
support for this with the ‘<samp>header</samp>’ <code>\special</code>. For instance,
@@ -3110,7 +3024,7 @@
<pre class="example">\special{header=foo.ps}
</pre></div>
-<a name="index-fonts_002c-as-header-files"></a>
+<span id="index-fonts_002c-as-header-files"></span>
<p>As another example, if you have some PostScript code that uses a
PostScript font not built into your printer, you must download it to the
printer. If the font isn’t used elsewhere in the document, Dvips can’t
@@ -3130,10 +3044,10 @@
<pre class="example">\special{header={foo.ps} pre={pre code} post={post code}}
</pre></div>
-<a name="index-before-header_002c-inserting-code"></a>
-<a name="index-after-header_002c-inserting-code"></a>
-<a name="index-pre-code-before-headers"></a>
-<a name="index-post-code-after-headers"></a>
+<span id="index-before-header_002c-inserting-code"></span>
+<span id="index-after-header_002c-inserting-code"></span>
+<span id="index-pre-code-before-headers"></span>
+<span id="index-post-code-after-headers"></span>
<p>This will insert <code>pre code</code> just before <samp>foo.ps</samp> and
<code>post code</code> just after. It is required to use the (balanced)
braces in <em>all</em> of the arguments, including the <code>header</code>,
@@ -3155,17 +3069,15 @@
</p>
<hr>
-<a name="Including-headers-from-the-command-line"></a>
-<div class="header">
+<span id="Including-headers-from-the-command-line"></span><div class="header">
<p>
Next: <a href="#Headers-and-memory-usage" accesskey="n" rel="next">Headers and memory usage</a>, Previous: <a href="#Including-headers-from-TeX" accesskey="p" rel="prev">Including headers from TeX</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Including-headers-from-the-command-line-1"></a>
-<h4 class="subsection">5.2.2 Including headers from the command line</h4>
+<span id="Including-headers-from-the-command-line-1"></span><h4 class="subsection">5.2.2 Including headers from the command line</h4>
-<a name="index-including-headers-from-the-command-line"></a>
-<a name="index-command-line_002c-including-headers-from"></a>
-<a name="index-headers_002c-including-from-the-command-line"></a>
+<span id="index-including-headers-from-the-command-line"></span>
+<span id="index-command-line_002c-including-headers-from"></span>
+<span id="index-headers_002c-including-from-the-command-line"></span>
<p>You can include headers when you run Dvips, as well as from your
document (see the previous section). To do this, run Dvips with the
@@ -3173,9 +3085,9 @@
<samp>config.<var>header</var></samp>, which in turn can specify a header file to
be downloaded with the ‘<samp>h</samp>’ option. See <a href="#Configuration-file-commands">Configuration file commands</a>. These files are called <samp><var>header</var>.cfg</samp> on MS-DOS.
</p>
-<a name="index-duplex-printers"></a>
-<a name="index-simplex-mode-on-duplex-printers"></a>
-<a name="index-screen-frequencies_002c-setting"></a>
+<span id="index-duplex-printers"></span>
+<span id="index-simplex-mode-on-duplex-printers"></span>
+<span id="index-screen-frequencies_002c-setting"></span>
<p>You can arrange for the same file to serve as a ‘<samp>-P</samp>’ config file
and the downloadable header file, by starting the lines of PostScript
code with a space, leaving only the ‘<samp>h</samp>’ line and any comments
@@ -3187,26 +3099,24 @@
</p>
<hr>
-<a name="Headers-and-memory-usage"></a>
-<div class="header">
+<span id="Headers-and-memory-usage"></span><div class="header">
<p>
Previous: <a href="#Including-headers-from-the-command-line" accesskey="p" rel="prev">Including headers from the command line</a>, Up: <a href="#Header-files" accesskey="u" rel="up">Header files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Headers-and-memory-usage-1"></a>
-<h4 class="subsection">5.2.3 Headers and memory usage</h4>
+<span id="Headers-and-memory-usage-1"></span><h4 class="subsection">5.2.3 Headers and memory usage</h4>
-<a name="index-headers-and-memory-usage"></a>
-<a name="index-memory-usage_002c-and-headers"></a>
+<span id="index-headers-and-memory-usage"></span>
+<span id="index-memory-usage_002c-and-headers"></span>
-<a name="index-sections-of-output-file_002c-and-memory"></a>
-<a name="index-output-file_002c-sectioning-of"></a>
+<span id="index-sections-of-output-file_002c-and-memory"></span>
+<span id="index-output-file_002c-sectioning-of"></span>
<p>Dvips tries to avoid overflowing the printer’s memory by splitting the
output files into “sections” (see the ‘<samp>-i</samp>’ option in <a href="#Option-details">Option details</a>). Therefore, for all header files, Dvips debits the printer VM
budget by some value. If the header file has, in its leading
commentary a line of the form
</p>
-<a name="index-VMusage"></a>
-<a name="index-_0025_0025VMusage"></a>
+<span id="index-VMusage"></span>
+<span id="index-_0025_0025VMusage"></span>
<div class="example">
<pre class="example">%%VMusage: <var>min</var> <var>max</var>
</pre></div>
@@ -3227,43 +3137,39 @@
</p>
<hr>
-<a name="Literal-PS"></a>
-<div class="header">
+<span id="Literal-PS"></span><div class="header">
<p>
Next: <a href="#Hypertext" accesskey="n" rel="next">Hypertext</a>, Previous: <a href="#Header-files" accesskey="p" rel="prev">Header files</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Literal-PostScript"></a>
-<h3 class="section">5.3 Literal PostScript</h3>
+<span id="Literal-PostScript"></span><h3 class="section">5.3 Literal PostScript</h3>
-<a name="index-literal-PostScript_002c-using"></a>
-<a name="index-PostScript-code_002c-literal"></a>
+<span id="index-literal-PostScript_002c-using"></span>
+<span id="index-PostScript-code_002c-literal"></span>
<p>You can include literal PostScript code in your document in several ways.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#g_t_0022-special" accesskey="1">" special</a>:</td><td> </td><td align="left" valign="top">To include inline PostScript code.
+<tr><td align="left" valign="top">• <a href="#g_t_0022-special" accesskey="1">" special</a></td><td> </td><td align="left" valign="top">To include inline PostScript code.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#ps-special" accesskey="2">ps special</a>:</td><td> </td><td align="left" valign="top">Inline PostScript without save/restore.
+<tr><td align="left" valign="top">• <a href="#ps-special" accesskey="2">ps special</a></td><td> </td><td align="left" valign="top">Inline PostScript without save/restore.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Literal-headers" accesskey="3">Literal headers</a>:</td><td> </td><td align="left" valign="top">Literal PostScript for the whole document.
+<tr><td align="left" valign="top">• <a href="#Literal-headers" accesskey="3">Literal headers</a></td><td> </td><td align="left" valign="top">Literal PostScript for the whole document.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#PostScript-hooks" accesskey="4">PostScript hooks</a>:</td><td> </td><td align="left" valign="top">Specifying code to run in the PS interpreter.
+<tr><td align="left" valign="top">• <a href="#PostScript-hooks" accesskey="4">PostScript hooks</a></td><td> </td><td align="left" valign="top">Specifying code to run in the PS interpreter.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Literal-examples" accesskey="5">Literal examples</a>:</td><td> </td><td align="left" valign="top">Neat example.
+<tr><td align="left" valign="top">• <a href="#Literal-examples" accesskey="5">Literal examples</a></td><td> </td><td align="left" valign="top">Neat example.
</td></tr>
</table>
<hr>
-<a name="g_t_0022-special"></a>
-<div class="header">
+<span id="g_t_0022-special"></span><div class="header">
<p>
Next: <a href="#ps-special" accesskey="n" rel="next">ps special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_0022-special_003a-Literal-PostScript"></a>
-<h4 class="subsection">5.3.1 <code>"</code> special: Literal PostScript</h4>
+<span id="g_t_0022-special_003a-Literal-PostScript"></span><h4 class="subsection">5.3.1 <code>"</code> special: Literal PostScript</h4>
-<a name="index-_0022-special-_0028literal-PostScript_0029"></a>
+<span id="index-_0022-special-_0028literal-PostScript_0029"></span>
<p>For simple graphics, or just for experimentation, literal PostScript
code can be included. Simply use a <code>\special</code> beginning with a
@@ -3285,17 +3191,15 @@
</p>
<hr>
-<a name="ps-special"></a>
-<div class="header">
+<span id="ps-special"></span><div class="header">
<p>
Next: <a href="#Literal-headers" accesskey="n" rel="next">Literal headers</a>, Previous: <a href="#g_t_0022-special" accesskey="p" rel="prev">" special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="ps-special-1"></a>
-<h4 class="subsection">5.3.2 ‘<samp>ps</samp>’ special</h4>
+<span id="ps-special-1"></span><h4 class="subsection">5.3.2 ‘<samp>ps</samp>’ special</h4>
-<a name="index-ps-special"></a>
+<span id="index-ps-special"></span>
-<a name="index-save_002frestore_002c-and-specials"></a>
+<span id="index-save_002frestore_002c-and-specials"></span>
<p>Generally, Dvips encloses specials in a PostScript save/restore pair,
guaranteeing that the special will have no effect on the rest of the
document. The ‘<samp>ps</samp>’ special, however, allows you to insert literal
@@ -3322,7 +3226,7 @@
<em>not</em> broken into lines. This feature may be used to include
PostScript comments, for example.
</p>
-<a name="index-plotfile_002c-ps-subspecial"></a>
+<span id="index-plotfile_002c-ps-subspecial"></span>
<p>In addition, the variant
</p>
<div class="example">
@@ -3329,7 +3233,7 @@
<pre class="example">\special{ps: plotfile <var>filename</var>}
</pre></div>
-<p><a name="index-rotate_002etex"></a>
+<p><span id="index-rotate_002etex"></span>
inserts the contents of <var>filename</var> verbatim into the output (except
for omitting lines that begin with %). An example of the proper use of
literal specials can be found in the file <samp>rotate.tex</samp>, which makes
@@ -3337,19 +3241,17 @@
</p>
<hr>
-<a name="Literal-headers"></a>
-<div class="header">
+<span id="Literal-headers"></span><div class="header">
<p>
Next: <a href="#PostScript-hooks" accesskey="n" rel="next">PostScript hooks</a>, Previous: <a href="#ps-special" accesskey="p" rel="prev">ps special</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Literal-headers_003a-_0021-_005cspecial"></a>
-<h4 class="subsection">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></h4>
+<span id="Literal-headers_003a-_0021-_005cspecial"></span><h4 class="subsection">5.3.3 Literal headers: ‘<samp>!</samp>’ <code>\special</code></h4>
-<a name="index-literal-headers"></a>
-<a name="index-SDict-dictionary"></a>
+<span id="index-literal-headers"></span>
+<span id="index-SDict-dictionary"></span>
-<a name="index-_0021-special-_0028literal-PS-header_0029"></a>
-<a name="index-dictionary_002c-SDict"></a>
+<span id="index-_0021-special-_0028literal-PS-header_0029"></span>
+<span id="index-dictionary_002c-SDict"></span>
<p>You can download literal PostScript header code in your TeX document,
for use with (for example) literal graphics code that you include later.
The text of a <code>\special</code> beginning with an ‘<samp>!</samp>’ is copied into
@@ -3367,15 +3269,13 @@
<hr>
-<a name="PostScript-hooks"></a>
-<div class="header">
+<span id="PostScript-hooks"></span><div class="header">
<p>
Next: <a href="#Literal-examples" accesskey="n" rel="next">Literal examples</a>, Previous: <a href="#Literal-headers" accesskey="p" rel="prev">Literal headers</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="PostScript-hooks-1"></a>
-<h4 class="subsection">5.3.4 PostScript hooks</h4>
+<span id="PostScript-hooks-1"></span><h4 class="subsection">5.3.4 PostScript hooks</h4>
-<a name="index-PostScript-hooks"></a>
+<span id="index-PostScript-hooks"></span>
<p>Besides including literal PostScript at a particular place in your
document (as described in the previous section), you can also arrange to
@@ -3382,17 +3282,17 @@
execute arbitrary PostScript code at particular times while the
PostScript is printing.
</p>
-<a name="index-bop_002dhook-2"></a>
-<a name="index-eop_002dhook"></a>
-<a name="index-start_002dhook"></a>
-<a name="index-end_002dhook"></a>
+<span id="index-bop_002dhook-2"></span>
+<span id="index-eop_002dhook"></span>
+<span id="index-start_002dhook"></span>
+<span id="index-end_002dhook"></span>
<p>If any of the PostScript names <code>bop-hook</code>, <code>eop-hook</code>,
<code>start-hook</code>, or <code>end-hook</code> are defined in <code>userdict</code>,
they will be executed at the beginning of a page, end of a page, start
of the document, and end of a document, respectively.
</p>
-<a name="index-draft-copies"></a>
-<a name="index-dated-output"></a>
+<span id="index-draft-copies"></span>
+<span id="index-dated-output"></span>
<p>When these macros are executed, the default PostScript coordinate system
and origin is in effect. Such macros can be defined in headers added by
the ‘<samp>-h</samp>’ option or the ‘<samp>header=</samp>’ special, and might be useful
@@ -3403,7 +3303,7 @@
divided into sections because of memory constraints, such added
information will be lost across section breaks.
</p>
-<a name="index-physical-page-number_002c-and-bop_002dhook"></a>
+<span id="index-physical-page-number_002c-and-bop_002dhook"></span>
<p>The single argument to <code>bop-hook</code> is the physical page number; the
first page gets zero, the second one, etc. <code>bop-hook</code> must leave
this number on the stack. None of the other hooks are passed arguments.
@@ -3417,7 +3317,7 @@
0 0 moveto 0.7 setgray (DRAFT) show grestore}def end}
</pre></div>
-<a name="index-_0025_0025Page_002c-and-multi_002dpage-information"></a>
+<span id="index-_0025_0025Page_002c-and-multi_002dpage-information"></span>
<p>Using <code>bop-hook</code> or <code>eop-hook</code> to preserve information across
pages breaks compliance with the Adobe document structuring conventions,
so if you use any such tricks, you may also want to use the ‘<samp>-N</samp>’
@@ -3427,16 +3327,14 @@
</p>
<hr>
-<a name="Literal-examples"></a>
-<div class="header">
+<span id="Literal-examples"></span><div class="header">
<p>
Previous: <a href="#PostScript-hooks" accesskey="p" rel="prev">PostScript hooks</a>, Up: <a href="#Literal-PS" accesskey="u" rel="up">Literal PS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Literal-examples-1"></a>
-<h4 class="subsection">5.3.5 Literal examples</h4>
+<span id="Literal-examples-1"></span><h4 class="subsection">5.3.5 Literal examples</h4>
-<a name="index-literal-PostScript_002c-examples"></a>
-<a name="index-examples-of-literal-PostScript"></a>
+<span id="index-literal-PostScript_002c-examples"></span>
+<span id="index-examples-of-literal-PostScript"></span>
<p>To finish off this section, the following examples of literal PostScript
are presented without explanation:
@@ -3460,9 +3358,9 @@
</pre></div>
-<a name="index-_005crotninety"></a>
-<a name="index-gsave_002fgrestore_002c-and-literal-PS"></a>
-<a name="index-save_002frestore_002c-and-literal-PS"></a>
+<span id="index-_005crotninety"></span>
+<span id="index-gsave_002fgrestore_002c-and-literal-PS"></span>
+<span id="index-save_002frestore_002c-and-literal-PS"></span>
<p>Some caveats are in order, however. Make sure that each <code>gsave</code> is
matched with a <code>grestore</code> on the same page. Do not use <code>save</code>
and <code>restore</code>; they can interact with the PostScript generated by
@@ -3472,26 +3370,24 @@
</p>
<hr>
-<a name="Hypertext"></a>
-<div class="header">
+<span id="Hypertext"></span><div class="header">
<p>
Previous: <a href="#Literal-PS" accesskey="p" rel="prev">Literal PS</a>, Up: <a href="#Interaction-with-PostScript" accesskey="u" rel="up">Interaction with PostScript</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="HyperTeXt"></a>
-<h3 class="section">5.4 HyperTeXt</h3>
+<span id="HyperTeXt"></span><h3 class="section">5.4 HyperTeXt</h3>
-<a name="index-hypertext-support"></a>
+<span id="index-hypertext-support"></span>
-<a name="index-_002dz"></a>
-<a name="index-html-specials"></a>
-<a name="index-pdfmark"></a>
+<span id="index-_002dz"></span>
+<span id="index-html-specials"></span>
+<span id="index-pdfmark"></span>
<p>Dvips has support for producing hypertext PostScript documents. If you
specify the ‘<samp>-z</samp>’ option, the <samp>html:</samp> specials described below
will be converted into ‘<samp>pdfmark</samp>’ PostScript operators to specify
links. Without ‘<samp>-z</samp>’, <samp>html:</samp> specials are ignored.
</p>
-<a name="index-distiller_002c-for-PDF-files"></a>
-<a name="index-PDF-files_002c-making-1"></a>
+<span id="index-distiller_002c-for-PDF-files"></span>
+<span id="index-PDF-files_002c-making-1"></span>
<p>The resulting PostScript can then be processed by a distiller program to
make a PDF file. (It can still be handled by ordinary PostScript
interpreters as well.) Various versions of both PC and Unix distillers
@@ -3500,15 +3396,15 @@
</p>
<p>Macros you can use in your TeX document to insert the specials in the
first place are available from <samp><var>CTAN:</var>/support/hypertex</samp>. For
-CTAN info, see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>.
+CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>.
</p>
-<a name="index-http_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi"></a>
-<a name="index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"></a>
-<a name="index-Doyle_002c-Mark"></a>
-<a name="index-Bhattacharya_002c-Tanmoy"></a>
-<a name="index-Java-DVI-reader"></a>
-<a name="index-idvi-Java-DVI-reader"></a>
-<a name="index-dvihps_002c-hyperdvi-to-PostScript"></a>
+<span id="index-http_003a_002f_002fwww_002ewin_002etue_002enl_002f_007edickie_002fidvi"></span>
+<span id="index-http_003a_002f_002fxxx_002elanl_002egov_002fhypertex"></span>
+<span id="index-Doyle_002c-Mark"></span>
+<span id="index-Bhattacharya_002c-Tanmoy"></span>
+<span id="index-Java-DVI-reader"></span>
+<span id="index-idvi-Java-DVI-reader"></span>
+<span id="index-dvihps_002c-hyperdvi-to-PostScript"></span>
<p>This hypertext support (and original form of the documentation) was
written by Mark Doyle and Tanmoy Bhattacharya as the ‘<samp>dvihps</samp>’
program. You can retrieve their software and additional documentation
@@ -3516,29 +3412,27 @@
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a>:</td><td> </td><td align="left" valign="top">Font quality, missing character psi.
+<tr><td align="left" valign="top">• <a href="#Hypertext-caveats" accesskey="1">Hypertext caveats</a></td><td> </td><td align="left" valign="top">Font quality, missing character psi.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Hypertext-specials" accesskey="2">Hypertext specials</a>:</td><td> </td><td align="left" valign="top">The details on the specials.
+<tr><td align="left" valign="top">• <a href="#Hypertext-specials" accesskey="2">Hypertext specials</a></td><td> </td><td align="left" valign="top">The details on the specials.
</td></tr>
</table>
<hr>
-<a name="Hypertext-caveats"></a>
-<div class="header">
+<span id="Hypertext-caveats"></span><div class="header">
<p>
Next: <a href="#Hypertext-specials" accesskey="n" rel="next">Hypertext specials</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">Hypertext</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Hypertext-caveats-1"></a>
-<h4 class="subsection">5.4.1 Hypertext caveats</h4>
+<span id="Hypertext-caveats-1"></span><h4 class="subsection">5.4.1 Hypertext caveats</h4>
-<a name="index-hypertext-caveats"></a>
+<span id="index-hypertext-caveats"></span>
-<a name="index-Computer-Modern-in-PostScript"></a>
-<a name="index-hypertext-and-bitmap-fonts"></a>
-<a name="index-hypertext-caveats-1"></a>
-<a name="index-embedding-Type-1-fonts"></a>
-<a name="index-PDF-files_002c-font-quality"></a>
+<span id="index-Computer-Modern-in-PostScript"></span>
+<span id="index-hypertext-and-bitmap-fonts"></span>
+<span id="index-hypertext-caveats-1"></span>
+<span id="index-embedding-Type-1-fonts"></span>
+<span id="index-PDF-files_002c-font-quality"></span>
<p>If you intend to go all the way to PDF, you may want to use the standard
35 PostScript fonts exclusively, since other fonts are embedded as
bitmaps by default. The Adobe PDF readers are extremely slow when
@@ -3554,8 +3448,8 @@
add ‘<samp>-Ppdf</samp>’ to the dvips command line switches. The printout
for a run should look something like this:
</p>
-<div class="smallexample">
-<pre class="smallexample"> dvips report -Ppdf -o report.ps
+<div class="example">
+<pre class="example"> dvips report -Ppdf -o report.ps
This is dvips(k) 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com)
' TeX output 2001.06.15:0837' -> report.ps
<tex.pro><alt-rule.pro><texc.pro><texps.pro><special.pro>.
@@ -3579,7 +3473,7 @@
commercial versions of the Computer Modern fonts are available from
Blue Sky; public domain versions - in particular, the lm fonts, and
the cm-super fonts, are available from CTAN sites (for CTAN info,
-see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
+see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>).
</p>
<p>You can convert a PostScript file to PDF using <code>distill</code>, which
comes with Adobe Acrobat, or <code>ps2pdf</code>, which comes with
@@ -3589,9 +3483,9 @@
You can check the fonts in a PDF file with Acrobat Reader by selecting
the menu entries ‘<samp>File|Document Info|Fonts</samp>’.
</p>
-<a name="index-psi-character-missing"></a>
-<a name="index-trailing-spaces_002c-dropped"></a>
-<a name="index-spaces_002c-dropped-trailing"></a>
+<span id="index-psi-character-missing"></span>
+<span id="index-trailing-spaces_002c-dropped"></span>
+<span id="index-spaces_002c-dropped-trailing"></span>
<p>Also, the Adobe distillers prior to 2.1 drop trailing space characters
(character code 32) from strings. Unfortunately, the PostScript fonts
use this character code for characters other than space (notably the
@@ -3625,18 +3519,16 @@
</p>
<hr>
-<a name="Hypertext-specials"></a>
-<div class="header">
+<span id="Hypertext-specials"></span><div class="header">
<p>
Previous: <a href="#Hypertext-caveats" accesskey="p" rel="prev">Hypertext caveats</a>, Up: <a href="#Hypertext" accesskey="u" rel="up">Hypertext</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Hypertext-specials-1"></a>
-<h4 class="subsection">5.4.2 Hypertext specials</h4>
+<span id="Hypertext-specials-1"></span><h4 class="subsection">5.4.2 Hypertext specials</h4>
-<a name="index-hypertext-specials"></a>
-<a name="index-specials_002c-hypertext"></a>
+<span id="index-hypertext-specials"></span>
+<span id="index-specials_002c-hypertext"></span>
-<a name="index-Smith_002c-Arthur"></a>
+<span id="index-Smith_002c-Arthur"></span>
<p>Current support for the World Wide Web in the TeX system does not
involve modifying TeX itself. We need only define some specials;
Arthur Smith (<a href="mailto:apsmith at aps.org">apsmith at aps.org</a>), Tanmoy Bhattacharya, and Paul
@@ -3653,21 +3545,21 @@
are uninterpreted by TeX itself. They are instructions to DVI
processors only.
</p>
-<a name="index-uniform-resource-locator"></a>
-<a name="index-extended-URL"></a>
-<a name="index-URL_002c-extended-for-TeX"></a>
-<a name="index-Murphy_002c-Tim"></a>
+<span id="index-uniform-resource-locator"></span>
+<span id="index-extended-URL"></span>
+<span id="index-URL_002c-extended-for-TeX"></span>
+<span id="index-Murphy_002c-Tim"></span>
<p>Here, <var>xurl</var> is a standard WWW uniform resource locator (URL),
possibly extended with a ‘<samp>#<var>type</var>.<var>string</var></samp>’ construct,
where <var>type</var> is ‘<samp>page</samp>’, ‘<samp>section</samp>’, ‘<samp>equation</samp>’,
‘<samp>reference</samp>’ (for bibliographic references), ‘<samp>figure</samp>’,
‘<samp>table</samp>’, etc. For example,
-</p><div class="smallexample">
-<pre class="smallexample">\special{html:<a href="http://www.maths.tcd.ie/~tim/ch1.dvi#equation.1.1">}
+</p><div class="example">
+<pre class="example">\special{html:<a href="http://www.maths.tcd.ie/~tim/ch1.dvi#equation.1.1">}
</pre></div>
<p>is a link to equation (1.1) in an example document by Tim Murphy.
</p>
-<a name="index-URL_002c-definition"></a>
+<span id="index-URL_002c-definition"></span>
<p>See the URL <a href="http://www.w3.org/hypertext/WWW/Addressing/Addressing.html">http://www.w3.org/hypertext/WWW/Addressing/Addressing.html</a>
for a precise description of base URL’s.
</p>
@@ -3674,9 +3566,9 @@
<p>Descriptions of the <code>\special</code>’s:
</p><dl compact="compact">
<dt>‘<samp>href</samp>’
-<a name="index-href"></a>
+<span id="index-href"></span>
</dt>
-<dd><a name="index-links_002c-hypertext"></a>
+<dd><span id="index-links_002c-hypertext"></span>
<p>Creates links in your TeX document. For example:
</p><div class="example">
<pre class="example">\special{html:<a href="http://www.tug.org/">}\TeX\ Users
@@ -3689,9 +3581,9 @@
</p>
</dd>
<dt>‘<samp>name</samp>’
-<a name="index-name"></a>
+<span id="index-name"></span>
</dt>
-<dd><a name="index-Anderson_002c-Laurie"></a>
+<dd><span id="index-Anderson_002c-Laurie"></span>
<p>Defines URL targets in your TeX documents, so links can be
resolved. For example:
</p><div class="example">
@@ -3705,9 +3597,9 @@
</p>
</dd>
<dt>‘<samp>img</samp>’
-<a name="index-img"></a>
+<span id="index-img"></span>
</dt>
-<dd><a name="index-mailcap-and-hypertext"></a>
+<dd><span id="index-mailcap-and-hypertext"></span>
<p>Links to an arbitrary external file. Interactively, a viewer is spawned
to read the file according to the file extension and your <samp>mailcap</samp>
file (see the Xdvi documentation).
@@ -3714,7 +3606,7 @@
</p>
</dd>
<dt>‘<samp>base</samp>’
-<a name="index-base"></a>
+<span id="index-base"></span>
</dt>
<dd><p>Defines a base URL that is prepended to all the <code>name</code> targets.
Typically unnecessary, as the name of the DVI file being read is used by
@@ -3727,15 +3619,13 @@
</p>
<hr>
-<a name="PostScript-fonts"></a>
-<div class="header">
+<span id="PostScript-fonts"></span><div class="header">
<p>
Next: <a href="#Color" accesskey="n" rel="next">Color</a>, Previous: <a href="#Interaction-with-PostScript" accesskey="p" rel="prev">Interaction with PostScript</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>
</div>
-<a name="PostScript-fonts-1"></a>
-<h2 class="chapter">6 PostScript fonts</h2>
+<span id="PostScript-fonts-1"></span><h2 class="chapter">6 PostScript fonts</h2>
-<a name="index-PostScript-fonts"></a>
+<span id="index-PostScript-fonts"></span>
<p>Dvips supports the use of PostScript fonts in TeX documents. To use
a PostScript font conveniently, you need to prepare a corresponding
@@ -3751,27 +3641,25 @@
supplied with Dvips. (Or if you’re curious.)
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Font-concepts" accesskey="1">Font concepts</a>:</td><td> </td><td align="left" valign="top">Metrics, glyphs, virtual fonts, and encodings.
+<tr><td align="left" valign="top">• <a href="#Font-concepts" accesskey="1">Font concepts</a></td><td> </td><td align="left" valign="top">Metrics, glyphs, virtual fonts, and encodings.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Making-a-font-available" accesskey="2">Making a font available</a>:</td><td> </td><td align="left" valign="top">Installing and using a PostScript font.
+<tr><td align="left" valign="top">• <a href="#Making-a-font-available" accesskey="2">Making a font available</a></td><td> </td><td align="left" valign="top">Installing and using a PostScript font.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Invoking-afm2tfm" accesskey="3">Invoking afm2tfm</a>:</td><td> </td><td align="left" valign="top">Creating TFM and AFM files for a virtual font.
+<tr><td align="left" valign="top">• <a href="#Invoking-afm2tfm" accesskey="3">Invoking afm2tfm</a></td><td> </td><td align="left" valign="top">Creating TFM and AFM files for a virtual font.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#psfonts_002emap" accesskey="4">psfonts.map</a>:</td><td> </td><td align="left" valign="top">Defining available PostScript fonts.
+<tr><td align="left" valign="top">• <a href="#psfonts_002emap" accesskey="4">psfonts.map</a></td><td> </td><td align="left" valign="top">Defining available PostScript fonts.
</td></tr>
</table>
<hr>
-<a name="Font-concepts"></a>
-<div class="header">
+<span id="Font-concepts"></span><div class="header">
<p>
Next: <a href="#Making-a-font-available" accesskey="n" rel="next">Making a font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Font-concepts-1"></a>
-<h3 class="section">6.1 Font concepts</h3>
+<span id="Font-concepts-1"></span><h3 class="section">6.1 Font concepts</h3>
-<a name="index-font-concepts"></a>
+<span id="index-font-concepts"></span>
<p>The information needed to typeset using a particular font is contained
in two files: a <em>metric file</em> that contains shape-independent
@@ -3787,29 +3675,27 @@
i.e., renumbers, the characters of a font.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Metric-files" accesskey="1">Metric files</a>:</td><td> </td><td align="left" valign="top">Shape-independent font information.
+<tr><td align="left" valign="top">• <a href="#Metric-files" accesskey="1">Metric files</a></td><td> </td><td align="left" valign="top">Shape-independent font information.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Glyph-files" accesskey="2">Glyph files</a>:</td><td> </td><td align="left" valign="top">Character shapes.
+<tr><td align="left" valign="top">• <a href="#Glyph-files" accesskey="2">Glyph files</a></td><td> </td><td align="left" valign="top">Character shapes.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Virtual-fonts" accesskey="3">Virtual fonts</a>:</td><td> </td><td align="left" valign="top">Constructing one font from others.
+<tr><td align="left" valign="top">• <a href="#Virtual-fonts" accesskey="3">Virtual fonts</a></td><td> </td><td align="left" valign="top">Constructing one font from others.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Encodings" accesskey="4">Encodings</a>:</td><td> </td><td align="left" valign="top">Character codes and character names.
+<tr><td align="left" valign="top">• <a href="#Encodings" accesskey="4">Encodings</a></td><td> </td><td align="left" valign="top">Character codes and character names.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#PostScript-typesetting" accesskey="5">PostScript typesetting</a>:</td><td> </td><td align="left" valign="top">How PostScript typesets a character.
+<tr><td align="left" valign="top">• <a href="#PostScript-typesetting" accesskey="5">PostScript typesetting</a></td><td> </td><td align="left" valign="top">How PostScript typesets a character.
</td></tr>
</table>
<hr>
-<a name="Metric-files"></a>
-<div class="header">
+<span id="Metric-files"></span><div class="header">
<p>
Next: <a href="#Glyph-files" accesskey="n" rel="next">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Metric-files-1"></a>
-<h4 class="subsection">6.1.1 Metric files</h4>
+<span id="Metric-files-1"></span><h4 class="subsection">6.1.1 Metric files</h4>
-<a name="index-metric-files"></a>
+<span id="index-metric-files"></span>
<p>A <em>metric file</em> describes properties of the font that are
independent of what the characters actually look like. Aside from
@@ -3820,8 +3706,8 @@
<p>The per-character information specifies the width, height, depth, and
italic correction of each character in the font. Any might be zero.
</p>
-<a name="index-kerning_002c-defined"></a>
-<a name="index-ligature_002c-defined"></a>
+<span id="index-kerning_002c-defined"></span>
+<span id="index-ligature_002c-defined"></span>
<p>In addition to information on individual characters, the metric file
specifies <em>kerning</em>, i.e., adding or removing space between
particular character pairs. It further specifies <em>ligature</em>
@@ -3834,37 +3720,37 @@
<p>Different typesetting systems use different metric file formats:
</p>
<ul>
-<li> <a name="index-afm-files"></a>
-<a name="index-_002eafm-Adobe-metric-files"></a>
+<li> <span id="index-afm-files"></span>
+<span id="index-_002eafm-Adobe-metric-files"></span>
Each Postscript font has an <em>Adobe font metrics</em> (‘<samp>.afm</samp>’)
file. These files are plain text, so you can inspect them easily. You
can get AFM files for Adobe’s fonts from
<a href="ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs">ftp://ftp.adobe.com/pub/adobe/Fonts/AFMs</a>.
-</li><li> <a name="index-tfm-files"></a>
-<a name="index-_002etfm-TeX-font-metric-files"></a>
+</li><li> <span id="index-tfm-files"></span>
+<span id="index-_002etfm-TeX-font-metric-files"></span>
TeX uses <em>TeX font metrics</em> (‘<samp>.tfm</samp>’) files. When you say
‘<samp>\font = <var>font</var></samp>’ in your TeX document, TeX reads a file
named ‘<samp><var>font</var>.tfm</samp>’. (Well, except for the <samp>texfonts.map</samp>
-feature; see <a href="http://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then
+feature; see <a href="https://tug.org/texinfohtml/kpathsea.html#Fontmap">Fontmap</a> in <cite>Kpathsea</cite>). TeX can then
calculate the space occupied by characters from the font when
typesetting. In addition, the DVI drivers you use to print or view the
DVI file produced by TeX may need to look at the TFM file.
-<a name="index-property-list-files"></a>
-<a name="index-tftopl"></a>
-<a name="index-pltotf"></a>
-<a name="index-_002epl-property-list-files"></a>
+<span id="index-property-list-files"></span>
+<span id="index-tftopl"></span>
+<span id="index-pltotf"></span>
+<span id="index-_002epl-property-list-files"></span>
<p>TFM files are binary (and hence are typically much smaller than AFM
-files). You can use the <code>tftopl</code> program (see <a href="http://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl
+files). You can use the <code>tftopl</code> program (see <a href="https://tug.org/texinfohtml/web2c.html#tftopl-invocation">tftopl
invocation</a> in <cite>Web2c</cite>) that comes with TeX to transform a TFM
file into a human-readable “property list” (‘<samp>.pl</samp>’) file. You can
also edit a PL file and transform it back to a TeX-readable TFM with
-the companion program <code>pltotf</code> (see <a href="http://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want
+the companion program <code>pltotf</code> (see <a href="https://tug.org/texinfohtml/web2c.html#pltotf-invocation">pltotf invocation</a> in <cite>Web2c</cite>). Editing metrics by hand is not something you’re likely to want
to do often, but the capability is there.
</p>
-</li><li> <a name="index-pfm-files"></a>
-<a name="index-_002epfm-printer-font-metric-files"></a>
+</li><li> <span id="index-pfm-files"></span>
+<span id="index-_002epfm-printer-font-metric-files"></span>
ATM and other typesetting systems use <em>printer font metric</em>
(‘<samp>.pfm</samp>’) files. These are binary files. They are irrelevant in the
TeX world, and not freely available, so we will not discuss them
@@ -3878,15 +3764,13 @@
</p>
<hr>
-<a name="Glyph-files"></a>
-<div class="header">
+<span id="Glyph-files"></span><div class="header">
<p>
Next: <a href="#Virtual-fonts" accesskey="n" rel="next">Virtual fonts</a>, Previous: <a href="#Metric-files" accesskey="p" rel="prev">Metric files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Glyph-files-1"></a>
-<h4 class="subsection">6.1.2 Glyph files</h4>
+<span id="Glyph-files-1"></span><h4 class="subsection">6.1.2 Glyph files</h4>
-<a name="index-glyph-files"></a>
+<span id="index-glyph-files"></span>
<p>Although a metric file (see the previous section) contains information
about the spatial and other properties of the character at position 75,
@@ -3899,9 +3783,9 @@
<p>A <em>glyph file</em> is a file that defines the shapes of the characters
in a font. The shapes can be defined either by outlines or by bitmaps.
</p>
-<a name="index-outline-fonts"></a>
-<a name="index-arcs"></a>
-<a name="index-splines"></a>
+<span id="index-outline-fonts"></span>
+<span id="index-arcs"></span>
+<span id="index-splines"></span>
<p>PostScript fonts are defined as <em>outline fonts</em>: Each character in
the font is defined by giving the mathematical curves (lines, arcs, and
splines) that define its contours. Different sizes of a character are
@@ -3910,11 +3794,11 @@
usually also contain <em>hints</em>—additional information to improve the
appearance of the font at small sizes or low resolutions.
</p>
-<a name="index-Type-1-fonts"></a>
-<a name="index-pfa-files"></a>
-<a name="index-pfb-files"></a>
-<a name="index-_002epfa-printer-font-ascii-files"></a>
-<a name="index-_002epfb-printer-font-binary-files"></a>
+<span id="index-Type-1-fonts"></span>
+<span id="index-pfa-files"></span>
+<span id="index-pfb-files"></span>
+<span id="index-_002epfa-printer-font-ascii-files"></span>
+<span id="index-_002epfb-printer-font-binary-files"></span>
<p>Although various kinds of PostScript outline fonts exist, by far the
most common, and the only one we will consider, is called <em>Type 1</em>.
The glyph files for Postscript Type 1 fonts typically have names ending
@@ -3921,16 +3805,16 @@
in ‘<samp>.pfa</samp>’ (“printer font ASCII”) or ‘<samp>.pfb</samp>’ (“printer font
binary”).
</p>
-<a name="index-bitmap-fonts"></a>
-<a name="index-_002emf-Metafont-source-files"></a>
-<a name="index-Metafont-source-files"></a>
+<span id="index-bitmap-fonts"></span>
+<span id="index-_002emf-Metafont-source-files"></span>
+<span id="index-Metafont-source-files"></span>
<p>In contrast, glyph files for Computer Modern and the other standard
TeX fonts are <em>bitmap fonts</em>, generated from Metafont
(‘<samp>.mf</samp>’) descriptions. The Metafont program distributed with TeX
generates bitmaps from these descriptions.
</p>
-<a name="index-pk-files"></a>
-<a name="index-_002ennnpk-packed-font-bitmaps"></a>
+<span id="index-pk-files"></span>
+<span id="index-_002ennnpk-packed-font-bitmaps"></span>
<p>The glyph files for TeX bitmap fonts are usually stored in
<em>packed font</em> (PK) files. The names of these files end in
‘<samp>.<var>nnn</var>pk</samp>’, where <var>nnn</var> is the resolution of the font in
@@ -3938,8 +3822,8 @@
the ‘<samp>cmr10</samp>’ font at a resolution of 600dpi. (On DOS
filesystems, it’s more likely <samp>dpi600\cmr10.pk</samp>.)
</p>
-<a name="index-gf-files"></a>
-<a name="index-gftopk"></a>
+<span id="index-gf-files"></span>
+<span id="index-gftopk"></span>
<p>Metafont actually outputs <em>generic font</em> (GF) files, e.g.,
<samp>cmr10.600gf</samp>, but the GF files are usually converted immediately
to PK format (using the <code>gftopk</code> utility that comes with TeX)
@@ -3948,15 +3832,13 @@
</p>
<hr>
-<a name="Virtual-fonts"></a>
-<div class="header">
+<span id="Virtual-fonts"></span><div class="header">
<p>
Next: <a href="#Encodings" accesskey="n" rel="next">Encodings</a>, Previous: <a href="#Glyph-files" accesskey="p" rel="prev">Glyph files</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Virtual-fonts-1"></a>
-<h4 class="subsection">6.1.3 Virtual fonts</h4>
+<span id="Virtual-fonts-1"></span><h4 class="subsection">6.1.3 Virtual fonts</h4>
-<a name="index-virtual-fonts"></a>
+<span id="index-virtual-fonts"></span>
<p>A <em>virtual font</em> is constructed by extracting characters from one or
more existing fonts and rearranging them, or synthesizing new characters
@@ -3966,19 +3848,19 @@
primary document on virtual fonts is Donald E. Knuth, <cite>TUGboat</cite>
11(1), Apr. 1990, pp. 13–23, “Virtual Fonts: More Fun for Grand
Wizards” (<samp><var>CTAN:</var>/info/virtual-fonts.knuth</samp>; for CTAN info,
-see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). (Don’t be intimidated by
+see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). (Don’t be intimidated by
the subtitle.)
</p>
-<a name="index-vf-files"></a>
-<a name="index-vpl-files"></a>
+<span id="index-vf-files"></span>
+<span id="index-vpl-files"></span>
<p>A virtual font (‘<samp>.vf</samp>’) file specifies, for each character in the
virtual font, a recipe for typesetting that character. A VF file, like
a TFM file, is in a compressed binary format. The <code>vftovp</code> and
<code>vptovf</code> programs convert a VF file to a human-readable VPL
-(virtual property list) format and back again. See <a href="http://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp
-invocation</a> in <cite>Web2c</cite>, and <a href="http://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>.
+(virtual property list) format and back again. See <a href="https://tug.org/texinfohtml/web2c.html#vftovp-invocation">vftovp
+invocation</a> in <cite>Web2c</cite>, and <a href="https://tug.org/texinfohtml/web2c.html#vptovf-invocation">vptovf invocation</a> in <cite>Web2c</cite>.
</p>
-<a name="index-base-fonts"></a>
+<span id="index-base-fonts"></span>
<p>In the case of a PostScript font <var>f</var> being used in a straightforward
way, the recipe says: character <var>i</var> in the VF font is character
<var>j</var> in font <var>f</var>. The font <var>f</var> is called a <em>base font</em>.
@@ -3990,23 +3872,21 @@
corresponding TFM for use with TeX. This corresponding TFM is
created when you run <code>vptovf</code>.
</p>
-<a name="index-expansion_002c-of-virtual-fonts"></a>
-<a name="index-virtual-font-expansion"></a>
+<span id="index-expansion_002c-of-virtual-fonts"></span>
+<span id="index-virtual-font-expansion"></span>
<p>You can <em>expand</em> virtual fonts into their base fonts with DVIcopy
-(see <a href="http://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are
+(see <a href="https://tug.org/texinfohtml/web2c.html#dvicopy-invocation">dvicopy invocation</a> in <cite>Web2c</cite>). This is useful if you are
using a DVI translator that doesn’t understand vf’s itself.
</p>
<hr>
-<a name="Encodings"></a>
-<div class="header">
+<span id="Encodings"></span><div class="header">
<p>
Next: <a href="#PostScript-typesetting" accesskey="n" rel="next">PostScript typesetting</a>, Previous: <a href="#Virtual-fonts" accesskey="p" rel="prev">Virtual fonts</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Encodings-1"></a>
-<h4 class="subsection">6.1.4 Encodings</h4>
+<span id="Encodings-1"></span><h4 class="subsection">6.1.4 Encodings</h4>
-<a name="index-encodings"></a>
+<span id="index-encodings"></span>
<p>Every font, whatever its type, has an <em>encoding</em>, that specifies the
correspondence between “logical” characters and character codes. For
@@ -4017,7 +3897,7 @@
specify how much space that character occupies; that information is in a
metric file (see <a href="#Metric-files">Metric files</a>).
</p>
-<a name="index-Computer-Modern_002c-encoding-of"></a>
+<span id="index-Computer-Modern_002c-encoding-of"></span>
<p>TeX implicitly assumes a particular encoding for the fonts you use
with it. For example, the plain TeX macro <code>\'</code>, which typesets
an acute accent over the following letter, assumes the acute accent is
@@ -4030,9 +3910,9 @@
font with the information for the acute accent at position 19, where
TeX expects it to be. See <a href="#Making-a-font-available">Making a font available</a>.
</p>
-<a name="index-PostScript-encoding"></a>
-<a name="index-encoding-files"></a>
-<a name="index-encoding-vectors_002c-defined"></a>
+<span id="index-PostScript-encoding"></span>
+<span id="index-encoding-files"></span>
+<span id="index-encoding-vectors_002c-defined"></span>
<p>PostScript represents encodings as a sequence of 256 character names
called an <em>encoding vector</em>. An <em>encoding file</em> (‘<samp>.enc</samp>’)
@@ -4042,12 +3922,12 @@
the PostScript interpreter in your printer if you use one of them in
place of the default encoding vector for a particular PostScript font.
</p>
-<a name="index-dvips_002eenc"></a>
-<a name="index-8r_002eenc"></a>
-<a name="index-texmext_002eenc"></a>
-<a name="index-texmital_002eenc"></a>
-<a name="index-texmsym_002eenc"></a>
-<a name="index-reencode_002f_002a_002eenc"></a>
+<span id="index-dvips_002eenc"></span>
+<span id="index-8r_002eenc"></span>
+<span id="index-texmext_002eenc"></span>
+<span id="index-texmital_002eenc"></span>
+<span id="index-texmsym_002eenc"></span>
+<span id="index-reencode_002f_002a_002eenc"></span>
<p>Examples of encodings: the <samp>dvips.enc</samp> encoding file that comes
with the Fontname distribution (<a href="http://tug.org/fontname">http://tug.org/fontname</a>) is a
good (but not perfect) approximation to the TeX encoding for
@@ -4061,16 +3941,14 @@
</p>
<hr>
-<a name="PostScript-typesetting"></a>
-<div class="header">
+<span id="PostScript-typesetting"></span><div class="header">
<p>
Previous: <a href="#Encodings" accesskey="p" rel="prev">Encodings</a>, Up: <a href="#Font-concepts" accesskey="u" rel="up">Font concepts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="How-PostScript-typesets-a-character"></a>
-<h4 class="subsection">6.1.5 How PostScript typesets a character</h4>
+<span id="How-PostScript-typesets-a-character"></span><h4 class="subsection">6.1.5 How PostScript typesets a character</h4>
-<a name="index-typesetting-in-PostScript"></a>
-<a name="index-character-lookup-procedure-in-PostScript"></a>
+<span id="index-typesetting-in-PostScript"></span>
+<span id="index-character-lookup-procedure-in-PostScript"></span>
<p>The output of Dvips is a program in the PostScript language that
instructs your (presumably PostScript-capable) printer how to typeset
@@ -4090,7 +3968,7 @@
and other information. (If you’re not wondering, skip this section
…)
</p>
-<a name="index-show-PostScript-operator"></a>
+<span id="index-show-PostScript-operator"></span>
<p>The basic PostScript operator for imaging characters is
<code>show</code>. Suppose you’ve asked TeX to typeset an ‘S’. This will
eventually wind up in the Dvips output as the equivalent of this
@@ -4103,13 +3981,13 @@
<p>Here is how PostScript typesets the ‘S’:
</p>
<ol>
-<li> <a name="index-ASCII-character-codes_002c-used-by-PostScript"></a>
+<li> <span id="index-ASCII-character-codes_002c-used-by-PostScript"></span>
PostScript interpreters use ASCII; therefore ‘S’ is represented as the
integer 83. (Any of the 256 possible characters representable in a
standard 8-bit byte can be typeset.)
-</li><li> <a name="index-current-font_002c-in-PostScript"></a>
-<a name="index-dictionary_002c-PostScript-language"></a>
+</li><li> <span id="index-current-font_002c-in-PostScript"></span>
+<span id="index-dictionary_002c-PostScript-language"></span>
A PostScript <em>dictionary</em> is a mapping of names to arbitrary values.
A font, to the interpreter, is a dictionary which contains entries for
certain names. (If these entries are missing, the interpreter refuses
@@ -4118,8 +3996,8 @@
<p>PostScript has a notion of “the current font”—whatever font is
currently being typeset in.
</p>
-</li><li> <a name="index-encoding-vectors_002c-in-Type-1-fonts"></a>
-<a name="index-Encoding-Type-1-dictionary"></a>
+</li><li> <span id="index-encoding-vectors_002c-in-Type-1-fonts"></span>
+<span id="index-Encoding-Type-1-dictionary"></span>
One of the mandatory entries in a font dictionary is ‘<samp>Encoding</samp>’,
which defines the encoding vector (see <a href="#Encodings">Encodings</a>) for that font.
This vector of 256 names maps each possible input character to a name.
@@ -4127,14 +4005,14 @@
</li><li> The interpreter retrieves the entry at position 83 of the encoding
vector. This value is a PostScript name: <code>/S</code>.
-</li><li> <a name="index-CharStrings-Type-1-dictionary"></a>
-<a name="index-dictionary_002c-CharStrings"></a>
+</li><li> <span id="index-CharStrings-Type-1-dictionary"></span>
+<span id="index-dictionary_002c-CharStrings"></span>
For Type 1 fonts (we’re not going to discuss anything else), the
interpreter now looks up <code>/S</code> as a key in a dictionary named
<code>CharStrings</code>, another mandatory entry in a font dictionary.
-</li><li> <a name="index-hints"></a>
-<a name="index-character-definitions-in-PostScript"></a>
+</li><li> <span id="index-hints"></span>
+<span id="index-character-definitions-in-PostScript"></span>
The value of <code>S</code> in <code>CharStrings</code> is the equivalent of a
series of standard PostScript commands like ‘<samp>curveto</samp>’,
‘<samp>lineto</samp>’, ‘<samp>fill</samp>’, and so on. These commands are executed to
@@ -4151,16 +4029,14 @@
</p>
<hr>
-<a name="Making-a-font-available"></a>
-<div class="header">
+<span id="Making-a-font-available"></span><div class="header">
<p>
Next: <a href="#Invoking-afm2tfm" accesskey="n" rel="next">Invoking afm2tfm</a>, Previous: <a href="#Font-concepts" accesskey="p" rel="prev">Font concepts</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Making-a-PostScript-font-available"></a>
-<h3 class="section">6.2 Making a PostScript font available</h3>
+<span id="Making-a-PostScript-font-available"></span><h3 class="section">6.2 Making a PostScript font available</h3>
-<a name="index-installing-fonts"></a>
-<a name="index-fonts_002c-installing"></a>
+<span id="index-installing-fonts"></span>
+<span id="index-fonts_002c-installing"></span>
<p>To make a PostScript font available in a TeX document, you need to
install the font on your system and then define it within the document.
@@ -4210,7 +4086,7 @@
<p>The simplest invocation of Afm2tfm to make virtual fonts goes something
like this:
</p>
-<a name="index-afm2tfm"></a>
+<span id="index-afm2tfm"></span>
<div class="example">
<pre class="example">afm2tfm Times-Roman -v ptmr rptmr
</pre></div>
@@ -4220,7 +4096,7 @@
“raw” font metric file <samp>rptmr.tfm</samp>. To use the font in TeX,
you first run
</p>
-<a name="index-vptovf"></a>
+<span id="index-vptovf"></span>
<div class="example">
<pre class="example">vptovf ptmr.vpl ptmr.vf ptmr.tfm
</pre></div>
@@ -4282,8 +4158,8 @@
you are actually following these instructions for new fonts, most likely
they are not built in to the printer.
</p>
-<a name="index-memory_002c-used-by-PostScript-fonts"></a>
-<a name="index-efficiency_002c-and-fonts"></a>
+<span id="index-memory_002c-used-by-PostScript-fonts"></span>
+<span id="index-efficiency_002c-and-fonts"></span>
<p>These PostScript fonts can be scaled to any size. Go wild! Using
PostScript fonts, however, does use up a great deal of the printer’s
memory and it does take time. You may find downloading bitmap fonts
@@ -4292,15 +4168,13 @@
</p>
<hr>
-<a name="Invoking-afm2tfm"></a>
-<div class="header">
+<span id="Invoking-afm2tfm"></span><div class="header">
<p>
Next: <a href="#psfonts_002emap" accesskey="n" rel="next">psfonts.map</a>, Previous: <a href="#Making-a-font-available" accesskey="p" rel="prev">Making a font available</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Invoking-Afm2tfm"></a>
-<h3 class="section">6.3 Invoking Afm2tfm</h3>
+<span id="Invoking-Afm2tfm"></span><h3 class="section">6.3 Invoking Afm2tfm</h3>
-<a name="index-afm2tfm-1"></a>
+<span id="index-afm2tfm-1"></span>
<p>The Afm2tfm program converts an AFM file for a PostScript font to a TFM
file and a VPL file for a corresponding virtual font (or, in its
@@ -4309,9 +4183,9 @@
especially by the reencodings you can specify with those options. You
can also obtain special effects such as an oblique font.
</p>
-<a name="index-fontinst"></a>
-<a name="index-virtual-fonts_002c-creating"></a>
-<a name="index-Jeffrey_002c-Alan"></a>
+<span id="index-fontinst"></span>
+<span id="index-virtual-fonts_002c-creating"></span>
+<span id="index-Jeffrey_002c-Alan"></span>
<p>Alternatives to Afm2tfm for creating virtual fonts include
<code>fontinst</code> <a href="http://ctan.org/pkg/fontinst">http://ctan.org/pkg/fontinst</a>,
<code>lcdf-typetools</code>, particularly <code>otftotfm</code>
@@ -4319,26 +4193,24 @@
(<a href="http://tex.aanhet.net/afm2pl/">http://tex.aanhet.net/afm2pl/</a>), among others.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a>:</td><td> </td><td align="left" valign="top">Reencoding with -t, -p, -T.
+<tr><td align="left" valign="top">• <a href="#Changing-font-encodings" accesskey="1">Changing font encodings</a></td><td> </td><td align="left" valign="top">Reencoding with -t, -p, -T.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Special-font-effects" accesskey="2">Special font effects</a>:</td><td> </td><td align="left" valign="top">Oblique fonts, small caps, and such.
+<tr><td align="left" valign="top">• <a href="#Special-font-effects" accesskey="2">Special font effects</a></td><td> </td><td align="left" valign="top">Oblique fonts, small caps, and such.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a>:</td><td> </td><td align="left" valign="top">afm2tfm command-line options.
+<tr><td align="left" valign="top">• <a href="#Afm2tfm-options" accesskey="3">Afm2tfm options</a></td><td> </td><td align="left" valign="top">afm2tfm command-line options.
</td></tr>
</table>
<hr>
-<a name="Changing-font-encodings"></a>
-<div class="header">
+<span id="Changing-font-encodings"></span><div class="header">
<p>
Next: <a href="#Special-font-effects" accesskey="n" rel="next">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Changing-font-encodings-1"></a>
-<h4 class="subsection">6.3.1 Changing font encodings</h4>
+<span id="Changing-font-encodings-1"></span><h4 class="subsection">6.3.1 Changing font encodings</h4>
-<a name="index-encoding-changes"></a>
-<a name="index-fonts_002c-changing-encoding-of"></a>
+<span id="index-encoding-changes"></span>
+<span id="index-fonts_002c-changing-encoding-of"></span>
<p>Afm2tfm allows you to specify a different encoding for a PostScript font
(for a general introduction to encodings, see <a href="#Encodings">Encodings</a>). The
@@ -4347,32 +4219,30 @@
detailed in the sections below.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Changing-TeX-encodings" accesskey="1">Changing TeX encodings</a>:</td><td> </td><td align="left" valign="top">Where TeX finds a character.
+<tr><td align="left" valign="top">• <a href="#Changing-TeX-encodings" accesskey="1">Changing TeX encodings</a></td><td> </td><td align="left" valign="top">Where TeX finds a character.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Changing-PostScript-encodings" accesskey="2">Changing PostScript encodings</a>:</td><td> </td><td align="left" valign="top">Where PostScript finds a character.
+<tr><td align="left" valign="top">• <a href="#Changing-PostScript-encodings" accesskey="2">Changing PostScript encodings</a></td><td> </td><td align="left" valign="top">Where PostScript finds a character.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Changing-both-encodings" accesskey="3">Changing both encodings</a>:</td><td> </td><td align="left" valign="top">One and the same, simultaneously.
+<tr><td align="left" valign="top">• <a href="#Changing-both-encodings" accesskey="3">Changing both encodings</a></td><td> </td><td align="left" valign="top">One and the same, simultaneously.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a>:</td><td> </td><td align="left" valign="top">Problems with the default encoding.
+<tr><td align="left" valign="top">• <a href="#Reencoding-with-Afm2tfm" accesskey="4">Reencoding with Afm2tfm</a></td><td> </td><td align="left" valign="top">Problems with the default encoding.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Encoding-file-format" accesskey="5">Encoding file format</a>:</td><td> </td><td align="left" valign="top">Syntax of an encoding file.
+<tr><td align="left" valign="top">• <a href="#Encoding-file-format" accesskey="5">Encoding file format</a></td><td> </td><td align="left" valign="top">Syntax of an encoding file.
</td></tr>
</table>
<hr>
-<a name="Changing-TeX-encodings"></a>
-<div class="header">
+<span id="Changing-TeX-encodings"></span><div class="header">
<p>
Next: <a href="#Changing-PostScript-encodings" accesskey="n" rel="next">Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002dt_003a-Changing-TeX-encodings"></a>
-<h4 class="subsubsection">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</h4>
+<span id="g_t_002dt_003a-Changing-TeX-encodings"></span><h4 class="subsubsection">6.3.1.1 ‘<samp>-t</samp>’: Changing TeX encodings</h4>
-<a name="index-changing-TeX-encodings"></a>
-<a name="index-TeX-encoding_002c-changing"></a>
+<span id="index-changing-TeX-encodings"></span>
+<span id="index-TeX-encoding_002c-changing"></span>
-<a name="index-_002dt-tex_002denc"></a>
+<span id="index-_002dt-tex_002denc"></span>
<p>To build a virtual font with Afm2tfm, you specify the ‘<samp>-v</samp>’ or
‘<samp>-V</samp>’ option. You can then specify an encoding for that virtual font
with ‘<samp>-t <var>tex-enc</var></samp>’. (‘<samp>-t</samp>’ is ignored if neither
@@ -4383,7 +4253,7 @@
<p>If the AFM file has no entry for a character specified in <var>tex-enc</var>,
that character will be omitted from the output VPL.
</p>
-<a name="index-texmsym_002eenc-1"></a>
+<span id="index-texmsym_002eenc-1"></span>
<p>The ‘<samp>-t</samp>’ option is likely to be needed when you have a PostScript
font corresponding to a TeX font other than a normal text font such
as Computer Modern. For instance, if you have a PostScript font that
@@ -4394,17 +4264,15 @@
</p>
<hr>
-<a name="Changing-PostScript-encodings"></a>
-<div class="header">
+<span id="Changing-PostScript-encodings"></span><div class="header">
<p>
Next: <a href="#Changing-both-encodings" accesskey="n" rel="next">Changing both encodings</a>, Previous: <a href="#Changing-TeX-encodings" accesskey="p" rel="prev">Changing TeX encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002dp_003a-Changing-PostScript-encodings"></a>
-<h4 class="subsubsection">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</h4>
+<span id="g_t_002dp_003a-Changing-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.2 ‘<samp>-p</samp>’: Changing PostScript encodings</h4>
-<a name="index-changing-PostScript-encodings"></a>
-<a name="index-PostScript-encoding_002c-changing"></a>
-<a name="index-_002dp-ps_002denc"></a>
+<span id="index-changing-PostScript-encodings"></span>
+<span id="index-PostScript-encoding_002c-changing"></span>
+<span id="index-_002dp-ps_002denc"></span>
<p>By default, Afm2tfm uses the encoding it finds in the AFM file. You can
specify a different PostScript encoding with ‘<samp>-p <var>ps-enc</var></samp>’.
@@ -4420,9 +4288,9 @@
<pre class="example">zpopr Optima "MyEncoding ReEncodeFont" <myenc.enc
</pre></div>
-<a name="index-trademark-character_002c-accessing"></a>
-<a name="index-registered-character_002c-accessing"></a>
-<a name="index-extra-characters_002c-accessing"></a>
+<span id="index-trademark-character_002c-accessing"></span>
+<span id="index-registered-character_002c-accessing"></span>
+<span id="index-extra-characters_002c-accessing"></span>
<p>Using ‘<samp>-p</samp>’ is the only way to access characters in a PostScript
font that are neither encoded in the AFM file nor constructed from other
characters. For instance, Adobe’s ‘<samp>Times-Roman</samp>’ font contains the
@@ -4429,21 +4297,19 @@
extra characters ‘<samp>trademark</samp>’ and ‘<samp>registered</samp>’ (among others);
these can only be accessed through such a PostScript reencoding.
</p>
-<a name="index-8r-encoding_002c-and-extra-characters"></a>
+<span id="index-8r-encoding_002c-and-extra-characters"></span>
<p>The ‘8r’ base encoding used for the current PostScript font
distribution does do this reencoding, for precisely this reason.
</p>
<hr>
-<a name="Changing-both-encodings"></a>
-<div class="header">
+<span id="Changing-both-encodings"></span><div class="header">
<p>
Next: <a href="#Reencoding-with-Afm2tfm" accesskey="n" rel="next">Reencoding with Afm2tfm</a>, Previous: <a href="#Changing-PostScript-encodings" accesskey="p" rel="prev">Changing PostScript encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"></a>
-<h4 class="subsubsection">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</h4>
+<span id="g_t_002dT_003a-Changing-both-TeX-and-PostScript-encodings"></span><h4 class="subsubsection">6.3.1.3 ‘<samp>-T</samp>’: Changing both TeX and PostScript encodings</h4>
-<a name="index-_002dT-enc_002dfile"></a>
+<span id="index-_002dT-enc_002dfile"></span>
<p>The option ‘<samp>-T <var>enc-file</var></samp>’ is equivalent to ‘<samp>-p
<var>enc-file</var> -t <var>enc-file</var></samp>’. If you make regular use of a private
@@ -4455,16 +4321,14 @@
</p>
<hr>
-<a name="Reencoding-with-Afm2tfm"></a>
-<div class="header">
+<span id="Reencoding-with-Afm2tfm"></span><div class="header">
<p>
Next: <a href="#Encoding-file-format" accesskey="n" rel="next">Encoding file format</a>, Previous: <a href="#Changing-both-encodings" accesskey="p" rel="prev">Changing both encodings</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Reencoding-with-Afm2tfm-1"></a>
-<h4 class="subsubsection">6.3.1.4 Reencoding with Afm2tfm</h4>
+<span id="Reencoding-with-Afm2tfm-1"></span><h4 class="subsubsection">6.3.1.4 Reencoding with Afm2tfm</h4>
-<a name="index-reencoding"></a>
-<a name="index-remapping"></a>
+<span id="index-reencoding"></span>
+<span id="index-remapping"></span>
<p>The Afm2tfm program creates the TFM and VF files for the virtual font
corresponding to a PostScript font by <em>reencoding</em> the PostScript
@@ -4492,11 +4356,11 @@
that the properties of PostScript character 194 appear in position 19 of
the TFM file for the virtual font.
</p>
-<a name="index-accents_002c-in-wrong-position"></a>
-<a name="index-Hungarian-umlaut"></a>
-<a name="index-dot-accent"></a>
-<a name="index-Scandinavian-A-ring"></a>
-<a name="index-A-ring_002c-Scandinavian-letter"></a>
+<span id="index-accents_002c-in-wrong-position"></span>
+<span id="index-Hungarian-umlaut"></span>
+<span id="index-dot-accent"></span>
+<span id="index-Scandinavian-A-ring"></span>
+<span id="index-A-ring_002c-Scandinavian-letter"></span>
<p>The default encoding of the distributed fonts (e.g., <samp>ptmr.tfm</samp>)
mostly follows plain TeX conventions for accents. The exceptions:
the Hungarian umlaut (which is at position <code>0x7D</code> in ‘<samp>cmr10</samp>’,
@@ -4509,10 +4373,10 @@
Computer Modern fonts for the relevant accents. They are already part
of the distributed <samp>psfonts.sty</samp> for use with LaTeX.
</p>
-<a name="index-_005cH"></a>
-<a name="index-_005c_002e"></a>
-<a name="index-_005cdot"></a>
-<a name="index-_005cAA"></a>
+<span id="index-_005cH"></span>
+<span id="index-_005c_002e"></span>
+<span id="index-_005cdot"></span>
+<span id="index-_005cAA"></span>
<div class="example">
<pre class="example">\def\H#1{{\accent"CD #1}}
\def\.#1{{\accent"C7 #1}}
@@ -4523,7 +4387,7 @@
\hbox to \wd0{\hss\char'27\hss}}A}
</pre></div>
-<a name="index-CODINGSCHEME"></a>
+<span id="index-CODINGSCHEME"></span>
<p>As a kind of summary, here are the ‘<samp>CODINGSCHEME</samp>’s that result from
the various possible choices for reencoding.
</p>
@@ -4559,15 +4423,13 @@
</p>
<hr>
-<a name="Encoding-file-format"></a>
-<div class="header">
+<span id="Encoding-file-format"></span><div class="header">
<p>
Previous: <a href="#Reencoding-with-Afm2tfm" accesskey="p" rel="prev">Reencoding with Afm2tfm</a>, Up: <a href="#Changing-font-encodings" accesskey="u" rel="up">Changing font encodings</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Encoding-file-format-1"></a>
-<h4 class="subsubsection">6.3.1.5 Encoding file format</h4>
+<span id="Encoding-file-format-1"></span><h4 class="subsubsection">6.3.1.5 Encoding file format</h4>
-<a name="index-encoding-file-format"></a>
+<span id="index-encoding-file-format"></span>
<p>Afm2tfm’s encoding files have the same format as an encoding vector in a
PostScript font. Here is a skeletal example:
@@ -4585,7 +4447,7 @@
<p>These encoding files are downloaded as part of changing the encoding at
the PostScript level (see the previous section).
</p>
-<a name="index-comments_002c-in-encoding-files"></a>
+<span id="index-comments_002c-in-encoding-files"></span>
<p>Comments, which start with a percent sign and continue until the end
of the line, are ignored unless they start with ‘<samp>LIGKERN</samp>’ (see below).
</p>
@@ -4604,12 +4466,12 @@
by a space and a semicolon and (unless the semicolon is at the end of a
line) another space.
</p>
-<a name="index-LIGKERN-encoding-file-command"></a>
+<span id="index-LIGKERN-encoding-file-command"></span>
<p>In these <code>LIGKERN</code> statements, three types of information may be
specified. These three types are ligature pairs, kerns to ignore, and
the character value of this font’s boundary character.
</p>
-<a name="index-boundary-character"></a>
+<span id="index-boundary-character"></span>
<p>Throughout a <code>LIGKERN</code> statement, the boundary character is
specified as ‘<samp>||</samp>’. To set the font’s boundary character value for
TeX:
@@ -4626,14 +4488,14 @@
as ‘<samp>*</samp>’, which is a wild card matching any character; thus, all
kerns can be removed with ‘<samp>* {} * ;</samp>’.
</p>
-<a name="index-ligature-operations"></a>
-<a name="index-Metafont-ligature-operations"></a>
+<span id="index-ligature-operations"></span>
+<span id="index-Metafont-ligature-operations"></span>
<p>To specify a ligature, specify the names of the pair of characters,
followed by the ligature operation (as in Metafont), followed by the
replacing character name. Either (but not both) of the first two
characters can be ‘<samp>||</samp>’ to indicate a word boundary.
</p>
-<a name="index-_003d_003a-ligature-operation"></a>
+<span id="index-_003d_003a-ligature-operation"></span>
<p>The most common operation is ‘<samp>=:</samp>’ meaning that both characters are
removed and replaced by the third character, but by adding the ‘<samp>|</samp>’
character on either side of the ‘<samp>=:</samp>’, you can retain either or both
@@ -4668,17 +4530,15 @@
<hr>
-<a name="Special-font-effects"></a>
-<div class="header">
+<span id="Special-font-effects"></span><div class="header">
<p>
Next: <a href="#Afm2tfm-options" accesskey="n" rel="next">Afm2tfm options</a>, Previous: <a href="#Changing-font-encodings" accesskey="p" rel="prev">Changing font encodings</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Special-font-effects-1"></a>
-<h4 class="subsection">6.3.2 Special font effects</h4>
+<span id="Special-font-effects-1"></span><h4 class="subsection">6.3.2 Special font effects</h4>
-<a name="index-oblique-fonts"></a>
-<a name="index-slanted-fonts"></a>
-<a name="index-fonts_002c-slanted"></a>
+<span id="index-oblique-fonts"></span>
+<span id="index-slanted-fonts"></span>
+<span id="index-fonts_002c-slanted"></span>
<p>Besides the reencodings described in the previous section, Afm2tfm can
do other manipulations. (Again, it’s best to use the prebuilt fonts
rather than attempting to remake them.)
@@ -4692,19 +4552,19 @@
<p>This creates <samp>ptmro.vpl</samp> and <samp>rptmro.tfm</samp>. To use this font,
put the line
</p>
-<a name="index-SlantFont"></a>
+<span id="index-SlantFont"></span>
<div class="example">
<pre class="example">rptmro Times-Roman ".167 SlantFont"
</pre></div>
-<p><a name="index-psfonts_002emap-1"></a>
+<p><span id="index-psfonts_002emap-1"></span>
into <samp>psfonts.map</samp>. Then ‘<samp>rptmro</samp>’ (our name for the obliqued
Times) will act as if it were a resident font, although it is actually
constructed from Times-Roman via the PostScript routine <code>SlantFont</code>
(which will slant everything 1/6 to the right, in this case).
</p>
-<a name="index-expanded-fonts"></a>
-<a name="index-fonts_002c-expanded"></a>
+<span id="index-expanded-fonts"></span>
+<span id="index-fonts_002c-expanded"></span>
<p>Similarly, you can get an expanded font with
</p>
<div class="example">
@@ -4712,7 +4572,7 @@
</pre></div>
<p>and by recording the pseudo-resident font
-<a name="index-ExtendFont"></a>
+<span id="index-ExtendFont"></span>
</p>
<div class="example">
<pre class="example">rptmrre Times-Roman "1.2 ExtendFont"
@@ -4721,8 +4581,8 @@
<p>in <samp>psfonts.map</samp>.
</p>
<p>You can also create a small caps font with a command such as
-<a name="index-small-caps-fonts"></a>
-<a name="index-fonts_002c-small-caps"></a>
+<span id="index-small-caps-fonts"></span>
+<span id="index-fonts_002c-small-caps"></span>
</p>
<div class="example">
<pre class="example">afm2tfm Times-Roman -V ptmrc rptmrc
@@ -4742,9 +4602,9 @@
professional looking set of small caps, you need to acquire a small caps
font.
</p>
-<a name="index-PaintType"></a>
-<a name="index-outline-fonts-1"></a>
-<a name="index-fonts_002c-outlined"></a>
+<span id="index-PaintType"></span>
+<span id="index-outline-fonts-1"></span>
+<span id="index-fonts_002c-outlined"></span>
<p>To change the <code>PaintType</code> in a font from filled (0) to outlined
(2), you can add <code>"/PaintType 2 store"</code> to <samp>psfonts.map</samp>, as
in the following:
@@ -4763,16 +4623,14 @@
</p>
<hr>
-<a name="Afm2tfm-options"></a>
-<div class="header">
+<span id="Afm2tfm-options"></span><div class="header">
<p>
Previous: <a href="#Special-font-effects" accesskey="p" rel="prev">Special font effects</a>, Up: <a href="#Invoking-afm2tfm" accesskey="u" rel="up">Invoking afm2tfm</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Afm2tfm-options-1"></a>
-<h4 class="subsection">6.3.3 Afm2tfm options</h4>
+<span id="Afm2tfm-options-1"></span><h4 class="subsection">6.3.3 Afm2tfm options</h4>
-<a name="index-options_002c-to-Afm2tfm"></a>
-<a name="index-afm2tfm-options"></a>
+<span id="index-options_002c-to-Afm2tfm"></span>
+<span id="index-afm2tfm-options"></span>
<p>Synopsis:
</p><div class="example">
@@ -4790,8 +4648,8 @@
<pre class="example">afm2tfm Times-Roman rptmr
</pre></div>
-<a name="index-accents_002c-wrong"></a>
-<a name="index-raw-tfm-files"></a>
+<span id="index-accents_002c-wrong"></span>
+<span id="index-raw-tfm-files"></span>
<p>The TFM file thus created is <em>raw</em> because it omits ligature and
kern information, and does no character remapping; it contains only
the character information in the AFM file in TFM format, which is the form
@@ -4809,8 +4667,8 @@
</p>
<dl compact="compact">
<dt>‘<samp>-a</samp>’</dt>
-<dd><a name="index-_002da-1"></a>
-<a name="index-accent-height-adjustment_002c-omitting"></a>
+<dd><span id="index-_002da-1"></span>
+<span id="index-accent-height-adjustment_002c-omitting"></span>
<p>By default, Afm2tfm looks for precomposed accented characters, such as
tdieresis, and possibly adjusts the height of the basic letter (t)
upward so that the result of using <code>\accent</code> (as in <code>\"t</code>)
@@ -4822,23 +4680,23 @@
</p>
</dd>
<dt>‘<samp>-c <var>ratio</var></samp>’</dt>
-<dd><a name="index-_002dc-ratio"></a>
-<a name="index-scaling-small-caps"></a>
+<dd><span id="index-_002dc-ratio"></span>
+<span id="index-scaling-small-caps"></span>
<p>See ‘<samp>-V</samp>’; overrides the default ratio of 0.8 for the
scaling of small caps.
</p>
</dd>
<dt>‘<samp>-e <var>ratio</var></samp>’</dt>
-<dd><a name="index-_002de-ratio"></a>
-<a name="index-expanded-fonts-1"></a>
-<a name="index-condensed-fonts"></a>
+<dd><span id="index-_002de-ratio"></span>
+<span id="index-expanded-fonts-1"></span>
+<span id="index-condensed-fonts"></span>
<p>Stretch characters horizontally by <var>ratio</var>; if less than 1.0, you
get a condensed font.
</p>
</dd>
<dt>‘<samp>-O</samp>’</dt>
-<dd><a name="index-_002dO"></a>
-<a name="index-octal-character-codes"></a>
+<dd><span id="index-_002dO"></span>
+<span id="index-octal-character-codes"></span>
<p>Output all character codes in the ‘<samp>vpl</samp>’ file as octal numbers, not
names; this is useful for symbol or other special-purpose fonts where
character names such as ‘<samp>A</samp>’ have no meaning.
@@ -4845,7 +4703,7 @@
</p>
</dd>
<dt>‘<samp>-p <var>ps-enc</var></samp>’</dt>
-<dd><a name="index-_002dp-ps_002denc-1"></a>
+<dd><span id="index-_002dp-ps_002denc-1"></span>
<p>Use <var>ps-enc</var> for the destination (PostScript) encoding of the font;
<var>ps-enc</var> must be mentioned as a header file for the font in
‘<samp>psfonts.map</samp>’.
@@ -4853,8 +4711,8 @@
</p>
</dd>
<dt>‘<samp>-s <var>slant</var></samp>’</dt>
-<dd><a name="index-_002ds-slant"></a>
-<a name="index-slanted-fonts_002c-making"></a>
+<dd><span id="index-_002ds-slant"></span>
+<span id="index-slanted-fonts_002c-making"></span>
<p>Slant characters to the right by <var>slant</var>. If <var>slant</var> is
negative, the letters slope to the left (or they might be upright if you
start with an italic font).
@@ -4861,7 +4719,7 @@
</p>
</dd>
<dt>‘<samp>-t <var>tex-enc</var></samp>’</dt>
-<dd><a name="index-_002dt-tex_002denc-1"></a>
+<dd><span id="index-_002dt-tex_002denc-1"></span>
<p>Use <var>tex-enc</var> for the target (TeX) encoding of the font.
Ligature and kern information may also be specified in <var>file</var>.
<var>file</var> is not mentioned in <samp>psfonts.map</samp>.
@@ -4868,13 +4726,13 @@
</p>
</dd>
<dt>‘<samp>-T <var>ps-tex-enc</var></samp>’</dt>
-<dd><a name="index-_002dT-ps_002dtex_002denc"></a>
+<dd><span id="index-_002dT-ps_002dtex_002denc"></span>
<p>Use <var>ps-tex-enc</var> for both the PostScript and target TeX encodings
of the font. Equivalent to ‘<samp>-p <var>file</var> -t <var>file</var></samp>’.
</p>
</dd>
<dt>‘<samp>-u</samp>’</dt>
-<dd><a name="index-_002du"></a>
+<dd><span id="index-_002du"></span>
<p>Use only those characters specified in the TeX encoding, and no
others. By default, Afm2tfm tries to include all characters in the
input font, even those not present in the TeX encoding (it puts them
@@ -4882,12 +4740,12 @@
</p>
</dd>
<dt>‘<samp>-v <var>vpl-file</var></samp>’</dt>
-<dd><a name="index-_002dv-vpl_002dfile"></a>
+<dd><span id="index-_002dv-vpl_002dfile"></span>
<p>Output a VPL (virtual property list) file, as well as a TFM file.
</p>
</dd>
<dt>‘<samp>-V <var>vpl-file</var></samp>’</dt>
-<dd><a name="index-_002dV-vpl_002dfile"></a>
+<dd><span id="index-_002dV-vpl_002dfile"></span>
<p>Same as ‘<samp>-v</samp>’, but the virtual font generated is a pseudo small caps
font obtained by scaling uppercase letters by 0.8 to typeset
lowercase. This font handles accented letters and retains proper
@@ -4897,18 +4755,16 @@
<hr>
-<a name="psfonts_002emap"></a>
-<div class="header">
+<span id="psfonts_002emap"></span><div class="header">
<p>
Previous: <a href="#Invoking-afm2tfm" accesskey="p" rel="prev">Invoking afm2tfm</a>, Up: <a href="#PostScript-fonts" accesskey="u" rel="up">PostScript fonts</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="psfonts_002emap_003a-PostScript-font-catalog"></a>
-<h3 class="section">6.4 <samp>psfonts.map</samp>: PostScript font catalog</h3>
+<span id="psfonts_002emap_003a-PostScript-font-catalog"></span><h3 class="section">6.4 <samp>psfonts.map</samp>: PostScript font catalog</h3>
-<a name="index-psfonts_002emap-2"></a>
-<a name="index-non_002dresident-fonts"></a>
-<a name="index-downloading-PostScript-fonts"></a>
-<a name="index-fonts_002c-downloading"></a>
+<span id="index-psfonts_002emap-2"></span>
+<span id="index-non_002dresident-fonts"></span>
+<span id="index-downloading-PostScript-fonts"></span>
+<span id="index-fonts_002c-downloading"></span>
<p>The <samp>psfonts.map</samp> file associates a PostScript font with related
files and constructs. Each line has the format:
@@ -4917,7 +4773,7 @@
<pre class="example"><var>filename</var> <var>PostScript-name</var> <var>options</var>
</pre></div>
-<a name="index-_003c-font-downloading"></a>
+<span id="index-_003c-font-downloading"></span>
<p>For example, the line
</p><div class="example">
<pre class="example">rpstrn StoneInformal <StoneInformal.pfb
@@ -4928,10 +4784,10 @@
The PostScript <code>/FontName</code> of the font defined inside the ‘<samp>pfb</samp>’
file should be <code>StoneInformal</code>.
</p>
-<a name="index-transforming-downloaded-fonts"></a>
-<a name="index-expanded-fonts-2"></a>
-<a name="index-wide-fonts"></a>
-<a name="index-narrow-fonts"></a>
+<span id="index-transforming-downloaded-fonts"></span>
+<span id="index-expanded-fonts-2"></span>
+<span id="index-wide-fonts"></span>
+<span id="index-narrow-fonts"></span>
<p>You can generate transformed fonts with a line like this:
</p><div class="example">
<pre class="example">rpstrc StoneInformal <StoneInformal.pfb ".8 ExtendFont"
@@ -4940,50 +4796,50 @@
<p>See <a href="#Special-font-effects">Special font effects</a>, for a
complete list of font effects.
</p>
-<a name="index-reencoding-PostScript-fonts"></a>
+<span id="index-reencoding-PostScript-fonts"></span>
<p>You can change the encoding of the Type 1 font at the PostScript
level with a ‘<samp>ReEncodeFont</samp>’ instruction, plus the name of the
encoding file. This allows you access to characters that may be present
in the Type 1 font file, but not encoded by default—most of the
preaccented characters, for example. An example:
-</p><div class="smallexample">
-<pre class="smallexample">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <8r.enc <pstrn8a.pfb
+</p><div class="example">
+<pre class="example">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <8r.enc <pstrn8a.pfb
</pre></div>
-<a name="index-8r-font-encoding"></a>
-<a name="index-base-encoding_002c-recommended"></a>
+<span id="index-8r-font-encoding"></span>
+<span id="index-base-encoding_002c-recommended"></span>
<p>The ‘<samp>8r</samp>’ encoding mentioned here has been designed to serve as a
base for all downloadable fonts; it allows access to all the characters
commonly present in a Type 1 font. For more details, see the
<samp>8r.enc</samp> source file that comes with (and is installed with) Dvips.
</p>
-<a name="index-_003c_005b-encoding-vector-downloading"></a>
+<span id="index-_003c_005b-encoding-vector-downloading"></span>
<p>You may notice that the same syntax is used for downloading encoding
vectors and Type 1 font files. To make your intentions clear, you can
also use ‘<samp><[</samp>’ to explicitly indicate you are downloading an
encoding vector, as in:
-</p><div class="smallexample">
-<pre class="smallexample">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <[8r.enc <pstrn8a.pfb
+</p><div class="example">
+<pre class="example">pstrn8r StoneInformal "TeXBase1Encoding ReEncodeFont" <[8r.enc <pstrn8a.pfb
</pre></div>
-<a name="index-_002eenc-extension-for-encoding-vectors"></a>
+<span id="index-_002eenc-extension-for-encoding-vectors"></span>
<p>If the filename of your encoding vector does not end in ‘<samp>.enc</samp>’, and
you are using partial font downloading, you must use the ‘<samp><[</samp>’
syntax, or Dvips will not download the font properly.
</p>
-<a name="index-_002epfa-extension-required-for-partial-downloading"></a>
-<a name="index-_002epfb-extension-required-for-partial-downloading"></a>
+<span id="index-_002epfa-extension-required-for-partial-downloading"></span>
+<span id="index-_002epfb-extension-required-for-partial-downloading"></span>
<p>Similarly, the name of the Type 1 font file itself must have extension
<samp>.pfa</samp> or <samp>.pfb</samp> for partial downloading to work properly.
</p>
-<a name="index-pfb-files_002c-automatically-unpacked"></a>
+<span id="index-pfb-files_002c-automatically-unpacked"></span>
<p>When using PFB files, Dvips is smart enough to unpack the binary PFB
format into printable ASCII so there is no need to perform this
conversion yourself. In addition, Dvips scans the font to determine its
memory usage, just as it does for other header files (see <a href="#Header-files">Header files</a>).
</p>
-<a name="index-partial-font-downloading"></a>
-<a name="index-downloading-fonts-partially"></a>
+<span id="index-partial-font-downloading"></span>
+<span id="index-downloading-fonts-partially"></span>
<p>If the ‘<samp>j</samp>’ config file or command-line option is enabled (as it
is by default), <samp>StoneInformal.pfb</samp> will be <em>partially
downloaded</em>—only those characters your document actually uses will
@@ -4990,10 +4846,10 @@
be extracted and downloaded, and the remainder discarded.
See <a href="#Option-details">Option details</a>.
</p>
-<a name="index-whole-font-downloading"></a>
-<a name="index-multiple-master-fonts"></a>
-<a name="index-Minion-typeface-family"></a>
-<a name="index-_003c_003c-whole-font-downloading"></a>
+<span id="index-whole-font-downloading"></span>
+<span id="index-multiple-master-fonts"></span>
+<span id="index-Minion-typeface-family"></span>
+<span id="index-_003c_003c-whole-font-downloading"></span>
<p>Adobe Multiple Master fonts, such as Minion, cannot be partially
downloaded. To partially download in general, but avoid partial
downloading for individual fonts, use ‘<samp><<</samp>’ instead ‘<samp><</samp>’:
@@ -5041,17 +4897,15 @@
<hr>
-<a name="Color"></a>
-<div class="header">
+<span id="Color"></span><div class="header">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#PostScript-fonts" accesskey="p" rel="prev">PostScript fonts</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>
</div>
-<a name="Color-1"></a>
-<h2 class="chapter">7 Color</h2>
+<span id="Color-1"></span><h2 class="chapter">7 Color</h2>
-<a name="index-color"></a>
+<span id="index-color"></span>
-<a name="index-Hafner_002c-Jim"></a>
+<span id="index-Hafner_002c-Jim"></span>
<p>Dvips supports one-pass multi-color printing of TeX documents on any
color PostScript device. Initially added by Jim Hafner, IBM Research,
<a href="mailto:hafner at almaden.ibm.com">hafner at almaden.ibm.com</a>, the color support has gone through many
@@ -5065,32 +4919,30 @@
for the TeX administrator.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Color-macro-files" accesskey="1">Color macro files</a>:</td><td> </td><td align="left" valign="top">TeX macro definitions.
+<tr><td align="left" valign="top">• <a href="#Color-macro-files" accesskey="1">Color macro files</a></td><td> </td><td align="left" valign="top">TeX macro definitions.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a>:</td><td> </td><td align="left" valign="top">Adding your own colors.
+<tr><td align="left" valign="top">• <a href="#User_002ddefinable-colors" accesskey="2">User-definable colors</a></td><td> </td><td align="left" valign="top">Adding your own colors.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color-subtleties" accesskey="3">Color subtleties</a>:</td><td> </td><td align="left" valign="top">Subtleties in using color.
+<tr><td align="left" valign="top">• <a href="#Color-subtleties" accesskey="3">Color subtleties</a></td><td> </td><td align="left" valign="top">Subtleties in using color.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Ted-Turner" accesskey="4">Ted Turner</a>:</td><td> </td><td align="left" valign="top">Printing in black/white after colorizing.
+<tr><td align="left" valign="top">• <a href="#Ted-Turner" accesskey="4">Ted Turner</a></td><td> </td><td align="left" valign="top">Printing in black/white after colorizing.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color-device-configuration" accesskey="5">Color device configuration</a>:</td><td> </td><td align="left" valign="top">Configuring Dvips for color devices.
+<tr><td align="left" valign="top">• <a href="#Color-device-configuration" accesskey="5">Color device configuration</a></td><td> </td><td align="left" valign="top">Configuring Dvips for color devices.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color-support-details" accesskey="6">Color support details</a>:</td><td> </td><td align="left" valign="top">Color support details
+<tr><td align="left" valign="top">• <a href="#Color-support-details" accesskey="6">Color support details</a></td><td> </td><td align="left" valign="top">Color support details
</td></tr>
</table>
<hr>
-<a name="Color-macro-files"></a>
-<div class="header">
+<span id="Color-macro-files"></span><div class="header">
<p>
Next: <a href="#User_002ddefinable-colors" accesskey="n" rel="next">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-macro-files-1"></a>
-<h3 class="section">7.1 Color macro files</h3>
+<span id="Color-macro-files-1"></span><h3 class="section">7.1 Color macro files</h3>
-<a name="index-macros-for-color"></a>
-<a name="index-color-macros"></a>
+<span id="index-macros-for-color"></span>
+<span id="index-color-macros"></span>
<p>All the color macro commands are defined in ‘<samp>colordvi.tex</samp>’ (or
‘<samp>colordvi.sty</samp>’). To access these macros simply add to the top of
@@ -5107,9 +4959,9 @@
<samp><var>CTAN</var>:doc/latex/graphics/</samp>. See also
<samp><var>CTAN</var>:doc/epslatex.ps</samp>.
</p>
-<a name="index-Crayola-crayon-box"></a>
-<a name="index-Pantone-colors"></a>
-<a name="index-color-names_002c-mixed-case"></a>
+<span id="index-Crayola-crayon-box"></span>
+<span id="index-Pantone-colors"></span>
+<span id="index-color-names_002c-mixed-case"></span>
<p>These macros provide two basic kinds of color macros: ones for local
color changes (a few words, a single symbol) and one for global color
changes (the whole document). All the color names use a mixed case
@@ -5127,7 +4979,7 @@
<pre class="example">\<var>ColorName</var>{this is the color <var>ColorName</var>}
</pre></div>
-<a name="index-_005cColorName"></a>
+<span id="index-_005cColorName"></span>
<p>where <var>ColorName</var> is the name of a predefined color, e.g.,
‘<samp>Blue</samp>’. As shown, these macros take one argument, the text to
print in the specified color. This can be used for nested color changes
@@ -5139,7 +4991,7 @@
\Blue{nesting blue}, recovering the red} and back to original.
</pre></div>
-<p><a name="index-color-nesting-level"></a>
+<p><span id="index-color-nesting-level"></span>
The color nesting level has no hard limit, but it is not advisable to
nest too deeply lest you and the reader lose track of the color history.
</p>
@@ -5149,7 +5001,7 @@
<pre class="example">\text<var>ColorName</var>
</pre></div>
-<p><a name="index-_005ctextColorName"></a>
+<p><span id="index-_005ctextColorName"></span>
These macros take no arguments and changes the default color from that
point on to <var>ColorName</var>. This of course can be overridden globally
by another such command or locally by local color commands. For example,
@@ -5181,16 +5033,14 @@
</p>
<hr>
-<a name="User_002ddefinable-colors"></a>
-<div class="header">
+<span id="User_002ddefinable-colors"></span><div class="header">
<p>
Next: <a href="#Color-subtleties" accesskey="n" rel="next">Color subtleties</a>, Previous: <a href="#Color-macro-files" accesskey="p" rel="prev">Color macro files</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User_002ddefinable-colors-1"></a>
-<h3 class="section">7.2 User-definable colors</h3>
+<span id="User_002ddefinable-colors-1"></span><h3 class="section">7.2 User-definable colors</h3>
-<a name="index-user_002ddefinable-colors"></a>
-<a name="index-colors_002c-user_002ddefinable"></a>
+<span id="index-user_002ddefinable-colors"></span>
+<span id="index-colors_002c-user_002ddefinable"></span>
<p>There are two ways for the user to specify colors not already defined.
For local changes, there is the command <code>\Color</code> which takes two
@@ -5223,15 +5073,13 @@
</p>
<hr>
-<a name="Color-subtleties"></a>
-<div class="header">
+<span id="Color-subtleties"></span><div class="header">
<p>
Next: <a href="#Ted-Turner" accesskey="n" rel="next">Ted Turner</a>, Previous: <a href="#User_002ddefinable-colors" accesskey="p" rel="prev">User-definable colors</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-subtleties-1"></a>
-<h3 class="section">7.3 Color subtleties</h3>
+<span id="Color-subtleties-1"></span><h3 class="section">7.3 Color subtleties</h3>
-<a name="index-color-subtleties"></a>
+<span id="index-color-subtleties"></span>
<p>Color macros are defined via <code>\special</code> keywords. As such, they
are put in the ‘<samp>.dvi</samp>’ file only as explicit message strings to the
@@ -5266,13 +5114,11 @@
</p>
<hr>
-<a name="Ted-Turner"></a>
-<div class="header">
+<span id="Ted-Turner"></span><div class="header">
<p>
Next: <a href="#Color-device-configuration" accesskey="n" rel="next">Color device configuration</a>, Previous: <a href="#Color-subtleties" accesskey="p" rel="prev">Color subtleties</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Printing-in-black_002fwhite-after-colorizing"></a>
-<h3 class="section">7.4 Printing in black/white after colorizing</h3>
+<span id="Printing-in-black_002fwhite-after-colorizing"></span><h3 class="section">7.4 Printing in black/white after colorizing</h3>
<p>If you have a TeX or LaTeX document written with color macros and
you want to print it in black and white there are two options. On all
@@ -5293,16 +5139,14 @@
</p>
<hr>
-<a name="Color-device-configuration"></a>
-<div class="header">
+<span id="Color-device-configuration"></span><div class="header">
<p>
Next: <a href="#Color-support-details" accesskey="n" rel="next">Color support details</a>, Previous: <a href="#Ted-Turner" accesskey="p" rel="prev">Ted Turner</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-device-configuration-1"></a>
-<h3 class="section">7.5 Color device configuration</h3>
+<span id="Color-device-configuration-1"></span><h3 class="section">7.5 Color device configuration</h3>
-<a name="index-color-configuration"></a>
-<a name="index-configuration_002c-of-color-devices"></a>
+<span id="index-color-configuration"></span>
+<span id="index-configuration_002c-of-color-devices"></span>
<p>To configure Dvips for a particular color device you need to fine tune
the color parameters to match your device’s color rendition. To do this,
@@ -5316,8 +5160,8 @@
‘<samp>currentcmykcolor</samp>’ in terms of a RGB equivalent so if your device
only understands RGB, there should be no problem.
</p>
-<a name="index-Phaser-printer_002c-used-for-color-calibration"></a>
-<a name="index-Tektronix-Phaser-printer_002c-used-for-color-calibration"></a>
+<span id="index-Phaser-printer_002c-used-for-color-calibration"></span>
+<span id="index-Tektronix-Phaser-printer_002c-used-for-color-calibration"></span>
<p>The parameters set in this file were determined by comparing the Pantone
chart of a Tektronix Phaser printer with the actual Crayola Crayons.
Because these were defined for a particular device, the actual color
@@ -5358,13 +5202,11 @@
</p>
<hr>
-<a name="Color-support-details"></a>
-<div class="header">
+<span id="Color-support-details"></span><div class="header">
<p>
Previous: <a href="#Color-device-configuration" accesskey="p" rel="prev">Color device configuration</a>, Up: <a href="#Color" accesskey="u" rel="up">Color</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-support-details-1"></a>
-<h3 class="section">7.6 Color support details</h3>
+<span id="Color-support-details-1"></span><h3 class="section">7.6 Color support details</h3>
<p>To support color, Dvips recognizes a certain set of specials. These
specials start with the keyword ‘<samp>color</samp>’ or the keyword
@@ -5371,23 +5213,21 @@
‘<samp>background</samp>’, followed by a color specification.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Color-specifications" accesskey="1">Color specifications</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Color-specifications" accesskey="1">Color specifications</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Color-specials" accesskey="2">Color specials</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Color-specials" accesskey="2">Color specials</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Color-specifications"></a>
-<div class="header">
+<span id="Color-specifications"></span><div class="header">
<p>
Next: <a href="#Color-specials" accesskey="n" rel="next">Color specials</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-specifications-1"></a>
-<h4 class="subsection">7.6.1 Color specifications</h4>
+<span id="Color-specifications-1"></span><h4 class="subsection">7.6.1 Color specifications</h4>
-<a name="index-color-specifications"></a>
+<span id="index-color-specifications"></span>
<p>What is a color specification? One of three things. First, it might be
a PostScript procedure as defined in a PostScript header file. The
@@ -5415,13 +5255,11 @@
</p>
<hr>
-<a name="Color-specials"></a>
-<div class="header">
+<span id="Color-specials"></span><div class="header">
<p>
Previous: <a href="#Color-specifications" accesskey="p" rel="prev">Color specifications</a>, Up: <a href="#Color-support-details" accesskey="u" rel="up">Color support details</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Color-specials-1"></a>
-<h4 class="subsection">7.6.2 Color specials</h4>
+<span id="Color-specials-1"></span><h4 class="subsection">7.6.2 Color specials</h4>
<p>We will describe ‘<samp>background</samp>’ first, since it is the simplest. The
‘<samp>background</samp>’ keyword must be followed by a color specification.
@@ -5463,13 +5301,11 @@
</p>
<hr>
-<a name="Index"></a>
-<div class="header">
+<span id="Index"></span><div class="header">
<p>
Previous: <a href="#Color" accesskey="p" rel="prev">Color</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>
</div>
-<a name="Index-1"></a>
-<h2 class="unnumbered">Index</h2>
+<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>!</b></a>
@@ -5558,14 +5394,14 @@
<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-1">!</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-1">!</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0021-special-_0028literal-PS-header_0029"><code>! <span class="roman">special (literal PS header)</span></code></a>:</td><td> </td><td valign="top"><a href="#Literal-headers">Literal headers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0021-starting-output-filename"><code>! <span class="roman">starting output filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-2">"</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-2">"</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0022-special-_0028literal-PostScript_0029"><code>" <span class="roman">special (literal PostScript)</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_0022-special">" special</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-3">%</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-3">%</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0025_0025BoundingBox"><code>%%BoundingBox</code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0025_0025Page_002c-and-multi_002dpage-information"><code>%%Page<span class="roman">, and multi-page information</span></code></a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0025_0025Page_002c-not-generating"><code>%%Page<span class="roman">, not generating</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -5574,13 +5410,13 @@
<tr><td></td><td valign="top"><a href="#index-_0025_0025VMusage"><code>%%VMusage</code></a>:</td><td> </td><td valign="top"><a href="#Headers-and-memory-usage">Headers and memory usage</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0025_002aFont"><code>%*Font</code></a>:</td><td> </td><td valign="top"><a href="#Fonts-in-figures">Fonts in figures</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-4">(</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-4">(</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0028atend_0029_002c-bounding-box-specification"><code>(atend)<span class="roman">, bounding box specification</span></code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-5">+</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-5">+</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002bpsmapfile"><code>+<var>psmapfile</var></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-6">-</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-6">-</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d"><code>-</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d-as-output-filename"><code>- <span class="roman">as output filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dhelp"><code>--help</code></a>:</td><td> </td><td valign="top"><a href="#Option-summary">Option summary</a></td></tr>
@@ -5653,7 +5489,7 @@
<tr><td></td><td valign="top"><a href="#index-_002dZ-for-compressing-bitmap-fonts"><code>-Z <span class="roman">for compressing bitmap fonts</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dz-for-recognizing-hyperdvi"><code>-z <span class="roman">for recognizing hyperdvi</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-7">.</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-7">.</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002e_002e_002drelative-filenames"><samp>..</samp>-relative filenames</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002eafm-Adobe-metric-files"><code>.afm <span class="roman">Adobe metric files</span></code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002edvipsrc_002c-searched-for"><code>.dvipsrc<span class="roman">, searched for</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-searching">Configuration file searching</a></td></tr>
@@ -5670,31 +5506,31 @@
<tr><td></td><td valign="top"><a href="#index-_002epro-prologue-files"><code>.pro <span class="roman">prologue files</span></code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002etfm-TeX-font-metric-files"><code>.tfm <span class="roman">TeX font metric files</span></code></a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-8">/</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-8">/</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002f_0023copies"><code>/#copies</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002f_0023copies-1"><code>/#copies</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002fmagscale"><code>/magscale</code></a>:</td><td> </td><td valign="top"><a href="#EPSF-scaling">EPSF scaling</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-9">6</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-9">6</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-612-792-bounding-box-size"><code>612 792 <span class="roman">bounding box size</span></code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-10">8</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-10">8</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-8r-encoding_002c-and-extra-characters"><code>8r <span class="roman">encoding, and extra characters</span></code></a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-8r-font-encoding">8r font encoding</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-8r_002eenc"><code>8r.enc</code></a>:</td><td> </td><td valign="top"><a href="#Encodings">Encodings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-11"><</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-11"><</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003c-font-downloading"><code>< <span class="roman">font downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003c_003c-whole-font-downloading"><code><< <span class="roman">whole font downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003c_005b-encoding-vector-downloading"><code><[ <span class="roman">encoding vector downloading</span></code></a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-12">=</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-12">=</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003d_003a-ligature-operation"><code>=: <span class="roman">ligature operation</span></code></a>:</td><td> </td><td valign="top"><a href="#Encoding-file-format">Encoding file format</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-13">@</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-13">@</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0040-config-command-_0028define-paper-sizes_0029"><code>@ <span class="roman">config command (define paper sizes)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-14">\</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-14">\</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_002e"><code>\.</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cAA"><code>\AA</code></a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cColorName"><code>\<var>ColorName</var></code></a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
@@ -5711,10 +5547,10 @@
<tr><td></td><td valign="top"><a href="#index-_005crotninety"><code>\rotninety</code></a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005ctextColorName"><code>\text<var>ColorName</var></code></a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-15">|</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-15">|</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007c-starting-output-filename"><code>| <span class="roman">starting output filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-a-config-command-_0028conserve-memory_0029"><code>a <span class="roman">config command (conserve memory)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-A-ring_002c-Scandinavian-letter">A ring, Scandinavian letter</a>:</td><td> </td><td valign="top"><a href="#Reencoding-with-Afm2tfm">Reencoding with Afm2tfm</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-a3-papertype">a3 papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -5740,7 +5576,7 @@
<tr><td></td><td valign="top"><a href="#index-ASCII-character-codes_002c-used-by-PostScript">ASCII character codes, used by PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-atend_002c-bounding-box-specification"><code>atend<span class="roman">, bounding box specification</span></code></a>:</td><td> </td><td valign="top"><a href="#Bounding-box">Bounding box</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-B">B</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-b-config-command-_0028_0023copies_0029"><code>b <span class="roman">config command (#copies)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-base"><code>base</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-base-encoding_002c-recommended">base encoding, recommended</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
@@ -5765,7 +5601,7 @@
<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-supplying-to-TeX">bounding box, supplying to TeX</a>:</td><td> </td><td valign="top"><a href="#g_t_005cincludegraphics">\includegraphics</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bounding-box_002c-supplying-to-TeX-1">bounding box, supplying to TeX</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-C">C</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-c-config-command-_0028include-another-config-file_0029"><code>c <span class="roman">config command (include another config file)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-changing-PostScript-encodings">changing PostScript encodings</a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-changing-TeX-encodings">changing TeX encodings</a>:</td><td> </td><td valign="top"><a href="#Changing-TeX-encodings">Changing TeX encodings</a></td></tr>
@@ -5820,7 +5656,7 @@
<tr><td></td><td valign="top"><a href="#index-cropmarks">cropmarks</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-current-font_002c-in-PostScript">current font, in PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-D">D</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-D-config-command-_0028dpi_0029"><code>D <span class="roman">config command (dpi)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dated-output">dated output</a>:</td><td> </td><td valign="top"><a href="#PostScript-hooks">PostScript hooks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-datestamp_002c-in-output">datestamp, in output</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
@@ -5859,7 +5695,7 @@
<tr><td></td><td valign="top"><a href="#index-DVIPSSIZES_002c-overrides-R"><code>DVIPSSIZES<span class="roman">, overrides</span> R</code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dynamic-creation-of-graphics">dynamic creation of graphics</a>:</td><td> </td><td valign="top"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-e-config-command-_0028maxdrift_0029"><code>e <span class="roman">config command (maxdrift)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-E-config-command-_0028shell-escape_0029"><code>E <span class="roman">config command (shell escape)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-efficiency_002c-and-fonts">efficiency, and fonts</a>:</td><td> </td><td valign="top"><a href="#Making-a-font-available">Making a font available</a></td></tr>
@@ -5893,7 +5729,7 @@
<tr><td></td><td valign="top"><a href="#index-ExtendFont"><code>ExtendFont</code></a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-extra-characters_002c-accessing">extra characters, accessing</a>:</td><td> </td><td valign="top"><a href="#Changing-PostScript-encodings">Changing PostScript encodings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-F">F</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-f-config-command-_0028filter_0029"><code>f <span class="roman">config command (filter)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-F-config-command-_0028filter_0029"><code>F <span class="roman">config command (filter)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-failure_002c-and-printer-errors">failure, and printer errors</a>:</td><td> </td><td valign="top"><a href="#Printer-errors">Printer errors</a></td></tr>
@@ -5921,7 +5757,7 @@
<tr><td></td><td valign="top"><a href="#index-fonts_002c-small-caps">fonts, small caps</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fonts_002c-system-PostScript">fonts, system PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-font-installation">PostScript font installation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-G">G</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-G-config-command-_0028character-shifting_0029"><code>G <span class="roman">config command (character shifting)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gf-files">gf files</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gftopk"><code>gftopk</code></a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
@@ -5936,7 +5772,7 @@
<tr><td></td><td valign="top"><a href="#index-gsave_002fgrestore_002c-and-literal-PS"><code>gsave<span class="roman">/</span>grestore<span class="roman">, and literal PS</span></code></a>:</td><td> </td><td valign="top"><a href="#Literal-examples">Literal examples</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gsftopk"><code>gsftopk</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-H">H</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-H">H</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-h-config-command-_0028download-additional-header_0029"><code>h <span class="roman">config command (download additional header)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-H-config-command-_0028PostScript-header-path_0029"><code>H <span class="roman">config command (PostScript header path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hafner_002c-Jim">Hafner, Jim</a>:</td><td> </td><td valign="top"><a href="#Color">Color</a></td></tr>
@@ -5965,7 +5801,7 @@
<tr><td></td><td valign="top"><a href="#index-hypertext-specials">hypertext specials</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hypertext-support">hypertext support</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-I">I</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-i-config-command-_0028pages_002fsection_0029"><code>i <span class="roman">config command (pages/section)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idvi-Java-DVI-reader"><code>idvi <span class="roman">Java DVI reader</span></code></a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Illustrator_002c-workaround-for">Illustrator, workaround for</a>:</td><td> </td><td valign="top"><a href="#Including-graphics-fails">Including graphics fails</a></td></tr>
@@ -5981,17 +5817,17 @@
<tr><td></td><td valign="top"><a href="#index-inverted-output">inverted output</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-invoking-Dvips">invoking Dvips</a>:</td><td> </td><td valign="top"><a href="#Invoking-Dvips">Invoking Dvips</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-J">J</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-J">J</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-j-config-command-_0028partial-font-downloading_0029"><code>j <span class="roman">config command (partial font downloading)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Java-DVI-reader">Java DVI reader</a>:</td><td> </td><td valign="top"><a href="#Hypertext">Hypertext</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Jeffrey_002c-Alan">Jeffrey, Alan</a>:</td><td> </td><td valign="top"><a href="#Invoking-afm2tfm">Invoking afm2tfm</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-K">K</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-K">K</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-K-config-command-_0028comment-removal_0029"><code>K <span class="roman">config command (comment removal)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kerning_002c-defined">kerning, defined</a>:</td><td> </td><td valign="top"><a href="#Metric-files">Metric files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-KPATHSEA_005fDEBUG"><code>KPATHSEA_DEBUG</code></a>:</td><td> </td><td valign="top"><a href="#Environment-variables">Environment variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-L">L</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-L-config-command-_0028last-paper-size-wins_0029"><code>L <span class="roman">config command (last paper size wins)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-landscape-orientation_002c-defined">landscape orientation, defined</a>:</td><td> </td><td valign="top"><a href="#Paper-size-and-landscape">Paper size and landscape</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-landscape-papertype">landscape papertype</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -6019,7 +5855,7 @@
<tr><td></td><td valign="top"><a href="#index-low-characters_002c-shifting">low characters, shifting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lpr-spooler_002c-MS_002dDOS-emulation">lpr spooler, MS-DOS emulation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-m-config-command-_0028available-memory_0029"><code>m <span class="roman">config command (available memory)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M-config-command-_0028mf-mode_0029"><code>M <span class="roman">config command (mf mode)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-macros-for-color">macros for color</a>:</td><td> </td><td valign="top"><a href="#Color-macro-files">Color macro files</a></td></tr>
@@ -6056,7 +5892,7 @@
<tr><td></td><td valign="top"><a href="#index-multiple-paper-trays">multiple paper trays</a>:</td><td> </td><td valign="top"><a href="#Paper-trays">Paper trays</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Murphy_002c-Tim">Murphy, Tim</a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-N">N</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-N--config-command-_0028disable-EPS_0029"><code>N <span class="roman"> config command (disable EPS)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-name"><code>name</code></a>:</td><td> </td><td valign="top"><a href="#Hypertext-specials">Hypertext specials</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-narrow-fonts">narrow fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
@@ -6065,7 +5901,7 @@
<tr><td></td><td valign="top"><a href="#index-non_002dresident-fonts">non-resident fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-nopaper_002c-paper-format-for-_002dt"><code>nopaper<span class="roman">, paper format for ‘<samp>-t</samp>’</span></code></a>:</td><td> </td><td valign="top"><a href="#Config-file-paper-sizes">Config file paper sizes</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-O">O</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-o-config-command-_0028output-destination_0029"><code>o <span class="roman">config command (output destination)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-O-config-command-_0028page-offsets_0029"><code>O <span class="roman">config command (page offsets)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-oblique-fonts">oblique fonts</a>:</td><td> </td><td valign="top"><a href="#Special-font-effects">Special font effects</a></td></tr>
@@ -6089,7 +5925,7 @@
<tr><td></td><td valign="top"><a href="#index-output_002c-redirecting">output, redirecting</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-output_002c-too-small">output, too small</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-P">P</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-p-config-command-_0028font-aliases_0029"><code>p <span class="roman">config command (font aliases)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-P-config-command-_0028PK-path_0029"><code>P <span class="roman">config command (PK path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-page-range">page range</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -6169,12 +6005,12 @@
<tr><td></td><td valign="top"><a href="#index-pTeX-extensions">pTeX extensions</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pTeX-extensions-1">pTeX extensions</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Q">Q</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Q">Q</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-q-config-command-_0028quiet_0029"><code>q <span class="roman">config command (quiet)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Q-config-command-_0028quiet_0029"><code>Q <span class="roman">config command (quiet)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-quiet-operation">quiet operation</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-R-config-command-_0028fallback-resolution_0029"><code>R <span class="roman">config command (fallback resolution)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-r-config-command-_0028page-reversal_0029"><code>r <span class="roman">config command (page reversal)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-raw-tfm-files">raw tfm files</a>:</td><td> </td><td valign="top"><a href="#Afm2tfm-options">Afm2tfm options</a></td></tr>
@@ -6194,7 +6030,7 @@
<tr><td></td><td valign="top"><a href="#index-rotate_002etex"><code>rotate.tex</code></a>:</td><td> </td><td valign="top"><a href="#ps-special">ps special</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rwi-_0028psfile-special-option_0029"><code>rwi <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-S">S</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-s-config-command-_0028global-save_002frestore_0029"><code>s <span class="roman">config command (global save/restore)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-S-config-command-_0028pict-path_0029"><code>S <span class="roman">config command (pict path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-save_002frestore_002c-and-inverted-output">save/restore, and inverted output</a>:</td><td> </td><td valign="top"><a href="#Small-or-inverted">Small or inverted</a></td></tr>
@@ -6236,7 +6072,7 @@
<tr><td></td><td valign="top"><a href="#index-structured-comments">structured comments</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-system-in-config-file"><code>system <span class="roman">in config file</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-T-config-command-_0028TFM-path_0029"><code>T <span class="roman">config command (TFM path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Tektronix-Phaser-printer_002c-used-for-color-calibration">Tektronix Phaser printer, used for color calibration</a>:</td><td> </td><td valign="top"><a href="#Color-device-configuration">Color device configuration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-testpage_002etex"><code>testpage.tex</code></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -6270,7 +6106,7 @@
<tr><td></td><td valign="top"><a href="#index-Type-1-fonts">Type 1 fonts</a>:</td><td> </td><td valign="top"><a href="#Glyph-files">Glyph files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-typesetting-in-PostScript">typesetting in PostScript</a>:</td><td> </td><td valign="top"><a href="#PostScript-typesetting">PostScript typesetting</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-U">U</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-U">U</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-U-config-command-_0028Xerox-4045_0029"><code>U <span class="roman">config command (Xerox 4045)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-uncollated-copies">uncollated copies</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-uncompressing-PostScript">uncompressing PostScript</a>:</td><td> </td><td valign="top"><a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a></td></tr>
@@ -6286,7 +6122,7 @@
<tr><td></td><td valign="top"><a href="#index-userdict_002c-and-dictionary-files"><code>userdict<span class="roman">, and dictionary files</span></code></a>:</td><td> </td><td valign="top"><a href="#Header-files">Header files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-userdict_002c-used-for-header-files">userdict<span class="roman">, used for header files</span></a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-V">V</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-V">V</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-V-config-command-_0028vf-path_0029"><code>V <span class="roman">config command (vf path)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-verbose-EPSF-processing">verbose EPSF processing</a>:</td><td> </td><td valign="top"><a href="#EPSF-macros">EPSF macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-vf-files">vf files</a>:</td><td> </td><td valign="top"><a href="#Virtual-fonts">Virtual fonts</a></td></tr>
@@ -6302,7 +6138,7 @@
<tr><td></td><td valign="top"><a href="#index-vscale-_0028psfile-special-option_0029"><code>vscale <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-vsize-_0028psfile-special-option_0029"><code>vsize <span class="roman">(‘<samp>psfile</samp>’ special option)</span></code></a>:</td><td> </td><td valign="top"><a href="#psfile-special">psfile special</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-W">W</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-W">W</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-W-config-command-_0028emit-warning_0029"><code>W <span class="roman">config command (emit warning)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-warning-messages_002c-defining">warning messages, defining</a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-warnings_002c-suppressing">warnings, suppressing</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
@@ -6309,14 +6145,14 @@
<tr><td></td><td valign="top"><a href="#index-whole-font-downloading">whole font downloading</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-wide-fonts">wide fonts</a>:</td><td> </td><td valign="top"><a href="#psfonts_002emap">psfonts.map</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-X">X</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-X">X</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-X-config-command-_0028horizontal-resolution_0029"><code>X <span class="roman">config command (horizontal resolution)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Xerox-4045">Xerox 4045</a>:</td><td> </td><td valign="top"><a href="#Option-details">Option details</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Y">Y</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Y">Y</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Y-config-command-_0028vertical-resolution_0029"><code>Y <span class="roman">config command (vertical resolution)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Z">Z</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Z">Z</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Z-config-command-_0028compress-fonts_0029"><code>Z <span class="roman">config command (compress fonts)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-z-config-command-_0028secure-mode_0029"><code>z <span class="roman">config command (secure mode)</span></code></a>:</td><td> </td><td valign="top"><a href="#Configuration-file-commands">Configuration file commands</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
Modified: trunk/Master/texmf-dist/doc/dvips/dvips.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/info/dvips.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/dvips.info 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/info/dvips.info 2019-02-28 19:14:13 UTC (rev 50170)
@@ -1,6 +1,6 @@
This is dvips.info, produced by makeinfo version 6.5 from dvips.texi.
-This manual documents Dvips version 5.998 (February 2018), a program to
+This manual documents Dvips version 5.999 (February 2019), a program to
translate a DVI file into PostScript. You may freely use, modify and/or
distribute this file.
INFO-DIR-SECTION TeX
@@ -16,7 +16,7 @@
Dvips
*****
-This manual documents Dvips version 5.998 (February 2018), a program to
+This manual documents Dvips version 5.999 (February 2019), a program to
translate a DVI file into PostScript. You may freely use, modify and/or
distribute this file.
Modified: trunk/Master/texmf-dist/doc/info/kpathsea.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/kpathsea.info 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/info/kpathsea.info 2019-02-28 19:14:13 UTC (rev 50170)
@@ -3,7 +3,7 @@
This file documents the Kpathsea library for path searching.
- Copyright (C) 1996-2018 Karl Berry & Olaf Weber.
+ Copyright (C) 1996-2019 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
@@ -37,7 +37,7 @@
****************
This manual documents the Kpathsea library for path searching. It
-corresponds to version 6.3.0, released in February 2018.
+corresponds to version 6.3.1, released in February 2019.
* Menu:
@@ -61,8 +61,8 @@
1 Introduction
**************
-This manual corresponds to version 6.3.0 of the Kpathsea library,
-released in February 2018.
+This manual corresponds to version 6.3.1 of the Kpathsea library,
+released in February 2019.
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
@@ -725,7 +725,7 @@
foo/{1,2}/baz
expands to 'foo/1/baz:foo/2/baz'. ':' is the path separator on the
-current system; e.g., on a DOS system, it's ';'.
+current system; e.g., on a Windows system, it's ';'.
Braces can be nested; for example, 'x{A,B{1,2}}y' expands to
'xAy:xB1y:xB2y'.
@@ -738,7 +738,7 @@
assigning a brace list to '$TEXMF', as mentioned in 'texmf.in'.
You can also use the path separator instead of the comma. The last
-example could have been written 'x{A:B}{1:2}y'.
+example could have been written 'x{A:B}{1:2}y' (on Unix).
Brace expansion is implemented in the source file
'kpathsea/expand.c'.
@@ -1153,7 +1153,8 @@
'--all'
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).
+ at random). Exception: with the glyph formats ('pk', 'gf'), this
+ option has no effect and only the first match is returned.
'--casefold-search'
'--no-casefold-search'
@@ -1424,8 +1425,8 @@
Set debugging options to NUM. *Note Debugging::.
'--expand-braces=STRING'
- Output variable and brace expansion of STRING. *Note Path
- expansion::.
+ Output variable, tilde, and brace expansion of STRING, which is
+ assumed to be a single path element. *Note Path expansion::.
'--expand-path=STRING'
Output the complete expansion of STRING, with each element
@@ -1443,12 +1444,15 @@
=>
For one-shot uses of an arbitrary (not built in to Kpathsea) path,
- see '--path' (*note Path searching options::)
+ see '--path' (*note Path searching options::).
'--expand-var=STRING'
- Output the variable and tilde expansion of STRING the 'mktex...'
- scripts run 'kpsewhich --expand-var='$TEXMF'' to find the root of
- the TeX system hierarchy. *Note Path expansion::.
+ Output the variable and tilde expansion of STRING. For example,
+ with the usual 'texmf.cnf', 'kpsewhich --expand-var='$TEXMF''
+ returns the TeX system hierarchy root(s). *Note Path expansion::.
+ The specified STRING can contain anything, though, not just
+ variable references. This calls 'kpse_var_expand' (*note
+ Programming with config files::).
'--help-formats'
Output information about each supported format (*note Supported
@@ -1468,12 +1472,34 @@
integer can be used, just as with '--format', described in the
previous section.
+'--var-brace-value=VARIABLE'
+ Like '--var-value' (next), but also expands '{...}' constructs.
+ (*note Brace expansion::). Thus, the value is assumed to possibly
+ be several path elements, and '~' is expanded at the beginning of
+ each. The path separator is changed to that of the current system
+ in the expansion.
+
+ Example: 'FOO='.;~' kpsewhich --var-brace-value=FOO' outputs (on a
+ Unix-ish system) '.:/home/karl', supposing the latter is the
+ current user's home directory. Note that the ';' in the source
+ value, as commonly used in 'texmf.cnf', has changed to a ':', as
+ the normal path separator on the current system. (On a Windows-ish
+ system, the ';' would remain.)
+
'--var-value=VARIABLE'
- Outputs the value of VARIABLE (a simple identifier like 'TEXMF',
- with no '$' or other constructs), expanding '$' (*note Variable
- expansion:: and '~' (*note Tilde expansion::) constructs, but not
- performing other expansions.
+ Outputs the value of VARIABLE (a simple identifier like
+ 'TEXMFDIST', with no '$' or other constructs), expanding '$' (*note
+ Variable expansion::) and '~' (*note Tilde expansion::) constructs
+ in the value. '~' expansion happens at the beginning of the
+ overall value and at the beginning of a variable expansion, but not
+ arbitrarily within the string. Braces are not expanded.
+ Example: '--var-value=texmf_casefold_search' outputs (if the
+ default is not changed) '1'.
+
+ Example to contrast with '--var-brace-value': 'FOO='.;~' kpsewhich
+ --var-value=FOO' outputs '.;~', i.e., the same as the input value.
+
File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invoking kpsewhich
@@ -2461,18 +2487,22 @@
file that Kpathsea uses for your program. This helps installers by
keeping all configuration in one place.
- To retrieve a value VAR from config files, the best way is to call
-'kpathsea_var_value' on the string 'VAR'. This will look first for an
-environment variable VAR, then a config file value. The result will be
-the value found or 'NULL'. This function is declared in
+ To retrieve a value for a configuration variable VAR, the best way is
+to call 'kpathsea_var_value' on the string 'VAR'. This will look first
+for an environment variable VAR, then a config file value. The result
+will be the value found or 'NULL'. This function is declared in
'kpathsea/variable.h'. For an example, see the 'shell_escape' code in
'web2c/lib/texmfmp.c'.
- The routine to do variable expansion in the context of a search path
-(as opposed to simply retrieving a value) is 'kpathsea_var_expand', also
-declared in 'kpathsea/variable.h'. It's generally only necessary to set
+ The routine to do full variable and tilde expansion of an arbitrary
+string in the context of a search path (as opposed to simply retrieving
+a value) is 'kpathsea_var_expand', also declared in
+'kpathsea/variable.h'. However, it's generally only necessary to set
the search path structure components as explained in the previous
-section, rather than using this yourself.
+section instead of using this directly. Because of its usage with any
+input string, undefined '$FOO' constructs in the argument to
+'kpathsea_var_expand' are returned literally ('"$FOO"'), while undefined
+'${FOO}' constructs are expanded to the empty string.
If for some reason you want to retrieve a value _only_ from a config
file, not automatically looking for a corresponding environment
@@ -2910,9 +2940,6 @@
passed, problems may lurk. Optimization occasionally causes trouble in
programs other than TeX and Metafont themselves, too.
- Insufficient swap space may also cause core dumps or other erratic
-behavior.
-
For a workaround, if you enabled any optimization flags, it's best to
omit optimization entirely. In any case, the way to find the facts is
to run the program under the debugger and see where it's failing.
@@ -2925,8 +2952,7 @@
To report compiler bugs effectively requires perseverance and
perspicacity: you must find the miscompiled line, and that usually
involves delving backwards in time from the point of error, checking
-through TeX's (or whatever program's) data structures. Things are not
-helped by all-too-common bugs in the debugger itself. Good luck.
+through TeX's (or whatever program's) data structures. Good luck.
File: kpathsea.info, Node: Index, Prev: Reporting bugs, Up: Top
@@ -2942,42 +2968,43 @@
* --all: Path searching options.
(line 12)
* --casefold-search: Path searching options.
- (line 18)
+ (line 19)
* --color=tty: ls-R. (line 21)
* --debug=NUM: Auxiliary tasks. (line 9)
* --dpi=NUM: Path searching options.
- (line 27)
+ (line 28)
* --engine=NAME: Path searching options.
- (line 31)
+ (line 32)
* --expand-braces=STRING: Auxiliary tasks. (line 12)
* --expand-path=STRING: Auxiliary tasks. (line 16)
* --expand-var=STRING: Auxiliary tasks. (line 34)
* --format=NAME: Path searching options.
- (line 47)
+ (line 48)
* --help: Standard options. (line 8)
-* --help-formats: Auxiliary tasks. (line 39)
+* --help-formats: Auxiliary tasks. (line 42)
* --interactive: Path searching options.
- (line 129)
+ (line 130)
* --mktex=FILETYPE: Path searching options.
- (line 134)
+ (line 135)
* --mode=STRING: Path searching options.
- (line 140)
+ (line 141)
* --must-exist: Path searching options.
- (line 145)
+ (line 146)
* --no-casefold-search: Path searching options.
- (line 18)
+ (line 19)
* --no-mktex=FILETYPE: Path searching options.
- (line 134)
+ (line 135)
* --path=STRING: Path searching options.
- (line 150)
+ (line 151)
* --progname=NAME: Path searching options.
- (line 158)
-* --safe-in-name=NAME: Auxiliary tasks. (line 45)
-* --safe-out-name=NAME: Auxiliary tasks. (line 45)
-* --show-path=NAME: Auxiliary tasks. (line 51)
+ (line 159)
+* --safe-in-name=NAME: Auxiliary tasks. (line 48)
+* --safe-out-name=NAME: Auxiliary tasks. (line 48)
+* --show-path=NAME: Auxiliary tasks. (line 54)
* --subdir=STRING: Path searching options.
- (line 163)
-* --var-value=VARIABLE: Auxiliary tasks. (line 57)
+ (line 164)
+* --var-brace-value=VARIABLE: Auxiliary tasks. (line 60)
+* --var-value=VARIABLE: Auxiliary tasks. (line 74)
* --version: Standard options. (line 11)
* --with-mktextex-default: mktex configuration. (line 12)
* --without-mktexfmt-default: mktex configuration. (line 12)
@@ -2989,7 +3016,7 @@
* -1 debugging value: Debugging. (line 23)
* -A option to ls: ls-R. (line 33)
* -D NUM: Path searching options.
- (line 27)
+ (line 28)
* -iname, find predicate: Casefolding examples.
(line 78)
* -L option to ls: ls-R. (line 38)
@@ -3184,7 +3211,7 @@
* cmr10.vf: Searching overview. (line 31)
* cnf.c: Config files. (line 86)
* cnf.h: Programming with config files.
- (line 23)
+ (line 27)
* comments, in fontmap files: Fontmap. (line 27)
* comments, in texmf.cnf: Config files. (line 27)
* comments, making: Introduction. (line 29)
@@ -3194,7 +3221,7 @@
* compiler bugs: TeX or Metafont failing.
(line 6)
* compiler bugs, finding: TeX or Metafont failing.
- (line 24)
+ (line 21)
* conditions for use: Introduction. (line 32)
* config files: Config files. (line 6)
* config files, for Kpathsea-using programs: Calling sequence.
@@ -3268,7 +3295,7 @@
* ENCFONTS: Supported file formats.
(line 61)
* engine name: Path searching options.
- (line 31)
+ (line 32)
* environment variable, source for path: Path sources. (line 9)
* environment variables for TeX: Supported file formats.
(line 6)
@@ -3359,7 +3386,7 @@
* glyphlist.txt: Specially-recognized files.
(line 25)
* GNU C compiler bugs: TeX or Metafont failing.
- (line 19)
+ (line 16)
* GNU General Public License: Introduction. (line 32)
* group-writable directories: Security. (line 40)
* GSFTOPK_DEBUG (128): Debugging. (line 88)
@@ -3376,7 +3403,7 @@
(line 84)
* input lines, reading: Calling sequence. (line 110)
* interactive query: Path searching options.
- (line 129)
+ (line 130)
* interface, not frozen: Introduction. (line 29)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -3387,7 +3414,7 @@
* kpathsea.h: Programming overview.
(line 26)
* kpathsea_cnf_get: Programming with config files.
- (line 23)
+ (line 27)
* KPATHSEA_DEBUG: Calling sequence. (line 28)
* KPATHSEA_DEBUG <1>: Debugging. (line 18)
* kpathsea_find_file: File lookup. (line 38)
@@ -3534,7 +3561,7 @@
* OPENTYPEFONTS: Supported file formats.
(line 145)
* optimization caveat: TeX or Metafont failing.
- (line 15)
+ (line 12)
* options for debugging: Debugging. (line 6)
* OTPINPUTS: Supported file formats.
(line 151)
@@ -3599,7 +3626,7 @@
* reporting bugs: Reporting bugs. (line 6)
* resident.c: Calling sequence. (line 47)
* resolution, setting: Path searching options.
- (line 27)
+ (line 28)
* resolutions, last-resort: Fallback font. (line 6)
* retrieving TeX: unixtex.ftp. (line 6)
* right-hand side of variable assignments: Config files. (line 56)
@@ -3668,7 +3695,7 @@
* symbolic links, and ls-R: ls-R. (line 38)
* symlinks, resolving: Calling sequence. (line 31)
* system C compiler bugs: TeX or Metafont failing.
- (line 19)
+ (line 16)
* system-dependent casefolding behavior: Casefolding rationale.
(line 6)
* T1FONTS: Supported file formats.
@@ -3860,47 +3887,47 @@
Node: Variable expansion29496
Node: Tilde expansion30897
Node: Brace expansion31877
-Node: KPSE_DOT expansion32802
-Node: Subdirectory expansion33315
-Node: Casefolding search35669
-Node: Casefolding rationale36438
-Node: Casefolding examples37777
-Node: Filename database42827
-Node: ls-R43885
-Node: Filename aliases46780
-Node: Database format47958
-Node: Invoking kpsewhich48971
-Node: Path searching options49926
-Node: Specially-recognized files58327
-Node: Auxiliary tasks59682
-Node: Standard options62021
-Node: TeX support62377
-Node: Supported file formats63731
-Node: File lookup71396
-Node: Glyph lookup73145
-Node: Basic glyph lookup74269
-Node: Fontmap75149
-Node: Fallback font77678
-Node: Suppressing warnings78590
-Node: mktex scripts79717
-Node: mktex configuration80932
-Node: mktex script names86735
-Node: mktex script arguments88121
-Node: Programming89000
-Node: Programming overview89573
-Node: Calling sequence92434
-Node: Program-specific files98966
-Node: Programming with config files99989
-Node: Reporting bugs101301
-Node: Bug checklist101979
-Node: Mailing lists105451
-Node: Debugging106126
-Node: Logging111203
-Node: Common problems113070
-Node: Unable to find files113547
-Node: Slow path searching115957
-Node: Unable to generate fonts117332
-Node: TeX or Metafont failing119803
-Node: Index121156
+Node: KPSE_DOT expansion32816
+Node: Subdirectory expansion33329
+Node: Casefolding search35683
+Node: Casefolding rationale36452
+Node: Casefolding examples37791
+Node: Filename database42841
+Node: ls-R43899
+Node: Filename aliases46794
+Node: Database format47972
+Node: Invoking kpsewhich48985
+Node: Path searching options49940
+Node: Specially-recognized files58459
+Node: Auxiliary tasks59814
+Node: Standard options63520
+Node: TeX support63876
+Node: Supported file formats65230
+Node: File lookup72895
+Node: Glyph lookup74644
+Node: Basic glyph lookup75768
+Node: Fontmap76648
+Node: Fallback font79177
+Node: Suppressing warnings80089
+Node: mktex scripts81216
+Node: mktex configuration82431
+Node: mktex script names88234
+Node: mktex script arguments89620
+Node: Programming90499
+Node: Programming overview91072
+Node: Calling sequence93933
+Node: Program-specific files100465
+Node: Programming with config files101488
+Node: Reporting bugs103075
+Node: Bug checklist103753
+Node: Mailing lists107225
+Node: Debugging107900
+Node: Logging112977
+Node: Common problems114844
+Node: Unable to find files115321
+Node: Slow path searching117731
+Node: Unable to generate fonts119106
+Node: TeX or Metafont failing121577
+Node: Index122779
End Tag Table
Modified: trunk/Master/texmf-dist/doc/info/tlbuild.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/tlbuild.info 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/info/tlbuild.info 2019-02-28 19:14:13 UTC (rev 50170)
@@ -1,9 +1,9 @@
-This is tlbuild.info, produced by makeinfo version 6.5 from
+This is tlbuild.info, produced by makeinfo version 6.6 from
tlbuild.texi.
This file documents the TeX Live build system and more.
-Copyright (C) 2016-2018 Karl Berry.
+Copyright (C) 2016-2019 Karl Berry.
Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner.
Permission is granted to make and distribute verbatim copies of this
@@ -33,7 +33,7 @@
File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir)
-Building TeX Live (2018)
+Building TeX Live (2019)
************************
For an overview of this manual, *note Introduction::.
@@ -59,7 +59,8 @@
1 Introduction
**************
-This manual (dated April 2018) corresponds to the TeX Live 2018 release.
+This manual (dated February 2019) corresponds to the TeX Live 2019
+release.
This manual is aimed at system installers and programmers, and
focuses on how to configure, build, and develop the TeX Live (TL)
@@ -66,38 +67,39 @@
sources. It is also available as plain text files in the source tree:
'source/README.*'.
- The 'source/README' file in the TL source tree provides the
+ The main 'source/README' file in the TL source tree provides
maximally-terse information for doing a build, and portability
information for different systems, along with
'source/doc/README.solaris'.
For information on acquiring the TL sources, see
-<http://tug.org/texlive/svn>.
+<https://tug.org/texlive/svn>. The canonical source repository uses
+Subversion, and we have no plans to change this.
This manual does not duplicate the information found in other TL
documentation resources, such as:
- * The TeX Live web pages: <http://tug.org/texlive>.
+ * The TeX Live web pages: <https://tug.org/texlive>.
* The web page describing how to build the binaries which are
- distributed with TeX Live: <http://tug.org/texlive/build.html>.
+ distributed with TeX Live: <https://tug.org/texlive/build.html>.
- * The TeX Live user manual: <http://tug.org/texlive/doc.html>, or run
- 'texdoc texlive'.
+ * The TeX Live user manual: <https://tug.org/texlive/doc.html>, or
+ run 'texdoc texlive'.
* Other TeX-related Texinfo manuals (*note (web2c)::, *note
- (kpathsea)::, etc.): <http://tug.org/texinfohtml/>, or check the
+ (kpathsea)::, etc.): <https://tug.org/texinfohtml/>, or check the
'TeX' category in the GNU Info system.
* Package documentation:
- <http://tug.org/texlive/Contents/live/doc.html>, or the 'doc.html'
+ <https://tug.org/texlive/Contents/live/doc.html>, or the 'doc.html'
file at the top level of the installed TL.
As an exception, the full documentation for 'install-tl' and 'tlmgr'
-is included here, just because it is convenient to do so. The same text
-is available online (linked from <http://tug.org/texlive/doc.html>, or
-by invoking the program with '--help' (or look at the end of the
-source).
+is included here as appendices, simply because it is easy to do so. The
+same text is available online (linked from
+<https://tug.org/texlive/doc.html>, or by invoking the program with
+'--help' (or look at the end of the source).
File: tlbuild.info, Node: Overview of build system, Next: Prerequisites, Prev: Introduction, Up: Top
@@ -105,10 +107,10 @@
2 Overview of build system
**************************
-The TeX Live build system was redesigned in 2009, consistently using
-Autoconf, Automake, and Libtool. Thus
+The TeX Live build system was redesigned in 2009 to consistently use
+Autoconf, Automake, and Libtool. Thus, running
'configure && make && make check && make install'
-or the basically-equivalent top-level 'Build' script suffice to build
+or the essentially-equivalent top-level 'Build' script suffices to build
and install the TL programs. The 'make check' clause performs various
tests of the generated programs--not strictly required but strongly
recommended. Running 'configure --help' will display a comprehensive
@@ -134,7 +136,7 @@
and properties, such as required libraries, whether an installed
(system) version of a library can be used, 'configure' options to be
seen at the top level, and more. An explicit list of all available
-modules is kept in only one central place, namely 'm4/kpse-pkgs.m4'.
+modules is kept in a single central place: 'm4/kpse-pkgs.m4'.
A second, related goal is to configure and build each library before
configuring any other (program or library) module which uses that
@@ -147,8 +149,8 @@
source tree and document any modifications of that source.
All this is for the sake of simplifying both upgrading of modules and
-integrating new modules into the TL build system. (Not to say that
-either task is trivial.)
+integrating new modules into the TL build system. (Despite all efforts,
+neither task is easy.)
File: tlbuild.info, Node: Prerequisites, Next: Building, Prev: Overview of build system, Up: Top
@@ -157,21 +159,22 @@
***************
Overall, building the TeX Live programs, when using all libraries from
-the TL source tree, requires only C and C++ compilers and GNU 'make'.
-(If 'make' from your 'PATH' is not GNU make, you can set 'MAKE' in the
-environment to whatever is necessary.)
+the TL source tree, requires C and C++11 compilers and GNU 'make'. If
+'make' from your 'PATH' is not GNU make, you can set the 'MAKE'
+environment variable to whatever is necessary.
GNU 'make' is required only because of some third-party libraries,
notably FreeType; all the TL-maintained directories (and
-Automake/Autoconf output in general) should work with any reasonable
-'make'.
+Automake/Autoconf output in general) work with any reasonable 'make'.
+ A C++11 compiler is similarly required because of the third-party
+libraries ICU and Poppler; the program 'dvisvgm' also requires C++11.
+It is possible to build everything else with older compilers;
+<https://tug.org/texlive/custom-bin.html> links to a build script for
+doing this.
+
However, a few programs in the tree have additional requirements:
-'dvisvgm'
- requires a C++11 compiler, such as gcc 4.8.1 (or later) or clang
- 3.3 (or later).
-
'web2c'
requires 'perl' for some tests run by 'make check'.
@@ -185,8 +188,9 @@
MacOSX only, the 'ApplicationServices' and 'Cocoa' frameworks.
'xindy'
- requires GNU 'clisp' and in addition 'perl', 'latex', and
- 'pdflatex' to build the rules and/or documentation.
+ requires GNU 'clisp', 'libsigsegv', and 'libiconv'; additionally,
+ to build the rules and/or documentation: 'perl', 'latex', and
+ 'pdflatex'
Lacking the required tools, building these programs must avoided, e.g.,
'configure --without-x --disable-xetex --disable-xindy'
@@ -195,7 +199,7 @@
expect:
* Modification of any '.y' or '.l' source files requires 'bison' or
- 'flex' to updatete the corresponding C sources.
+ 'flex' to update the corresponding C sources.
* Modification of the sources for '.info' files requires 'makeinfo'.
@@ -202,7 +206,10 @@
* Modification of any part of the build system (M4 macros,
'configure.ac', 'Makefile.am', or their fragments) requires GNU M4,
GNU Autoconf, GNU Automake, and GNU Libtool to update the generated
- files. *Note Build system tools::.
+ files. Furthermore, to reliably reproduce the build files, the
+ original GNU releases of these tools must be used, not any distro
+ packaging of them. *Note Build system tools::, for more
+ discussion.
If you haven't modified any source files, and infrastructure tools
such as 'autoconf' or 'makeinfo' are still being run, check your
@@ -210,11 +217,6 @@
Subversion configuration (*note Build system tools::). Barring buggy
commits, no infrastructure tools are needed to do a normal build.
- As an example, on Debian systems the necessary build dependencies can
-be installed via:
-
- apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
-
File: tlbuild.info, Node: Building, Next: Installing, Prev: Prerequisites, Up: Top
@@ -223,26 +225,27 @@
The top-level 'Build' script is intended to simplify building the
binaries distributed with TeX Live itself--we call this the "native" TL
-build. It configures and makes everything in a subdirectory of the main
-build tree (default 'Work/'), installs everything in another
-subdirectory (default 'inst/'), and finally runs 'make check'. The
-exact directory and command names can be specified via environment
-variables and a few leading options. All remaining arguments
-(assignments or options) are passed to the 'configure' script. Please
-take a look at the './Build' source file itself for more information; it
+build. It runs 'configure && make world', which builds everything in a
+subdirectory of the main source tree (default 'Work/'), installs
+everything in another subdirectory (default 'inst/'), and finally runs
+'make check'. The exact directory and command names can be specified
+via environment variables and a few leading options. All remaining
+arguments (assignments or options) are passed to the 'configure' script.
+Please take a look at the './Build' source file for more information; it
is a straightforward shell script.
An alternative, and the one we will mainly discuss here, is to run
-'configure' and 'make' oneself in a suitable empty subdirectory.
-Building in the source directory itself is not supported (sorry).
+'configure' and 'make' in a suitable empty subdirectory. Building in
+the source directory itself is not supported (sorry).
* Menu:
-* Build iteration:: What 'configure' and 'make' do.
+* Build iteration:: What 'configure' and 'make' do in TL.
* Build problems:: If the build fails.
* Build in parallel:: Simultaneous 'make' processes.
* Build distribution:: Making a distribution tarball.
* Build one package:: Example of working on just one program.
+* Build one engine:: Example of building just one TeX engine.
* Cross compilation:: Building on host X for target Y.
@@ -253,10 +256,10 @@
Running the top-level 'configure' script configures the top level and
the subdirectories 'libs', 'utils', and 'texk'. Running 'make' at the
-top-level first iterates over all TeX-specific libraries, and then runs
-'make' in 'libs', 'utils', and 'texk' to iterate over all generic
-libraries, utility programs, and TeX-specific programs. These
-iterations consist of two steps:
+top level first iterates over the TeX-specific libraries, and then runs
+'make' in 'libs', 'utils', and 'texk' to iterate over the generic
+libraries, utility programs, and TeX-specific programs, respectively.
+These iterations consist of two steps:
1. For each library or program module not yet configured, run
'configure', adding the configure option '--disable-build' if the
@@ -267,8 +270,8 @@
'check' to run tests, 'install', etc.
Running the top-level 'make' a second time iterates again over all
-the library and program modules, but finds (should find) nothing to be
-done unless some source files have been modified.
+the library and program modules, and finds (should find) nothing to be
+done.
File: tlbuild.info, Node: Build problems, Next: Build in parallel, Prev: Build iteration, Up: Building
@@ -276,10 +279,11 @@
4.2 Build problems
==================
-If configuring or building a module fails, you should first find and fix
-the problem, then perhaps remove the subdirectory for that module from
-the build tree, and finally rerun the top level 'make' (or 'Build' with
-'--no-clean' as its first argument).
+If configuring or building a module fails, you should first try to find
+and fix the problem. Failing that, a possible workaround is to remove
+the subdirectory for that module from the build tree (so 'configure'
+won't try to run there, and finally rerun the top level 'make' (or
+'./Build' '--no-clean').
File: tlbuild.info, Node: Build in parallel, Next: Build distribution, Prev: Build problems, Up: Building
@@ -288,13 +292,13 @@
=====================
The TL build system carefully formulates dependencies as well as 'make'
-rules when a tool (such as 'tangle', 'ctangle', or 'convert') creates
+rules when a tool (such as 'tangle', 'ctangle', and 'convert') creates
several output files. This allows for parallel builds ('make -j N' with
N>1 or even 'make -j') that can considerably speed up the TL build.
- Incidentally, a noticeable speed-up can also be (independently)
-gained by using a configure cache file, i.e., with the option '-C'
-(recommended).
+ Incidentally, a noticeable speed-up can be independently gained by
+using a configure cache file, i.e., specifying the 'configure' option
+'-C' (recommended).
File: tlbuild.info, Node: Build distribution, Next: Build one package, Prev: Build in parallel, Up: Building
@@ -309,10 +313,11 @@
This is useful for checking consistency of the source tree and
Makefiles, but the result is not a complete or even usable TeX system,
-since all the support files are lacking; *note Installing::.
+since all the support files are lacking; *note Installing::. We do not
+actually distribute any such tarball, and have no plans to do so.
-File: tlbuild.info, Node: Build one package, Next: Cross compilation, Prev: Build distribution, Up: Building
+File: tlbuild.info, Node: Build one package, Next: Build one engine, Prev: Build distribution, Up: Building
4.5 Build one package
=====================
@@ -321,15 +326,15 @@
'--disable-all-pkgs' (*note --disable-all-pkgs::). Then all program and
library modules are configured but none are made. However, the
'Makefile's still contain all build rules and dependencies and can be
-invoked to build an individual program or library and causes to first
-build any required libraries.
+invoked to build an individual program or library, first building any
+required libraries.
This "build-on-demand" procedure is used, e.g., in the upstream
-LuaTeX repository to build LuaTeX, essentially from a subset of the
-complete TeX Live tree. Similarly, when, e.g., building the original
+LuaTeX repository to build LuaTeX, from a subset of the complete
+TeX Live source tree. As another example, when building the original
e-TeX has been disabled (as it is by default), one can run 'make etex'
(or 'make etex.exe') in 'texk/web2c/' to build e-TeX (although there is
-no comparably simple way to install e-TeX).
+no comparably simple way to _install_ e-TeX).
If you want to work on a single program within the TL sources, this
is the recommended way to do it. Here is an example from start to
@@ -337,7 +342,7 @@
mkdir mydir && cd mydir # new working directory
- # Get sources (<http://tug.org/texlive/svn>)
+ # Get sources (<https://tug.org/texlive/svn>), e.g.:
rsync -a --delete --exclude=.svn --exclude=Work \
tug.org::tldevsrc/Build/source/ .
@@ -346,27 +351,30 @@
# Do the configure:
../configure --disable-all-pkgs --enable-dvipdfm-x \
- -C CFLAGS=-g CXXFLAGS=-g >&outc
+ -C CFLAGS=-g CXXFLAGS=-g >&outc || echo fail
# Do the make:
- make >&outm
+ make >&outm || echo fail
# Test:
cd texk/dvipdfm-x
make check
- Then you modify source files in 'mydir/texk/dvipdfm-x' and rerun
-'make' in 'mydir/Work/texk/dvipdfm-x' to rebuild.
+ Then you can modify source files in 'mydir/texk/dvipdfm-x' and rerun
+'make' in 'mydir/Work/texk/dvipdfm-x' to rebuild; that build directory
+is where the binary ends up and where you can run a debugger, etc.
The second line of the 'configure' invocation shows examples of extra
things you likely want to specify if you intend to hack the sources (and
-not just build binaries): the '-C' speeds up 'configure', and the
-'CFLAGS' and 'CXXFLAGS' settings eliminate compiler optimization for
-debugging purposes.
+not just build binaries): the '-C' speeds 'configure' by enabling a
+cache file, and the 'CFLAGS' and 'CXXFLAGS' settings eliminate compiler
+optimization for debugging purposes.
- Of course, one should actually look at the output and check that
+ Of course, you need to actually look at the output and check that
things are working. There are many 'configure' options you can tweak as
-desired; check the output from 'configure --help'.
+desired; check the output from 'configure --help'. It is also a good
+idea to run 'make check' after making any changes, to ensure that
+whatever tests have been written still pass.
Finally, the above retrieves the entire TL source tree (several
hundred megabytes). It is natural to ask if this is really necessary.
@@ -374,15 +382,15 @@
do so. If you cut down the source tree, you must also give additional
'configure' flags to individually disable using system versions of
libraries, or the intricacies of the dependencies (such as 'teckit'
-requiring 'zlib') will have undesired side effects. For an example, see
-the 'build-pdftex.sh' script in the 'pdftex' development source
-(<http://pdftex.org>), which is indeed a cut-down TL source tree.
+requiring 'zlib') will have undesired side effects. For an example of
+this approach, see the 'build-pdftex.sh' script in the 'pdftex'
+development source (details at <http://pdftex.org>), which is indeed
+such a cut-down TL source tree.
Even with '--disable-all-pkgs', dependencies will be checked. For
-instance, if a non-MacOSX system does not have 'fontconfig', XeTeX
+instance, if a (non-MacOSX) system does not have 'fontconfig', XeTeX
cannot be built (*note Prerequisites::) and 'configure' will terminate.
To proceed without such dependencies, specify '--enable-missing' also.
-(Arguably this should happen automatically.)
By default, the 'gcc' compilers will be used if present; otherwise,
individual packages may use something different. You can explicitly
@@ -390,9 +398,34 @@
'CXX', and 'OBJCXX'.
-File: tlbuild.info, Node: Cross compilation, Prev: Build one package, Up: Building
+File: tlbuild.info, Node: Build one engine, Next: Cross compilation, Prev: Build one package, Up: Building
-4.6 Cross compilation
+4.6 Build one engine
+====================
+
+Unfortunately, there is one common case where the steps in the preceding
+section to build one package (*note Build one package::) do not suffice:
+wanting to build one, or a subset, of the TeX engines (or other Web2c
+programs).
+
+ The simplest way to do this is to disable everything and then
+explicitly specify what to make. For example, to build only LuaTeX:
+
+ ./configure --disable-all-pkgs # or ./Build
+ cd Work/texk/web2c # build directory
+ make luatex # specify target
+
+ This works because the 'make' automatically runs 'configure' as
+necessary for the dependencies and target. Furthermore, the source tree
+can be cut down to just what is needed for the given engine (as the
+separate pdfTeX and LuaTeX source repositories do).
+
+ We hope to improve the situation in the future. Patches are welcome.
+
+
+File: tlbuild.info, Node: Cross compilation, Prev: Build one engine, Up: Building
+
+4.7 Cross compilation
=====================
In a cross compilation a "build" system is used to create binaries to be
@@ -425,7 +458,7 @@
File: tlbuild.info, Node: Cross configuring, Next: Cross problems, Up: Cross compilation
-4.6.1 Cross configuring
+4.7.1 Cross configuring
-----------------------
In a standard cross compilation, binaries for the host system cannot
@@ -474,7 +507,7 @@
File: tlbuild.info, Node: Cross problems, Prev: Cross configuring, Up: Cross compilation
-4.6.2 Cross problems
+4.7.2 Cross problems
--------------------
The fact that binaries for the host system cannot be executed on the
@@ -500,12 +533,12 @@
This approach would also be possible for the tools such as 'tangle'
used in the module 'texk/web2c' to build the WEB programs, but that
would require first building a native 'kpathsea' library. To avoid this
-complication, cross compilation of the WEB or CWEB programs requires
+complication, cross compilation of programs written in (C)WEB requires
sufficiently recent installed versions of 'tangle', 'ctangle',
'otangle', and 'tie'.
Building 'xindy' requires running the host system 'clisp' binary,
-thus cross compilation is not possible.
+thus cross compilation is painful, but possible.
File: tlbuild.info, Node: Installing, Next: Layout and infrastructure, Prev: Building, Up: Top
@@ -517,14 +550,14 @@
The main consideration is that 'make install' is not enough to make a
usable TeX installation. Beyond the compiled binaries, (thousands of)
-support files are needed; just as a first example 'plain.tex' is not in
+support files are needed; just as a first example, 'plain.tex' is not in
the source tree.
These support files are maintained completely independently and are
-not present in the source tree. The best basis for dealing with them is
-the TeX Live (plain text) database in 'Master/tlpkg/texlive.tlpdb',
+not present in the TL source tree. The best basis for dealing with them
+is the TeX Live (plain text) database in 'Master/tlpkg/texlive.tlpdb',
and/or the TeX Live installer, 'install-tl'. More information is under
-'Master/tlpkg' and at <http://tug.org/texlive/distro.html>.
+'Master/tlpkg' and at <https://tug.org/texlive/distro.html>.
* Menu:
@@ -545,7 +578,7 @@
'INFODIR'.
The values of these directories are determined by 'configure' and can
-be specified explictly as options such as '--prefix=PREFIX' or
+be specified explicitly as options such as '--prefix=PREFIX' or
'--bindir=BINDIR'; otherwise, they are given by their usual Autoconf
defaults:
@@ -572,7 +605,7 @@
The top-level 'configure' script displays all these installation paths.
For the native TL build, the 'Build' script leaves the binaries in
-'./inst/bin/STD-PLATFORM-NAME'. The new binaries are not directly
+'./inst/bin/STD-SYSTEM-TRIPLET'. The new binaries are not directly
usable from that location; they need to be copied to
'Master/bin/TL-PLATFORM'. The other files and directories that end up
in './inst/' are ignored.
@@ -592,8 +625,9 @@
'DATAROOTDIR/texmf-dist/scripts'; for Unix-like systems a symbolic link
is made in 'BINDIR'. For example, a symlink points from 'BINDIR/ps2eps'
to 'DATAROOTDIR/texmf-dist/scripts/ps2eps/ps2eps.pl'. For Windows, a
-standard wrapper binary (e.g., 'BINDIR/ps2eps.exe') serves the same
-purpose. (The source for the wrapper is in 'texk/texlive/w32_wrapper'.)
+standard wrapper binary (copied to, e.g., 'BINDIR/ps2eps.exe') serves
+the same purpose. The source for the wrapper is in
+'texk/texlive/w32_wrapper'.
One reason for this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
@@ -603,9 +637,9 @@
to be as close as possible to what is in the TL distribution. At
present, there are a few exceptions--Asymptote, Biber, Xindy--and each
one creates considerable extra work. We don't want to add more. (See
-<http://tug.org/texlive/build.html> for information about building those
-exceptions, as well as the 'xz' and 'wget' programs that are used in the
-TL infrastructure.)
+<https://tug.org/texlive/build.html> for information about building
+those exceptions, as well as the 'xz' and 'wget' programs that are used
+in the TL infrastructure.)
File: tlbuild.info, Node: Distro builds, Prev: Linked scripts, Up: Installing
@@ -619,12 +653,12 @@
operating system distribution.
The native TL distribution uses shared libraries only when absolutely
-necessary ('libc', 'libm', X11 libraries, and 'libfontconfig').
-However, a distro typically wants to use as many shared libraries as
+necessary ('libc', 'libm', X11 libraries, and 'libfontconfig'). In
+contrast, a distro typically wants to use as many shared libraries as
possible from elsewhere on the system, including TeX-specific libraries
such as 'libkpathsea' (even though Kpathsea has never officially been
-released as a shared library, but we digress). In addition, the
-installation paths will, in general, be completely different.
+released as a shared library). In addition, the installation paths
+will, in general, be completely different.
Here are the 'configure' options that distro builds are likely to
find most relevant:
@@ -645,8 +679,8 @@
Do not build the static versions of the TeX-specific libraries.
'--with-system-LIB'
- Use system versions for as many libraries LIB as possible.
- 'configure --help' will give you the list of possibilities.
+ Look for and use a system version of the library LIB. 'configure
+ --help' will give you the list of possibilities.
'--with-LIB-includes=DIR'
'--with-LIB-libdir=DIR'
@@ -665,7 +699,7 @@
(*note Installing::), and many other issues, such as font maps,
languages, and formats, independently of the build. Norbert Preining
has written a detailed article on adapting TL for distros:
-<http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf>. (If the
+<https://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf>. (If the
article needs updating in the future, perhaps we will merge it into this
document.)
@@ -687,7 +721,7 @@
* Autoconf macros:: TL-specific Autoconf macros.
* Library modules:: Handling libraries, with examples.
* Program modules:: Handling programs, with examples.
-* Extending TeX Live:: Adding a new module.
+* Extending TeX Live:: Adding a new module.
File: tlbuild.info, Node: Build system tools, Next: Top-level directories, Up: Layout and infrastructure
@@ -695,8 +729,8 @@
6.1 Build system tools
======================
-As mentioned above (*note Prerequisites::), a normal build requires very
-little. On the other hand, if you want to modify the TeX Live
+As mentioned above (*note Prerequisites::), a normal build has few
+requirements. On the other hand, if you want to modify the TeX Live
infrastructure sources, such as 'configure.ac' or 'Makefile.am' files,
you will need to have several additional tools installed.
@@ -710,12 +744,12 @@
Currently the versions we use are:
autoconf (GNU Autoconf) 2.69
- automake (GNU automake) 1.15.1
- bison (GNU Bison) 3.0.4
+ automake (GNU automake) 1.16.1
+ bison (GNU Bison) 3.3.1
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.18
- makeinfo (GNU texinfo) 6.5
+ makeinfo (GNU texinfo) 6.6
These versions should be used to update the generated files (e.g.,
'configure' or 'Makefile.in') in all or parts of the TL tree after their
@@ -723,16 +757,21 @@
top-level 'reautoconf' script or implicitly by using the configure
option '--enable-maintainer-mode'.
+ It has often turned out that the bison and flex versions are not
+critical; however, the autotools versions are. If you don't have the
+given versions, get them before modifying the build infrastructure.
+
The files in the Subversion repository (see
-<http://tug.org/texlive/svn>) are all up to date, but unfortunately this
-may not be reflected by their timestamps. (For starters, be sure to set
-'use-commit-times=yes' in '~/.subversion/config' or the equivalent.)
+<https://tug.org/texlive/svn>) are all up to date (barring bugs). For
+this to be reflected by their timestamps in your checkout, be sure to
+set 'use-commit-times=yes' in '~/.subversion/config' or the equivalent.
- To avoid unnecessary runs of 'bison', 'flex', or 'makeinfo' it may be
-necessary to 'touch' the generated ('.c', '.h', or '.info') files. With
-'--enable-maintainer-mode' it may also be necessary to 'touch' first
-'aclocal.m4', then 'configure' and 'config.h.in' (or 'c-auto.in'), and
-finally all 'Makefile.in' files. Perhaps 'make -t' will help.
+ If timestamps are wrong, you may also be able to avoid unnecessary
+runs of 'bison', 'flex', or 'makeinfo' with 'touch' of the generated
+('.c', '.h', or '.info') files. With '--enable-maintainer-mode' it may
+also be necessary to 'touch' first 'aclocal.m4', then 'configure' and
+'config.h.in' (or 'c-auto.in'), and finally all 'Makefile.in' files.
+Perhaps 'make -t' will help.
File: tlbuild.info, Node: Top-level directories, Next: Autoconf macros, Prev: Build system tools, Up: Layout and infrastructure
@@ -766,22 +805,18 @@
The top-level 'build-aux/' directory contains the common files
'compile', 'config.guess', 'config.sub', 'depcomp', etc. used by most
-packages. These are from the GNU Gnulib sources
-(<http://www.gnu.org/software/gnulib>), which in turn synchronizes with
-the appropriate ultimate upstream repository. There are, however,
-independent copies in, e.g., 'libs/freetype2/freetype-*/builds/unix/',
-and a few other places. The 'reautoconf' script does not touch those,
-but a TL cron job keeps them in sync (nightly).
+packages. These are taken from the GNU Gnulib sources
+(<https://www.gnu.org/software/gnulib>), which in turn synchronizes with
+any ultimate upstream repository. There are independent copies of some
+of these in a few other places, e.g.,
+'libs/freetype2/freetype-*/builds/unix/'. The 'reautoconf' script does
+not touch those, but a TL cron job keeps them in sync (nightly).
- The directory 'extra/' contains things which are not part of the TL
-build, but are present just for (someone's) convenience, e.g., is
-'epstopdf' development source is here.
-
When the top-level './Build' script is used to build TL, two more two
more top-level directories appear: 'Work/' for the build tree, and
'inst/' for the install tree (from 'make install'). These names (and
everything else about 'Build''s operation) can be changed by setting
-environment variables before running it; see the script file.
+environment variables before running it; see the script source.
File: tlbuild.info, Node: Autoconf macros, Next: Library modules, Prev: Top-level directories, Up: Layout and infrastructure
@@ -789,11 +824,12 @@
6.3 Autoconf macros
===================
-Here we describe some of the Autoconf macros used in several modules-not
-a complete list, by any means. These general macros are supplemented by
-module-specific macros in directories such as 'texk/dvipng/m4/'; some of
-those are described in *note Library modules:: and *note Program
-modules::.
+Here we describe a few of the Autoconf macros used in several
+modules--many more are defined in the sources; see the top-level 'm4/'
+directory. These general macros are supplemented by module-specific
+macros in directories such as 'texk/dvipng/m4/'; some of those are
+described in following sections (*note Library modules:: and *note
+Program modules::).
* Menu:
@@ -826,8 +862,8 @@
'LT_INIT([win32-dll])'
'AC_SYS_LARGEFILE'
'AC_FUNC_FSEEKO'
- and check for frequently used functions, headers, types, and
- structures. This is used for TeX-specific modules.
+ along with checks for frequently used functions, headers, types,
+ and structures. This is used for TeX-specific modules.
File: tlbuild.info, Node: Macros for programs, Next: Macros for compilers, Prev: General setup macros, Up: Autoconf macros
@@ -838,11 +874,11 @@
Macros for program checks:
-- Macro: KPSE_CHECK_LATEX
- Set 'LATEX' to the name of the first of 'latex', 'elatex', or
- 'lambda' which exists in 'PATH', or to 'no' if none of them exists.
- Call 'AC_SUBST' for 'LATEX'. The result of this test can be
- overridden by setting the 'LATEX' environment variable or the cache
- variable 'ac_cv_prog_LATEX'.
+ Set 'LATEX' to the first of 'latex', 'elatex', or 'lambda' which
+ exists in 'PATH', or to 'no' if none of them exists. Call
+ 'AC_SUBST' for 'LATEX'. The result of this test can be overridden
+ by setting the 'LATEX' environment variable or the cache variable
+ 'ac_cv_prog_LATEX'.
-- Macro: KPSE_CHECK_PDFLATEX
Check for 'pdflatex' in 'PATH' and set 'PDFLATEX'.
@@ -865,8 +901,8 @@
When using the (Objective) C/C++ compiler, set
'WARNING_[OBJ]C[XX]FLAGS' to suitable warning flags (depending on
the value given to or implied for '--enable-compiler-warnings').
- Call 'AC_SUBST' for them. At the moment this only works for GNU
- compilers, but could be extended to others if necessary.
+ Call 'AC_SUBST' for them. At present this assumes GNU compiler
+ warning options, but could be extended to others if necessary.
This macro caches its results in the 'kpse_cv_warning_cflags', ...
variables.
@@ -874,9 +910,9 @@
-- Macro: KPSE_COMPILER_VISIBILITY
When using the C or C++ compiler, try to set
'VISIBILITY_C[XX]FLAGS' to flags to hide external symbols. Call
- 'AC_SUBST' for this variable. At the moment this only tests for
- the compiler option '-fvisibility=hidden', but that could be
- extended with more checks if necessary.
+ 'AC_SUBST' for this variable. At present this only tests for the
+ compiler option '-fvisibility=hidden', but could be extended if
+ necessary.
This macro caches its results in the 'kpse_cv_visibility_cflags' or
'kpse_cv_visibility_cxxflags' variable.
@@ -884,8 +920,7 @@
-- Macro: KPSE_CXX_HACK
Provide the configure option '--enable-cxx-runtime-hack'. If
enabled and when using 'g++', try to statically link with
- 'libstdc++', somewhat improving portability of the resulting
- binary.
+ 'libstdc++', notably improving portability of the resulting binary.
This macro caches its result in the 'kpse_cv_cxx_hack' variable.
@@ -914,11 +949,13 @@
-- Macro: KPSE_LIBPNG_FLAGS
Provide the configure option '--with-system-libpng'. Set and
'AC_SUBST' 'make' variables for modules using this library (either
- an installed version or from the TeX Live tree): 'LIBPNG_INCLUDES'
- for use in 'CPPFLAGS', 'LIBPNG_LIBS' for use in 'LDADD',
- 'LIBPNG_DEPEND' for use as dependency, and 'LIBPNG_RULE' defining
- 'make' rules to rebuild the library.
+ an installed version or from the TeX Live tree):
+ 'LIBPNG_INCLUDES' for use in 'CPPFLAGS',
+ 'LIBPNG_LIBS' for use in 'LDADD',
+ 'LIBPNG_DEPEND' for use as a Makefile dependency,
+ 'LIBPNG_RULE' for the 'make' rules to rebuild the library.
+
-- Macro: KPSE_ADD_FLAGS (NAME)
Temporarily extend 'CPPFLAGS' and 'LIBS' with the values required
for the library module 'NAME'.
@@ -941,7 +978,7 @@
## Rebuild libpng
@LIBPNG_RULE@
- If it was necessary to examine whether certain 'zlib' or 'libpng'
+ If it were necessary to examine whether certain 'zlib' or 'libpng'
features were available, 'configure.ac' should be continued this way:
KPSE_ADD_FLAGS([zlib])
... # tests for 'zlib' features, if any
@@ -959,10 +996,10 @@
due to the lack of symbolic links.
-- Macro: KPSE_CHECK_WIN32
- Check if compiling for a Windows system. The result is 'no' for
- Unix-like systems (including Cygwin), 'mingw32' for Windows with
- GCC, or 'native' for Windows with MSVC. The result is cached in the
- 'kpse_cv_have_win32' variable.
+ Check if compiling for a Windows system. The result is either 'no'
+ for Unix-like systems (including Cygwin), 'mingw32' for Windows
+ with GCC, or 'native' for Windows with MSVC. The result is cached
+ in the 'kpse_cv_have_win32' variable.
-- Macro: KPSE_COND_WIN32
Call 'KPSE_CHECK_WIN32' and define the Automake conditional 'WIN32'
@@ -981,7 +1018,7 @@
Linked scripts::).
-- Macro: KPSE_WIN32_CALL
- Call 'KPSE_COND_WIN32', check if the file
+ Call 'KPSE_COND_WIN32' and check if the file
'texk/texlive/w32_wrapper/callexe.c' exists; if it does, create a
symlink in the build tree. Compiling 'callexe.c' with
'-DEXEPROG='"FOO.exe"'' and installing 'callexe.exe' as 'BAR.exe'
@@ -1011,14 +1048,14 @@
6.4.1 The 'png' library in 'libs/libpng'
----------------------------------------
-This generic library uses the source tree in, e.g., the subdirectory
-'libpng-src/' with all modifications for TL recorded in 'TLpatches/*'.
+The "generic" 'png' library uses the source tree in the subdirectory
+'libpng-src/', with all modifications for TL recorded in 'TLpatches/*'.
The 'configure.ac' fragment 'ac/withenable.ac' contains
KPSE_WITH_LIB([libpng], [zlib])
-specifying the module name, and indicating the dependency on 'zlib'. A
-third literal argument 'tree' would specify that the library from the
+to specify the module name and indicate the dependency on 'zlib'. A
+third literal argument ''tree'' would specify that the library from the
TeX Live tree cannot be replaced by a system version. That not being
the case here, a second fragment 'ac/libpng.ac' contains
@@ -1036,27 +1073,30 @@
return 0; }
which Autoconf uses to verify the usability of a system version with C
-code. The analogous macro 'KPSE_TRY_LIBXX' would check using C++ code.
-These fragments are included by 'configure.ac' at the top level.
+code. The analogous macro 'KPSE_TRY_LIBXX' would check using C++.
+These fragments are included by the 'configure.ac' at the top level of
+TL ('Build/source/configure.ac').
- For this library, among many other modules, a proxy build system for
-TL is used ('configure.ac', 'Makefile.am', and 'include/Makefile.am'),
-ignoring the distributed one. Consequently, a few generated files and
-auxiliary scripts are removed from the distributed source tree. The
-public headers 'png.h', 'pngconf.h', and 'pnglibconf.h' are "installed"
-(as symlinks) under 'include/' in the build tree exactly as they are for
-a system version under, e.g., '/usr/include/'.
+ For this library, like many other modules, a proxy build system for
+TL is used, consisting of our own 'configure.ac', 'Makefile.am',
+'include/Makefile.am'; the distributed build system is not used.
+(Consequently, a few generated files and auxiliary scripts are removed
+from the distributed source tree.)
+ The public headers 'png.h', 'pngconf.h', and 'pnglibconf.h' are
+"installed" (as symlinks) under 'include/' in the build tree exactly as
+they are for a system version under, e.g., '/usr/include/'.
+
The module is supplemented by the file 'm4/kpse-libpng-flags.m4' that
defines the M4 macro 'KPSE_LIBPNG_FLAGS' used by all modules depending
on this library in their 'configure.ac' to generate the 'make' variables
'LIBPNG_INCLUDES' for use in 'CPPFLAGS', 'LIBPNG_LIBS' for use in
-'LDADD', 'LIBPNG_DEPEND' for use as dependencies, and 'LIBPNG_RULE'
-defining 'make' rules to rebuild the library.
+'LDADD', 'LIBPNG_DEPEND' for use as dependencies, and 'LIBPNG_RULE' for
+the 'make' rules to rebuild the library.
'm4/kpse-libpng-flags.m4' also supplies the configure option
-'--with-system-libpng' and uses 'pkg-config' to determine the flags
-required for the system library.
+'--with-system-libpng', which then uses 'pkg-config' to determine the
+flags required for the system library.
File: tlbuild.info, Node: zlib library, Next: freetype library, Prev: png library, Up: Library modules
@@ -1076,12 +1116,16 @@
6.4.3 The 'freetype' library in 'libs/freetype2'
------------------------------------------------
-This module uses a wrapper build system with an almost trivial
-'configure.ac' and with a 'Makefile.am' that invokes 'configure' and
-'make' for the distributed source, followed by 'make install' with the
-build tree as destination. The flags required for the system library
-are obtained through 'freetype-config'.
+This module uses a wrapper build system. In contrast to the proxy build
+described earlier, the wrapper build has an almost trivial
+'configure.ac' and a 'Makefile.am' which invokes the 'configure' and
+'make' in the distributed source, followed by 'make install' with the TL
+build tree as destination. In other words, this actually uses the build
+system provided by upstream (possibly patched).
+ The flags required for the system library are obtained through
+'freetype-config'.
+
File: tlbuild.info, Node: kpathsea library, Prev: freetype library, Up: Library modules
@@ -1089,26 +1133,26 @@
-----------------------------------------------
This is one of the TeX-specific libraries that are maintained as part of
-TeX Live (*note (kpathsea)::). Despite being a core part of the TeX
-system, it is not a terribly special case in the infrastructure. The
-TeX libraries are Libtool libraries (static and/or shared) and are
-installed by 'make install' together with the programs. They are,
-however, not part of the TL DVD as distributed by TeX user groups, and
-have never been officially released for standalone use.
+TeX Live (*note (kpathsea)::); the other is 'ptexenc'. These TeX
+libraries are Libtool libraries (static and/or shared) and are installed
+by 'make install' together with the programs. They are, however, not
+part of the TL DVD as distributed by TeX user groups, and have never
+been officially released for standalone use.
- It is possible, and perhaps even useful for distro builds (*note
-Distro builds::), to specify the configure option
-'--with-system-kpathsea' in order to use a system version of the
-library. Programs outside the TL tree should use 'pkg-config' for the
-required flags.
+ It is possible, and probably useful for distro builds (*note Distro
+builds::), to specify the configure option '--with-system-kpathsea' in
+order to use a system version of the library. Programs outside the TL
+tree should use 'pkg-config' for the required flags.
- In addition to 'ac/withenable.ac' and 'ac/kpathsea.ac' there is a
-third fragment 'ac/mktex.ac' included by both 'ac/withenable.ac' and
-'configure.ac' that supplies configure options such as
-'--enable-mktextfm-default', which determine the compile time default of
-whether or not to run 'mktextfm' to generate a missing '.tfm' file. In
-any case, however, the command line options '-mktex=tfm' or
-'-no-mktex=tfm' for the TeX-like engines override this default.
+ In addition to 'kpathsea/ac/withenable.ac' and
+'kpathsea/ac/kpathsea.ac' here there is a third fragment
+'kpathsea.ac/mktex.ac', included by both 'withenable.ac' and
+'configure.ac', which supplies configure options such as
+'--enable-mktextfm-default'. These determine the compile time default
+of whether or not to run 'mktextfm' (and similar) to generate a missing
+'.tfm' (or whatever) file. In any case, however, the command line
+options '-mktex=tfm' or '-no-mktex=tfm' for the TeX-like engines
+override this default.
File: tlbuild.info, Node: Program modules, Next: Extending TeX Live, Prev: Library modules, Up: Layout and infrastructure
@@ -1132,10 +1176,10 @@
6.5.1 The 't1utils' package in 'utils/t1utils'
----------------------------------------------
-Once again we use the distributed source tree 't1utils-src' with
-modifications documented in 'TLpatches/*' and a proxy build system
-consisting of 'configure.ac' and 'Makefile.am'. The fragment
-'ac/withenable.ac' contains
+Here we use the distributed source tree 't1utils-src' with modifications
+documented in 'TLpatches/*' and a proxy build system consisting of
+'configure.ac' and 'Makefile.am'. The fragment 'ac/withenable.ac'
+contains
KPSE_ENABLE_PROG([t1utils])
@@ -1149,24 +1193,25 @@
------------------------------------------
This module uses the distributed source tree 'xindy-src/' with
-modifications documented in 'TLpatches/*', a proxy 'configure.ac', and a
-wrapper 'Makefile.am' that descends into 'xindy-src'. The 'xindy' build
-requires a 'make' that supports a 'VPATH' build, can handle all targets,
-and do not refer to '${top_srcdir}' or '${top_builddir}'. The fragment
-'ac/withenable.ac' contains
+modifications documented in 'TLpatches/*', and a wrapper 'configure.ac'
+and 'Makefile.am' that descends into 'xindy-src'.
- KPSE_ENABLE_PROG([xindy], , [disable native])
+ The 'xindy' build requires a 'make' that supports a 'VPATH' build,
+can handle all targets, and do not refer to '${top_srcdir}' or
+'${top_builddir}'. The fragment 'xindy/ac/withenable.ac' contains
+
+ KPSE_ENABLE_PROG([xindy], , [disable])
m4_include(kpse_TL[utils/xindy/ac/xindy.ac])
m4_include(kpse_TL[utils/xindy/ac/clisp.ac])
where 'disable' in the third argument indicates that 'xindy' is only
built if explicitly enabled by the user with 'configure --enable-xindy'
-(the need for 'clisp' is too painful to require by default), and
-'native' disallows cross compilation. The additional fragments
-'ac/xindy.ac' and 'ac/clisp.ac' specify more 'configure' options to be
-seen at the top level with 'ac/xindy.ac' also included by
-'configure.ac'.
+(the need for 'clisp' makes it too painful to enable by default).
+ The additional fragments 'ac/xindy.ac' and 'ac/clisp.ac' specify more
+'configure' options to be seen at the top level, with 'ac/xindy.ac' also
+included by 'configure.ac'.
+
File: tlbuild.info, Node: xdvik package, Next: asymptote, Prev: xindy package, Up: Program modules
@@ -1174,23 +1219,23 @@
-----------------------------------------
This package is maintained as part of the TeX Live tree with sources in
-its top level directory and the subdirectory 'gui'. The fragment
-'ac/withenable.ac' contains
+its own directory ('texk/xdvik/'). The fragment
+'xdvik/ac/withenable.ac' contains
dnl extra_dirs = texk/xdvik/squeeze
KPSE_ENABLE_PROG([xdvik], [kpathsea freetype2], [x])
m4_include(kpse_TL[texk/xdvik/ac/xdvik.ac])
-thus specifying the dependency on the 'kpathsea', 'freetype', and X11
+thus specifying dependencies on the 'kpathsea', 'freetype', and X11
libraries. The M4 comment (following 'dnl') signals the subsidiary
'squeeze/configure.ac'. This is needed because the main executable
'xdvi-bin' (to be installed as, e.g., 'xdvi-xaw') is for the 'host'
system whereas the auxiliary program 'squeeze/squeeze' has to run on the
-'build' system and in a cross compilation they differ.
+'build' system; in a cross compilation, these differ.
The additional fragment 'ac/xdvik.ac' is also included by
'configure.ac' and supplies the configure option '--with-xdvi-x-toolkit'
-also seen at the top-level.
+also seen at the top level.
File: tlbuild.info, Node: asymptote, Prev: xdvik package, Up: Program modules
@@ -1201,7 +1246,8 @@
This subdirectory contains the sources for 'asy' and 'xasy' but due to
its complexity and prerequisites (e.g., OpenGL) it is not part of the TL
build system. These programs must be built and installed independently,
-but are included on the TL DVD together with their support files.
+but are included on the TL DVD together with their support files. See
+<https://tug.org/build.html#asymptote>.
File: tlbuild.info, Node: Extending TeX Live, Prev: Program modules, Up: Layout and infrastructure
@@ -1213,11 +1259,11 @@
TL build system.
In any case, a new package directory 'foo' should contain the
-original sources, as modified for TL, in 'foo/foo-src', and the changes
-should be documented in 'foo/TLpatches/*'; changes should also be
-submitted upstream whenever reasonable, of course. In addition, 'foo/'
+original sources, modified only with changes necessary for TL, in
+'foo/foo-src'. The changes should be documented in 'foo/TLpatches/*',
+and also be submitted upstream whenever reasonable. In addition, 'foo/'
will need the usual Automake build-related files ('configure.ac',
-'Makefile.am', etc. Please keep a 'ChangeLog' for all TL changes.
+'Makefile.am', etc. Please maintain 'foo/ChangeLog' for all TL changes.
* Menu:
@@ -1246,25 +1292,25 @@
1. a list of required libraries from the TL tree;
- 2. a list of options ('disable' if this module is not to be built
+ 2. a list of options: 'disable' if this module is not to be built
without the configure option '--enable-PROG', 'native' if cross
compilation is not possible, 'x' if the program requires X11
- libraries);
+ libraries;
3. a comment added to the help text for the 'configure' option
'--enable-PROG' or '--disable-PROG'.
- If the module requires specific configure options to be seen at the
+ If the module requires specific 'configure' options to be seen at the
top level, they should be defined in an additional fragment 'ac/PROG.ac'
included from 'ac/withenable.ac' and 'configure.ac'.
Usually, the new program is maintained somewhere outside of TeX Live.
-In that case, we put the upstream sources into a subdirectory 'PROG-src'
-(e.g., 'utils/newprog/newprog-src'). We do not run 'configure' in this
-original '...-src' directory, only in our own directory, but we do
-compile using the source files in '...-src'.
+In that case, as above, we put the upstream sources into a subdirectory
+'PROG-src' (e.g., 'utils/newprog/newprog-src'). We do not typically run
+'configure' in this original '...-src' directory, but only in our own
+directory; but we do compile using the source files in '...-src'.
- So, these are the files that we must generally create:
+ So, to summarize the files that we must (usually) create:
'ac/withenable.ac'
The 'KPSE_ENABLE_PROG' call just explained.
@@ -1289,10 +1335,11 @@
Record all TL-specific changes, now and in the future.
Then, run GNU 'autoreconf' in the new directory (*note Build system
-tools::). After that works, 'svn add' the necessary files, notably
-'Makefile.in aclocal.m4 configure', and 'svn:ignore' the Automake cache
-'autom4te.cache'. (This is so people checking out the TL source tree do
-not have to run any autotools, but can simply run 'configure'.)
+tools::). After that works, 'svn add' the necessary files, including
+the generated 'Makefile.in aclocal.m4 configure', and 'svn:ignore' the
+Automake cache 'autom4te.cache'. (This is so people checking out the TL
+source tree do not have to run any autotools, but can simply run
+'configure'.)
Then, run the TL tool 'reautoconf' in the top-level TL 'source/'
directory, to incorporate the new program into the build tree.
@@ -1311,7 +1358,7 @@
A generic library module in a subdirectory 'libs/LIB' must not depend on
TeX-specific libraries, by definition. It is included by adding its
-name 'LIB' to the M4 list 'kpse_libs_pkgs' in 'm4/kpse-pkgs.m4'--before
+name 'LIB' to the M4 macro 'kpse_libs_pkgs' in 'm4/kpse-pkgs.m4'--before
any other libraries from the TeX Live tree on which it depends.
As with program modules, the subdirectory 'libs/LIB' must contain the
@@ -1319,9 +1366,9 @@
programs) and a fragment 'ac/withenable.ac' that contains the M4 macro
'KPSE_WITH_LIB' defined in 'm4/kpse-setup.m4' with 'LIB' as the
mandatory first argument and two optional arguments: a list of required
-libraries from the TL tree, and a list of options (currently there is
-only one: specify 'tree' if this library cannot be replaced by a system
-version).
+libraries from the TL tree, and a list of options: for libraries,
+currently there is only one--specify 'tree' if this library cannot be
+replaced by a system version.
If a system version can be used, a second fragment 'ac/LIB.ac' is
needed, containing the M4 macro 'KPSE_TRY_LIB' (or 'KPSE_TRY_LIBXX')
@@ -1340,7 +1387,7 @@
If a system library is allowed, 'KPSE_LIB_FLAGS' also provides the
configure option '--with-system-LIB' and uses the additional M4 macro
'KPSE_LIB_SYSTEM_FLAGS' to generate the 'make' variables for a system
-library. Furthermore the definition of the M4 macro
+library. In addition, the definition of the M4 macro
'KPSE_ALL_SYSTEM_FLAGS' in 'm4/kpse-pkgs.m4' must be extended by the
line:
'AC_REQUIRE([KPSE_LIB_SYSTEM_FLAGS])'
@@ -1356,8 +1403,8 @@
from the TL tree. It is included in the same general ways as a generic
library (see the previous section), with these modifications:
- * The library name 'LIB' is added to the M4 list 'kpse_texlibs_pkgs'
- also in 'm4/kpse-pkgs.m4'.
+ * The library name 'LIB' is added to the M4 macro
+ 'kpse_texlibs_pkgs', which is also in 'm4/kpse-pkgs.m4'.
* The fragment 'ac/withenable.ac' must use 'KPSE_WITH_TEXLIB'.
@@ -1375,17 +1422,17 @@
few important module-specific ones, whereas, e.g.,
'texk/lcdf-typetools/configure --help'
also displays the 'lcdf-typetools' specific options, which are not shown
-at the top-level.
+at the top level.
The help text also mentions several influential environment
-variables, but for TeX Live it is better to specify them as assigments
+variables, but for TeX Live it is better to specify them as assignments
on the command line.
The './Build' script used to make the binaries shipped with TeX Live
invokes the top-level 'configure' with a few additional options (*note
Building::). The defaults discussed below are those for the actual
-'configure' script; invoking 'configure' via './Build' may yield
-different results.
+'configure' script; invoking 'configure' via './Build' yields different
+results.
Defaults for most options are set at the top level and propagated
explicitly to all subdirectories. Options specified on the command line
@@ -1433,15 +1480,14 @@
are explicitly disabled), and enforces '--disable-shared'.
If building TL for a GNU/Linux or other distribution, this should be
-disabled and system versions of most libraries would be used (*note
-Distro builds::). This may fail without GNU 'make', but will be tried
-regardless.
+disabled and system versions of most libraries should be used (*note
+Distro builds::).
A related option, '--enable-texlive-build', is automatically passed
to all subdirectories (and cannot be disabled). Subdirectories that can
also be built independently from the TL tree (such as 'utils/xindy' and
-'texk/dvipng') can use this option, e.g., to choose TL-specific
-installation paths.
+'texk/dvipng') but cooperate with TL can use this option to enable
+TL-specific adaptations, such as installation paths.
File: tlbuild.info, Node: --prefix --bindir ..., Next: --disable-largefile, Prev: --disable-native-texlive-build, Up: Global configure options
@@ -1462,9 +1508,10 @@
7.1.3 '--disable-largefile'
---------------------------
-Omit large file support (LFS), needed on most 32-bit Unix systems for
-files with 2GB or more. Regardless of this, the size of 'DVI' and 'GF'
-files must always be <2GB, due to the file format specifications.
+Omit large file support (LFS), which is needed on most 32-bit Unix
+systems for files with 2GB or more. Regardless of this option, the size
+of 'DVI' and 'GF' files must always be <2GB, due to the file format
+specifications.
With LFS, there is no fixed limit on the size of PDF files created by
'pdftex' or PostScript files created by 'dvips'. The size of PDF images
@@ -1487,16 +1534,13 @@
7.1.5 '--enable-compiler-warnings='LEVEL
----------------------------------------
-Enable various levels of compiler warnings for (Objective) C and C++:
-the LEVEL value can be one of: 'no min yes max all'. The default is
-'yes' in 'maintainer-mode' (see below) and 'min' otherwise. This option
-defines 'WARNING_[OBJ]C[XX]FLAGS' but these flags are not used in all
-library and program modules. Using them should help to resolve
-portability problems.
+Enable various levels of compiler warnings for C, C++, and/or
+Objective C: the LEVEL value can be one of: 'no min yes max all'. The
+default is 'yes' in 'maintainer-mode' (see below) and 'min' otherwise.
+This option defines the variables 'WARNING_[OBJ]C[XX]FLAGS', but these
+variables are not consistently used in all library and program modules.
+At present, these warning flags assume options from the GNU compilers.
- At present, these warning flags are only defined for the GNU
-compilers but flags for other compilers could be added when needed.
-
File: tlbuild.info, Node: --enable-cxx-runtime-hack, Next: --enable-maintainer-mode, Prev: --enable-compiler-warnings=LEVEL, Up: Global configure options
@@ -1503,9 +1547,9 @@
7.1.6 '--enable-cxx-runtime-hack'
---------------------------------
-If enabled (as it is for the native TL build) and when using 'g++', try
-to statically link with 'libstdc++', somewhat improving portability of
-the resulting binary. *Note Macros for compilers::.
+If enabled (as it is for the native TL build), when using 'g++', try to
+statically link with 'libstdc++', thus improving portability of the
+resulting binary. *Note Macros for compilers::.
File: tlbuild.info, Node: --enable-maintainer-mode, Next: --enable-multiplatform, Prev: --enable-cxx-runtime-hack, Up: Global configure options
@@ -1525,11 +1569,12 @@
7.1.8 '--enable-multiplatform'
------------------------------
-If enabled and '--bindir=DIR' or '--libdir=DIR' are not specified,
-install executables and libraries in per-platform subdirectories of
-'EPREFIX/bin' and 'EPREFIX/lib' where EPREFIX is the value given or
-implied for 'exec_prefix'. In any case, the values for 'bindir' and
-'libdir' are automatically propagated to all subdirectories.
+If enabled (as it is for the native TL build) and '--bindir=DIR' or
+'--libdir=DIR' are not specified, install executables and libraries in
+per-platform subdirectories of 'EPREFIX/bin' and 'EPREFIX/lib' where
+EPREFIX is the value given or implied for 'exec_prefix'. In any case,
+the values for 'bindir' and 'libdir' are automatically propagated to all
+subdirectories.
File: tlbuild.info, Node: --enable-shared, Next: --enable-silent-rules, Prev: --enable-multiplatform, Up: Global configure options
@@ -1548,9 +1593,9 @@
------------------------------
Enable the use of less verbose build rules. When using GNU 'make' (or
-another 'make' implementation supporting nested variable expansions),
-you can specify 'V=1' on the 'make' command line to get more verbosity,
-or 'V=0' to get less, regardless of this option.
+any 'make' implementation supporting nested variable expansions), you
+can specify 'V=1' on the 'make' command line to get more verbosity, or
+'V=0' to get less, regardless of this option.
File: tlbuild.info, Node: --without-ln-s, Next: --without-x, Prev: --enable-silent-rules, Up: Global configure options
@@ -1560,7 +1605,7 @@
Required when using a system without a working 'ln -s' to build binaries
for a Unix-like system. However, 'make install' will not create
-anything useful and might even fail.
+anything useful, and might fail.
File: tlbuild.info, Node: --without-x, Prev: --without-ln-s, Up: Global configure options
@@ -1596,7 +1641,7 @@
7.2.1 '--enable-PROG', '--disable-PROG'
---------------------------------------
-Do or do not build and install the program(s) of the module 'PROG'.
+Do or do not build and install the program(s) of module 'PROG'.
File: tlbuild.info, Node: --disable-all-pkgs, Next: Configure options for texk/web2c, Prev: --enable-PROG --disable-PROG, Up: Program-specific configure options
@@ -1609,10 +1654,7 @@
program, which is specified with an additional '--enable' option, e.g.,
'--enable-dvipdfm-x'. It's still simplest to check out and configure
the whole source tree, but at least only the program you are interested
-in, and its dependencies, are built. The 'configure' will generally
-take less than a minute with everything disabled. (It is a good idea to
-run 'make check' after doing this, and after making any changes, to
-ensure that whatever tests have been written still pass.)
+in, and its dependencies, are built. *Note Build one package::.
Without this option, all modules are built except those that are
explicitly disabled or specify 'disable' in their 'ac/withenable.ac'
@@ -1625,13 +1667,13 @@
----------------------------------------
'--with-banner-add=STR'
-Add 'STR' to the default version string ('TeX Live YEAR' or 'Web2C
-YEAR') appended to banner lines. This is ignored for a native TL build,
-but distro builds should specify, e.g., '/SOMEDISTRO'.
+Add 'STR' to the default version string (which is ''TeX Live YEAR'' or
+''Web2C YEAR'') appended to banner lines. This is ignored for a native
+TL build, but distro builds should specify, e.g., '/SOMEDISTRO'.
'--with-editor=CMD'
-Specify the command 'CMD' to invoke from the 'e' option of TeX-like
-engines, replacing the default 'vi +%d '%s'' for Unix or 'texworks
+Specify the command 'CMD' to invoke from the 'e' option of TeX and
+friends, replacing the default 'vi +%d '%s'' for Unix or 'texworks
--position=%d "%s"' for Windows.
'--with-fontconfig-includes=DIR', '--with-fontconfig-libdir=DIR'
@@ -1660,8 +1702,8 @@
(defaults are defined in the fragment 'texk/web2c/ac/web2c.ac').
'--disable-web-progs'
-Do not build the core WEB programs 'bibtex', ..., 'weave'. Useful if,
-e.g., you only want to (re)build some engines.
+Do not build the original WEB programs 'bibtex', ..., 'weave'. Useful
+if, e.g., you only want to (re)build some engines.
'--enable-auto-core'
This option causes TeX and Metafont to produce a core dump when a
@@ -1674,12 +1716,12 @@
'libexpat'.
'--enable-*win'
-Include various types of other window support for Metafont (EPSF output,
-'mftalk', old terminals, ...).
+Include various types of non-X window support for Metafont (EPSF output,
+'mftalk', old graphics terminals, ...).
'--enable-tex-synctex', '--disable-etex-synctex', ...
Build the TeX engines with or without 'SyncTeX' support; ignored for a
-native TeX Live build, defaults are again defined in
+native TeX Live build. Defaults are defined in
'texk/web2c/ac/web2c.ac'.
'--disable-synctex'
@@ -1714,7 +1756,7 @@
'dvipdfmx', with backward-compatible (very slightly different) behavior.
'--disable-dvipdfmx'
-Do not build the 'dvipdfmx' program with the 'dvipdfm' symlink.
+Do not build the 'dvipdfmx' program or make the 'dvipdfm' symlink.
'--disable-xdvipdfmx'
Do not build the 'xdvipdfmx' program.
@@ -1728,8 +1770,8 @@
'--with-system-libgs'
Build 'dvisvgm' using installed Ghostscript ('gs') headers and library
(not allowed for a native TL build). The default is to load the 'gs'
-library at runtime if possible, or otherwise disable support for
-PostScript specials.
+library at runtime if possible, else to disable support for PostScript
+specials.
'--without-libgs'
Build 'dvisvgm' without PostScript support at all. Because the dynamic
@@ -1756,7 +1798,7 @@
----------------------------------------
'--with-gs=FILENAME'
-Hardwire the location of Ghostscript ('gs').
+Hardwire the location of Ghostscript ('gs') as called by Xdvik.
'--with-xdvi-x-toolkit=KIT'
Use toolkit 'KIT' for 'xdvik', one of: 'motif xaw xaw3d neXtaw'. The
@@ -1763,8 +1805,8 @@
default is 'motif' if available, else 'xaw'.
'--enable-xi2-scrolling'
-Use XInput 2.1 "smooth scrolling" if available. (default: yes, except
-for a native TL build).
+Use XInput 2.1 "smooth scrolling" if available (default: yes, except for
+a native TL build).
File: tlbuild.info, Node: Configure options for utils/xindy, Prev: Configure options for texk/xdvik, Up: Program-specific configure options
@@ -1781,13 +1823,12 @@
native TL build).
'--with-clisp-runtime=FILENAME'
-Specifies the Full path for the CLISP runtime file ('lisp.run' or
+Specifies the full path for the Clisp runtime file ('lisp.run' or
'lisp.exe') to be installed. When specified as 'default' (the default
-for a native TL build) the path is determined by the CLISP executable;
+for a native TL build) the path is determined by the Clisp executable;
the value 'system' (not allowed for a native TL build, but the default
-for a non-native one) indicates that 'xindy' will use the installed
-version of 'clisp' (which must be identical to the one used to build
-'xindy').
+otherwise) indicates that 'xindy' will use the installed version of
+'clisp' (which must be identical to the one used to build 'xindy').
File: tlbuild.info, Node: Library-specific configure options, Next: Variables for configure, Prev: Program-specific configure options, Up: Configure options
@@ -1803,7 +1844,7 @@
Use an installed (system) version of the library 'LIB'; this option
exists for most libraries, but is not allowed for a native TL build.
Using a system version implies also using the system versions of all
-libraries (if any) that LIB depends on.
+libraries that LIB depends on.
For many libraries '--with-LIB-includes=DIR' and
'--with-LIB-libdir=DIR' can specify non-standard search locations;
@@ -1824,7 +1865,8 @@
--------------------------------------
'--enable-CMD-default', '--disable-CMD-default'
-Determine the compile time default whether or not to run CMD, one of:
+Determine the compile time default for whether or not to run CMD, which
+is one of:
'mkocp'
(Omega compiled translation process file)
'mkofm'
@@ -1841,7 +1883,7 @@
(TFM file)
to generate the specified type of file dynamically. The default can be
-overridden by the user in any case.
+overridden by the user in any case (*note kpathsea library::).
File: tlbuild.info, Node: Configure options for system poppler, Prev: Configure options for kpathsea, Up: Library-specific configure options
@@ -1849,10 +1891,9 @@
7.3.2 Configure options for system 'poppler'
--------------------------------------------
-Building LuaTeX (or LuaJITTeX) and XeTeX requires 'poppler', either from
-the TL tree or system headers and library. Building pdfTeX requires
-either 'xpdf' from the TeX Live tree or system 'poppler' headers and
-library.
+Building XeTeX requires 'poppler', either from the TL tree or system
+headers and library. Building pdfTeX requires either 'xpdf' from the
+TeX Live tree or system 'poppler' headers and library.
'--with-system-poppler'
Use a system version (0.18 or newer) of 'poppler' for LuaTeX (or
@@ -1859,9 +1900,8 @@
LuaJITTeX) and XeTeX, and use 'pkg-config' to obtain the required flags.
'--with-system-xpdf'
-Use a system version (0.12 or better) of 'poppler' (and 'pkg-config')
-for pdfTeX instead of 'xpdf' from the TL tree. *Note
---disable-largefile::.
+Use a system version (0.12 or newer) of 'poppler' (and 'pkg-config') for
+pdfTeX instead of 'xpdf' from the TL tree. *Note --disable-largefile::.
File: tlbuild.info, Node: Variables for configure, Prev: Library-specific configure options, Up: Configure options
@@ -1878,7 +1918,7 @@
'CPPFLAGS'
And plenty more. As usual with Autoconf, these variables specify
the name (or full path) of compilers, preprocessor flags, and
- similar. *Note autoconf: (GNU Autoconf)Preset Output Variables.
+ similar. *Note (autoconf)Preset Output Variables::.
'CLISP'
Name (or full path) of the 'clisp' executable, used to build
@@ -1890,7 +1930,7 @@
These specify the name (or path) for the 'freetype-config',
'icu-config', and 'pkg-config' commands used to determine the flags
required for system versions of 'libfreetype', the ICU libraries,
- or many other libraries.
+ and other libraries, respectively.
'KPSEWHICH'
Name (or path) of an installed 'kpsewhich' binary, used by 'make
@@ -1919,9 +1959,9 @@
considerable efforts into that direction we are still far from that goal
and there are reasons that we may never fully reach it. Below are some
rules about declarations of functions or variables and the use of
-'const'. These rules should be applied to most of the TeX Live tree,
-the exception being code that is maintained independently and whose
-maintainers don't want to accept patches.
+'const'. These rules should be applied to the code maintained in the
+TeX Live tree and for other packages whose maintainers are willing to
+accept patches.
* Menu:
@@ -1942,7 +1982,7 @@
standard (including 'void' in the declaration of C functions with no
parameters). On the other hand, TL is built for a wide variety of
systems, not all of which support the C99 standard. Therefore using C99
-features should be avoided if that can easily be done. In particular C
+features should be avoided if that can easily be done. In particular, C
code must not contain declarations after statements or C++-style
comments.
@@ -1951,7 +1991,7 @@
For example, the module 'texk/chktex' uses the C99 function 'stpcpy()'
that may or may not be available on a particular system. It uses
'AC_CHECK_DECLS([stpcpy])' in 'configure.ac' to test this, and provides
-the perhaps slightly less efficient alternative
+a perhaps less efficient alternative (in the file 'Utility.h'):
#if !(defined HAVE_DECL_STPCPY && HAVE_DECL_STPCPY)
static inline char *stpcpy(char *dest, const char *src)
@@ -1960,13 +2000,11 @@
}
#endif
-in the file 'Utility.h'.
-
Static functions
................
Functions used in only one file should be declared 'static'; they
-require no prototype except as forward declaration.
+require no prototype except in forward declarations.
Extern functions
................
@@ -2010,8 +2048,8 @@
Getting all 'const' qualifiers right can get quite involved but can
almost always be done. There are only a couple notable exceptions: the
X11 headers are full of declarations that ought to use 'const' but do
-not, and the same is true to some extent for 'libfreetype' (but,
-thankfully, not for 'zlib' nowadays).
+not; at one time, 'libfreetype' also did not fully specify 'const', but
+this has not been checked recently.
What must be avoided with 'const'
.................................
@@ -2018,8 +2056,8 @@
The GCC compiler warnings "assignment discards qualifiers..." and
analogous warnings for "initialization", "passing arg", or "return" must
-be strenously avoided in our own code. The only exception is when they
-are caused by X11 headers or macros or other third party code.
+be strenuously avoided in our own code. The only exception is when they
+are caused by X11 declarations or other third party code.
What should be avoided with 'const'
...................................
@@ -2036,10 +2074,9 @@
9 Continuous integration
************************
-Overview: the sources of TeX Live are subjected to continuous
-integration testing on Travis-CI
-(<https://travis-ci.org/TeX-Live/texlive-source>) via a git-svn mirror
-of the sources that is pushed to Github
+The TeX Live sources are subjected to continuous integration testing on
+Travis-CI (<https://travis-ci.org/TeX-Live/texlive-source>) via a
+git-svn mirror of the sources that is pushed to Github
(<https://github.com/TeX-Live/texlive-source>). The git-svn mirror is
updated (currently) at 30 minute intervals, and only the last commit
pushed is tested on Travis-CI.
@@ -2056,39 +2093,40 @@
9.1 Transfer from Subversion to Github
======================================
-git-svn (<https://git-scm.com/docs/git-svn>) is used to check out the
-subtree 'Build/source' of the Subversion repository. The author index
-file used is not maintained in either Git or Subversion but can be
-provided on request.
+The git-svn program (<https://git-scm.com/docs/git-svn>) is used to
+check out the subtree 'Build/source' of the canonical Subversion
+repository. The author index file used is not maintained in either Git
+or Subversion but can be provided on request.
The initial checkout was done by invoking
- git svn --authors-file usermap clone svn://USER@tug.org/texlive/trunk/Build/source
+ git svn --authors-file usermap clone \
+ svn://USER@tug.org/texlive/trunk/Build/source
where the 'usermap' file maps Subversion user names to name and emails
-of the authors. If no user account at <tug.org> is available, anonymous
-checkout is possible, too:
- git svn --authors-file usermap clone svn://tug.org/texlive/trunk/Build/source
+of the authors. Anonymous checkout is also possible:
+ git svn --authors-file usermap clone \
+ svn://tug.org/texlive/trunk/Build/source
In the following, we will use _admin_ to refer to a user who has
read/write access to the TeX Live subversion repository, and is also an
-administrator of the 'TeX-Live' Team on Github. The above initial
+administrator of the ''TeX-Live'' team at Github. The above initial
checkout has been carried out by _admin_ on the server 'texlive.info'.
- On Github (<https://github.com>), a new git repository named
-'texlive-source' was created by _admin_ within the 'TeX-Live'
-"organization" (<https://github.com/TeX-Live>). The remote was added to
-the checkout with 'git remote add origin
-git at github.com:TeX-Live/texlive-source.git'.
+ On Github, a new git repository named 'texlive-source' was created by
+_admin_ within the 'TeX-Live' "organization"
+(<https://github.com/TeX-Live>). The remote was added to the checkout
+with 'git remote add origin git at github.com:TeX-Live/texlive-source.git'.
To automate the update on Github, a new ssh key was generated and
added to the 'texlive-source' repository on Github as deployment key.
-This way pushes using this key can only go to the 'texlive-source'
+Thus, pushes using this key can only go to the 'texlive-source'
repository and not anywhere else.
The usage of 'git-svn' requires a strict discipline to keep a linear
history in the master branch. Since we are aiming at a pure mirror
-facility, we have decided to further restrict the 'master' branch of the
-'texlive-source' repository on Github to changes by _admin_.
+facility on Github, we have decided to further restrict the 'master'
+branch of the 'texlive-source' repository on Github to changes by
+_admin_.
This setup allows other developers to branch off 'master' and push
their branches to the Github repository, but all updates need to come
@@ -2105,7 +2143,7 @@
minute which essentially runs 'git svn rebase' and 'git push' in the
'master' branch of the checkout. The first command fetches the changes
from the Subversion repository and updates the 'master' branch with
-them, the second one pushes changes (if available) to Github.
+them, and the second pushes changes (if any) to Github.
File: tlbuild.info, Node: CI testing on Travis-CI, Prev: Automatic update of the Git mirror, Up: Continuous integration
@@ -2115,7 +2153,7 @@
The 'source' tree of TeX Live contains a top-level file '.travis.yml'
which controls the automatic testing on Travis-CI. _admin_ has
-registered to Travis-CI and allowed access to the Github's 'TeX-Live'
+registered with Travis-CI and allowed access to the Github's 'TeX-Live'
organization's 'texlive-source' repository. The default settings are to
build the last commit of each push. No further action is necessary on
Travis-CI.
@@ -2325,7 +2363,7 @@
_path_ are copied over to 'bin/custom/' under your installation
directory and this 'bin/custom/' directory is what will be added to
the path for the post-install actions. To install multiple custom
- binary sets, manully rename 'custom' before doing each.
+ binary sets, manually rename 'custom' before doing each.
For more information on custom binaries, see
<http://tug.org/texlive/custom-bin.html>. For general information
@@ -5045,8 +5083,8 @@
* --enable-maintainer-mode: Build system tools. (line 28)
* --enable-maintainer-mode <1>: --enable-maintainer-mode.
(line 6)
-* --enable-missing to ignore dependencies: Build one package. (line 67)
-* --enable-mktextfm-default: kpathsea library. (line 20)
+* --enable-missing to ignore dependencies: Build one package. (line 71)
+* --enable-mktextfm-default: kpathsea library. (line 18)
* --enable-multiplatform: --enable-multiplatform.
(line 6)
* --enable-PROG: --enable-PROG --disable-PROG.
@@ -5057,7 +5095,7 @@
* --enable-tex-synctex: Configure options for texk/web2c.
(line 59)
* --enable-texlive-build: --disable-native-texlive-build.
- (line 16)
+ (line 15)
* --enable-xi2-scrolling: Configure options for texk/xdvik.
(line 13)
* --enable-xindy-docs: Configure options for utils/xindy.
@@ -5086,7 +5124,7 @@
(line 16)
* --with-libgs-includes, -libdir: Configure options for texk/dvisvgm.
(line 17)
-* --with-system-kpathsea: kpathsea library. (line 14)
+* --with-system-kpathsea: kpathsea library. (line 13)
* --with-system-LIB: Adding a new generic library module.
(line 34)
* --with-system-LIB <1>: Library-specific configure options.
@@ -5106,8 +5144,6 @@
* --without-x: --without-x. (line 6)
* -C configure option: Build in parallel. (line 11)
* -j make option: Build in parallel. (line 6)
-* .travis.yml: CI testing on Travis-CI.
- (line 6)
* adapting TeX Live for distros: Distro builds. (line 54)
* adding a new generic library: Adding a new generic library module.
(line 6)
@@ -5121,8 +5157,8 @@
* ANSI C: Declarations and definitions.
(line 6)
* ApplicationServices Mac framework, required by xetex: Prerequisites.
- (line 31)
-* asymptote: Linked scripts. (line 22)
+ (line 32)
+* asymptote: Linked scripts. (line 23)
* asymptote <1>: asymptote. (line 6)
* Autoconf: Overview of build system.
(line 6)
@@ -5129,7 +5165,7 @@
* autoconf macros: Autoconf macros. (line 6)
* Automake: Overview of build system.
(line 6)
-* biber: Linked scripts. (line 22)
+* biber: Linked scripts. (line 23)
* bibtex-x: Configure options for texk/bibtex-x.
(line 6)
* bibtex8: Configure options for texk/bibtex-x.
@@ -5140,6 +5176,7 @@
* build directory, required: Building. (line 17)
* build iteration: Build iteration. (line 6)
* build on demand: Build one package. (line 6)
+* build one engine: Build one engine. (line 6)
* build one package: Build one package. (line 6)
* build problems: Build problems. (line 6)
* Build script: Building. (line 6)
@@ -5151,7 +5188,7 @@
* building: Building. (line 6)
* building a distribution: Build distribution. (line 6)
* building in parallel: Build in parallel. (line 6)
-* C++11, required by dvisvgm: Prerequisites. (line 19)
+* C++11, required: Prerequisites. (line 15)
* C, ANSI, required: Declarations and definitions.
(line 6)
* C99, avoided: Declarations and definitions.
@@ -5161,12 +5198,10 @@
* callexe.c: Macros for Windows. (line 32)
* CC: Variables for configure.
(line 10)
-* CC=C-COMPILER: Build one package. (line 73)
+* CC=C-COMPILER: Build one package. (line 76)
* CC_BUILD: Cross problems. (line 13)
* chktex: Declarations and definitions.
(line 18)
-* ci: Continuous integration.
- (line 6)
* clisp: Variables for configure.
(line 18)
* CLISP: Variables for configure.
@@ -5173,10 +5208,10 @@
(line 17)
* CLISP <1>: Configure options for utils/xindy.
(line 14)
-* clisp, required by xindy: Prerequisites. (line 35)
-* Cocoa Mac framework, required by xetex: Prerequisites. (line 31)
+* clisp, required by xindy: Prerequisites. (line 36)
+* Cocoa Mac framework, required by xetex: Prerequisites. (line 32)
* coding conventions: Coding conventions. (line 6)
-* compilers, C and C++: Prerequisites. (line 6)
+* compilers, C and C++11: Prerequisites. (line 6)
* config.guess, config.sub, ...: Top-level directories.
(line 30)
* configure options: Configure options. (line 6)
@@ -5220,10 +5255,11 @@
* ctangle: Cross problems. (line 26)
* CXX: Variables for configure.
(line 11)
-* CXX=C++-COMPILER: Build one package. (line 73)
-* Debian installation of build prerequisites: Prerequisites. (line 60)
+* CXX=C++-COMPILER: Build one package. (line 76)
* declarations and definitions, in source code: Declarations and definitions.
(line 6)
+* declarations before statements, avoiding: Declarations and definitions.
+ (line 6)
* dependencies, with several output files: Build in parallel. (line 6)
* DESTDIR: --prefix --bindir ....
(line 9)
@@ -5235,35 +5271,39 @@
* dist and distcheck targets for make: Build distribution. (line 6)
* distribution tarball, making: Build distribution. (line 6)
* distro, building for: Distro builds. (line 6)
+* dvipdfm-x: Configure options for texk/dvipdfm-x.
+ (line 6)
* dvipdfmx: Configure options for texk/dvipdfm-x.
(line 6)
* dvisvgm: Configure options for texk/dvisvgm.
(line 6)
-* dvisvgm requirement for C++11: Prerequisites. (line 19)
+* engine, building one: Build one engine. (line 6)
* environment variables, for configure: Configure options. (line 16)
* exec_prefix: --enable-multiplatform.
(line 6)
* extending TeX Live: Extending TeX Live. (line 6)
* extern functions: Declarations and definitions.
- (line 43)
-* extra/ top-level directory: Top-level directories.
- (line 39)
+ (line 41)
* failure to build: Build problems. (line 6)
-* ffcall, required by xindy: Prerequisites. (line 35)
* flags, macros for library and header: Macros for library and header flags.
(line 6)
-* fontconfig library, required by xetex: Prerequisites. (line 31)
+* fontconfig library, required by xetex: Prerequisites. (line 32)
* FreeType: Prerequisites. (line 11)
* freetype cross compiling: Cross problems. (line 13)
* freetype library: freetype library. (line 6)
-* freetype-config: freetype library. (line 6)
+* freetype-config: freetype library. (line 13)
* freetype-config <1>: Variables for configure.
(line 24)
* FT2_CONFIG: Variables for configure.
(line 21)
+* gcc, default compilers: Build one package. (line 76)
* general setup macros: General setup macros. (line 6)
* generic library module, adding: Adding a new generic library module.
(line 6)
+* Ghostscript location for Xdvik: Configure options for texk/xdvik.
+ (line 6)
+* git-svn: Transfer from Subversion to Github.
+ (line 6)
* global configure options: Global configure options.
(line 6)
* gmake, required: Prerequisites. (line 11)
@@ -5281,7 +5321,7 @@
(line 22)
* infrastructure, tools needed for: Build system tools. (line 6)
* inst/ top-level directory: Top-level directories.
- (line 43)
+ (line 39)
* install-tl, TeX Live installer: Installing. (line 8)
* installation directories: Installation directories.
(line 6)
@@ -5292,8 +5332,8 @@
* iteration through sources, by configure and make: Build iteration.
(line 6)
* kpathsea library: kpathsea library. (line 6)
-* kpathsea.ac: kpathsea library. (line 20)
-* kpse-libpng-flags.m4: png library. (line 43)
+* kpathsea.ac: kpathsea library. (line 18)
+* kpse-libpng-flags.m4: png library. (line 46)
* kpse-pkgs.m4: Overview of build system.
(line 30)
* kpse-zlib-flags.m4: zlib library. (line 6)
@@ -5302,7 +5342,7 @@
* KPSEWHICH: Variables for configure.
(line 29)
* KPSE_ADD_FLAGS: Macros for library and header flags.
- (line 18)
+ (line 20)
* KPSE_ALL_SYSTEM_FLAGS: Adding a new generic library module.
(line 34)
* KPSE_BASIC: General setup macros. (line 8)
@@ -5316,7 +5356,7 @@
* KPSE_COND_MINGW32: Macros for Windows. (line 19)
* KPSE_COND_WIN32: Macros for Windows. (line 15)
* KPSE_COND_WIN32_WRAP: Macros for Windows. (line 24)
-* kpse_cv_cxx_hack: Macros for compilers. (line 34)
+* kpse_cv_cxx_hack: Macros for compilers. (line 33)
* kpse_cv_have_win32: Macros for Windows. (line 10)
* kpse_cv_visibility_c[xx]flags: Macros for compilers. (line 25)
* kpse_cv_warning_cflags: Macros for compilers. (line 15)
@@ -5326,7 +5366,7 @@
* KPSE_LARGEFILE: Macros for libraries. (line 8)
* KPSE_LIBPNG_FLAGS: Macros for library and header flags.
(line 10)
-* KPSE_LIBPNG_FLAGS <1>: png library. (line 43)
+* KPSE_LIBPNG_FLAGS <1>: png library. (line 46)
* kpse_libs_pkgs: Adding a new generic library module.
(line 6)
* KPSE_LIB_FLAGS: Macros for library and header flags.
@@ -5337,7 +5377,7 @@
(line 34)
* KPSE_PROG_LEX: Macros for programs. (line 21)
* KPSE_RESTORE_FLAGS: Macros for library and header flags.
- (line 22)
+ (line 24)
* kpse_texk_pkgs: Adding a new program module.
(line 6)
* kpse_texlibs_pkgs: Adding a new TeX-specific library module.
@@ -5361,6 +5401,10 @@
* layout of sources: Layout and infrastructure.
(line 6)
* LFS (large file support): --disable-largefile. (line 6)
+* libexpat, dependency of libfontconfig: Configure options for texk/web2c.
+ (line 50)
+* libfontconfig, hack for avoiding linking dependencies: Configure options for texk/web2c.
+ (line 50)
* libfreetype: Variables for configure.
(line 24)
* libfreetype, and const: Const. (line 21)
@@ -5372,6 +5416,7 @@
* library modules: Library modules. (line 6)
* library-specific configure options: Library-specific configure options.
(line 6)
+* libsigsegv, required by xindy: Prerequisites. (line 36)
* libstc++, statically linking: Macros for compilers. (line 29)
* Libtool: Overview of build system.
(line 6)
@@ -5396,19 +5441,22 @@
* macros, general setup: General setup macros. (line 6)
* MAKE: Variables for configure.
(line 33)
-* make -t: Build system tools. (line 39)
+* make -t: Build system tools. (line 43)
+* make rules, verbose vs. silent: --enable-silent-rules.
+ (line 6)
* mf-nowin: Configure options for texk/web2c.
(line 34)
* mingw32: Cross configuring. (line 27)
* MINGW32, Automake conditional: Macros for Windows. (line 20)
-* mktex.ac: kpathsea library. (line 20)
-* mktextfm: kpathsea library. (line 20)
+* mktex.ac: kpathsea library. (line 18)
+* mktextfm: kpathsea library. (line 18)
* modules, for libraries: Library modules. (line 6)
* modules, for programs: Program modules. (line 6)
* motif: Configure options for texk/xdvik.
(line 9)
* native cross compilation: Cross compilation. (line 10)
-* OBJCXX=OBJC-COMPILER: Build one package. (line 73)
+* OBJCXX=OBJC-COMPILER: Build one package. (line 76)
+* one engine, building: Build one engine. (line 6)
* one package, building: Build one package. (line 6)
* OpenGL, required for Asymptote: asymptote. (line 6)
* operating system distribution, building for: Distro builds. (line 6)
@@ -5417,12 +5465,12 @@
* parallel build: Build in parallel. (line 6)
* paths, for installation: Installation directories.
(line 6)
-* PDF files, size of: --disable-largefile. (line 10)
+* PDF files, size of: --disable-largefile. (line 11)
* PDFLATEX: Variables for configure.
(line 41)
* PERL: Variables for configure.
(line 39)
-* perl, required by web2c, etc.: Prerequisites. (line 23)
+* perl, required by web2c, etc.: Prerequisites. (line 24)
* PKG_CONFIG: Variables for configure.
(line 23)
* plain.tex, not in source tree: Installing. (line 8)
@@ -5429,7 +5477,7 @@
* png library: png library. (line 6)
* poppler: Configure options for system poppler.
(line 6)
-* PostScript files, size of: --disable-largefile. (line 10)
+* PostScript files, size of: --disable-largefile. (line 11)
* Preining, Norbert: Distro builds. (line 54)
* preloaded binaries: Configure options for texk/web2c.
(line 45)
@@ -5440,18 +5488,19 @@
* program modules: Program modules. (line 6)
* program-specific configure options: Program-specific configure options.
(line 6)
+* proxy build system: png library. (line 36)
* reautoconf: Build system tools. (line 28)
* requirements for building: Prerequisites. (line 6)
* runscript.exe: Macros for Windows. (line 25)
* scripts, linked and not maintained: Linked scripts. (line 6)
-* scrolling: Configure options for texk/xdvik.
+* scrolling, smooth: Configure options for texk/xdvik.
(line 13)
* SED: Variables for configure.
(line 34)
* setup macros, general: General setup macros. (line 6)
* shared libraries, using vs. avoiding: Distro builds. (line 11)
-* size of PDF and PS files: --disable-largefile. (line 10)
-* size of source tree: Build one package. (line 57)
+* size of PDF and PS files: --disable-largefile. (line 11)
+* size of source tree: Build one package. (line 60)
* source code declarations: Declarations and definitions.
(line 6)
* source directory building, not supported: Building. (line 17)
@@ -5460,11 +5509,11 @@
* squeeze: Cross problems. (line 13)
* squeeze/configure.ac: xdvik package. (line 14)
* static functions: Declarations and definitions.
- (line 37)
+ (line 35)
* static linking for C++: Macros for compilers. (line 29)
* stpcpy: Declarations and definitions.
(line 18)
-* Subversion repository: Build system tools. (line 34)
+* Subversion repository: Build system tools. (line 38)
* support files, separate from build: Installing. (line 8)
* symlinks, used for scripts: Linked scripts. (line 6)
* synctex: Configure options for texk/web2c.
@@ -5480,17 +5529,19 @@
(line 6)
* texlive.tlpdb, TeX Live database: Installing. (line 8)
* tie: Cross problems. (line 26)
-* timestamps, in repository: Build system tools. (line 34)
+* timestamps, in repository: Build system tools. (line 38)
* tools, for building: Build system tools. (line 6)
* top-level directories: Top-level directories.
(line 6)
-* touching files to avoid rerunning: Build system tools. (line 39)
+* touching files to avoid rerunning: Build system tools. (line 43)
* Travis-CI: Continuous integration.
(line 6)
-* type cast, avoiding: Const. (line 38)
-* use-commit-times, Subversion: Build system tools. (line 34)
+* travis.yml: CI testing on Travis-CI.
+ (line 6)
+* type cast from const, avoiding: Const. (line 38)
+* use-commit-times, Subversion: Build system tools. (line 38)
* variable declarations, in source code: Declarations and definitions.
- (line 54)
+ (line 52)
* variables for configure: Variables for configure.
(line 6)
* warning, discards qualifiers: Const. (line 30)
@@ -5498,7 +5549,7 @@
* web2c program: Cross problems. (line 13)
* web2c.ac: Configure options for texk/web2c.
(line 37)
-* wget: Linked scripts. (line 22)
+* wget: Linked scripts. (line 23)
* WIN32, Automake conditional: Macros for Windows. (line 16)
* WIN32_WRAP, Automake conditional: Macros for Windows. (line 25)
* Windows, invoking scripts on: Linked scripts. (line 6)
@@ -5506,12 +5557,13 @@
* withenable.ac, for new modules: Adding a new program module.
(line 14)
* Work/ top-level directory: Top-level directories.
- (line 43)
+ (line 39)
* wrapper binary for scripts on Windows: Linked scripts. (line 6)
+* wrapper build system: freetype library. (line 6)
* X toolkit: Configure options for texk/web2c.
(line 22)
+* X11 development, required by X clients: Prerequisites. (line 28)
* X11 headers, and const: Const. (line 21)
-* X11, required by X clients: Prerequisites. (line 27)
* xasy: asymptote. (line 6)
* xaw: Configure options for texk/xdvik.
(line 9)
@@ -5520,11 +5572,11 @@
(line 6)
* xdvipdfmx: Configure options for texk/dvipdfm-x.
(line 6)
-* xindy: Linked scripts. (line 22)
+* xindy: Linked scripts. (line 23)
* xindy <1>: xindy package. (line 6)
* xindy <2>: Configure options for utils/xindy.
(line 6)
-* xindy cross compiling impossible: Cross problems. (line 33)
+* xindy cross compiling requires clisp: Cross problems. (line 33)
* XInput: Configure options for texk/xdvik.
(line 13)
* Xlib: Configure options for texk/web2c.
@@ -5531,7 +5583,7 @@
(line 22)
* xpdf as library: Configure options for system poppler.
(line 6)
-* xz: Linked scripts. (line 22)
+* xz: Linked scripts. (line 23)
* zlib library: zlib library. (line 6)
@@ -5539,368 +5591,369 @@
Tag Table:
Node: Top1208
Node: Introduction2118
-Node: Overview of build system3838
-Node: Prerequisites5881
-Node: Building8279
-Node: Build iteration9584
-Node: Build problems10656
-Node: Build in parallel11059
-Node: Build distribution11651
-Node: Build one package12222
-Node: Cross compilation15600
-Node: Cross configuring16881
-Node: Cross problems18558
-Node: Installing20209
-Node: Installation directories21224
-Node: Linked scripts23040
-Node: Distro builds24521
-Node: Layout and infrastructure26911
-Node: Build system tools27739
-Node: Top-level directories29750
-Node: Autoconf macros32164
-Node: General setup macros32865
-Node: Macros for programs33732
-Node: Macros for compilers34544
-Node: Macros for libraries35978
-Node: Macros for library and header flags36404
-Node: Macros for Windows38284
-Node: Library modules39861
-Node: png library40350
-Node: zlib library42624
-Node: freetype library43139
-Node: kpathsea library43667
-Node: Program modules45066
-Node: t1utils package45494
-Node: xindy package46045
-Node: xdvik package47195
-Node: asymptote48268
-Node: Extending TeX Live48719
-Node: Adding a new program module49496
-Node: Adding a new generic library module52791
-Node: Adding a new TeX-specific library module55004
-Node: Configure options55691
-Node: Global configure options57074
-Node: --disable-native-texlive-build57616
-Node: --prefix --bindir ...58606
-Node: --disable-largefile59146
-Node: --disable-missing59831
-Node: --enable-compiler-warnings=LEVEL60232
-Node: --enable-cxx-runtime-hack60971
-Node: --enable-maintainer-mode61398
-Node: --enable-multiplatform61927
-Node: --enable-shared62465
-Node: --enable-silent-rules62836
-Node: --without-ln-s63292
-Node: --without-x63643
-Node: Program-specific configure options63831
-Node: --enable-PROG --disable-PROG64474
-Node: --disable-all-pkgs64751
-Node: Configure options for texk/web2c65737
-Node: Configure options for texk/bibtex-x68255
-Node: Configure options for texk/dvipdfm-x68798
-Node: Configure options for texk/dvisvgm69571
-Node: Configure options for texk/texlive70457
-Node: Configure options for texk/xdvik70878
-Node: Configure options for utils/xindy71482
-Node: Library-specific configure options72383
-Node: Configure options for kpathsea73394
-Node: Configure options for system poppler74103
-Node: Variables for configure74894
-Node: Coding conventions76322
-Node: Declarations and definitions77061
-Node: Const79243
-Node: Continuous integration81106
-Node: Transfer from Subversion to Github81760
-Node: Automatic update of the Git mirror83942
-Node: CI testing on Travis-CI84530
-Node: install-tl85210
-Node: install-tl NAME85579
-Node: install-tl SYNOPSIS85737
-Node: install-tl DESCRIPTION85995
-Node: install-tl REFERENCES87062
-Node: install-tl OPTIONS87588
-Ref: install-tl *-gui* [[=]_module_]87929
-Ref: install-tl text88139
-Ref: install-tl wizard88262
-Ref: install-tl perltk88416
-Ref: install-tl *-no-gui*88847
-Ref: install-tl *-lang* _llcode_88928
-Ref: install-tl *-repository* _url|path_89615
-Ref: install-tl *-select-repository*91495
-Ref: install-tl *-all-options*91931
-Ref: install-tl *-custom-bin* _path_92186
-Ref: install-tl *-debug-translation*93017
-Ref: install-tl *-force-platform* _platform_93236
-Ref: install-tl *-help*, *--help*, *-?*93480
-Ref: install-tl *-in-place*93887
-Ref: install-tl *-init-from-profile* _profile_file_94432
-Ref: install-tl *-logfile* _file_94652
-Ref: install-tl *-no-cls*95003
-Ref: install-tl *-non-admin*95137
-Ref: install-tl *-persistent-downloads*95242
-Ref: install-tl *-no-persistent-downloads*95270
-Ref: install-tl *-no-verify-downloads*95888
-Ref: install-tl *-portable*96249
-Ref: install-tl *-print-platform*96388
-Ref: install-tl *-profile* _profile_file_96586
-Ref: install-tl *-q*96766
-Ref: install-tl *-scheme* _scheme_96828
-Ref: install-tl *-v*97302
-Ref: install-tl *-version*, *--version*97457
-Node: install-tl PROFILES97588
-Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)100238
-Ref: install-tl instopt_adjustrepo (default 1)100314
-Ref: install-tl instopt_letter (default 0)100451
-Ref: install-tl instopt_portable (default 0)100542
-Ref: install-tl instopt_write18_restricted (default 1)100638
-Node: install-tl ENVIRONMENT VARIABLES101957
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK102348
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE102550
-Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME102660
-Ref: install-tl TEXLIVE_INSTALL_PREFIX102781
-Ref: install-tl TEXLIVE_INSTALL_TEXDIR102807
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG102838
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR102866
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME102895
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL102925
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG102959
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR102990
-Ref: install-tl NOPERLDOC103361
-Node: install-tl AUTHORS AND COPYRIGHT103425
-Node: tlmgr103841
-Node: tlmgr NAME104294
-Node: tlmgr SYNOPSIS104426
-Node: tlmgr DESCRIPTION104616
-Node: tlmgr EXAMPLES105712
-Ref: tlmgr tlmgr option repository ctan105963
-Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet106035
-Ref: tlmgr tlmgr update --list106487
-Ref: tlmgr tlmgr update --all106580
-Ref: tlmgr tlmgr info _what_106737
-Node: tlmgr OPTIONS106999
-Ref: tlmgr *--repository* _url|path_107519
-Ref: tlmgr *--gui* [_action_]108244
-Ref: tlmgr *--gui-lang* _llcode_108651
-Ref: tlmgr *--debug-translation*109334
-Ref: tlmgr *--machine-readable*109537
-Ref: tlmgr *--no-execute-actions*109805
-Ref: tlmgr *--package-logfile* _file_109998
-Ref: tlmgr *--pause*110252
-Ref: tlmgr *--persistent-downloads*110407
-Ref: tlmgr *--no-persistent-downloads*110435
-Ref: tlmgr *--pin-file*110929
-Ref: tlmgr *--usermode*111147
-Ref: tlmgr *--usertree* _dir_111267
-Ref: tlmgr *--verify-repo=[none|main|all]*111393
-Node: tlmgr ACTIONS112292
-Node: tlmgr help113144
-Node: tlmgr version113620
-Node: tlmgr backup113883
-Ref: tlmgr *backup [_option_...] --all*114054
-Ref: tlmgr *backup [_option_...] _pkg_...*114087
-Ref: tlmgr *--backupdir* _directory_114942
-Ref: tlmgr *--all*115159
-Ref: tlmgr *--clean*[=_N_]115411
-Ref: tlmgr *--dry-run*115738
-Node: tlmgr candidates _pkg_115868
-Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]116214
-Ref: tlmgr *files*116587
-Ref: tlmgr *depends*116722
-Ref: tlmgr *executes*117064
-Ref: tlmgr *runfiles*117182
-Ref: tlmgr *--use-svn*117303
-Node: tlmgr conf117420
-Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*117699
-Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*117763
-Node: tlmgr dump-tlpdb [_option_...] [--json]120108
-Ref: tlmgr *--local*120541
-Ref: tlmgr *--remote*120580
-Ref: tlmgr *--json*120618
-Node: tlmgr generate121189
-Ref: tlmgr *generate [_option_...] language*121385
-Ref: tlmgr *generate [_option_...] language.dat*121424
-Ref: tlmgr *generate [_option_...] language.def*121463
-Ref: tlmgr *generate [_option_...] language.dat.lua*121506
-Ref: tlmgr *--dest* _output_file_123832
-Ref: tlmgr *--localcfg* _local_conf_file_124408
-Ref: tlmgr *--rebuild-sys*124531
-Node: tlmgr gui125346
-Node: tlmgr info125524
-Ref: tlmgr *info [_option_...] _pkg_...*125686
-Ref: tlmgr *info [_option_...] collections*125720
-Ref: tlmgr *info [_option_...] schemes*125750
-Ref: tlmgr *--list*127280
-Ref: tlmgr *--only-installed*127594
-Ref: tlmgr *--data item1,item2,...*127793
-Ref: tlmgr *--json* 1128374
-Node: tlmgr init-usertree128757
-Node: tlmgr install [_option_...] _pkg_...129138
-Ref: tlmgr *--dry-run* 1129648
-Ref: tlmgr *--file*129765
-Ref: tlmgr *--force*129987
-Ref: tlmgr *--no-depends*130207
-Ref: tlmgr *--no-depends-at-all*130366
-Ref: tlmgr *--reinstall*130766
-Ref: tlmgr *--with-doc*131144
-Ref: tlmgr *--with-src*131157
-Node: tlmgr key131679
-Ref: tlmgr *key list*131837
-Ref: tlmgr *key add _file_*131855
-Ref: tlmgr *key remove _keyid_*131877
-Node: tlmgr list132472
-Node: tlmgr option132634
-Ref: tlmgr *option [--json] [show]*132789
-Ref: tlmgr *option [--json] showall*132815
-Ref: tlmgr *option _key_ [_value_]*132841
-Node: tlmgr paper137238
-Ref: tlmgr *paper [a4|letter]*137387
-Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*137461
-Ref: tlmgr *paper --json*137476
-Node: tlmgr path138691
-Ref: tlmgr *path [--w32mode=user|admin] add*138852
-Ref: tlmgr *path [--w32mode=user|admin] remove*138889
-Node: tlmgr pinning140229
-Ref: tlmgr pinning show140470
-Ref: tlmgr pinning add _repo_ _pkgglob_...140543
-Ref: tlmgr pinning remove _repo_ _pkgglob_...140662
-Ref: tlmgr pinning remove _repo_ --all140815
-Node: tlmgr platform140869
-Ref: tlmgr *platform list|add|remove _platform_...*141055
-Ref: tlmgr *platform set _platform_*141082
-Ref: tlmgr *platform set auto*141103
-Ref: tlmgr *--dry-run* 2141989
-Node: tlmgr postaction142108
-Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*142338
-Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*142412
-Ref: tlmgr *--w32mode=[user|admin]*142727
-Ref: tlmgr *--fileassocmode=[1|2]*143143
-Ref: tlmgr *--all* 1143428
-Node: tlmgr print-platform143483
-Node: tlmgr print-platform-info143814
-Node: tlmgr remove [_option_...] _pkg_...144114
-Ref: tlmgr *--all* 2144598
-Ref: tlmgr *--backup*144708
-Ref: tlmgr *--backupdir* _directory_ 1144734
-Ref: tlmgr *--no-depends* 1145139
-Ref: tlmgr *--no-depends-at-all* 1145201
-Ref: tlmgr *--force* 1145304
-Ref: tlmgr *--dry-run* 3145777
-Node: tlmgr repository145884
-Ref: tlmgr *repository list*146072
-Ref: tlmgr *repository list _path|tag_*146102
-Ref: tlmgr *repository add _path_ [_tag_]*146135
-Ref: tlmgr *repository remove _path|tag_*146167
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*146221
-Node: tlmgr restore147274
-Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*147453
-Ref: tlmgr *restore [_option_...] --all*147483
-Ref: tlmgr *--all* 3148183
-Ref: tlmgr *--backupdir* _directory_ 2148397
-Ref: tlmgr *--dry-run* 4148578
-Ref: tlmgr *--force* 2148710
-Ref: tlmgr *--json* 2148756
-Node: tlmgr search149083
-Ref: tlmgr *search [_option_...] _what_*149247
-Ref: tlmgr *search [_option_...] --file _what_*149284
-Ref: tlmgr *search [_option_...] --all _what_*149320
-Ref: tlmgr *--file* 1149540
-Ref: tlmgr *--all* 4149602
-Ref: tlmgr *--global*149691
-Ref: tlmgr *--word*149818
-Node: tlmgr shell150133
-Ref: tlmgr protocol150868
-Ref: tlmgr help 1150932
-Ref: tlmgr version 1150985
-Ref: tlmgr quit, end, bye, byebye, EOF151053
-Ref: tlmgr restart151074
-Ref: tlmgr load [local|remote]151197
-Ref: tlmgr save151267
-Ref: tlmgr get [_var_] =item set [_var_ [_val_]]151390
-Node: tlmgr show151991
-Node: tlmgr uninstall152158
-Node: tlmgr update [_option_...] [_pkg_...]152388
-Ref: tlmgr *--all* 5152759
-Ref: tlmgr *--self*154500
-Ref: tlmgr *--dry-run* 5155264
-Ref: tlmgr *--list* [_pkg_]155441
-Ref: tlmgr *--exclude* _pkg_156130
-Ref: tlmgr *--no-auto-remove* [_pkg_...]156930
-Ref: tlmgr *--no-auto-install* [_pkg_...]157381
-Ref: tlmgr *--reinstall-forcibly-removed*158037
-Ref: tlmgr *--backup* 1158572
-Ref: tlmgr *--backupdir* _directory_ 3158598
-Ref: tlmgr *--no-depends* 2159764
-Ref: tlmgr *--no-depends-at-all* 2159967
-Ref: tlmgr *--force* 3160070
-Node: tlmgr CONFIGURATION FILE FOR TLMGR160885
-Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.161898
-Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.162035
-Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.162117
-Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).162171
-Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.162251
-Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.162331
-Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.162479
-Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.162555
-Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).162824
-Node: tlmgr CRYPTOGRAPHIC VERIFICATION163910
-Node: tlmgr Configuration of GnuPG invocation166059
-Node: tlmgr USER MODE166697
-Node: tlmgr User mode install169543
-Node: tlmgr User mode backup, restore, remove, update170687
-Node: tlmgr User mode generate, option, paper171129
-Node: tlmgr MULTIPLE REPOSITORIES171505
-Node: tlmgr Pinning173234
-Node: tlmgr GUI FOR TLMGR175209
-Node: tlmgr Main display176549
-Node: tlmgr Display configuration area176801
-Ref: tlmgr Status177162
-Ref: tlmgr Category177326
-Ref: tlmgr Match177512
-Ref: tlmgr Selection177693
-Ref: tlmgr Display configuration buttons177897
-Node: tlmgr Package list area178080
-Ref: tlmgr a checkbox178664
-Ref: tlmgr package name178800
-Ref: tlmgr local revision (and version)178899
-Ref: tlmgr remote revision (and version)179274
-Ref: tlmgr short description179571
-Node: tlmgr Main display action buttons179616
-Ref: tlmgr Update all installed179882
-Ref: tlmgr Update180254
-Ref: tlmgr Install180304
-Ref: tlmgr Remove180490
-Ref: tlmgr Backup180668
-Node: tlmgr Menu bar180825
-Ref: tlmgr tlmgr menu181048
-Ref: tlmgr Options menu181356
-Ref: tlmgr Actions menu182439
-Ref: tlmgr Help menu182867
-Node: tlmgr GUI options183000
-Ref: tlmgr -background _color_183246
-Ref: tlmgr -font " _fontname_ _fontsize_ "183311
-Ref: tlmgr -foreground _color_183469
-Ref: tlmgr -geometry _geomspec_183521
-Ref: tlmgr -xrm _xresource_183713
-Node: tlmgr MACHINE-READABLE OUTPUT183981
-Node: tlmgr Machine-readable update and install output184791
-Ref: tlmgr location-url _location_186067
-Ref: tlmgr total-bytes _count_186283
-Ref: tlmgr _pkgname_186693
-Ref: tlmgr _status_186903
-Ref: tlmgr d186981
-Ref: tlmgr f187041
-Ref: tlmgr u187220
-Ref: tlmgr r187266
-Ref: tlmgr a187389
-Ref: tlmgr i187567
-Ref: tlmgr I187686
-Ref: tlmgr _localrev_187788
-Ref: tlmgr _serverrev_187895
-Ref: tlmgr _size_188007
-Ref: tlmgr _runtime_188176
-Ref: tlmgr _esttot_188246
-Node: tlmgr Machine-readable option output188279
-Node: tlmgr AUTHORS AND COPYRIGHT188791
-Node: Index189190
+Node: Overview of build system3946
+Node: Prerequisites5997
+Node: Building8616
+Node: Build iteration10002
+Node: Build problems11043
+Node: Build in parallel11497
+Node: Build distribution12101
+Node: Build one package12749
+Node: Build one engine16384
+Node: Cross compilation17399
+Node: Cross configuring18679
+Node: Cross problems20356
+Node: Installing22018
+Node: Installation directories23038
+Node: Linked scripts24856
+Node: Distro builds26347
+Node: Layout and infrastructure28723
+Node: Build system tools29554
+Node: Top-level directories31800
+Node: Autoconf macros34036
+Node: General setup macros34798
+Node: Macros for programs35673
+Node: Macros for compilers36474
+Node: Macros for libraries37882
+Node: Macros for library and header flags38308
+Node: Macros for Windows40219
+Node: Library modules41806
+Node: png library42295
+Node: zlib library44643
+Node: freetype library45158
+Node: kpathsea library45854
+Node: Program modules47233
+Node: t1utils package47661
+Node: xindy package48206
+Node: xdvik package49320
+Node: asymptote50379
+Node: Extending TeX Live50875
+Node: Adding a new program module51658
+Node: Adding a new generic library module54997
+Node: Adding a new TeX-specific library module57226
+Node: Configure options57924
+Node: Global configure options59305
+Node: --disable-native-texlive-build59847
+Node: --prefix --bindir ...60809
+Node: --disable-largefile61349
+Node: --disable-missing62050
+Node: --enable-compiler-warnings=LEVEL62451
+Node: --enable-cxx-runtime-hack63107
+Node: --enable-maintainer-mode63527
+Node: --enable-multiplatform64056
+Node: --enable-shared64629
+Node: --enable-silent-rules65000
+Node: --without-ln-s65452
+Node: --without-x65799
+Node: Program-specific configure options65987
+Node: --enable-PROG --disable-PROG66630
+Node: --disable-all-pkgs66903
+Node: Configure options for texk/web2c67686
+Node: Configure options for texk/bibtex-x70224
+Node: Configure options for texk/dvipdfm-x70767
+Node: Configure options for texk/dvisvgm71543
+Node: Configure options for texk/texlive72424
+Node: Configure options for texk/xdvik72845
+Node: Configure options for utils/xindy73466
+Node: Library-specific configure options74356
+Node: Configure options for kpathsea75358
+Node: Configure options for system poppler76107
+Node: Variables for configure76871
+Node: Coding conventions78297
+Node: Declarations and definitions79012
+Node: Const81186
+Node: Continuous integration83050
+Node: Transfer from Subversion to Github83691
+Node: Automatic update of the Git mirror85853
+Node: CI testing on Travis-CI86435
+Node: install-tl87117
+Node: install-tl NAME87486
+Node: install-tl SYNOPSIS87644
+Node: install-tl DESCRIPTION87902
+Node: install-tl REFERENCES88969
+Node: install-tl OPTIONS89495
+Ref: install-tl *-gui* [[=]_module_]89836
+Ref: install-tl text90046
+Ref: install-tl wizard90169
+Ref: install-tl perltk90323
+Ref: install-tl *-no-gui*90754
+Ref: install-tl *-lang* _llcode_90835
+Ref: install-tl *-repository* _url|path_91522
+Ref: install-tl *-select-repository*93402
+Ref: install-tl *-all-options*93838
+Ref: install-tl *-custom-bin* _path_94093
+Ref: install-tl *-debug-translation*94925
+Ref: install-tl *-force-platform* _platform_95144
+Ref: install-tl *-help*, *--help*, *-?*95388
+Ref: install-tl *-in-place*95795
+Ref: install-tl *-init-from-profile* _profile_file_96340
+Ref: install-tl *-logfile* _file_96560
+Ref: install-tl *-no-cls*96911
+Ref: install-tl *-non-admin*97045
+Ref: install-tl *-persistent-downloads*97150
+Ref: install-tl *-no-persistent-downloads*97178
+Ref: install-tl *-no-verify-downloads*97796
+Ref: install-tl *-portable*98157
+Ref: install-tl *-print-platform*98296
+Ref: install-tl *-profile* _profile_file_98494
+Ref: install-tl *-q*98674
+Ref: install-tl *-scheme* _scheme_98736
+Ref: install-tl *-v*99210
+Ref: install-tl *-version*, *--version*99365
+Node: install-tl PROFILES99496
+Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102146
+Ref: install-tl instopt_adjustrepo (default 1)102222
+Ref: install-tl instopt_letter (default 0)102359
+Ref: install-tl instopt_portable (default 0)102450
+Ref: install-tl instopt_write18_restricted (default 1)102546
+Node: install-tl ENVIRONMENT VARIABLES103865
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104256
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104458
+Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME104568
+Ref: install-tl TEXLIVE_INSTALL_PREFIX104689
+Ref: install-tl TEXLIVE_INSTALL_TEXDIR104715
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG104746
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR104774
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME104803
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL104833
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG104867
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR104898
+Ref: install-tl NOPERLDOC105269
+Node: install-tl AUTHORS AND COPYRIGHT105333
+Node: tlmgr105749
+Node: tlmgr NAME106202
+Node: tlmgr SYNOPSIS106334
+Node: tlmgr DESCRIPTION106524
+Node: tlmgr EXAMPLES107620
+Ref: tlmgr tlmgr option repository ctan107871
+Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet107943
+Ref: tlmgr tlmgr update --list108395
+Ref: tlmgr tlmgr update --all108488
+Ref: tlmgr tlmgr info _what_108645
+Node: tlmgr OPTIONS108907
+Ref: tlmgr *--repository* _url|path_109427
+Ref: tlmgr *--gui* [_action_]110152
+Ref: tlmgr *--gui-lang* _llcode_110559
+Ref: tlmgr *--debug-translation*111242
+Ref: tlmgr *--machine-readable*111445
+Ref: tlmgr *--no-execute-actions*111713
+Ref: tlmgr *--package-logfile* _file_111906
+Ref: tlmgr *--pause*112160
+Ref: tlmgr *--persistent-downloads*112315
+Ref: tlmgr *--no-persistent-downloads*112343
+Ref: tlmgr *--pin-file*112837
+Ref: tlmgr *--usermode*113055
+Ref: tlmgr *--usertree* _dir_113175
+Ref: tlmgr *--verify-repo=[none|main|all]*113301
+Node: tlmgr ACTIONS114200
+Node: tlmgr help115052
+Node: tlmgr version115528
+Node: tlmgr backup115791
+Ref: tlmgr *backup [_option_...] --all*115962
+Ref: tlmgr *backup [_option_...] _pkg_...*115995
+Ref: tlmgr *--backupdir* _directory_116850
+Ref: tlmgr *--all*117067
+Ref: tlmgr *--clean*[=_N_]117319
+Ref: tlmgr *--dry-run*117646
+Node: tlmgr candidates _pkg_117776
+Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]118122
+Ref: tlmgr *files*118495
+Ref: tlmgr *depends*118630
+Ref: tlmgr *executes*118972
+Ref: tlmgr *runfiles*119090
+Ref: tlmgr *--use-svn*119211
+Node: tlmgr conf119328
+Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*119607
+Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*119671
+Node: tlmgr dump-tlpdb [_option_...] [--json]122016
+Ref: tlmgr *--local*122449
+Ref: tlmgr *--remote*122488
+Ref: tlmgr *--json*122526
+Node: tlmgr generate123097
+Ref: tlmgr *generate [_option_...] language*123293
+Ref: tlmgr *generate [_option_...] language.dat*123332
+Ref: tlmgr *generate [_option_...] language.def*123371
+Ref: tlmgr *generate [_option_...] language.dat.lua*123414
+Ref: tlmgr *--dest* _output_file_125740
+Ref: tlmgr *--localcfg* _local_conf_file_126316
+Ref: tlmgr *--rebuild-sys*126439
+Node: tlmgr gui127254
+Node: tlmgr info127432
+Ref: tlmgr *info [_option_...] _pkg_...*127594
+Ref: tlmgr *info [_option_...] collections*127628
+Ref: tlmgr *info [_option_...] schemes*127658
+Ref: tlmgr *--list*129188
+Ref: tlmgr *--only-installed*129502
+Ref: tlmgr *--data item1,item2,...*129701
+Ref: tlmgr *--json* 1130282
+Node: tlmgr init-usertree130665
+Node: tlmgr install [_option_...] _pkg_...131046
+Ref: tlmgr *--dry-run* 1131556
+Ref: tlmgr *--file*131673
+Ref: tlmgr *--force*131895
+Ref: tlmgr *--no-depends*132115
+Ref: tlmgr *--no-depends-at-all*132274
+Ref: tlmgr *--reinstall*132674
+Ref: tlmgr *--with-doc*133052
+Ref: tlmgr *--with-src*133065
+Node: tlmgr key133587
+Ref: tlmgr *key list*133745
+Ref: tlmgr *key add _file_*133763
+Ref: tlmgr *key remove _keyid_*133785
+Node: tlmgr list134380
+Node: tlmgr option134542
+Ref: tlmgr *option [--json] [show]*134697
+Ref: tlmgr *option [--json] showall*134723
+Ref: tlmgr *option _key_ [_value_]*134749
+Node: tlmgr paper139146
+Ref: tlmgr *paper [a4|letter]*139295
+Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*139369
+Ref: tlmgr *paper --json*139384
+Node: tlmgr path140599
+Ref: tlmgr *path [--w32mode=user|admin] add*140760
+Ref: tlmgr *path [--w32mode=user|admin] remove*140797
+Node: tlmgr pinning142137
+Ref: tlmgr pinning show142378
+Ref: tlmgr pinning add _repo_ _pkgglob_...142451
+Ref: tlmgr pinning remove _repo_ _pkgglob_...142570
+Ref: tlmgr pinning remove _repo_ --all142723
+Node: tlmgr platform142777
+Ref: tlmgr *platform list|add|remove _platform_...*142963
+Ref: tlmgr *platform set _platform_*142990
+Ref: tlmgr *platform set auto*143011
+Ref: tlmgr *--dry-run* 2143897
+Node: tlmgr postaction144016
+Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*144246
+Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*144320
+Ref: tlmgr *--w32mode=[user|admin]*144635
+Ref: tlmgr *--fileassocmode=[1|2]*145051
+Ref: tlmgr *--all* 1145336
+Node: tlmgr print-platform145391
+Node: tlmgr print-platform-info145722
+Node: tlmgr remove [_option_...] _pkg_...146022
+Ref: tlmgr *--all* 2146506
+Ref: tlmgr *--backup*146616
+Ref: tlmgr *--backupdir* _directory_ 1146642
+Ref: tlmgr *--no-depends* 1147047
+Ref: tlmgr *--no-depends-at-all* 1147109
+Ref: tlmgr *--force* 1147212
+Ref: tlmgr *--dry-run* 3147685
+Node: tlmgr repository147792
+Ref: tlmgr *repository list*147980
+Ref: tlmgr *repository list _path|tag_*148010
+Ref: tlmgr *repository add _path_ [_tag_]*148043
+Ref: tlmgr *repository remove _path|tag_*148075
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*148129
+Node: tlmgr restore149182
+Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*149361
+Ref: tlmgr *restore [_option_...] --all*149391
+Ref: tlmgr *--all* 3150091
+Ref: tlmgr *--backupdir* _directory_ 2150305
+Ref: tlmgr *--dry-run* 4150486
+Ref: tlmgr *--force* 2150618
+Ref: tlmgr *--json* 2150664
+Node: tlmgr search150991
+Ref: tlmgr *search [_option_...] _what_*151155
+Ref: tlmgr *search [_option_...] --file _what_*151192
+Ref: tlmgr *search [_option_...] --all _what_*151228
+Ref: tlmgr *--file* 1151448
+Ref: tlmgr *--all* 4151510
+Ref: tlmgr *--global*151599
+Ref: tlmgr *--word*151726
+Node: tlmgr shell152041
+Ref: tlmgr protocol152776
+Ref: tlmgr help 1152840
+Ref: tlmgr version 1152893
+Ref: tlmgr quit, end, bye, byebye, EOF152961
+Ref: tlmgr restart152982
+Ref: tlmgr load [local|remote]153105
+Ref: tlmgr save153175
+Ref: tlmgr get [_var_] =item set [_var_ [_val_]]153298
+Node: tlmgr show153899
+Node: tlmgr uninstall154066
+Node: tlmgr update [_option_...] [_pkg_...]154296
+Ref: tlmgr *--all* 5154667
+Ref: tlmgr *--self*156408
+Ref: tlmgr *--dry-run* 5157172
+Ref: tlmgr *--list* [_pkg_]157349
+Ref: tlmgr *--exclude* _pkg_158038
+Ref: tlmgr *--no-auto-remove* [_pkg_...]158838
+Ref: tlmgr *--no-auto-install* [_pkg_...]159289
+Ref: tlmgr *--reinstall-forcibly-removed*159945
+Ref: tlmgr *--backup* 1160480
+Ref: tlmgr *--backupdir* _directory_ 3160506
+Ref: tlmgr *--no-depends* 2161672
+Ref: tlmgr *--no-depends-at-all* 2161875
+Ref: tlmgr *--force* 3161978
+Node: tlmgr CONFIGURATION FILE FOR TLMGR162793
+Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.163806
+Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.163943
+Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.164025
+Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).164079
+Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.164159
+Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.164239
+Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.164387
+Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.164463
+Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).164732
+Node: tlmgr CRYPTOGRAPHIC VERIFICATION165818
+Node: tlmgr Configuration of GnuPG invocation167967
+Node: tlmgr USER MODE168605
+Node: tlmgr User mode install171451
+Node: tlmgr User mode backup, restore, remove, update172595
+Node: tlmgr User mode generate, option, paper173037
+Node: tlmgr MULTIPLE REPOSITORIES173413
+Node: tlmgr Pinning175142
+Node: tlmgr GUI FOR TLMGR177117
+Node: tlmgr Main display178457
+Node: tlmgr Display configuration area178709
+Ref: tlmgr Status179070
+Ref: tlmgr Category179234
+Ref: tlmgr Match179420
+Ref: tlmgr Selection179601
+Ref: tlmgr Display configuration buttons179805
+Node: tlmgr Package list area179988
+Ref: tlmgr a checkbox180572
+Ref: tlmgr package name180708
+Ref: tlmgr local revision (and version)180807
+Ref: tlmgr remote revision (and version)181182
+Ref: tlmgr short description181479
+Node: tlmgr Main display action buttons181524
+Ref: tlmgr Update all installed181790
+Ref: tlmgr Update182162
+Ref: tlmgr Install182212
+Ref: tlmgr Remove182398
+Ref: tlmgr Backup182576
+Node: tlmgr Menu bar182733
+Ref: tlmgr tlmgr menu182956
+Ref: tlmgr Options menu183264
+Ref: tlmgr Actions menu184347
+Ref: tlmgr Help menu184775
+Node: tlmgr GUI options184908
+Ref: tlmgr -background _color_185154
+Ref: tlmgr -font " _fontname_ _fontsize_ "185219
+Ref: tlmgr -foreground _color_185377
+Ref: tlmgr -geometry _geomspec_185429
+Ref: tlmgr -xrm _xresource_185621
+Node: tlmgr MACHINE-READABLE OUTPUT185889
+Node: tlmgr Machine-readable update and install output186699
+Ref: tlmgr location-url _location_187975
+Ref: tlmgr total-bytes _count_188191
+Ref: tlmgr _pkgname_188601
+Ref: tlmgr _status_188811
+Ref: tlmgr d188889
+Ref: tlmgr f188949
+Ref: tlmgr u189128
+Ref: tlmgr r189174
+Ref: tlmgr a189297
+Ref: tlmgr i189475
+Ref: tlmgr I189594
+Ref: tlmgr _localrev_189696
+Ref: tlmgr _serverrev_189803
+Ref: tlmgr _size_189915
+Ref: tlmgr _runtime_190084
+Ref: tlmgr _esttot_190154
+Node: tlmgr Machine-readable option output190187
+Node: tlmgr AUTHORS AND COPYRIGHT190699
+Node: Index191098
End Tag Table
Modified: trunk/Master/texmf-dist/doc/info/web2c.info
===================================================================
--- trunk/Master/texmf-dist/doc/info/web2c.info 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/info/web2c.info 2019-02-28 19:14:13 UTC (rev 50170)
@@ -58,7 +58,7 @@
This document describes how to install and use the programs in the Web2c
implementation of the TeX system, especially for Unix systems. It
-corresponds to Web2c version 2018, released in February 2018.
+corresponds to Web2c version 2019, released in February 2019.
* Menu:
@@ -82,8 +82,8 @@
1 Introduction
**************
-This manual corresponds to version 2018 of Web2c, released in February
-2018.
+This manual corresponds to version 2019 of Web2c, released in February
+2019.
"Web2c" is the name of a TeX implementation, originally for Unix, but
now also running under DOS, Amiga, and other operating systems. By "TeX
Modified: trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html
===================================================================
--- trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/kpathsea/kpathsea.html 2019-02-28 19:14:13 UTC (rev 50170)
@@ -2,7 +2,7 @@
<html>
<!-- This file documents the Kpathsea library for path searching.
-Copyright (C) 1996-2018 Karl Berry & Olaf Weber.
+Copyright (C) 1996-2019 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,7 +18,7 @@
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.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.6, 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>
@@ -36,23 +36,14 @@
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
-blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
-blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
-div.smalldisplay {margin-left: 3.2em}
-div.smallexample {margin-left: 3.2em}
-div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
-pre.smalldisplay {font-family: inherit; font-size: smaller}
-pre.smallexample {font-size: smaller}
-pre.smallformat {font-family: inherit; font-size: smaller}
-pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
@@ -74,169 +65,165 @@
-<a name="SEC_Contents"></a>
+<span id="SEC_Contents"></span>
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="no-bullet">
- <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a>
+ <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a>
<ul class="no-bullet">
- <li><a name="toc-History-1" href="#History">1.1 History</a></li>
+ <li><a id="toc-History-1" href="#History">1.1 History</a></li>
</ul></li>
- <li><a name="toc-unixtex_002eftp_003a-Obtaining-TeX" href="#unixtex_002eftp">2 <samp>unixtex.ftp</samp>: Obtaining TeX</a></li>
- <li><a name="toc-Security-1" href="#Security">3 Security</a></li>
- <li><a name="toc-TeX-directory-structure-1" href="#TeX-directory-structure">4 TeX directory structure</a></li>
- <li><a name="toc-Path-searching-1" href="#Path-searching">5 Path searching</a>
+ <li><a id="toc-unixtex_002eftp_003a-Obtaining-TeX" href="#unixtex_002eftp">2 <samp>unixtex.ftp</samp>: Obtaining TeX</a></li>
+ <li><a id="toc-Security-1" href="#Security">3 Security</a></li>
+ <li><a id="toc-TeX-directory-structure-1" href="#TeX-directory-structure">4 TeX directory structure</a></li>
+ <li><a id="toc-Path-searching-1" href="#Path-searching">5 Path searching</a>
<ul class="no-bullet">
- <li><a name="toc-Searching-overview-1" href="#Searching-overview">5.1 Searching overview</a></li>
- <li><a name="toc-Path-sources-1" href="#Path-sources">5.2 Path sources</a>
+ <li><a id="toc-Searching-overview-1" href="#Searching-overview">5.1 Searching overview</a></li>
+ <li><a id="toc-Path-sources-1" href="#Path-sources">5.2 Path sources</a>
<ul class="no-bullet">
- <li><a name="toc-Config-files-1" href="#Config-files">5.2.1 Config files</a></li>
+ <li><a id="toc-Config-files-1" href="#Config-files">5.2.1 Config files</a></li>
</ul></li>
- <li><a name="toc-Path-expansion-1" href="#Path-expansion">5.3 Path expansion</a>
+ <li><a id="toc-Path-expansion-1" href="#Path-expansion">5.3 Path expansion</a>
<ul class="no-bullet">
- <li><a name="toc-Default-expansion-1" href="#Default-expansion">5.3.1 Default expansion</a></li>
- <li><a name="toc-Variable-expansion-1" href="#Variable-expansion">5.3.2 Variable expansion</a></li>
- <li><a name="toc-Tilde-expansion-1" href="#Tilde-expansion">5.3.3 Tilde expansion</a></li>
- <li><a name="toc-Brace-expansion-1" href="#Brace-expansion">5.3.4 Brace expansion</a></li>
- <li><a name="toc-KPSE_005fDOT-expansion-1" href="#KPSE_005fDOT-expansion">5.3.5 <code>KPSE_DOT</code> expansion</a></li>
- <li><a name="toc-Subdirectory-expansion-1" href="#Subdirectory-expansion">5.3.6 Subdirectory expansion</a></li>
+ <li><a id="toc-Default-expansion-1" href="#Default-expansion">5.3.1 Default expansion</a></li>
+ <li><a id="toc-Variable-expansion-1" href="#Variable-expansion">5.3.2 Variable expansion</a></li>
+ <li><a id="toc-Tilde-expansion-1" href="#Tilde-expansion">5.3.3 Tilde expansion</a></li>
+ <li><a id="toc-Brace-expansion-1" href="#Brace-expansion">5.3.4 Brace expansion</a></li>
+ <li><a id="toc-KPSE_005fDOT-expansion-1" href="#KPSE_005fDOT-expansion">5.3.5 <code>KPSE_DOT</code> expansion</a></li>
+ <li><a id="toc-Subdirectory-expansion-1" href="#Subdirectory-expansion">5.3.6 Subdirectory expansion</a></li>
</ul></li>
- <li><a name="toc-Casefolding-search-1" href="#Casefolding-search">5.4 Casefolding search</a>
+ <li><a id="toc-Casefolding-search-1" href="#Casefolding-search">5.4 Casefolding search</a>
<ul class="no-bullet">
- <li><a name="toc-Casefolding-rationale-1" href="#Casefolding-rationale">5.4.1 Casefolding rationale</a></li>
- <li><a name="toc-Casefolding-examples-1" href="#Casefolding-examples">5.4.2 Casefolding examples</a></li>
+ <li><a id="toc-Casefolding-rationale-1" href="#Casefolding-rationale">5.4.1 Casefolding rationale</a></li>
+ <li><a id="toc-Casefolding-examples-1" href="#Casefolding-examples">5.4.2 Casefolding examples</a></li>
</ul></li>
- <li><a name="toc-Filename-database-_0028ls_002dR_0029" href="#Filename-database">5.5 Filename database (<code>ls-R</code>)</a>
+ <li><a id="toc-Filename-database-_0028ls_002dR_0029" href="#Filename-database">5.5 Filename database (<code>ls-R</code>)</a>
<ul class="no-bullet">
- <li><a name="toc-ls_002dR-1" href="#ls_002dR">5.5.1 <samp>ls-R</samp></a></li>
- <li><a name="toc-Filename-aliases-1" href="#Filename-aliases">5.5.2 Filename aliases</a></li>
- <li><a name="toc-Database-format-1" href="#Database-format">5.5.3 Database format</a></li>
+ <li><a id="toc-ls_002dR-1" href="#ls_002dR">5.5.1 <samp>ls-R</samp></a></li>
+ <li><a id="toc-Filename-aliases-1" href="#Filename-aliases">5.5.2 Filename aliases</a></li>
+ <li><a id="toc-Database-format-1" href="#Database-format">5.5.3 Database format</a></li>
</ul></li>
- <li><a name="toc-kpsewhich_003a-Standalone-path-searching" href="#Invoking-kpsewhich">5.6 <code>kpsewhich</code>: Standalone path searching</a>
+ <li><a id="toc-kpsewhich_003a-Standalone-path-searching" href="#Invoking-kpsewhich">5.6 <code>kpsewhich</code>: Standalone path searching</a>
<ul class="no-bullet">
- <li><a name="toc-Path-searching-options-1" href="#Path-searching-options">5.6.1 Path searching options</a></li>
- <li><a name="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.6.2 Specially-recognized files for <code>kpsewhich</code></a></li>
- <li><a name="toc-Auxiliary-tasks-1" href="#Auxiliary-tasks">5.6.3 Auxiliary tasks</a></li>
- <li><a name="toc-Standard-options-1" href="#Standard-options">5.6.4 Standard options</a></li>
+ <li><a id="toc-Path-searching-options-1" href="#Path-searching-options">5.6.1 Path searching options</a></li>
+ <li><a id="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.6.2 Specially-recognized files for <code>kpsewhich</code></a></li>
+ <li><a id="toc-Auxiliary-tasks-1" href="#Auxiliary-tasks">5.6.3 Auxiliary tasks</a></li>
+ <li><a id="toc-Standard-options-1" href="#Standard-options">5.6.4 Standard options</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-TeX-support-1" href="#TeX-support">6 TeX support</a>
+ <li><a id="toc-TeX-support-1" href="#TeX-support">6 TeX support</a>
<ul class="no-bullet">
- <li><a name="toc-Supported-file-formats-1" href="#Supported-file-formats">6.1 Supported file formats</a></li>
- <li><a name="toc-File-lookup-1" href="#File-lookup">6.2 File lookup</a></li>
- <li><a name="toc-Glyph-lookup-1" href="#Glyph-lookup">6.3 Glyph lookup</a>
+ <li><a id="toc-Supported-file-formats-1" href="#Supported-file-formats">6.1 Supported file formats</a></li>
+ <li><a id="toc-File-lookup-1" href="#File-lookup">6.2 File lookup</a></li>
+ <li><a id="toc-Glyph-lookup-1" href="#Glyph-lookup">6.3 Glyph lookup</a>
<ul class="no-bullet">
- <li><a name="toc-Basic-glyph-lookup-1" href="#Basic-glyph-lookup">6.3.1 Basic glyph lookup</a></li>
- <li><a name="toc-Fontmap-1" href="#Fontmap">6.3.2 Fontmap</a></li>
- <li><a name="toc-Fallback-font-1" href="#Fallback-font">6.3.3 Fallback font</a></li>
+ <li><a id="toc-Basic-glyph-lookup-1" href="#Basic-glyph-lookup">6.3.1 Basic glyph lookup</a></li>
+ <li><a id="toc-Fontmap-1" href="#Fontmap">6.3.2 Fontmap</a></li>
+ <li><a id="toc-Fallback-font-1" href="#Fallback-font">6.3.3 Fallback font</a></li>
</ul></li>
- <li><a name="toc-Suppressing-warnings-1" href="#Suppressing-warnings">6.4 Suppressing warnings</a></li>
- <li><a name="toc-mktex-scripts-1" href="#mktex-scripts">6.5 <samp>mktex</samp> scripts</a>
+ <li><a id="toc-Suppressing-warnings-1" href="#Suppressing-warnings">6.4 Suppressing warnings</a></li>
+ <li><a id="toc-mktex-scripts-1" href="#mktex-scripts">6.5 <samp>mktex</samp> scripts</a>
<ul class="no-bullet">
- <li><a name="toc-mktex-configuration-1" href="#mktex-configuration">6.5.1 <samp>mktex</samp> configuration</a></li>
- <li><a name="toc-mktex-script-names-1" href="#mktex-script-names">6.5.2 <samp>mktex</samp> script names</a></li>
- <li><a name="toc-mktex-script-arguments-1" href="#mktex-script-arguments">6.5.3 <samp>mktex</samp> script arguments</a></li>
+ <li><a id="toc-mktex-configuration-1" href="#mktex-configuration">6.5.1 <samp>mktex</samp> configuration</a></li>
+ <li><a id="toc-mktex-script-names-1" href="#mktex-script-names">6.5.2 <samp>mktex</samp> script names</a></li>
+ <li><a id="toc-mktex-script-arguments-1" href="#mktex-script-arguments">6.5.3 <samp>mktex</samp> script arguments</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Programming-1" href="#Programming">7 Programming</a>
+ <li><a id="toc-Programming-1" href="#Programming">7 Programming</a>
<ul class="no-bullet">
- <li><a name="toc-Programming-overview-1" href="#Programming-overview">7.1 Programming overview</a></li>
- <li><a name="toc-Calling-sequence-1" href="#Calling-sequence">7.2 Calling sequence</a></li>
- <li><a name="toc-Program_002dspecific-files-1" href="#Program_002dspecific-files">7.3 Program-specific files</a></li>
- <li><a name="toc-Programming-with-config-files-1" href="#Programming-with-config-files">7.4 Programming with config files</a></li>
+ <li><a id="toc-Programming-overview-1" href="#Programming-overview">7.1 Programming overview</a></li>
+ <li><a id="toc-Calling-sequence-1" href="#Calling-sequence">7.2 Calling sequence</a></li>
+ <li><a id="toc-Program_002dspecific-files-1" href="#Program_002dspecific-files">7.3 Program-specific files</a></li>
+ <li><a id="toc-Programming-with-config-files-1" href="#Programming-with-config-files">7.4 Programming with config files</a></li>
</ul></li>
- <li><a name="toc-Reporting-bugs-1" href="#Reporting-bugs">8 Reporting bugs</a>
+ <li><a id="toc-Reporting-bugs-1" href="#Reporting-bugs">8 Reporting bugs</a>
<ul class="no-bullet">
- <li><a name="toc-Bug-checklist-1" href="#Bug-checklist">8.1 Bug checklist</a></li>
- <li><a name="toc-Mailing-lists-1" href="#Mailing-lists">8.2 Mailing lists</a></li>
- <li><a name="toc-Debugging-1" href="#Debugging">8.3 Debugging</a></li>
- <li><a name="toc-Logging-1" href="#Logging">8.4 Logging</a></li>
- <li><a name="toc-Common-problems-1" href="#Common-problems">8.5 Common problems</a>
+ <li><a id="toc-Bug-checklist-1" href="#Bug-checklist">8.1 Bug checklist</a></li>
+ <li><a id="toc-Mailing-lists-1" href="#Mailing-lists">8.2 Mailing lists</a></li>
+ <li><a id="toc-Debugging-1" href="#Debugging">8.3 Debugging</a></li>
+ <li><a id="toc-Logging-1" href="#Logging">8.4 Logging</a></li>
+ <li><a id="toc-Common-problems-1" href="#Common-problems">8.5 Common problems</a>
<ul class="no-bullet">
- <li><a name="toc-Unable-to-find-files-1" href="#Unable-to-find-files">8.5.1 Unable to find files</a></li>
- <li><a name="toc-Slow-path-searching-1" href="#Slow-path-searching">8.5.2 Slow path searching</a></li>
- <li><a name="toc-Unable-to-generate-fonts-1" href="#Unable-to-generate-fonts">8.5.3 Unable to generate fonts</a></li>
- <li><a name="toc-TeX-or-Metafont-failing-1" href="#TeX-or-Metafont-failing">8.5.4 TeX or Metafont failing</a></li>
+ <li><a id="toc-Unable-to-find-files-1" href="#Unable-to-find-files">8.5.1 Unable to find files</a></li>
+ <li><a id="toc-Slow-path-searching-1" href="#Slow-path-searching">8.5.2 Slow path searching</a></li>
+ <li><a id="toc-Unable-to-generate-fonts-1" href="#Unable-to-generate-fonts">8.5.3 Unable to generate fonts</a></li>
+ <li><a id="toc-TeX-or-Metafont-failing-1" href="#TeX-or-Metafont-failing">8.5.4 TeX or Metafont failing</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Index-1" href="#Index">Index</a></li>
+ <li><a id="toc-Index-1" href="#Index">Index</a></li>
</ul>
</div>
-<a name="Top"></a>
-<div class="header">
+<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>
-<a name="Kpathsea-library"></a>
-<h1 class="top">Kpathsea library</h1>
+<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.0, released in
-February 2018.
+corresponds to version 6.3.1, released in
+February 2019.
</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.
+<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.
+</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.
+<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.
+<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.
+</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.
+<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.
+</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.
+</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" accesskey="9">Index</a>:</td><td> </td><td align="left" valign="top">General index.
+<tr><td align="left" valign="top">• <a href="#Index" accesskey="9">Index</a></td><td> </td><td align="left" valign="top">General index.
</td></tr>
</table>
<hr>
-<a name="Introduction"></a>
-<div class="header">
+<span id="Introduction"></span><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>
</div>
-<a name="Introduction-1"></a>
-<h2 class="chapter">1 Introduction</h2>
+<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
-<a name="index-introduction"></a>
-<a name="index-fundamental-purpose-of-Kpathsea"></a>
+<span id="index-introduction"></span>
+<span id="index-fundamental-purpose-of-Kpathsea"></span>
-<p>This manual corresponds to version 6.3.0 of the Kpathsea
-library, released in February 2018.
+<p>This manual corresponds to version 6.3.1 of the Kpathsea
+library, released in February 2019.
</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
looking up program names to execute.
</p>
-<a name="index-programs-using-the-library"></a>
+<span id="index-programs-using-the-library"></span>
<p>The following software, all of which is maintained in parallel, uses
this library:
</p>
<ul>
<li> Dviljk (see the ‘<samp>dvilj</samp>’ man page)
-</li><li> Dvipsk (see <cite><a href="http://tug.org/texinfohtml/dvips.html#Top">Dvips: A DVI driver</a></cite>)
+</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="http://tug.org/texinfohtml/web2c.html#Top">Web2c: A TeX implementation</a></cite>)
+</li><li> Web2c (see <cite><a 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>
@@ -245,17 +232,17 @@
<p>Kpathsea is now maintained as part of the TeX Live distribution
(<a href="http://tug.org/texlive">http://tug.org/texlive</a>), which includes several more
Kpathsea-using programs. For information on configuration, building,
-installing, and more, see <cite><a href="http://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>.
+installing, and more, see <cite><a href="https://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>.
</p>
-<a name="index-interface_002c-not-frozen"></a>
-<a name="index-comments_002c-making"></a>
-<a name="index-suggestions_002c-making"></a>
+<span id="index-interface_002c-not-frozen"></span>
+<span id="index-comments_002c-making"></span>
+<span id="index-suggestions_002c-making"></span>
<p>The library is still actively maintained. If you have comments or
suggestions, please send along (see <a href="#Reporting-bugs">Reporting bugs</a>).
</p>
-<a name="index-conditions-for-use"></a>
-<a name="index-license-for-using-the-library"></a>
-<a name="index-GNU-General-Public-License"></a>
+<span id="index-conditions-for-use"></span>
+<span id="index-license-for-using-the-library"></span>
+<span id="index-GNU-General-Public-License"></span>
<p>The Kpathsea library is distributed under the GNU Library General
Public License (LGPL), version 2.1 or (at your option) any later
version. In short, this means if you write a program using the
@@ -266,7 +253,7 @@
although we hope you will. See accompanying files for the text of the
GNU licenses, or <a href="http2://www.gnu.org/licenses">http2://www.gnu.org/licenses</a>.
</p>
-<a name="index-TeX-Users-Group"></a>
+<span id="index-TeX-Users-Group"></span>
<p>If you know enough about TeX to be reading this manual, then you (or
your institution) should consider joining the TeX Users Group (if
you’re already a member, thanks!). TUG produces the periodical
@@ -275,23 +262,21 @@
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">
+<tr><td align="left" valign="top">• <a href="#History" accesskey="1">History</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="History"></a>
-<div class="header">
+<span id="History"></span><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>
-<a name="History-1"></a>
-<h3 class="section">1.1 History</h3>
+<span id="History-1"></span><h3 class="section">1.1 History</h3>
-<a name="index-history-of-Kpathsea"></a>
+<span id="index-history-of-Kpathsea"></span>
-<a name="index-Knuth_002c-Donald-E_002e"></a>
+<span id="index-Knuth_002c-Donald-E_002e"></span>
<p>This section is for those people who are curious about how the library
came about. If you like to read historical accounts of software, we
urge you to seek out the GNU Autoconf manual and the “Errors of
@@ -298,13 +283,13 @@
TeX” paper by Don Knuth, published in his book <cite>Digital
Typography</cite>, among other places.
</p>
-<a name="index-Morgan_002c-Tim"></a>
-<a name="index-Rokicki_002c-Tom"></a>
-<a name="index-Berry_002c-Karl"></a>
-<a name="index-VAX-11_002f750"></a>
-<a name="index-Sun-2"></a>
-<a name="index-pxp-Pascal-preprocessor"></a>
-<a name="index-pc-Pascal-compiler"></a>
+<span id="index-Morgan_002c-Tim"></span>
+<span id="index-Rokicki_002c-Tom"></span>
+<span id="index-Berry_002c-Karl"></span>
+<span id="index-VAX-11_002f750"></span>
+<span id="index-Sun-2"></span>
+<span id="index-pxp-Pascal-preprocessor"></span>
+<span id="index-pc-Pascal-compiler"></span>
<p>[Karl writes.] My first ChangeLog entry for Web2c seems to be
February 1990, but I may have done some work before then. In any
case, Tim Morgan and I were jointly maintaining it for a time. (I
@@ -324,7 +309,7 @@
everything in one big directory, and also couldn’t stand having to
explicitly specify <samp>cm</samp>, <samp>pandora</samp>, … in a path.
</p>
-<a name="index-Vojta_002c-Paul"></a>
+<span id="index-Vojta_002c-Paul"></span>
<p>In the first incarnation, I just hacked separately on each
program—that was the original subdirectory searching code in both
Xdvi and Dvips. That is, I tried to go with the flow in each program,
@@ -339,7 +324,7 @@
with shell scripts. (I was developing on a 386 running ISC 2.2 at the
time, and so didn’t have symbolic links. An awful experience.)
</p>
-<a name="index-MacKenzie_002c-David"></a>
+<span id="index-MacKenzie_002c-David"></span>
<p>The ChangeLogs for Xdvik and Dvipsk record initial releases of those
distributions in May and June 1992. I think it was because I was tired
of the different configuration strategies of each program, not so much
@@ -346,7 +331,7 @@
because of the path searching. Autoconf was being developed by David
MacKenzie and others, and I was adapting it to TeX and friends.
</p>
-<a name="index-zuhn_002c-david"></a>
+<span id="index-zuhn_002c-david"></span>
<p>I started to make a separate library that other programs could link with
on my birthday in April 1993, according to the ChangeLog. I don’t
remember exactly why I finally took the time to make it a separate
@@ -353,8 +338,8 @@
library; a conversation with david zuhn initiated it. Just seemed
like it was time.
</p>
-<a name="index-Walsh_002c-Norman"></a>
-<a name="index-Neumann_002c-Gustaf"></a>
+<span id="index-Walsh_002c-Norman"></span>
+<span id="index-Neumann_002c-Gustaf"></span>
<p>Dviljk got started in March 1994 after I bought a Laserjet 4. (Kpathsea
work got suspended while Norm Walsh and I, with Gustaf Neumann’s help,
implemented a way for TeX to get at all those neat builtin LJ4 fonts
@@ -371,14 +356,14 @@
is actually what I think is likely to happen, but that’s another
story…)
</p>
-<a name="index-Weber_002c-Olaf"></a>
+<span id="index-Weber_002c-Olaf"></span>
<p>[Olaf writes.] At the end of 1997, Unix is still alive and kicking,
individuals still develop software, and Web2c development still
continues. Karl had been looking for some time for someone to take up
part of the burden, and I volunteered.
</p>
-<a name="index-Hoekwater_002c-Taco"></a>
-<a name="index-Breitenlohner_002c-Peter"></a>
+<span id="index-Hoekwater_002c-Taco"></span>
+<span id="index-Breitenlohner_002c-Peter"></span>
<p>[Karl writes again.] Indeed, time goes on. As of 2006 or so, Olaf’s
available time for Kpathsea was reduced, and I started taking overall
care of it again, although I did not do any significant new
@@ -392,21 +377,19 @@
<hr>
-<a name="unixtex_002eftp"></a>
-<div class="header">
+<span id="unixtex_002eftp"></span><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>
</div>
-<a name="unixtex_002eftp_003a-Obtaining-TeX"></a>
-<h2 class="chapter">2 <samp>unixtex.ftp</samp>: Obtaining TeX</h2>
+<span id="unixtex_002eftp_003a-Obtaining-TeX"></span><h2 class="chapter">2 <samp>unixtex.ftp</samp>: Obtaining TeX</h2>
-<a name="index-obtaining-TeX"></a>
-<a name="index-retrieving-TeX"></a>
+<span id="index-obtaining-TeX"></span>
+<span id="index-retrieving-TeX"></span>
-<a name="index-unixtex_002eftp"></a>
-<a name="index-tug_002eorg"></a>
-<a name="index-www_002etug_002eorg"></a>
-<a name="index-ftp_002etug_002eorg"></a>
+<span id="index-unixtex_002eftp"></span>
+<span id="index-tug_002eorg"></span>
+<span id="index-www_002etug_002eorg"></span>
+<span id="index-ftp_002etug_002eorg"></span>
<p>This
is <a href="https://tug.org/tex/unixtex.ftp">https://tug.org/tex/unixtex.ftp</a>, last updated 28 November
2017. Email <a href="mailto:tex-k at tug.org">tex-k at tug.org</a> with comments or questions.
@@ -422,9 +405,9 @@
separate packages. Their sources are now maintained as part of TeX
Live.
</p>
-<a name="index-ftp_002ecs_002estanford_002eedu"></a>
-<a name="index-tex_002eweb"></a>
-<a name="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by"></a>
+<span id="index-ftp_002ecs_002estanford_002eedu"></span>
+<span id="index-tex_002eweb"></span>
+<span id="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by"></span>
<p>The host <tt>ftp.cs.stanford.edu</tt> is the original source for the files
for which Donald Knuth is directly responsible: <samp>tex.web</samp>,
<samp>plain.tex</samp>, etc. However, unless you want to undertake the
@@ -441,36 +424,34 @@
<hr>
-<a name="Security"></a>
-<div class="header">
+<span id="Security"></span><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>
</div>
-<a name="Security-1"></a>
-<h2 class="chapter">3 Security</h2>
+<span id="Security-1"></span><h2 class="chapter">3 Security</h2>
-<a name="index-security-considerations"></a>
+<span id="index-security-considerations"></span>
<p>None of the programs in the TeX system require any special system
privileges, so there’s no first-level security concern of people gaining
illegitimate root access.
</p>
-<a name="index-trojan-horse-attack"></a>
-<a name="index-_002erhosts_002c-writable-by-TeX"></a>
+<span id="index-trojan-horse-attack"></span>
+<span id="index-_002erhosts_002c-writable-by-TeX"></span>
<p>A TeX document, however, can write to arbitrary files, e.g.,
<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="http://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>. MetaPost has
+<samp>texmf.cnf</samp>. See <a 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="http://tug.org/texinfohtml/dvips.html#Option-details">Option
-details</a> in <cite>Dvips</cite>, the xdvi man page, and <a href="http://tug.org/texinfohtml/web2c.html#tex-invocation">tex
+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
invocation</a> in <cite>Web2c</cite>, respectively.
</p>
-<a name="index-local-cache-of-fonts"></a>
-<a name="index-cache-of-fonts_002c-local"></a>
+<span id="index-local-cache-of-fonts"></span>
+<span id="index-cache-of-fonts_002c-local"></span>
<p>Another security issue arises because it’s very useful—almost
necessary—to make arbitrary fonts on user demand with <code>mktexpk</code>
and friends. Where do these files get installed? By default, the
@@ -479,7 +460,7 @@
it may not suit your situation because it means that a local cache of
fonts is created on every machine.
</p>
-<a name="index-globally-writable-directories"></a>
+<span id="index-globally-writable-directories"></span>
<p>To avoid this duplication, many people consider a shared, globally
writable font tree desirable, in spite of the potential security
problems. To do this you should change the value of <code>VARTEXFONTS</code>
@@ -486,13 +467,13 @@
in <samp>texmf.cnf</samp> to refer to some globally known directory.
See <a href="#mktex-configuration">mktex configuration</a>.
</p>
-<a name="index-append_002donly-directories-and-mktexpk"></a>
+<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>.
</p>
-<a name="index-group_002dwritable-directories"></a>
-<a name="index-setgid-scripts"></a>
+<span id="index-group_002dwritable-directories"></span>
+<span id="index-setgid-scripts"></span>
<p>Another approach is to establish a group (or user) for TeX files,
make the <samp>texmf</samp> tree writable only to that group (or user), and
make <code>mktexpk</code> et al. setgid to that group (or setuid to that
@@ -500,14 +481,14 @@
you’re worried about the inevitable security holes in scripts, then you
could write a C wrapper to exec the script.)
</p>
-<a name="index-file-permissions"></a>
-<a name="index-permissions_002c-file"></a>
+<span id="index-file-permissions"></span>
+<span id="index-permissions_002c-file"></span>
<p>The <samp>mktex…</samp> scripts install files with the same read and
write permissions as the directory they are installed in. The
executable, sgid, suid, and sticky bits are always cleared.
</p>
-<a name="index-directory-permissions"></a>
-<a name="index-permissions_002c-directory"></a>
+<span id="index-directory-permissions"></span>
+<span id="index-permissions_002c-directory"></span>
<p>Any directories created by the <samp>mktex…</samp> scripts have the
same permissions as their parent directory, unless the
<code>appendonlydir</code> feature is used, in which case the sticky bit is
@@ -515,19 +496,17 @@
</p>
<hr>
-<a name="TeX-directory-structure"></a>
-<div class="header">
+<span id="TeX-directory-structure"></span><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>
</div>
-<a name="TeX-directory-structure-1"></a>
-<h2 class="chapter">4 TeX directory structure</h2>
+<span id="TeX-directory-structure-1"></span><h2 class="chapter">4 TeX directory structure</h2>
-<a name="index-TEXMF"></a>
-<a name="index-TeX-directory-structure"></a>
-<a name="index-directory-structure_002c-for-TeX-files"></a>
-<a name="index-skeleton-TeX-directory"></a>
-<a name="index-TDS"></a>
+<span id="index-TEXMF"></span>
+<span id="index-TeX-directory-structure"></span>
+<span id="index-directory-structure_002c-for-TeX-files"></span>
+<span id="index-skeleton-TeX-directory"></span>
+<span id="index-TDS"></span>
<p>This section describes the default installation hierarchy of the
distribution. It conforms to both the GNU coding standards and the
@@ -613,15 +592,13 @@
<hr>
-<a name="Path-searching"></a>
-<div class="header">
+<span id="Path-searching"></span><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>
</div>
-<a name="Path-searching-1"></a>
-<h2 class="chapter">5 Path searching</h2>
+<span id="Path-searching-1"></span><h2 class="chapter">5 Path searching</h2>
-<a name="index-path-searching"></a>
+<span id="index-path-searching"></span>
<p>This chapter describes the generic path searching mechanism Kpathsea
provides. For information about searching for particular file types
@@ -628,35 +605,33 @@
(e.g., TeX fonts), see the next chapter.
</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.
+<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.
+<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.
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Searching-overview"></a>
-<div class="header">
+<span id="Searching-overview"></span><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>
-<a name="Searching-overview-1"></a>
-<h3 class="section">5.1 Searching overview</h3>
+<span id="Searching-overview-1"></span><h3 class="section">5.1 Searching overview</h3>
-<a name="index-searching-overview"></a>
-<a name="index-path-searching_002c-overview"></a>
-<a name="index-overview-of-path-searching"></a>
+<span id="index-searching-overview"></span>
+<span id="index-path-searching_002c-overview"></span>
+<span id="index-overview-of-path-searching"></span>
-<a name="index-search-path_002c-defined"></a>
+<span id="index-search-path_002c-defined"></span>
<p>A <em>search path</em> is a colon-separated list of <em>path elements</em>,
which are directory names with a few extra frills. A search path can
come from (a combination of) many sources; see below. To look up a file
@@ -664,24 +639,24 @@
the path in turn: first <samp>./foo</samp>, then <samp>/dir/foo</samp>, returning
the first match (or possibly all matches).
</p>
-<a name="index-magic-characters"></a>
-<a name="index-_003a-may-not-be-_003a"></a>
-<a name="index-_002f-may-not-be-_002f"></a>
+<span id="index-magic-characters"></span>
+<span id="index-_003a-may-not-be-_003a"></span>
+<span id="index-_002f-may-not-be-_002f"></span>
<p>The “colon” and “slash” mentioned here aren’t necessarily ‘<samp>:</samp>’
and ‘<samp>/</samp>’ on non-Unix systems. Kpathsea tries to adapt to other
operating systems’ conventions.
</p>
-<a name="index-database-search"></a>
-<a name="index-searching-the-database"></a>
+<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.,
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>
-<a name="index-floating-directories"></a>
-<a name="index-filesystem-search"></a>
-<a name="index-disk-search"></a>
-<a name="index-searching-the-disk"></a>
+<span id="index-floating-directories"></span>
+<span id="index-filesystem-search"></span>
+<span id="index-disk-search"></span>
+<span id="index-searching-the-disk"></span>
<p>If the database does not exist, or does not apply to this path element,
or contains no matches, the filesystem is searched (if this was not
forbidden by the specification with ‘<samp>!!</samp>’ and if the file being
@@ -691,10 +666,10 @@
same directory, the directory in which a file is found is floated to the
top of the directory list.)
</p>
-<a name="index-must-exist"></a>
-<a name="index-VF-files_002c-not-found"></a>
-<a name="index-cmr10_002evf"></a>
-<a name="index-_005copenin"></a>
+<span id="index-must-exist"></span>
+<span id="index-VF-files_002c-not-found"></span>
+<span id="index-cmr10_002evf"></span>
+<span id="index-_005copenin"></span>
<p>The “file must exist” condition comes into play with VF files and
input files read by the TeX ‘<samp>\openin</samp>’ command. These files
might very well not exist (consider <samp>cmr10.vf</samp>), and so it would
@@ -714,7 +689,7 @@
name like ‘<samp>./FooBar.TeX</samp>’ will match a file ‘<samp>./foobar.tex</samp>’,
and vice versa. This is not done on Windows. See <a href="#Casefolding-search">Casefolding search</a>.
</p>
-<a name="index-expansion_002c-path-element"></a>
+<span id="index-expansion_002c-path-element"></span>
<p>Although the simplest and most common path element is a directory name,
Kpathsea supports additional features in search paths: layered default
values, environment variable names, config file values, users’ home
@@ -724,21 +699,21 @@
process is described in the sections below. It happens in the same
order as the sections.
</p>
-<a name="index-absolute-filenames"></a>
-<a name="index-relative-filenames"></a>
-<a name="index-explicitly-relative-filenames"></a>
-<a name="index-filenames_002c-absolute-or-explicitly-relative"></a>
+<span id="index-absolute-filenames"></span>
+<span id="index-relative-filenames"></span>
+<span id="index-explicitly-relative-filenames"></span>
+<span id="index-filenames_002c-absolute-or-explicitly-relative"></span>
<p>Exception to all of the above: If the filename being searched for is
absolute or explicitly relative, i.e., starts with ‘<samp>/</samp>’ or ‘<samp>./</samp>’
or ‘<samp>../</samp>’, Kpathsea simply checks if that file exists, with a
fallback to a casefolding match if needed and enabled, as described above.
</p>
-<a name="index-permission-denied"></a>
-<a name="index-unreadable-files"></a>
-<a name="index-access-warnings"></a>
-<a name="index-warnings_002c-file-access"></a>
-<a name="index-lost_002bfound-directory"></a>
-<a name="index-TEX_005fHUSH"></a>
+<span id="index-permission-denied"></span>
+<span id="index-unreadable-files"></span>
+<span id="index-access-warnings"></span>
+<span id="index-warnings_002c-file-access"></span>
+<span id="index-lost_002bfound-directory"></span>
+<span id="index-TEX_005fHUSH"></span>
<p>Ordinarily, if Kpathsea tries to access a file or directory that
cannot be read, it gives a warning. This is so you will be alerted to
directories or files that accidentally lack any read permission (for
@@ -752,22 +727,20 @@
</p>
<hr>
-<a name="Path-sources"></a>
-<div class="header">
+<span id="Path-sources"></span><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>
-<a name="Path-sources-1"></a>
-<h3 class="section">5.2 Path sources</h3>
+<span id="Path-sources-1"></span><h3 class="section">5.2 Path sources</h3>
-<a name="index-path-sources"></a>
-<a name="index-sources-for-search-paths"></a>
+<span id="index-path-sources"></span>
+<span id="index-sources-for-search-paths"></span>
<p>A search path or other configuration value can come from many sources.
In the order in which Kpathsea looks for them:
</p>
<ol>
-<li> <a name="index-environment-variable_002c-source-for-path"></a>
+<li> <span id="index-environment-variable_002c-source-for-path"></span>
A user-set environment variable, e.g., <code>TEXINPUTS</code>.
Environment variables with an underscore and the program name appended
override; for example, <code>TEXINPUTS_latex</code> overrides <code>TEXINPUTS</code>
@@ -774,15 +747,15 @@
if the program being run is named ‘<samp>latex</samp>’.
</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="http://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>).
+Dvips’ <samp>config.ps</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#Config-files">Config files</a> in <cite>Dvips</cite>).
-</li><li> <a name="index-configuration-file_002c-source-for-path"></a>
-<a name="index-Kpathsea-config-file_002c-source-for-path"></a>
-<a name="index-texmf_002ecnf_002c-source-for-path"></a>
+</li><li> <span id="index-configuration-file_002c-source-for-path"></span>
+<span id="index-Kpathsea-config-file_002c-source-for-path"></span>
+<span id="index-texmf_002ecnf_002c-source-for-path"></span>
A line in a Kpathsea configuration file <samp>texmf.cnf</samp>, e.g.,
‘<samp>TEXINPUTS=/c:/d</samp>’ (see below).
-</li><li> <a name="index-compilation-value_002c-source-for-path"></a>
+</li><li> <span id="index-compilation-value_002c-source-for-path"></span>
The compile-time default (specified in <samp>kpathsea/paths.h</samp>).
</li></ol>
@@ -792,25 +765,23 @@
<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).
+<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>
<hr>
-<a name="Config-files"></a>
-<div class="header">
+<span id="Config-files"></span><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>
-<a name="Config-files-1"></a>
-<h4 class="subsection">5.2.1 Config files</h4>
+<span id="Config-files-1"></span><h4 class="subsection">5.2.1 Config files</h4>
-<a name="index-config-files"></a>
-<a name="index-texmf_002ecnf_002c-definition-for"></a>
+<span id="index-config-files"></span>
+<span id="index-texmf_002ecnf_002c-definition-for"></span>
-<a name="index-runtime-configuration-files"></a>
-<a name="index-TEXMFCNF"></a>
+<span id="index-runtime-configuration-files"></span>
+<span id="index-TEXMFCNF"></span>
<p>As mentioned above, Kpathsea reads <em>runtime configuration files</em>
named <samp>texmf.cnf</samp> for search path and other definitions. The
search path used to look for these configuration files is named
@@ -824,9 +795,9 @@
later files. Thus, if the search path is ‘<samp>.:$TEXMF</samp>’, values from
<samp>./texmf.cnf</samp> override those from <samp>$TEXMF/texmf.cnf</samp>.
</p>
-<a name="index-KPATHSEA_005fWARNING"></a>
-<a name="index-warning_002c-about-missing-texmf_002ecnf"></a>
-<a name="index-texmf_002ecnf-missing_002c-warning-about"></a>
+<span id="index-KPATHSEA_005fWARNING"></span>
+<span id="index-warning_002c-about-missing-texmf_002ecnf"></span>
+<span id="index-texmf_002ecnf-missing_002c-warning-about"></span>
<p>If Kpathsea cannot find any <samp>texmf.cnf</samp> file, it reports a
warning including all the directories it checked. If you don’t want
to see this warning, set the environment variable
@@ -838,7 +809,7 @@
mentions most features. The format of <samp>texmf.cnf</samp> files follows:
</p>
<ul>
-<li> <a name="index-comments_002c-in-texmf_002ecnf"></a>
+<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,
as with most shells, a ‘<samp>%</samp>’ in the “middle” of a value does not
@@ -849,13 +820,13 @@
var = a%b % but the value of var will be "a%b".
</pre></div>
-</li><li> <a name="index-blank-lines_002c-in-texmf_002ecnf"></a>
+</li><li> <span id="index-blank-lines_002c-in-texmf_002ecnf"></span>
Blank lines are ignored.
-</li><li> <a name="index-backslash_002dnewline"></a>
-<a name="index-continuation-character"></a>
-<a name="index-whitespace_002c-not-ignored-on-continuation-lines"></a>
-<a name="index-_005c_002c-line-continuation-in-texmf_002ecnf"></a>
+</li><li> <span id="index-backslash_002dnewline"></span>
+<span id="index-continuation-character"></span>
+<span id="index-whitespace_002c-not-ignored-on-continuation-lines"></span>
+<span id="index-_005c_002c-line-continuation-in-texmf_002ecnf"></span>
A ‘<samp>\</samp>’ at the end of a line acts as a continuation character, i.e.,
the next line is appended. Whitespace at the beginning of continuation
lines is not ignored.
@@ -868,7 +839,7 @@
<p>where the ‘<samp>=</samp>’ and surrounding whitespace is optional.
</p>
-</li><li> <a name="index-identifiers_002c-characters-valid-in"></a>
+</li><li> <span id="index-identifiers_002c-characters-valid-in"></span>
The <var>variable</var> name may contain any character other than whitespace,
‘<samp>=</samp>’, or ‘<samp>.</samp>’, but sticking to ‘<samp>A-Za-z_</samp>’ is safest.
@@ -878,7 +849,7 @@
<samp><var>progname</var>.{exe,bat,cmd,...}</samp>. Most notably, this allows
different flavors of TeX to have different search paths.
-</li><li> <a name="index-right_002dhand-side-of-variable-assignments"></a>
+</li><li> <span id="index-right_002dhand-side-of-variable-assignments"></span>
<var>value</var> may contain any characters except ‘<samp>%</samp>’ and ‘<samp>@</samp>’.
(These restrictions are only necessary because of the processing done
on <samp>texmf.cnf</samp> at build time, so you can stick those characters
@@ -907,8 +878,8 @@
TEXINPUTS.latex = $latex2e_inputs
</pre></div>
-<a name="index-shell-scripts-as-configuration-files"></a>
-<a name="index-configuration-files-as-shell-scripts_002e"></a>
+<span id="index-shell-scripts-as-configuration-files"></span>
+<span id="index-configuration-files-as-shell-scripts_002e"></span>
<p>This format has obvious similarities 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
@@ -917,21 +888,19 @@
to Kpathsea and parsed there anyway, since the <code>sh</code> process
couldn’t affect its parent’s environment.
</p>
-<a name="index-cnf_002ec"></a>
+<span id="index-cnf_002ec"></span>
<p>The implementation of all this is in <samp>kpathsea/cnf.c</samp>.
</p>
<hr>
-<a name="Path-expansion"></a>
-<div class="header">
+<span id="Path-expansion"></span><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>
-<a name="Path-expansion-1"></a>
-<h3 class="section">5.3 Path expansion</h3>
+<span id="Path-expansion-1"></span><h3 class="section">5.3 Path expansion</h3>
-<a name="index-path-expansion"></a>
-<a name="index-expansion_002c-search-path"></a>
+<span id="index-path-expansion"></span>
+<span id="index-expansion_002c-search-path"></span>
<p>Kpathsea recognizes certain special characters and constructions in
search paths, similar to that in shells. As a general example:
@@ -942,37 +911,35 @@
<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.
+<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.
+<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.
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Default-expansion"></a>
-<div class="header">
+<span id="Default-expansion"></span><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>
-<a name="Default-expansion-1"></a>
-<h4 class="subsection">5.3.1 Default expansion</h4>
+<span id="Default-expansion-1"></span><h4 class="subsection">5.3.1 Default expansion</h4>
-<a name="index-_003a_003a-expansion"></a>
-<a name="index-doubled-colons"></a>
-<a name="index-leading-colons"></a>
-<a name="index-trailing-colons"></a>
-<a name="index-extra-colons"></a>
-<a name="index-default-expansion"></a>
-<a name="index-expansion_002c-default"></a>
+<span id="index-_003a_003a-expansion"></span>
+<span id="index-doubled-colons"></span>
+<span id="index-leading-colons"></span>
+<span id="index-trailing-colons"></span>
+<span id="index-extra-colons"></span>
+<span id="index-default-expansion"></span>
+<span id="index-expansion_002c-default"></span>
<p>If the highest-priority search path (see <a href="#Path-sources">Path sources</a>) contains an
<em>extra colon</em> (i.e., leading, trailing, or doubled), Kpathsea
@@ -1018,7 +985,7 @@
This doesn’t happen. It’s not clear this would be desirable in all
cases, and trying to devise a way to specify the path to which the extra
colon should expand seemed truly baroque.
-<a name="index-Bach_002c-Johann-Sebastian"></a>
+<span id="index-Bach_002c-Johann-Sebastian"></span>
</p>
<p>Technicality: Since it would be useless to insert the default value in
more than one place, Kpathsea changes only one extra ‘<samp>:</samp>’ and leaves
@@ -1026,7 +993,7 @@
first for a leading ‘<samp>:</samp>’, then a trailing ‘<samp>:</samp>’, then a doubled
‘<samp>:</samp>’.
</p>
-<a name="index-kdefault_002ec"></a>
+<span id="index-kdefault_002ec"></span>
<p>You can trace this by debugging “paths” (see <a href="#Debugging">Debugging</a>).
Default expansion is implemented in the source file
<samp>kpathsea/kdefault.c</samp>.
@@ -1033,19 +1000,17 @@
</p>
<hr>
-<a name="Variable-expansion"></a>
-<div class="header">
+<span id="Variable-expansion"></span><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>
-<a name="Variable-expansion-1"></a>
-<h4 class="subsection">5.3.2 Variable expansion</h4>
+<span id="Variable-expansion-1"></span><h4 class="subsection">5.3.2 Variable expansion</h4>
-<a name="index-_0024-expansion"></a>
-<a name="index-environment-variables-in-paths"></a>
-<a name="index-variable-expansion"></a>
-<a name="index-expansion_002c-variable"></a>
-<a name="index-texmf_002ecnf_002c-and-variable-expansion"></a>
+<span id="index-_0024-expansion"></span>
+<span id="index-environment-variables-in-paths"></span>
+<span id="index-variable-expansion"></span>
+<span id="index-expansion_002c-variable"></span>
+<span id="index-texmf_002ecnf_002c-and-variable-expansion"></span>
<p>‘<samp>$foo</samp>’ or ‘<samp>${foo}</samp>’ in a path element is replaced by (1) the
value of an environment variable ‘<samp>foo</samp>’ (if defined); (2) the value
@@ -1058,8 +1023,8 @@
variable names). Otherwise, Kpathsea gives a warning and ignores the
‘<samp>$</samp>’ and its following character.
</p>
-<a name="index-quoting-variable-values"></a>
-<a name="index-shell-variables"></a>
+<span id="index-quoting-variable-values"></span>
+<span id="index-shell-variables"></span>
<p>You must quote the <tt>$</tt>’s and braces as necessary for your shell.
<em>Shell</em> variable values cannot be seen by Kpathsea, i.e., ones
defined by <code>set</code> in C shells and without <code>export</code> in Bourne
@@ -1080,27 +1045,25 @@
for general variable expansions. These are only recognized when search
paths are initialized (see <a href="#Path-sources">Path sources</a>).
</p>
-<a name="index-variable_002ec"></a>
+<span id="index-variable_002ec"></span>
<p>Variable expansion is implemented in the source file
<samp>kpathsea/variable.c</samp>.
</p>
<hr>
-<a name="Tilde-expansion"></a>
-<div class="header">
+<span id="Tilde-expansion"></span><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>
-<a name="Tilde-expansion-1"></a>
-<h4 class="subsection">5.3.3 Tilde expansion</h4>
+<span id="Tilde-expansion-1"></span><h4 class="subsection">5.3.3 Tilde expansion</h4>
-<a name="index-_007e-expansion"></a>
-<a name="index-home-directories-in-paths"></a>
-<a name="index-tilde-expansion"></a>
-<a name="index-expansion_002c-tilde"></a>
+<span id="index-_007e-expansion"></span>
+<span id="index-home-directories-in-paths"></span>
+<span id="index-tilde-expansion"></span>
+<span id="index-expansion_002c-tilde"></span>
-<a name="index-HOME_002c-as-_007e-expansion"></a>
-<a name="index-USERPROFILE_002c-as-_007e-expansion"></a>
+<span id="index-HOME_002c-as-_007e-expansion"></span>
+<span id="index-USERPROFILE_002c-as-_007e-expansion"></span>
<p>A leading ‘<samp>~</samp>’ in a path element is replaced by the value of the
environment variable <code>HOME</code>, or <samp>.</samp> if <code>HOME</code> is not
set. On Windows, the environment variable <code>USERPROFILE</code> is
@@ -1117,9 +1080,9 @@
<p>will prepend a directory <samp>mymacros</samp> in your home
directory to the default path.
</p>
-<a name="index-root-user"></a>
-<a name="index-trailing-_002f-in-home-directory"></a>
-<a name="index-_002f_002c-trailing-in-home-directory"></a>
+<span id="index-root-user"></span>
+<span id="index-trailing-_002f-in-home-directory"></span>
+<span id="index-_002f_002c-trailing-in-home-directory"></span>
<p>As a special case, if a home directory ends in ‘<samp>/</samp>’, the trailing
slash is dropped, to avoid inadvertently creating a ‘<samp>//</samp>’ construct
in the path. For example, if the home directory of the user ‘<samp>root</samp>’
@@ -1126,21 +1089,19 @@
is ‘<samp>/</samp>’, the path element ‘<samp>~root/mymacros</samp>’ expands to just
‘<samp>/mymacros</samp>’, not ‘<samp>//mymacros</samp>’.
</p>
-<a name="index-tilde_002ec"></a>
+<span id="index-tilde_002ec"></span>
<p>Tilde expansion is implemented in the source file <samp>kpathsea/tilde.c</samp>.
</p>
<hr>
-<a name="Brace-expansion"></a>
-<div class="header">
+<span id="Brace-expansion"></span><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>
</div>
-<a name="Brace-expansion-1"></a>
-<h4 class="subsection">5.3.4 Brace expansion</h4>
+<span id="Brace-expansion-1"></span><h4 class="subsection">5.3.4 Brace expansion</h4>
-<a name="index-_007b-expansion"></a>
-<a name="index-brace-expansion"></a>
+<span id="index-_007b-expansion"></span>
+<span id="index-brace-expansion"></span>
<p>‘<samp>x{<var>a</var>,<var>b</var>}y</samp>’ expands to ‘<samp>x<var>a</var>y:x<var>b</var>y</samp>’.
For example:
@@ -1150,7 +1111,7 @@
</pre></div>
<p>expands to ‘<samp>foo/1/baz:foo/2/baz</samp>’. ‘<samp>:</samp>’ is the path
-separator on the current system; e.g., on a DOS system, it’s ‘<samp>;</samp>’.
+separator on the current system; e.g., on a Windows system, it’s ‘<samp>;</samp>’.
</p>
<p>Braces can be nested; for example, ‘<samp>x{A,B{1,2}}y</samp>’ expands to
‘<samp>xAy:xB1y:xB2y</samp>’.
@@ -1159,30 +1120,28 @@
‘<samp>x{A,B}{1,2}y</samp>’ expands to ‘<samp>x{A,B}1y:x{A,B}2y</samp>’, which
expands to ‘<samp>xA1y:xB1y:xA2y:xB2y</samp>’.
</p>
-<a name="index-multiple-TeX-hierarchies"></a>
+<span id="index-multiple-TeX-hierarchies"></span>
<p>This feature can be used to implement multiple TeX hierarchies, by
assigning a brace list to <code>$TEXMF</code>, as mentioned in
<samp>texmf.in</samp>.
</p>
<p>You can also use the path separator instead of the comma. The last
-example could have been written ‘<samp>x{A:B}{1:2}y</samp>’.
+example could have been written ‘<samp>x{A:B}{1:2}y</samp>’ (on Unix).
</p>
-<a name="index-expand_002ec"></a>
+<span id="index-expand_002ec"></span>
<p>Brace expansion is implemented in the source file
<samp>kpathsea/expand.c</samp>.
</p>
<hr>
-<a name="KPSE_005fDOT-expansion"></a>
-<div class="header">
+<span id="KPSE_005fDOT-expansion"></span><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>
-<a name="KPSE_005fDOT-expansion-1"></a>
-<h4 class="subsection">5.3.5 <code>KPSE_DOT</code> expansion</h4>
+<span id="KPSE_005fDOT-expansion-1"></span><h4 class="subsection">5.3.5 <code>KPSE_DOT</code> expansion</h4>
-<a name="index-KPSE_005fDOT-expansion"></a>
+<span id="index-KPSE_005fDOT-expansion"></span>
<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
@@ -1192,19 +1151,17 @@
</p>
<hr>
-<a name="Subdirectory-expansion"></a>
-<div class="header">
+<span id="Subdirectory-expansion"></span><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>
</div>
-<a name="Subdirectory-expansion-1"></a>
-<h4 class="subsection">5.3.6 Subdirectory expansion</h4>
+<span id="Subdirectory-expansion-1"></span><h4 class="subsection">5.3.6 Subdirectory expansion</h4>
-<a name="index-_002f_002f"></a>
-<a name="index-subdirectory-searching"></a>
-<a name="index-expansion_002c-subdirectory"></a>
+<span id="index-_002f_002f"></span>
+<span id="index-subdirectory-searching"></span>
+<span id="index-expansion_002c-subdirectory"></span>
-<a name="index-alphabetical-order_002c-not"></a>
+<span id="index-alphabetical-order_002c-not"></span>
<p>Two or more consecutive slashes in a path element following a directory
<var>d</var> is replaced by all subdirectories of <var>d</var>: first those
subdirectories directly under <var>d</var>, then the subsubdirectories under
@@ -1222,14 +1179,14 @@
<p>‘<samp>//</samp>’ at the beginning of a path is ignored; you didn’t really want
to search every directory on the system, did you?
</p>
-<a name="index-trick-for-detecting-leaf-directories"></a>
-<a name="index-leaf-directory-trick"></a>
-<a name="index-Farwell_002c-Matthew"></a>
-<a name="index-MacKenzie_002c-David-1"></a>
+<span id="index-trick-for-detecting-leaf-directories"></span>
+<span id="index-leaf-directory-trick"></span>
+<span id="index-Farwell_002c-Matthew"></span>
+<span id="index-MacKenzie_002c-David-1"></span>
<p>I should mention one related implementation trick, which I took from GNU
find. Matthew Farwell suggested it, and David MacKenzie implemented it.
</p>
-<a name="index-st_005fnlink"></a>
+<span id="index-st_005fnlink"></span>
<p>The trick is that in every real Unix implementation (as opposed to the
POSIX specification), a directory which contains no subdirectories will
have exactly two links (namely, one for <samp>.</samp> and one for <samp>..</samp>).
@@ -1242,11 +1199,11 @@
regular files, <code>st_nlink</code> will be 3, and Kpathsea has to stat every
one of those 501 entries. Therein lies slowness.
</p>
-<a name="index-ST_005fNLINK_005fTRICK"></a>
+<span id="index-ST_005fNLINK_005fTRICK"></span>
<p>You can disable the trick by undefining <code>ST_NLINK_TRICK</code> in
<samp>kpathsea/config.h</samp>. (It is undefined by default except under Unix.)
</p>
-<a name="index-elt_002ddirs_002ec"></a>
+<span id="index-elt_002ddirs_002ec"></span>
<p>Unfortunately, in some cases files in leaf directories are
<code>stat</code>’d: if the path specification is, say,
‘<samp>$TEXMF/fonts//pk//</samp>’, then files in a subdirectory
@@ -1256,22 +1213,20 @@
curious. And if you can find a way to <em>solve</em> the problem, please
let me know.
</p>
-<a name="index-elt_002ddirs_002ec-1"></a>
+<span id="index-elt_002ddirs_002ec-1"></span>
<p>Subdirectory expansion is implemented in the source file
<samp>kpathsea/elt-dirs.c</samp>.
</p>
<hr>
-<a name="Casefolding-search"></a>
-<div class="header">
+<span id="Casefolding-search"></span><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>
</div>
-<a name="Casefolding-search-1"></a>
-<h3 class="section">5.4 Casefolding search</h3>
+<span id="Casefolding-search-1"></span><h3 class="section">5.4 Casefolding search</h3>
-<a name="index-casefolding-search"></a>
-<a name="index-search_002c-case_002dinsensitive"></a>
+<span id="index-casefolding-search"></span>
+<span id="index-search_002c-case_002dinsensitive"></span>
<p>In Kpathsea version 6.3.0 (released with TeX Live 2018), a new
fallback search was implemented on Unix-like systems, including Macs:
@@ -1279,7 +1234,7 @@
search, and the path element allows for checking the filesystem, a
second check is made for a case-insensitive match.
</p>
-<a name="index-texmf_005fcasefold_005fsearch"></a>
+<span id="index-texmf_005fcasefold_005fsearch"></span>
<p>This is enabled at compile-time on Unix systems, and enabled at
runtime by setting the configuration variable
<code>texmf_casefold_search</code>, to a true value, e.g., ‘<samp>1</samp>’; this is
@@ -1286,28 +1241,26 @@
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">
+<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">
+<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>
<hr>
-<a name="Casefolding-rationale"></a>
-<div class="header">
+<span id="Casefolding-rationale"></span><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>
-<a name="Casefolding-rationale-1"></a>
-<h4 class="subsection">5.4.1 Casefolding rationale</h4>
+<span id="Casefolding-rationale-1"></span><h4 class="subsection">5.4.1 Casefolding rationale</h4>
-<a name="index-casefolding-fallback-rationale"></a>
-<a name="index-rationale-for-casefolding-fallback"></a>
-<a name="index-system_002ddependent-casefolding-behavior"></a>
+<span id="index-casefolding-fallback-rationale"></span>
+<span id="index-rationale-for-casefolding-fallback"></span>
+<span id="index-system_002ddependent-casefolding-behavior"></span>
-<a name="index-filesystem_002c-case_002d_0028in_0029sensitive"></a>
-<a name="index-Apple-filesystem_002c-case_002dinsensitive"></a>
-<a name="index-Mac-filesystem_002c-case_002dinsensitive"></a>
+<span id="index-filesystem_002c-case_002d_0028in_0029sensitive"></span>
+<span id="index-Apple-filesystem_002c-case_002dinsensitive"></span>
+<span id="index-Mac-filesystem_002c-case_002dinsensitive"></span>
<p>The purpose of the fallback casefolding search is to ease moving
complex documents between case-insensitive (file)systems and
case-sensitive ones. In particular, Apple decided to make the default
@@ -1324,7 +1277,7 @@
to a case-insensitive filesystem. Hence the move to change the
Kpathsea behavior now.
</p>
-<a name="index-Windows-and-casefolding"></a>
+<span id="index-Windows-and-casefolding"></span>
<p>The fallback case-insensitive search is omitted at compile-time on
Windows, where (for practical purposes) all file names are
case-insensitive at the kernel level, and so the normal search will
@@ -1334,16 +1287,14 @@
</p>
<hr>
-<a name="Casefolding-examples"></a>
-<div class="header">
+<span id="Casefolding-examples"></span><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>
-<a name="Casefolding-examples-1"></a>
-<h4 class="subsection">5.4.2 Casefolding examples</h4>
+<span id="Casefolding-examples-1"></span><h4 class="subsection">5.4.2 Casefolding examples</h4>
-<a name="index-casefolding-examples"></a>
-<a name="index-examples_002c-of-casefolding-searches"></a>
+<span id="index-casefolding-examples"></span>
+<span id="index-examples_002c-of-casefolding-searches"></span>
<p>The casefolding implementation prefers exact matches to casefolded
matches within a given path element, so as to retain most
@@ -1424,8 +1375,8 @@
find `cat /tmp/texdirlist` -iname somefile.tex -print </tmp/texdirlist
</pre></div>
-<a name="index-Findutils_002c-GNU-package"></a>
-<a name="index-_002diname_002c-find-predicate"></a>
+<span id="index-Findutils_002c-GNU-package"></span>
+<span id="index-_002diname_002c-find-predicate"></span>
<p>Sorry that it’s annoyingly lengthy, but implementing this inside
Kpathsea would be a lot of error-prone trouble for something that is
only useful for debugging. If your <code>find</code> does not support
@@ -1436,7 +1387,7 @@
<samp>kpathsea/pathsearch.c</samp>. Two implementation points:
</p>
<ul>
-<li> <a name="index-access-system-call"></a>
+<li> <span id="index-access-system-call"></span>
Kpathsea never tries to check if a given directory resides on a
case-insensitive filesystem, because there is no efficient and
portable way to do so. All it does is try to see if a potential file
@@ -1452,17 +1403,15 @@
<hr>
-<a name="Filename-database"></a>
-<div class="header">
+<span id="Filename-database"></span><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>
</div>
-<a name="Filename-database-_0028ls_002dR_0029"></a>
-<h3 class="section">5.5 Filename database (<code>ls-R</code>)</h3>
+<span id="Filename-database-_0028ls_002dR_0029"></span><h3 class="section">5.5 Filename database (<code>ls-R</code>)</h3>
-<a name="index-filename-database"></a>
-<a name="index-database_002c-for-filenames"></a>
-<a name="index-externally_002dbuilt-filename-database"></a>
+<span id="index-filename-database"></span>
+<span id="index-database_002c-for-filenames"></span>
+<span id="index-externally_002dbuilt-filename-database"></span>
<p>Kpathsea goes to some lengths to minimize disk accesses for searches
(see <a href="#Subdirectory-expansion">Subdirectory expansion</a>). Nevertheless, in practice searching
@@ -1481,26 +1430,24 @@
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.
+<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.
+<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.
+<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>
<hr>
-<a name="ls_002dR"></a>
-<div class="header">
+<span id="ls_002dR"></span><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>
</div>
-<a name="ls_002dR-1"></a>
-<h4 class="subsection">5.5.1 <samp>ls-R</samp></h4>
+<span id="ls_002dR-1"></span><h4 class="subsection">5.5.1 <samp>ls-R</samp></h4>
-<a name="index-ls_002dR-database-file"></a>
-<a name="index-TEXMFDBS"></a>
+<span id="index-ls_002dR-database-file"></span>
+<span id="index-TEXMFDBS"></span>
<p>As mentioned above, you must name the main filename database
<samp>ls-R</samp>. You can put one at the root of each TeX installation
@@ -1515,14 +1462,14 @@
follow symbolic links as necessary, etc. It’s also invoked by the
distributed ‘<samp>mktex…</samp>’ scripts.
</p>
-<a name="index-ls_002dR_002c-simplest-build"></a>
+<span id="index-ls_002dR_002c-simplest-build"></span>
<p>At its simplest, though, you can build <samp>ls-R</samp> with the command
</p><div class="example">
<pre class="example">cd <var>/your/texmf/root</var> && ls -LAR ./ >ls-R
</pre></div>
-<p><a name="index-_002d_002dcolor_003dtty"></a>
-<a name="index-_002fetc_002fprofile-and-aliases"></a>
+<p><span id="index-_002d_002dcolor_003dtty"></span>
+<span id="index-_002fetc_002fprofile-and-aliases"></span>
presuming your <code>ls</code> produces the right output format (see the
section below). GNU <code>ls</code>, for example, outputs in this format.
Also presuming your <code>ls</code> hasn’t been aliased in a system file
@@ -1536,29 +1483,29 @@
changes in the installed files (say if you install a new LaTeX
package), <samp>ls-R</samp> will be automatically updated.
</p>
-<a name="index-_002dA-option-to-ls"></a>
-<a name="index-dot-files"></a>
-<a name="index-_002e-files"></a>
-<a name="index-_002e-directories_002c-ignored"></a>
-<a name="index-_002etex-file_002c-included-in-ls_002dR"></a>
+<span id="index-_002dA-option-to-ls"></span>
+<span id="index-dot-files"></span>
+<span id="index-_002e-files"></span>
+<span id="index-_002e-directories_002c-ignored"></span>
+<span id="index-_002etex-file_002c-included-in-ls_002dR"></span>
<p>The ‘<samp>-A</samp>’ option to <code>ls</code> includes files beginning with ‘<samp>.</samp>’
(except for <samp>.</samp> and <samp>..</samp>), such as the file <samp>.tex</samp>
included with the LaTeX tools package. (On the other hand,
<em>directories</em> whose names begin with ‘<samp>.</samp>’ are always ignored.)
</p>
-<a name="index-symbolic-links_002c-and-ls_002dR"></a>
-<a name="index-_002dL-option-to-ls"></a>
+<span id="index-symbolic-links_002c-and-ls_002dR"></span>
+<span id="index-_002dL-option-to-ls"></span>
<p>If your system does not support symbolic links, omit the ‘<samp>-L</samp>’.
</p>
-<a name="index-automounter_002c-and-ls_002dR"></a>
-<a name="index-NFS-and-ls_002dR"></a>
+<span id="index-automounter_002c-and-ls_002dR"></span>
+<span id="index-NFS-and-ls_002dR"></span>
<p><code>ls -LAR <var>/your/texmf/root</var></code> will also work. But using
‘<samp>./</samp>’ avoids embedding absolute pathnames, so the hierarchy can be
easily transported. It also avoids possible trouble with automounters
or other network filesystem conventions.
</p>
-<a name="index-warning-about-unusable-ls_002dR"></a>
-<a name="index-unusable-ls_002dR-warning"></a>
+<span id="index-warning-about-unusable-ls_002dR"></span>
+<span id="index-unusable-ls_002dR-warning"></span>
<p>Kpathsea warns you if it finds an <samp>ls-R</samp> file, but the file does
not contain any usable entries. The usual culprit is running plain
‘<samp>ls -R</samp>’ instead of ‘<samp>ls -LR ./</samp>’ or ‘<samp>ls -R
@@ -1566,8 +1513,8 @@
name starting with a ‘<samp>.</samp>’ (perhaps if you are using AFS); Kpathsea
ignores everything under such directories.
</p>
-<a name="index-_0021_0021-in-path-specifications"></a>
-<a name="index-disk-searching_002c-avoiding"></a>
+<span id="index-_0021_0021-in-path-specifications"></span>
+<span id="index-disk-searching_002c-avoiding"></span>
<p>Because the database may be out-of-date for a particular run, if a file
is not found in the database, by default Kpathsea goes ahead and
searches the disk. If a particular path element begins with ‘<samp>!!</samp>’,
@@ -1579,16 +1526,14 @@
</p>
<hr>
-<a name="Filename-aliases"></a>
-<div class="header">
+<span id="Filename-aliases"></span><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>
</div>
-<a name="Filename-aliases-1"></a>
-<h4 class="subsection">5.5.2 Filename aliases</h4>
+<span id="Filename-aliases-1"></span><h4 class="subsection">5.5.2 Filename aliases</h4>
-<a name="index-filename-aliases"></a>
-<a name="index-aliases_002c-for-filenames"></a>
+<span id="index-filename-aliases"></span>
+<span id="index-aliases_002c-for-filenames"></span>
<p>In some circumstances, you may wish to find a file under several names.
For example, suppose a TeX document was created using a DOS system
@@ -1616,16 +1561,14 @@
</p>
<hr>
-<a name="Database-format"></a>
-<div class="header">
+<span id="Database-format"></span><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>
</div>
-<a name="Database-format-1"></a>
-<h4 class="subsection">5.5.3 Database format</h4>
+<span id="Database-format-1"></span><h4 class="subsection">5.5.3 Database format</h4>
-<a name="index-format-of-external-database"></a>
-<a name="index-database_002c-format-of"></a>
+<span id="index-format-of-external-database"></span>
+<span id="index-database_002c-format-of"></span>
<p>The “database” read by Kpathsea is a line-oriented file of plain
text. The format is that generated by GNU (and most other) <code>ls</code>
@@ -1670,17 +1613,15 @@
<hr>
-<a name="Invoking-kpsewhich"></a>
-<div class="header">
+<span id="Invoking-kpsewhich"></span><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>
</div>
-<a name="kpsewhich_003a-Standalone-path-searching"></a>
-<h3 class="section">5.6 <code>kpsewhich</code>: Standalone path searching</h3>
+<span id="kpsewhich_003a-Standalone-path-searching"></span><h3 class="section">5.6 <code>kpsewhich</code>: Standalone path searching</h3>
-<a name="index-kpsewhich"></a>
-<a name="index-path-searching_002c-standalone"></a>
-<a name="index-standalone-path-searching"></a>
+<span id="index-kpsewhich"></span>
+<span id="index-path-searching_002c-standalone"></span>
+<span id="index-standalone-path-searching"></span>
<p>The Kpsewhich program exercises the path searching functionality
independent of any particular application. This can also be useful as a
@@ -1699,27 +1640,25 @@
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.
+<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.
+<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.
+<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>’.
+<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>
<hr>
-<a name="Path-searching-options"></a>
-<div class="header">
+<span id="Path-searching-options"></span><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>
</div>
-<a name="Path-searching-options-1"></a>
-<h4 class="subsection">5.6.1 Path searching options</h4>
+<span id="Path-searching-options-1"></span><h4 class="subsection">5.6.1 Path searching options</h4>
-<a name="index-path-searching-options"></a>
+<span id="index-path-searching-options"></span>
<p>Kpsewhich looks up each non-option argument on the command line as a
filename, and returns the first file found.
@@ -1728,16 +1667,18 @@
</p>
<dl compact="compact">
<dt>‘<samp>--all</samp>’</dt>
-<dd><a name="index-_002d_002dall"></a>
-<a name="index-all-matches_002c-finding"></a>
+<dd><span id="index-_002d_002dall"></span>
+<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).
+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><a name="index-_002d_002dcasefold_002dsearch"></a>
-<a name="index-_002d_002dno_002dcasefold_002dsearch"></a>
+<dd><span id="index-_002d_002dcasefold_002dsearch"></span>
+<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 +1689,9 @@
</p>
</dd>
<dt>‘<samp>--dpi=<var>num</var></samp>’</dt>
-<dd><a name="index-_002d_002ddpi_003dnum"></a>
-<a name="index-_002dD-num"></a>
-<a name="index-resolution_002c-setting"></a>
+<dd><span id="index-_002d_002ddpi_003dnum"></span>
+<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.
@@ -1757,8 +1698,8 @@
</p>
</dd>
<dt>‘<samp>--engine=<var>name</var></samp>’</dt>
-<dd><a name="index-_002d_002dengine_003dname"></a>
-<a name="index-engine-name"></a>
+<dd><span id="index-_002d_002dengine_003dname"></span>
+<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.
@@ -1777,7 +1718,7 @@
</p>
</dd>
<dt>‘<samp>--format=<var>name</var></samp>’</dt>
-<dd><a name="index-_002d_002dformat_003dname"></a>
+<dd><span id="index-_002d_002dformat_003dname"></span>
<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
@@ -1862,8 +1803,8 @@
</p>
</dd>
<dt>‘<samp>--interactive</samp>’</dt>
-<dd><a name="index-_002d_002dinteractive"></a>
-<a name="index-interactive-query"></a>
+<dd><span id="index-_002d_002dinteractive"></span>
+<span id="index-interactive-query"></span>
<p>After processing the command line, read additional filenames to look up
from standard input.
</p>
@@ -1870,8 +1811,8 @@
</dd>
<dt>‘<samp>--mktex=<var>filetype</var></samp>’</dt>
<dt>‘<samp>--no-mktex=<var>filetype</var></samp>’</dt>
-<dd><a name="index-_002d_002dmktex_003dfiletype"></a>
-<a name="index-_002d_002dno_002dmktex_003dfiletype"></a>
+<dd><span id="index-_002d_002dmktex_003dfiletype"></span>
+<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
@@ -1880,13 +1821,13 @@
</p>
</dd>
<dt>‘<samp>--mode=<var>string</var></samp>’</dt>
-<dd><a name="index-_002d_002dmode_003dstring"></a>
+<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>.
</p>
</dd>
<dt>‘<samp>--must-exist</samp>’</dt>
-<dd><a name="index-_002d_002dmust_002dexist"></a>
+<dd><span id="index-_002d_002dmust_002dexist"></span>
<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.
@@ -1893,7 +1834,7 @@
</p>
</dd>
<dt>‘<samp>--path=<var>string</var></samp>’</dt>
-<dd><a name="index-_002d_002dpath_003dstring"></a>
+<dd><span id="index-_002d_002dpath_003dstring"></span>
<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
@@ -1903,7 +1844,7 @@
</p>
</dd>
<dt>‘<samp>--progname=<var>name</var></samp>’</dt>
-<dd><a name="index-_002d_002dprogname_003dname"></a>
+<dd><span id="index-_002d_002dprogname_003dname"></span>
<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>).
@@ -1910,7 +1851,7 @@
</p>
</dd>
<dt>‘<samp>--subdir=<var>string</var></samp>’</dt>
-<dd><a name="index-_002d_002dsubdir_003dstring"></a>
+<dd><span id="index-_002d_002dsubdir_003dstring"></span>
<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
@@ -1990,13 +1931,11 @@
<hr>
-<a name="Specially_002drecognized-files"></a>
-<div class="header">
+<span id="Specially_002drecognized-files"></span><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>
</div>
-<a name="Specially_002drecognized-files-for-kpsewhich"></a>
-<h4 class="subsection">5.6.2 Specially-recognized files for <code>kpsewhich</code></h4>
+<span id="Specially_002drecognized-files-for-kpsewhich"></span><h4 class="subsection">5.6.2 Specially-recognized files for <code>kpsewhich</code></h4>
<p><code>kpsewhich</code> recognizes a few special filenames on the command
line and defaults to using the ‘known’ file formats for them, merely
@@ -2010,49 +1949,49 @@
</p>
<dl compact="compact">
<dd>
-<a name="index-config_002eps"></a>
+<span id="index-config_002eps"></span>
</dd>
<dt><samp>config.ps</samp></dt>
<dd><p><code>dvips config</code>
</p>
-<a name="index-dvipdfmx_002ecfg"></a>
+<span id="index-dvipdfmx_002ecfg"></span>
</dd>
<dt><samp>dvipdfmx.cfg</samp></dt>
<dd><p>‘<samp>other text files</samp>’
</p>
-<a name="index-fmtutil_002ecnf"></a>
+<span id="index-fmtutil_002ecnf"></span>
</dd>
<dt><samp>fmtutil.cnf</samp></dt>
<dd><p>‘<samp>web2c files</samp>’
</p>
-<a name="index-glyphlist_002etxt"></a>
+<span id="index-glyphlist_002etxt"></span>
</dd>
<dt><samp>glyphlist.txt</samp></dt>
<dd><p>‘<samp>map</samp>’
</p>
-<a name="index-mktex_002ecnf"></a>
+<span id="index-mktex_002ecnf"></span>
</dd>
<dt><samp>mktex.cnf</samp></dt>
<dd><p>‘<samp>web2c files</samp>’
</p>
-<a name="index-pdfglyphlist_002etxt"></a>
+<span id="index-pdfglyphlist_002etxt"></span>
</dd>
<dt><samp>pdfglyphlist.txt</samp></dt>
<dd><p>‘<samp>map</samp>’
</p>
-<a name="index-pdftex_002ecfg"></a>
-<a name="index-pdftexconfig_002etex"></a>
+<span id="index-pdftex_002ecfg"></span>
+<span id="index-pdftexconfig_002etex"></span>
</dd>
<dt><samp>pdftex.cfg</samp></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>
-<a name="index-texmf_002ecnf"></a>
+<span id="index-texmf_002ecnf"></span>
</dd>
<dt><samp>texmf.cnf</samp></dt>
<dd><p>‘<samp>cnf</samp>’
</p>
-<a name="index-XDvi"></a>
+<span id="index-XDvi"></span>
</dd>
<dt><samp>XDvi</samp></dt>
<dd><p>‘<samp>other text files</samp>’
@@ -2062,7 +2001,7 @@
<p>A user-specified format will override the above defaults.
</p>
-<a name="index-tcfmgr_002emap"></a>
+<span id="index-tcfmgr_002emap"></span>
<p>Another useful configuration file in this regard is <samp>tcfmgr.map</samp>,
found in <samp>texmf/texconfig/tcfmgr.map</samp>, which records various
information about the above configuration files (among others).
@@ -2069,31 +2008,30 @@
</p>
<hr>
-<a name="Auxiliary-tasks"></a>
-<div class="header">
+<span id="Auxiliary-tasks"></span><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>
</div>
-<a name="Auxiliary-tasks-1"></a>
-<h4 class="subsection">5.6.3 Auxiliary tasks</h4>
+<span id="Auxiliary-tasks-1"></span><h4 class="subsection">5.6.3 Auxiliary tasks</h4>
-<a name="index-auxiliary-tasks"></a>
+<span id="index-auxiliary-tasks"></span>
<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><a name="index-_002d_002ddebug_003dnum"></a>
+<dd><span id="index-_002d_002ddebug_003dnum"></span>
<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><a name="index-_002d_002dexpand_002dbraces_003dstring"></a>
-<p>Output variable and brace expansion of <var>string</var>. See <a href="#Path-expansion">Path expansion</a>.
+<dd><span id="index-_002d_002dexpand_002dbraces_003dstring"></span>
+<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><a name="index-_002d_002dexpand_002dpath_003dstring"></a>
+<dd><span id="index-_002d_002dexpand_002dpath_003dstring"></span>
<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
@@ -2111,19 +2049,21 @@
</pre></div>
<p>For one-shot uses of an arbitrary (not built in to Kpathsea) path, see
-‘<samp>--path</samp>’ (see <a href="#Path-searching-options">Path searching options</a>)
+‘<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><a name="index-_002d_002dexpand_002dvar_003dstring"></a>
-<p>Output the variable and tilde expansion of <var>string</var>
-the ‘<samp>mktex…</samp>’ scripts run ‘<samp>kpsewhich
---expand-var='$TEXMF'</samp>’ to find the root of the TeX system
-hierarchy. See <a href="#Path-expansion">Path expansion</a>.
+<dd><span id="index-_002d_002dexpand_002dvar_003dstring"></span>
+<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
+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><a name="index-_002d_002dhelp_002dformats"></a>
+<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
looked for, and the original path.
</p>
@@ -2130,8 +2070,8 @@
</dd>
<dt>‘<samp>--safe-in-name=<var>name</var></samp>’</dt>
<dt>‘<samp>--safe-out-name=<var>name</var></samp>’</dt>
-<dd><a name="index-_002d_002dsafe_002din_002dname_003dname"></a>
-<a name="index-_002d_002dsafe_002dout_002dname_003dname"></a>
+<dd><span id="index-_002d_002dsafe_002din_002dname_003dname"></span>
+<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
@@ -2139,7 +2079,7 @@
</p>
</dd>
<dt>‘<samp>--show-path=<var>name</var></samp>’</dt>
-<dd><a name="index-_002d_002dshow_002dpath_003dname"></a>
+<dd><span id="index-_002d_002dshow_002dpath_003dname"></span>
<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
@@ -2146,49 +2086,70 @@
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>’
+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
+current system in the expansion.
+</p>
+<p>Example: ‘<samp>FOO='.;~' kpsewhich --var-brace-value=FOO</samp>’ outputs (on
+a Unix-ish system) ‘<samp>.:/home/karl</samp>’, supposing the latter is the
+current user’s home directory. Note that the ‘<samp>;</samp>’ in the source
+value, as commonly used in <samp>texmf.cnf</samp>, has changed to a
+‘<samp>:</samp>’, as the normal path separator on the current system. (On a
+Windows-ish system, the ‘<samp>;</samp>’ would remain.)
+</p>
+</dd>
<dt>‘<samp>--var-value=<var>variable</var></samp>’</dt>
-<dd><a name="index-_002d_002dvar_002dvalue_003dvariable"></a>
+<dd><span id="index-_002d_002dvar_002dvalue_003dvariable"></span>
<p>Outputs the value of <var>variable</var> (a simple identifier like
-‘<samp>TEXMF</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, but not performing other expansions.
+‘<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
+expansion, but not arbitrarily within the string. Braces are not expanded.
</p>
+<p>Example: ‘<samp>--var-value=texmf_casefold_search</samp>’ outputs (if the
+default is not changed) ‘<samp>1</samp>’.
+</p>
+<p>Example to contrast with ‘<samp>--var-brace-value</samp>’: ‘<samp>FOO='.;~'
+kpsewhich --var-value=FOO</samp>’ outputs ‘<samp>.;~</samp>’, i.e., the same as the
+input value.
+</p>
</dd>
</dl>
<hr>
-<a name="Standard-options"></a>
-<div class="header">
+<span id="Standard-options"></span><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>
</div>
-<a name="Standard-options-1"></a>
-<h4 class="subsection">5.6.4 Standard options</h4>
+<span id="Standard-options-1"></span><h4 class="subsection">5.6.4 Standard options</h4>
-<a name="index-standard-options"></a>
+<span id="index-standard-options"></span>
<p>Kpsewhich accepts the standard GNU options:
</p>
<ul>
-<li> <a name="index-_002d_002dhelp"></a>
+<li> <span id="index-_002d_002dhelp"></span>
‘<samp>--help</samp>’ prints a help message on standard output and exits
successfully.
-</li><li> <a name="index-_002d_002dversion"></a>
+</li><li> <span id="index-_002d_002dversion"></span>
‘<samp>--version</samp>’ prints the Kpathsea version number and exits successfully.
</li></ul>
<hr>
-<a name="TeX-support"></a>
-<div class="header">
+<span id="TeX-support"></span><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>
</div>
-<a name="TeX-support-1"></a>
-<h2 class="chapter">6 TeX support</h2>
+<span id="TeX-support-1"></span><h2 class="chapter">6 TeX support</h2>
-<a name="index-TeX-support"></a>
+<span id="index-TeX-support"></span>
<p>Although the basic features in Kpathsea can be used for any type of
path searching, it came about, as usual, with a specific application
@@ -2209,33 +2170,31 @@
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.
+<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.
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Supported-file-formats"></a>
-<div class="header">
+<span id="Supported-file-formats"></span><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>
-<a name="Supported-file-formats-1"></a>
-<h3 class="section">6.1 Supported file formats</h3>
+<span id="Supported-file-formats-1"></span><h3 class="section">6.1 Supported file formats</h3>
-<a name="index-supported-file-formats"></a>
-<a name="index-file-formats_002c-supported"></a>
+<span id="index-supported-file-formats"></span>
+<span id="index-file-formats_002c-supported"></span>
-<a name="index-environment-variables-for-TeX"></a>
-<a name="index-TeX-environment-variables"></a>
+<span id="index-environment-variables-for-TeX"></span>
+<span id="index-TeX-environment-variables"></span>
<p>Kpathsea has support for a number of file types. Each file type has a
list of environment and config file variables that are checked to define
@@ -2243,7 +2202,7 @@
finding files (see the next section). Some also define additional
suffixes, and/or a program to be run to create missing files on the fly.
</p>
-<a name="index-program_002dvarying-paths"></a>
+<span id="index-program_002dvarying-paths"></span>
<p>Since environment variables containing periods, such as
‘<samp>TEXINPUTS.latex</samp>’, are not allowed on some systems, Kpathsea looks
for environment variables with an underscore, e.g.,
@@ -2255,34 +2214,34 @@
</p>
<dl compact="compact">
<dt>‘<samp>afm</samp>’</dt>
-<dd><a name="index-_002eafm"></a>
-<a name="index-AFMFONTS"></a>
-<p>(Adobe font metrics, see <a href="http://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
+<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>)
<code>AFMFONTS</code>;
suffix ‘<samp>.afm</samp>’.
</p>
</dd>
<dt>‘<samp>base</samp>’</dt>
-<dd><a name="index-_002ebase"></a>
-<a name="index-MFBASES"></a>
-<a name="index-TEXMFINI"></a>
-<p>(Metafont memory dump, see <a href="http://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
+<dd><span id="index-_002ebase"></span>
+<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>)
<code>MFBASES</code>, <code>TEXMFINI</code>;
suffix ‘<samp>.base</samp>’.
</p>
</dd>
<dt>‘<samp>bib</samp>’</dt>
-<dd><a name="index-_002ebib"></a>
-<a name="index-BIBINPUTS"></a>
-<a name="index-TEXBIB"></a>
-<p>(BibTeX bibliography source, see <a href="http://tug.org/texinfohtml/web2c.html#bibtex-invocation">bibtex invocation</a> in <cite>Web2c</cite>)
+<dd><span id="index-_002ebib"></span>
+<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>)
<code>BIBINPUTS</code>, <code>TEXBIB</code>;
suffix ‘<samp>.bib</samp>’.
</p>
</dd>
<dt>‘<samp>bltxml</samp>’</dt>
-<dd><a name="index-_002ebltxml"></a>
-<a name="index-BLTXMLINPUTS"></a>
+<dd><span id="index-_002ebltxml"></span>
+<span id="index-BLTXMLINPUTS"></span>
<p>(BibLaTeXML bibliography files for Biber, <a href="http://ctan.org/pkg/biber">http://ctan.org/pkg/biber</a>)
<code>BLTXMLINPUTS</code>
suffix ‘<samp>.bltxml</samp>’.
@@ -2289,9 +2248,9 @@
</p>
</dd>
<dt>‘<samp>bst</samp>’</dt>
-<dd><a name="index-_002ebst"></a>
-<a name="index-BSTINPUTS"></a>
-<p>(BibTeX style, see <a href="http://tug.org/texinfohtml/web2c.html#Basic-BibTeX-style-files">Basic BibTeX
+<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
style files</a> in <cite>Web2c</cite>)
<code>BSTINPUTS</code>;
suffix ‘<samp>.bst</samp>’.
@@ -2298,9 +2257,9 @@
</p>
</dd>
<dt>‘<samp>clua</samp>’</dt>
-<dd><a name="index-_002edll"></a>
-<a name="index-_002eso"></a>
-<a name="index-CLUAINPUTS"></a>
+<dd><span id="index-_002edll"></span>
+<span id="index-_002eso"></span>
+<span id="index-CLUAINPUTS"></span>
<p>(dynamic libraries for Lua, <a href="http://ctan.org/pkg/luatex">http://ctan.org/pkg/luatex</a>)
<code>CLUAINPUTS</code>
suffixes ‘<samp>.dll</samp>’ and ‘<samp>.so</samp>’.
@@ -2307,8 +2266,8 @@
</p>
</dd>
<dt>‘<samp>cmap</samp>’</dt>
-<dd><a name="index-_002ecmap"></a>
-<a name="index-CMAPFONTS"></a>
+<dd><span id="index-_002ecmap"></span>
+<span id="index-CMAPFONTS"></span>
<p>(character map files)
<code>CMAPFONTS</code>;
suffix ‘<samp>.cmap</samp>’.
@@ -2315,8 +2274,8 @@
</p>
</dd>
<dt>‘<samp>cnf</samp>’</dt>
-<dd><a name="index-_002ecnf"></a>
-<a name="index-TEXMFCNF-1"></a>
+<dd><span id="index-_002ecnf"></span>
+<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>’.
@@ -2323,9 +2282,9 @@
</p>
</dd>
<dt>‘<samp>cweb</samp>’</dt>
-<dd><a name="index-_002ew"></a>
-<a name="index-_002eweb"></a>
-<a name="index-CWEBINPUTS"></a>
+<dd><span id="index-_002ew"></span>
+<span id="index-_002eweb"></span>
+<span id="index-CWEBINPUTS"></span>
<p>(CWEB input files)
<code>CWEBINPUTS</code>;
suffixes ‘<samp>.w</samp>’, ‘<samp>.web</samp>’;
@@ -2333,16 +2292,16 @@
</p>
</dd>
<dt>‘<samp>dvips config</samp>’</dt>
-<dd><a name="index-TEXCONFIG"></a>
-<a name="index-config_002eps_002c-search-path-for"></a>
-<p>(Dvips ‘<samp>config.*</samp>’ files, such as <samp>config.ps</samp>, see <a href="http://tug.org/texinfohtml/dvips.html#Config-files">Config
+<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
files</a> in <cite>Dvips</cite>)
<code>TEXCONFIG</code>.
</p>
</dd>
<dt>‘<samp>enc files</samp>’</dt>
-<dd><a name="index-_002eenc"></a>
-<a name="index-ENCFONTS"></a>
+<dd><span id="index-_002eenc"></span>
+<span id="index-ENCFONTS"></span>
<p>(encoding vectors)
<code>ENCFONTS</code>;
suffix ‘<samp>.enc</samp>’.
@@ -2349,17 +2308,17 @@
</p>
</dd>
<dt>‘<samp>fmt</samp>’</dt>
-<dd><a name="index-_002efmt"></a>
-<a name="index-TEXFORMATS"></a>
-<a name="index-TEXMFINI-1"></a>
-<p>(TeX memory dump, see <a href="http://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
+<dd><span id="index-_002efmt"></span>
+<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>)
<code>TEXFORMATS</code>, <code>TEXMFINI</code>;
suffix ‘<samp>.fmt</samp>’.
</p>
</dd>
<dt>‘<samp>font cid map</samp>’</dt>
-<dd><a name="index-_002ecid"></a>
-<a name="index-FONTCIDMAPS"></a>
+<dd><span id="index-_002ecid"></span>
+<span id="index-FONTCIDMAPS"></span>
<p>(CJK mapping)
<code>FONTCIDMAPS</code>
suffix ‘<samp>.cid</samp>’.
@@ -2366,8 +2325,8 @@
</p>
</dd>
<dt>‘<samp>font feature files</samp>’</dt>
-<dd><a name="index-_002efea"></a>
-<a name="index-FONTFEATURES"></a>
+<dd><span id="index-_002efea"></span>
+<span id="index-FONTFEATURES"></span>
<p>(primarily for OpenType font features)
<code>FONTFEATURES</code>
suffix ‘<samp>.fea</samp>’.
@@ -2374,29 +2333,29 @@
</p>
</dd>
<dt>‘<samp>gf</samp>’</dt>
-<dd><a name="index-gf"></a>
-<a name="index-GFFONTS"></a>
-<a name="index-GLYPHFONTS"></a>
-<a name="index-TEXFONTS"></a>
-<p>(generic font bitmap, see <a href="http://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
+<dd><span id="index-gf"></span>
+<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>)
<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><a name="index-_002eeps"></a>
-<a name="index-_002eepsi"></a>
-<a name="index-TEXPICTS"></a>
-<a name="index-TEXINPUTS"></a>
-<p>(Encapsulated PostScript figures, see <a href="http://tug.org/texinfohtml/dvips.html#PostScript-figures">PostScript figures</a> in <cite>Dvips</cite>)
+<dd><span id="index-_002eeps"></span>
+<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>)
<code>TEXPICTS</code>, <code>TEXINPUTS</code>;
additional suffixes: ‘<samp>.eps</samp>’, ‘<samp>.epsi</samp>’.
</p>
</dd>
<dt>‘<samp>ist</samp>’</dt>
-<dd><a name="index-_002eist"></a>
-<a name="index-TEXINDEXSTYLE"></a>
-<a name="index-INDEXSTYLE"></a>
+<dd><span id="index-_002eist"></span>
+<span id="index-TEXINDEXSTYLE"></span>
+<span id="index-INDEXSTYLE"></span>
<p>(makeindex style files)
<code>TEXINDEXSTYLE</code>, <code>INDEXSTYLE</code>;
suffix ‘<samp>.ist</samp>’.
@@ -2403,8 +2362,8 @@
</p>
</dd>
<dt>‘<samp>lig files</samp>’</dt>
-<dd><a name="index-_002elig"></a>
-<a name="index-LIGFONTS"></a>
+<dd><span id="index-_002elig"></span>
+<span id="index-LIGFONTS"></span>
<p>(ligature definition files)
<code>LIGFONTS</code>;
suffix ‘<samp>.lig</samp>’.
@@ -2411,15 +2370,15 @@
</p>
</dd>
<dt>‘<samp>ls-R</samp>’</dt>
-<dd><a name="index-ls_002dR"></a>
-<a name="index-TEXMFDBS-1"></a>
+<dd><span id="index-ls_002dR"></span>
+<span id="index-TEXMFDBS-1"></span>
<p>(Filename databases, see <a href="#Filename-database">Filename database</a>)
<code>TEXMFDBS</code>.
</p>
</dd>
<dt>‘<samp>map</samp>’</dt>
-<dd><a name="index-_002emap"></a>
-<a name="index-TEXFONTMAPS"></a>
+<dd><span id="index-_002emap"></span>
+<span id="index-TEXFONTMAPS"></span>
<p>(Fontmaps, see <a href="#Fontmap">Fontmap</a>)
<code>TEXFONTMAPS</code>;
suffix ‘<samp>.map</samp>’.
@@ -2426,24 +2385,24 @@
</p>
</dd>
<dt>‘<samp>mem</samp>’</dt>
-<dd><a name="index-_002emem"></a>
-<a name="index-MPMEMS"></a>
-<a name="index-TEXMFINI-2"></a>
-<p>(MetaPost memory dump, see <a href="http://tug.org/texinfohtml/web2c.html#Memory-dumps">Memory dumps</a> in <cite>Web2c</cite>)
+<dd><span id="index-_002emem"></span>
+<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>)
<code>MPMEMS</code>, <code>TEXMFINI</code>;
suffix ‘<samp>.mem</samp>’.
</p>
</dd>
<dt>‘<samp><span class="roman">MetaPost support</span></samp>’</dt>
-<dd><a name="index-MPSUPPORT"></a>
-<p>(MetaPost support files, used by DMP; see <a href="http://tug.org/texinfohtml/web2c.html#dmp-invocation">dmp invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>MPSUPPORT</code>.
</p>
</dd>
<dt>‘<samp>mf</samp>’</dt>
-<dd><a name="index-_002emf"></a>
-<a name="index-MFINPUTS"></a>
-<p>(Metafont source, see <a href="http://tug.org/texinfohtml/web2c.html#mf-invocation">mf invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>MFINPUTS</code>;
suffix ‘<samp>.mf</samp>’;
dynamic creation program: <code>mktexmf</code>.
@@ -2450,32 +2409,32 @@
</p>
</dd>
<dt>‘<samp>mfpool</samp>’</dt>
-<dd><a name="index-_002epool"></a>
-<a name="index-MFPOOL"></a>
-<p>(Metafont program strings, see <a href="http://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>MFPOOL</code>, <code>TEXMFINI</code>;
suffix ‘<samp>.pool</samp>’.
</p>
</dd>
<dt>‘<samp>mft</samp>’</dt>
-<dd><a name="index-_002emft"></a>
-<a name="index-MFTINPUTS"></a>
-<p>(<code>MFT</code> style file, see <a href="http://tug.org/texinfohtml/web2c.html#mft-invocation">mft invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>MFTINPUTS</code>;
suffix ‘<samp>.mft</samp>’.
</p>
</dd>
<dt>‘<samp>misc fonts</samp>’</dt>
-<dd><a name="index-MISCFONTS"></a>
+<dd><span id="index-MISCFONTS"></span>
<p>(font-related files that don’t fit the other categories)
<code>MISCFONTS</code>
</p>
</dd>
<dt>‘<samp>mlbib</samp>’</dt>
-<dd><a name="index-_002emlbib"></a>
-<a name="index-MLBIBINPUTS"></a>
-<a name="index-BIBINPUTS-1"></a>
-<a name="index-TEXBIB-1"></a>
+<dd><span id="index-_002emlbib"></span>
+<span id="index-MLBIBINPUTS"></span>
+<span id="index-BIBINPUTS-1"></span>
+<span id="index-TEXBIB-1"></span>
<p>(MlBibTeX bibliography source)
<code>MLBIBINPUTS</code>, <code>BIBINPUTS</code>, <code>TEXBIB</code>;
suffixes ‘<samp>.mlbib</samp>’, ‘<samp>.mlbib</samp>’.
@@ -2482,9 +2441,9 @@
</p>
</dd>
<dt>‘<samp>mlbst</samp>’</dt>
-<dd><a name="index-_002emlbst"></a>
-<a name="index-MLBSTINPUTS"></a>
-<a name="index-BSTINPUTS-1"></a>
+<dd><span id="index-_002emlbst"></span>
+<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>’.
@@ -2491,24 +2450,24 @@
</p>
</dd>
<dt>‘<samp>mp</samp>’</dt>
-<dd><a name="index-_002emp"></a>
-<a name="index-MPINPUTS"></a>
-<p>(MetaPost source, see <a href="http://tug.org/texinfohtml/web2c.html#mpost-invocation">mpost invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>MPINPUTS</code>;
suffix ‘<samp>.mp</samp>’.
</p>
</dd>
<dt>‘<samp>mppool</samp>’</dt>
-<dd><a name="index-_002epool-1"></a>
-<a name="index-MPPOOL"></a>
-<p>(MetaPost program strings, see <a href="http://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>MPPOOL</code>, <code>TEXMFINI</code>;
suffix ‘<samp>.pool</samp>’.
</p>
</dd>
<dt>‘<samp>ocp</samp>’</dt>
-<dd><a name="index-_002eocp"></a>
-<a name="index-OCPINPUTS"></a>
+<dd><span id="index-_002eocp"></span>
+<span id="index-OCPINPUTS"></span>
<p>(Omega compiled process files)
<code>OCPINPUTS</code>; <br>
suffix ‘<samp>.ocp</samp>’;
@@ -2516,8 +2475,8 @@
</p>
</dd>
<dt>‘<samp>ofm</samp>’</dt>
-<dd><a name="index-_002eofm"></a>
-<a name="index-OFMFONTS"></a>
+<dd><span id="index-_002eofm"></span>
+<span id="index-OFMFONTS"></span>
<p>(Omega font metrics)
<code>OFMFONTS</code>, <code>TEXFONTS</code>; <br>
suffixes ‘<samp>.ofm</samp>’, ‘<samp>.tfm</samp>’;
@@ -2525,13 +2484,13 @@
</p>
</dd>
<dt>‘<samp>opentype fonts</samp>’</dt>
-<dd><a name="index-OPENTYPEFONTS"></a>
+<dd><span id="index-OPENTYPEFONTS"></span>
<p>(OpenType fonts)
<code>OPENTYPEFONTS</code>.
</p>
</dd>
<dt>‘<samp>opl</samp>’</dt>
-<dd><a name="index-_002eopl"></a>
+<dd><span id="index-_002eopl"></span>
<p>(Omega property lists)
<code>OPLFONTS</code>, <code>TEXFONTS</code>;
suffix ‘<samp>.opl</samp>’.
@@ -2538,8 +2497,8 @@
</p>
</dd>
<dt>‘<samp>otp</samp>’</dt>
-<dd><a name="index-_002eotp"></a>
-<a name="index-OTPINPUTS"></a>
+<dd><span id="index-_002eotp"></span>
+<span id="index-OTPINPUTS"></span>
<p>(Omega translation process files)
<code>OTPINPUTS</code>;
suffix ‘<samp>.otp</samp>’.
@@ -2546,8 +2505,8 @@
</p>
</dd>
<dt>‘<samp>ovf</samp>’</dt>
-<dd><a name="index-_002eovf"></a>
-<a name="index-OVFFONTS"></a>
+<dd><span id="index-_002eovf"></span>
+<span id="index-OVFFONTS"></span>
<p>(Omega virtual fonts)
<code>OVFFONTS</code>, <code>TEXFONTS</code>;
suffix ‘<samp>.ovf</samp>’.
@@ -2554,8 +2513,8 @@
</p>
</dd>
<dt>‘<samp>ovp</samp>’</dt>
-<dd><a name="index-_002eovp"></a>
-<a name="index-OVPFONTS"></a>
+<dd><span id="index-_002eovp"></span>
+<span id="index-OVPFONTS"></span>
<p>(Omega virtual property lists)
<code>OVPFONTS</code>, <code>TEXFONTS</code>;
suffix ‘<samp>.ovp</samp>’.
@@ -2562,18 +2521,18 @@
</p>
</dd>
<dt>‘<samp>pdftex config</samp>’</dt>
-<dd><a name="index-PDFTEXCONFIG"></a>
+<dd><span id="index-PDFTEXCONFIG"></span>
<p>(PDFTeX-specific configuration files)
<code>PDFTEXCONFIG</code>.
</p>
</dd>
<dt>‘<samp>pk</samp>’</dt>
-<dd><a name="index-_002epk"></a>
-<a name="index-PKFONTS"></a>
-<a name="index-TEXPKS"></a>
-<a name="index-GLYPHFONTS-1"></a>
-<a name="index-TEXFONTS-1"></a>
-<p>(packed bitmap fonts, see <a href="http://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
+<dd><span id="index-_002epk"></span>
+<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>)
<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>’;
@@ -2581,17 +2540,17 @@
</p>
</dd>
<dt>‘<samp>PostScript header</samp>’</dt>
-<dd><a name="index-_002epro"></a>
-<a name="index-TEXPSHEADERS"></a>
-<a name="index-PSHEADERS"></a>
-<p>(downloadable PostScript, see <a href="http://tug.org/texinfohtml/dvips.html#Header-files">Header files</a> in <cite>Dvips</cite>)
+<dd><span id="index-_002epro"></span>
+<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>)
<code>TEXPSHEADERS</code>, <code>PSHEADERS</code>;
additional suffix ‘<samp>.pro</samp>’.
</p>
</dd>
<dt>‘<samp>ris</samp>’</dt>
-<dd><a name="index-_002eris"></a>
-<a name="index-RISINPUTS"></a>
+<dd><span id="index-_002eris"></span>
+<span id="index-RISINPUTS"></span>
<p>(RIS bibliography files, primarily for Biber, <a href="http://ctan.org/pkg/biber">http://ctan.org/pkg/biber</a>)
<code>RISINPUTS</code>
suffix ‘<samp>.ris</samp>’.
@@ -2598,8 +2557,8 @@
</p>
</dd>
<dt>‘<samp>subfont definition files</samp>’</dt>
-<dd><a name="index-_002esfd"></a>
-<a name="index-SFDFONTS"></a>
+<dd><span id="index-_002esfd"></span>
+<span id="index-SFDFONTS"></span>
<p>(subfont definition files)
<code>SFDFONTS</code>
suffix ‘<samp>.sfd</samp>’.
@@ -2606,9 +2565,9 @@
</p>
</dd>
<dt>‘<samp>tex</samp>’</dt>
-<dd><a name="index-_002etex"></a>
-<a name="index-TEXINPUTS-1"></a>
-<p>(TeX source, see <a href="http://tug.org/texinfohtml/web2c.html#tex-invocation">tex invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>TEXINPUTS</code>;
suffix ‘<samp>.tex</samp>’;
additional suffixes: none, because such a list cannot be complete;
@@ -2616,38 +2575,38 @@
</p>
</dd>
<dt>‘<samp>TeX system documentation</samp>’</dt>
-<dd><a name="index-doc-files"></a>
-<a name="index-TEXDOCS"></a>
+<dd><span id="index-doc-files"></span>
+<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><a name="index-source-files"></a>
-<a name="index-TEXSOURCES"></a>
+<dd><span id="index-source-files"></span>
+<span id="index-TEXSOURCES"></span>
<p>(Source files for the TeX system)
<code>TEXSOURCES</code>.
</p>
</dd>
<dt>‘<samp>texmfscripts</samp>’</dt>
-<dd><a name="index-TEXMFSCRIPTS"></a>
+<dd><span id="index-TEXMFSCRIPTS"></span>
<p>(Architecture-independent executables distributed in the texmf trees)
<code>TEXMFSCRIPTS</code>.
</p>
</dd>
<dt>‘<samp>texpool</samp>’</dt>
-<dd><a name="index-_002epool-2"></a>
-<a name="index-TEXPOOL"></a>
-<p>(TeX program strings, see <a href="http://tug.org/texinfohtml/web2c.html#pooltype-invocation">pooltype invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>TEXPOOL</code>, <code>TEXMFINI</code>;
suffix ‘<samp>.pool</samp>’.
</p>
</dd>
<dt>‘<samp>tfm</samp>’</dt>
-<dd><a name="index-_002etfm"></a>
-<a name="index-TFMFONTS"></a>
-<a name="index-TEXFONTS-2"></a>
-<p>(TeX font metrics, see <a href="http://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>)
+<dd><span id="index-_002etfm"></span>
+<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>)
<code>TFMFONTS</code>, <code>TEXFONTS</code>;
suffix ‘<samp>.tfm</samp>’;
dynamic creation program: <code>mktextfm</code>.
@@ -2654,48 +2613,48 @@
</p>
</dd>
<dt>‘<samp>Troff fonts</samp>’</dt>
-<dd><a name="index-TRFONTS"></a>
-<p>(Troff fonts, used by DMP; see <a href="http://tug.org/texinfohtml/web2c.html#DMP-invocation">DMP invocation</a> in <cite>Web2c</cite>)
+<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>)
<code>TRFONTS</code>.
</p>
</dd>
<dt>‘<samp>truetype fonts</samp>’</dt>
-<dd><a name="index-_002ettf"></a>
-<a name="index-_002ettc"></a>
-<a name="index-TTFONTS"></a>
+<dd><span id="index-_002ettf"></span>
+<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><a name="index-_002epfa"></a>
-<a name="index-_002epfb"></a>
-<a name="index-T1FONTS"></a>
-<a name="index-T1INPUTS"></a>
-<a name="index-TEXPSHEADERS-1"></a>
-<a name="index-DVIPSHEADERS"></a>
-<p>(Type 1 PostScript outline fonts, see <a href="http://tug.org/texinfohtml/dvips.html#Glyph-files">Glyph files</a> in <cite>Dvips</cite>)
+<dd><span id="index-_002epfa"></span>
+<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>)
<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><a name="index-T42FONTS"></a>
+<dd><span id="index-T42FONTS"></span>
<p>(Type 42 PostScript outline fonts) <code>T42FONTS</code>.
</p>
</dd>
<dt>‘<samp>vf</samp>’</dt>
-<dd><a name="index-_002evf"></a>
-<a name="index-VFFONTS"></a>
-<a name="index-TEXFONTS-3"></a>
-<p>(virtual fonts, see <a href="http://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>)
+<dd><span id="index-_002evf"></span>
+<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>)
<code>VFFONTS</code>, <code>TEXFONTS</code>;
suffix ‘<samp>.vf</samp>’.
</p>
</dd>
<dt>‘<samp>web</samp>’</dt>
-<dd><a name="index-_002eweb-1"></a>
-<a name="index-WEBINPUTS"></a>
+<dd><span id="index-_002eweb-1"></span>
+<span id="index-WEBINPUTS"></span>
<p>(WEB input files)
<code>WEBINPUTS</code>;
suffix ‘<samp>.web</samp>’;
@@ -2703,7 +2662,7 @@
</p>
</dd>
<dt>‘<samp>web2c files</samp>’</dt>
-<dd><a name="index-WEB2C"></a>
+<dd><span id="index-WEB2C"></span>
<p>(files specific to the web2c implementation)
<code>WEB2C</code>.
</p></dd>
@@ -2717,13 +2676,13 @@
</p>
<dl compact="compact">
<dt>‘<samp>other text files</samp>’</dt>
-<dd><a name="index-FOOINPUTS"></a>
+<dd><span id="index-FOOINPUTS"></span>
<p>(text files used by ‘<samp>foo</samp>’)
<code>FOOINPUTS</code>.
</p>
</dd>
<dt>‘<samp>other binary files</samp>’</dt>
-<dd><a name="index-FOOINPUTS-1"></a>
+<dd><span id="index-FOOINPUTS-1"></span>
<p>(binary files used by ‘<samp>foo</samp>’)
<code>FOOINPUTS</code>.
</p></dd>
@@ -2742,8 +2701,8 @@
</li><li> Each font format has a variable of its own.
-</li><li> <a name="index-XDVIFONTS"></a>
-<a name="index-DVIPSFONTS"></a>
+</li><li> <span id="index-XDVIFONTS"></span>
+<span id="index-DVIPSFONTS"></span>
Each program has its own font override path as well; e.g.,
<code>DVIPSFONTS</code> for Dvipsk. Again, this is for bitmaps, not metrics.
@@ -2751,17 +2710,15 @@
<hr>
-<a name="File-lookup"></a>
-<div class="header">
+<span id="File-lookup"></span><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>
-<a name="File-lookup-1"></a>
-<h3 class="section">6.2 File lookup</h3>
+<span id="File-lookup-1"></span><h3 class="section">6.2 File lookup</h3>
-<a name="index-file-lookup"></a>
-<a name="index-searching-for-files"></a>
-<a name="index-TeX-file-lookup"></a>
+<span id="index-file-lookup"></span>
+<span id="index-searching-for-files"></span>
+<span id="index-TeX-file-lookup"></span>
<p>This section describes how Kpathsea searches for most files (bitmap font
searches are the exception, as described in the next section).
@@ -2783,9 +2740,9 @@
run it (see <a href="#mktex-scripts">mktex scripts</a>).
</li></ol>
-<a name="index-extensions_002c-filename"></a>
-<a name="index-suffixes_002c-filename"></a>
-<a name="index-try_005fstd_005fextension_005ffirst"></a>
+<span id="index-extensions_002c-filename"></span>
+<span id="index-suffixes_002c-filename"></span>
+<span id="index-try_005fstd_005fextension_005ffirst"></span>
<p>The order in which we search for “suffixed” name (item 1) or
the “as-is” name (item 2) is controlled by the
<samp>try_std_extension_first</samp> configuration value. The default set
@@ -2800,8 +2757,8 @@
which *already* have an extension. A name without an extension (e.g.,
‘<samp>tex story</samp>’) will always have an extension added first.
</p>
-<a name="index-tex_002dfile_002ec"></a>
-<a name="index-kpathsea_005ffind_005ffile"></a>
+<span id="index-tex_002dfile_002ec"></span>
+<span id="index-kpathsea_005ffind_005ffile"></span>
<p>This algorithm is implemented in the function
<code>kpathsea_find_file</code> in the source file
<samp>kpathsea/tex-file.c</samp>. You can watch it in action with the
@@ -2809,17 +2766,15 @@
</p>
<hr>
-<a name="Glyph-lookup"></a>
-<div class="header">
+<span id="Glyph-lookup"></span><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>
-<a name="Glyph-lookup-1"></a>
-<h3 class="section">6.3 Glyph lookup</h3>
+<span id="Glyph-lookup-1"></span><h3 class="section">6.3 Glyph lookup</h3>
-<a name="index-glyph-lookup"></a>
-<a name="index-searching-for-glyphs"></a>
-<a name="index-TeX-glyph-lookup"></a>
+<span id="index-glyph-lookup"></span>
+<span id="index-searching-for-glyphs"></span>
+<span id="index-TeX-glyph-lookup"></span>
<p>This section describes how Kpathsea searches for a bitmap font in GF or
PK format (or either) given a font name (e.g., ‘<samp>cmr10</samp>’) and a
@@ -2843,32 +2798,30 @@
last-resort font (typically ‘<samp>cmr10</samp>’).
</li></ol>
-<a name="index-tex_002dglyph_002ec"></a>
-<a name="index-kpathsea_005ffind_005fglyph"></a>
+<span id="index-tex_002dglyph_002ec"></span>
+<span id="index-kpathsea_005ffind_005fglyph"></span>
<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Basic-glyph-lookup"></a>
-<div class="header">
+<span id="Basic-glyph-lookup"></span><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>
-<a name="Basic-glyph-lookup-1"></a>
-<h4 class="subsection">6.3.1 Basic glyph lookup</h4>
+<span id="Basic-glyph-lookup-1"></span><h4 class="subsection">6.3.1 Basic glyph lookup</h4>
-<a name="index-basic-glyph-lookup"></a>
-<a name="index-common-features-in-glyph-lookup"></a>
+<span id="index-basic-glyph-lookup"></span>
+<span id="index-common-features-in-glyph-lookup"></span>
<p>When Kpathsea looks for a bitmap font <var>name</var> at resolution <var>dpi</var>
in a format <var>format</var>, it first checks each directory in the search
@@ -2880,9 +2833,9 @@
‘<samp>dpi600/cmr10.pk</samp>’. This is how fonts are typically stored on
filesystems (such as DOS) that permit only three-character extensions.
</p>
-<a name="index-tolerance-for-glyph-lookup"></a>
-<a name="index-glyph-lookup-bitmap-tolerance"></a>
-<a name="index-KPSE_005fBITMAP_005fTOLERANCE"></a>
+<span id="index-tolerance-for-glyph-lookup"></span>
+<span id="index-glyph-lookup-bitmap-tolerance"></span>
+<span id="index-KPSE_005fBITMAP_005fTOLERANCE"></span>
<p>If that fails, Kpathsea looks for a font with a close-enough <var>dpi</var>.
“Close enough” is defined by the macro <code>KPSE_BITMAP_TOLERANCE</code> in
<samp>kpathsea/tex-glyph.h</samp> to be <code><var>dpi</var> / 500 + 1</code>. This is
@@ -2891,19 +2844,17 @@
</p>
<hr>
-<a name="Fontmap"></a>
-<div class="header">
+<span id="Fontmap"></span><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>
-<a name="Fontmap-1"></a>
-<h4 class="subsection">6.3.2 Fontmap</h4>
+<span id="Fontmap-1"></span><h4 class="subsection">6.3.2 Fontmap</h4>
-<a name="index-fontmap-files"></a>
-<a name="index-font-alias-files"></a>
-<a name="index-aliases-for-fonts"></a>
+<span id="index-fontmap-files"></span>
+<span id="index-font-alias-files"></span>
+<span id="index-aliases-for-fonts"></span>
-<a name="index-texfonts_002emap"></a>
+<span id="index-texfonts_002emap"></span>
<p>If a bitmap font or metric file is not found with the original name (see
the previous section), Kpathsea looks through any <em>fontmap</em> files
for an <em>alias</em> for the original font name. These files are named
@@ -2914,13 +2865,13 @@
<p>This feature is intended to help in two respects:
</p>
<ol>
-<li> <a name="index-fontnames_002c-arbitrary-length"></a>
+<li> <span id="index-fontnames_002c-arbitrary-length"></span>
An alias name is limited in length only by available memory, not by your
filesystem. Therefore, if you want to ask for ‘<samp>Times-Roman</samp>’
instead of <samp>ptmr</samp>, you can (you get ‘<samp>ptmr8r</samp>’).
-</li><li> <a name="index-circle-fonts"></a>
-<a name="index-lcircle10"></a>
+</li><li> <span id="index-circle-fonts"></span>
+<span id="index-lcircle10"></span>
A few fonts have historically had multiple names: specifically,
LaTeX’s “circle font” has variously been known as <samp>circle10</samp>,
<samp>lcircle10</samp>, and <samp>lcirc10</samp>. Aliases can make all the names
@@ -2932,18 +2883,18 @@
<p>The format of fontmap files is straightforward:
</p>
<ul>
-<li> <a name="index-comments_002c-in-fontmap-files"></a>
+<li> <span id="index-comments_002c-in-fontmap-files"></span>
Comments start with the last ‘<samp>%</samp>’ on a line and continue to
the end of the line. (This provides for names that include a %,
ill-advised as that may be.)
-</li><li> <a name="index-whitespace_002c-in-fontmap-files"></a>
+</li><li> <span id="index-whitespace_002c-in-fontmap-files"></span>
Blank lines are ignored.
</li><li> Each nonblank line is broken up into a series of <em>words</em>:
a sequence of non-whitespace characters.
-</li><li> <a name="index-include-fontmap-directive"></a>
+</li><li> <span id="index-include-fontmap-directive"></span>
If the first word is ‘<samp>include</samp>’, the second word is used as
a filename, and it is searched for and read.
@@ -2980,25 +2931,23 @@
</p>
<hr>
-<a name="Fallback-font"></a>
-<div class="header">
+<span id="Fallback-font"></span><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>
-<a name="Fallback-font-1"></a>
-<h4 class="subsection">6.3.3 Fallback font</h4>
+<span id="Fallback-font-1"></span><h4 class="subsection">6.3.3 Fallback font</h4>
-<a name="index-fallback-font"></a>
-<a name="index-fallback-resolutions"></a>
-<a name="index-font-of-last-resort"></a>
-<a name="index-resolutions_002c-last_002dresort"></a>
-<a name="index-last_002dresort-font"></a>
+<span id="index-fallback-font"></span>
+<span id="index-fallback-resolutions"></span>
+<span id="index-font-of-last-resort"></span>
+<span id="index-resolutions_002c-last_002dresort"></span>
+<span id="index-last_002dresort-font"></span>
-<a name="index-DVIPSSIZES"></a>
-<a name="index-XDVISIZES"></a>
-<a name="index-DVILJSIZES"></a>
-<a name="index-TEXSIZES"></a>
-<a name="index-default_005ftexsizes"></a>
+<span id="index-DVIPSSIZES"></span>
+<span id="index-XDVISIZES"></span>
+<span id="index-DVILJSIZES"></span>
+<span id="index-TEXSIZES"></span>
+<span id="index-default_005ftexsizes"></span>
<p>If a bitmap font cannot be found or created at the requested size,
Kpathsea looks for the font at a set of <em>fallback resolutions</em>. You
specify these resolutions as a colon-separated list (like search paths).
@@ -3008,8 +2957,8 @@
variable <code>default_texsizes</code>). You can set this list to be empty if
you prefer to find fonts at their stated size or not at all.
</p>
-<a name="index-cmr10_002c-as-fallback-font"></a>
-<a name="index-kpathsea_005finit_005fprog"></a>
+<span id="index-cmr10_002c-as-fallback-font"></span>
+<span id="index-kpathsea_005finit_005fprog"></span>
<p>Finally, if the font cannot be found even at the fallback resolutions,
Kpathsea looks for a fallback font, typically <samp>cmr10</samp>. Programs
must enable this feature by calling <code>kpathsea_init_prog</code>
@@ -3017,18 +2966,16 @@
</p>
<hr>
-<a name="Suppressing-warnings"></a>
-<div class="header">
+<span id="Suppressing-warnings"></span><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>
</div>
-<a name="Suppressing-warnings-1"></a>
-<h3 class="section">6.4 Suppressing warnings</h3>
+<span id="Suppressing-warnings-1"></span><h3 class="section">6.4 Suppressing warnings</h3>
-<a name="index-warnings_002c-suppressing"></a>
-<a name="index-suppressing-warnings"></a>
+<span id="index-warnings_002c-suppressing"></span>
+<span id="index-suppressing-warnings"></span>
-<a name="index-TEX_005fHUSH-1"></a>
+<span id="index-TEX_005fHUSH-1"></span>
<p>Kpathsea provides a way to suppress selected usually-harmless warnings;
this is useful at large sites where most users are not administrators,
and thus the warnings are merely a source of confusion, not a help. To
@@ -3038,45 +2985,45 @@
</p>
<dl compact="compact">
<dt>‘<samp>all</samp>’
-<a name="index-all"></a>
+<span id="index-all"></span>
</dt>
<dd><p>Suppress everything possible.
</p>
</dd>
<dt>‘<samp>checksum</samp>’
-<a name="index-checksum"></a>
+<span id="index-checksum"></span>
</dt>
-<dd><a name="index-mismatched-checksum-warnings"></a>
+<dd><span id="index-mismatched-checksum-warnings"></span>
<p>Suppress mismatched font checksum warnings.
</p>
</dd>
<dt>‘<samp>lostchar</samp>’
-<a name="index-lostchar"></a>
+<span id="index-lostchar"></span>
</dt>
-<dd><a name="index-missing-character-warnings"></a>
+<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>’
-<a name="index-none"></a>
+<span id="index-none"></span>
</dt>
<dd><p>Don’t suppress any warnings.
</p>
</dd>
<dt>‘<samp>readable</samp>’
-<a name="index-readable"></a>
+<span id="index-readable"></span>
</dt>
-<dd><a name="index-unreadable-file-warnings"></a>
+<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>’
-<a name="index-special"></a>
+<span id="index-special"></span>
</dt>
-<dd><a name="index-unknown-special-warnings"></a>
-<a name="index-_005cspecial_002c-suppressing-warnings-about"></a>
+<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
‘<samp>\special</samp>’ command.
</p></dd>
@@ -3088,21 +3035,19 @@
</p>
<hr>
-<a name="mktex-scripts"></a>
-<div class="header">
+<span id="mktex-scripts"></span><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>
-<a name="mktex-scripts-1"></a>
-<h3 class="section">6.5 <samp>mktex</samp> scripts</h3>
+<span id="mktex-scripts-1"></span><h3 class="section">6.5 <samp>mktex</samp> scripts</h3>
-<a name="index-mktex-scripts"></a>
-<a name="index-scripts-for-file-creation"></a>
+<span id="index-mktex-scripts"></span>
+<span id="index-scripts-for-file-creation"></span>
-<a name="index-font-set_002c-infinite"></a>
-<a name="index-dynamic-creation-of-files"></a>
-<a name="index-Sauter-fonts_002c-and-dynamic-source-creation"></a>
-<a name="index-EC-fonts_002c-and-dynamic-source-creation"></a>
+<span id="index-font-set_002c-infinite"></span>
+<span id="index-dynamic-creation-of-files"></span>
+<span id="index-Sauter-fonts_002c-and-dynamic-source-creation"></span>
+<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
@@ -3126,28 +3071,26 @@
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">
+<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">
+<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">
+<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>
<hr>
-<a name="mktex-configuration"></a>
-<div class="header">
+<span id="mktex-configuration"></span><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>
</div>
-<a name="mktex-configuration-1"></a>
-<h4 class="subsection">6.5.1 <samp>mktex</samp> configuration</h4>
+<span id="mktex-configuration-1"></span><h4 class="subsection">6.5.1 <samp>mktex</samp> configuration</h4>
-<a name="index-mktex-script-configuration"></a>
-<a name="index-configuration-of-mktex-scripts"></a>
-<a name="index-enabling-mktex-scripts"></a>
-<a name="index-disabling-mktex-scripts"></a>
+<span id="index-mktex-script-configuration"></span>
+<span id="index-configuration-of-mktex-scripts"></span>
+<span id="index-enabling-mktex-scripts"></span>
+<span id="index-disabling-mktex-scripts"></span>
<p>The list of file types and program names that can run an external
program to create missing files is listed in the next section. In the
@@ -3155,14 +3098,14 @@
but <samp>mktextex</samp> will be enabled by default. The <code>configure</code>
options to change the defaults are:
</p>
-<a name="index-configure-options-for-mktex-scripts"></a>
-<a name="index-_002d_002dwithout_002dmktexfmt_002ddefault"></a>
-<a name="index-_002d_002dwithout_002dmktexmf_002ddefault"></a>
-<a name="index-_002d_002dwithout_002dmktexocp_002ddefault"></a>
-<a name="index-_002d_002dwithout_002dmktexofm_002ddefault"></a>
-<a name="index-_002d_002dwithout_002dmktexpk_002ddefault"></a>
-<a name="index-_002d_002dwithout_002dmktextfm_002ddefault"></a>
-<a name="index-_002d_002dwith_002dmktextex_002ddefault"></a>
+<span id="index-configure-options-for-mktex-scripts"></span>
+<span id="index-_002d_002dwithout_002dmktexfmt_002ddefault"></span>
+<span id="index-_002d_002dwithout_002dmktexmf_002ddefault"></span>
+<span id="index-_002d_002dwithout_002dmktexocp_002ddefault"></span>
+<span id="index-_002d_002dwithout_002dmktexofm_002ddefault"></span>
+<span id="index-_002d_002dwithout_002dmktexpk_002ddefault"></span>
+<span id="index-_002d_002dwithout_002dmktextfm_002ddefault"></span>
+<span id="index-_002d_002dwith_002dmktextex_002ddefault"></span>
<div class="example">
<pre class="example">--without-mktexfmt-default
--without-mktexmf-default
@@ -3177,15 +3120,15 @@
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>).
</p>
-<a name="index-fmtutils_002ecnf"></a>
+<span id="index-fmtutils_002ecnf"></span>
<p><code>mktexfmt</code> reads a file <samp>fmtutil.cnf</samp>, typically located in
<samp>texmf/web2c/</samp> to glean its configuration information. The rest
of the files and features in this section are primarily intended for
the font generation scripts.
</p>
-<a name="index-mktex_002ecnf-1"></a>
-<a name="index-mktex_002eopt"></a>
-<a name="index-site-overrides-for-mktex_2026"></a>
+<span id="index-mktex_002ecnf-1"></span>
+<span id="index-mktex_002eopt"></span>
+<span id="index-site-overrides-for-mktex_2026"></span>
<p>As distributed, all the scripts source a file
<samp>texmf/web2c/mktex.cnf</samp> if it exists, so you can override various
defaults.
@@ -3198,8 +3141,8 @@
sample <samp>mktex.cnf</samp> for you to copy and modify as you please (it
is not installed anywhere).
</p>
-<a name="index-mktex_002eopt-1"></a>
-<a name="index-MT_005fFEATURES"></a>
+<span id="index-mktex_002eopt-1"></span>
+<span id="index-MT_005fFEATURES"></span>
<p>In addition, you can configure a number of features with the
<code>MT_FEATURES</code> variable, which you can define:
</p>
@@ -3227,12 +3170,12 @@
</p>
<dl compact="compact">
<dt>‘<samp>appendonlydir</samp>’
-<a name="index-appendonlydir"></a>
+<span id="index-appendonlydir"></span>
</dt>
-<dd><a name="index-directories_002c-making-append_002donly"></a>
-<a name="index-mktexdir"></a>
+<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="http://www.gnu.org/software/coreutils/manual/coreutils#Mode-Structure">Mode Structure</a> in <cite>GNU Core
+their sticky bit (see <a 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.
@@ -3239,11 +3182,11 @@
</p>
</dd>
<dt>‘<samp>dosnames</samp>’
-<a name="index-dosnames"></a>
+<span id="index-dosnames"></span>
</dt>
-<dd><a name="index-8_002e3-filenames_002c-using"></a>
-<a name="index-DOS-compatible-names"></a>
-<a name="index-dpinnn-directories"></a>
+<dd><span id="index-8_002e3-filenames_002c-using"></span>
+<span id="index-DOS-compatible-names"></span>
+<span id="index-dpinnn-directories"></span>
<p>Use 8.3 names; e.g., <samp>dpi600/cmr10.pk</samp> instead of
<samp>cmr10.600pk</samp>. Note that this feature only affects filenames that
would otherwise clash with other TeX-related filenames; <samp>mktex</samp>
@@ -3264,10 +3207,10 @@
</p>
</dd>
<dt>‘<samp>fontmaps</samp>’
-<a name="index-fontmaps-1"></a>
+<span id="index-fontmaps-1"></span>
</dt>
-<dd><a name="index-fontmaps"></a>
-<a name="index-fontname"></a>
+<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>).
@@ -3274,9 +3217,9 @@
</p>
</dd>
<dt>‘<samp>nomfdrivers</samp>’
-<a name="index-nomfdrivers"></a>
+<span id="index-nomfdrivers"></span>
</dt>
-<dd><a name="index-metafont-driver-files"></a>
+<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.
@@ -3283,42 +3226,42 @@
</p>
</dd>
<dt>‘<samp>nomode</samp>’
-<a name="index-nomode"></a>
+<span id="index-nomode"></span>
</dt>
-<dd><a name="index-mode-directory_002c-omitting"></a>
+<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>’
-<a name="index-stripsupplier"></a>
+<span id="index-stripsupplier"></span>
</dt>
-<dd><a name="index-supplier-directory_002c-omitting"></a>
+<dd><span id="index-supplier-directory_002c-omitting"></span>
<p>Omit the font supplier name directory level.
</p>
</dd>
<dt>‘<samp>striptypeface</samp>’
-<a name="index-striptypeface"></a>
+<span id="index-striptypeface"></span>
</dt>
-<dd><a name="index-typeface-directory_002c-omitting"></a>
+<dd><span id="index-typeface-directory_002c-omitting"></span>
<p>Omit the font typeface name directory level.
</p>
</dd>
<dt>‘<samp>strip</samp>’
-<a name="index-strip"></a>
+<span id="index-strip"></span>
</dt>
-<dd><a name="index-supplier-directory_002c-omitting-1"></a>
-<a name="index-typeface-directory_002c-omitting-1"></a>
+<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>’
-<a name="index-varfonts"></a>
+<span id="index-varfonts"></span>
</dt>
-<dd><a name="index-_002fvar_002ftmp_002ftexfonts"></a>
-<a name="index-VARTEXFONTS"></a>
-<a name="index-Linux-File-System-Standard"></a>
+<dd><span id="index-_002fvar_002ftmp_002ftexfonts"></span>
+<span id="index-VARTEXFONTS"></span>
+<span id="index-Linux-File-System-Standard"></span>
<p>When this option is enabled, fonts that would otherwise be written in
system texmf tree go to the <code>VARTEXFONTS</code> tree instead. The
default value in <samp>kpathsea/Makefile.in</samp> is
@@ -3325,7 +3268,7 @@
<samp>/var/tmp/texfonts</samp>. The <cite>Linux File System Standard</cite>
recommends <samp>/var/tex/fonts</samp>.
</p>
-<a name="index-USE_005fVARTEXFONTS"></a>
+<span id="index-USE_005fVARTEXFONTS"></span>
<p>The ‘<samp>varfonts</samp>’ setting in <code>MT_FEATURES</code> is overridden by the
<code>USE_VARTEXFONTS</code> environment variable: if set to ‘<samp>1</samp>’, the
feature is enabled, and if set to ‘<samp>0</samp>’, the feature is disabled.
@@ -3332,15 +3275,15 @@
</p>
</dd>
<dt>‘<samp>texmfvar</samp>’
-<a name="index-texmfvar"></a>
+<span id="index-texmfvar"></span>
</dt>
-<dd><a name="index-TEXMFVAR"></a>
+<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
variable <code>TEXMFVAR</code> is always set. The ‘<samp>varfonts</samp>’ feature takes
precedence if also set.
</p>
-<a name="index-USE_005fTEXMFVAR"></a>
+<span id="index-USE_005fTEXMFVAR"></span>
<p>The ‘<samp>texmfvar</samp>’ setting in <code>MT_FEATURES</code> is overridden by the
<code>USE_TEXMFVAR</code> environment variable: if set to ‘<samp>1</samp>’, the
feature is enabled, and if set to ‘<samp>0</samp>’, the feature is disabled.
@@ -3349,16 +3292,14 @@
<hr>
-<a name="mktex-script-names"></a>
-<div class="header">
+<span id="mktex-script-names"></span><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>
</div>
-<a name="mktex-script-names-1"></a>
-<h4 class="subsection">6.5.2 <samp>mktex</samp> script names</h4>
+<span id="mktex-script-names-1"></span><h4 class="subsection">6.5.2 <samp>mktex</samp> script names</h4>
-<a name="index-mktex-script-names"></a>
-<a name="index-names-for-mktex-scripts"></a>
+<span id="index-mktex-script-names"></span>
+<span id="index-names-for-mktex-scripts"></span>
<p>The following table shows the default name of the script for each
of the file types which support runtime generation.
@@ -3365,8 +3306,8 @@
</p>
<dl compact="compact">
<dt><samp>mktexfmt</samp></dt>
-<dd><a name="index-mktexfmt"></a>
-<a name="index-fmtutil"></a>
+<dd><span id="index-mktexfmt"></span>
+<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.
@@ -3373,51 +3314,51 @@
</p>
</dd>
<dt><samp>mktexmf</samp></dt>
-<dd><a name="index-mktexmf"></a>
+<dd><span id="index-mktexmf"></span>
<p>(‘<samp>.mf</samp>’) Metafont input files.
</p>
</dd>
<dt><samp>mkocp</samp></dt>
-<dd><a name="index-mkocp"></a>
+<dd><span id="index-mkocp"></span>
<p>(‘<samp>.ocp</samp>’) Omega compiled process files.
</p>
</dd>
<dt><samp>mkofm</samp></dt>
-<dd><a name="index-mkofm"></a>
+<dd><span id="index-mkofm"></span>
<p>(‘<samp>.ofm</samp>’) Omega font metric files.
</p>
</dd>
<dt><samp>mktexpk</samp></dt>
-<dd><a name="index-mktexpk"></a>
+<dd><span id="index-mktexpk"></span>
<p>(‘<samp>pk</samp>’) Glyph fonts.
</p>
</dd>
<dt><samp>mktextex</samp></dt>
-<dd><a name="index-mktextex"></a>
+<dd><span id="index-mktextex"></span>
<p>(‘<samp>.tex</samp>’) TeX input files (disabled by default).
</p>
</dd>
<dt><samp>mktextfm</samp></dt>
-<dd><a name="index-mktextfm"></a>
+<dd><span id="index-mktextfm"></span>
<p>(‘<samp>.tfm</samp>’) TFM files.
</p></dd>
</dl>
-<a name="index-DVIPSMAKEPK"></a>
-<a name="index-XDVIMAKEPK"></a>
-<a name="index-DVILJMAKEPK"></a>
+<span id="index-DVIPSMAKEPK"></span>
+<span id="index-XDVIMAKEPK"></span>
+<span id="index-DVILJMAKEPK"></span>
<p>These names can be overridden by an environment variable specific
to the program—for example, <code>DVIPSMAKEPK</code> for Dvipsk.
</p>
-<a name="index-missfont_002elog"></a>
-<a name="index-failed-mktex_2026-script-invocation"></a>
+<span id="index-missfont_002elog"></span>
+<span id="index-failed-mktex_2026-script-invocation"></span>
<p>If a <code>mktex…</code> script fails, the invocation is appended to a
file <samp>missfont.log</samp> (by default) in the current directory. You can
then execute the log file to create the missing files after fixing the
problem.
</p>
-<a name="index-TEXMFOUTPUT"></a>
-<a name="index-MISSFONT_005fLOG"></a>
+<span id="index-TEXMFOUTPUT"></span>
+<span id="index-MISSFONT_005fLOG"></span>
<p>If the current directory is not writable and the environment variable or
configuration file value <code>TEXMFOUTPUT</code> is set, its value is
used. Otherwise, nothing is written. The name ‘<samp>missfont.log</samp>’ is
@@ -3426,15 +3367,13 @@
</p>
<hr>
-<a name="mktex-script-arguments"></a>
-<div class="header">
+<span id="mktex-script-arguments"></span><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>
</div>
-<a name="mktex-script-arguments-1"></a>
-<h4 class="subsection">6.5.3 <samp>mktex</samp> script arguments</h4>
+<span id="mktex-script-arguments-1"></span><h4 class="subsection">6.5.3 <samp>mktex</samp> script arguments</h4>
-<a name="index-arguments-to-mktex"></a>
+<span id="index-arguments-to-mktex"></span>
<p>The first argument to a <samp>mktex</samp> script is always the name
of the file to be created.
@@ -3466,13 +3405,11 @@
<hr>
-<a name="Programming"></a>
-<div class="header">
+<span id="Programming"></span><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>
</div>
-<a name="Programming-1"></a>
-<h2 class="chapter">7 Programming</h2>
+<span id="Programming-1"></span><h2 class="chapter">7 Programming</h2>
<p>This chapter is for programmers who wish to use Kpathsea.
See <a href="#Introduction">Introduction</a>, for the conditions under which you may do so (in
@@ -3479,28 +3416,26 @@
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.
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Programming-overview"></a>
-<div class="header">
+<span id="Programming-overview"></span><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>
-<a name="Programming-overview-1"></a>
-<h3 class="section">7.1 Programming overview</h3>
+<span id="Programming-overview-1"></span><h3 class="section">7.1 Programming overview</h3>
-<a name="index-programming-overview"></a>
-<a name="index-overview-of-programming-with-Kpathsea"></a>
+<span id="index-programming-overview"></span>
+<span id="index-overview-of-programming-with-Kpathsea"></span>
<p>Aside from this manual, your best source of information is the source
to the programs that use Kpathsea (see <a href="#Introduction">Introduction</a>). First,
@@ -3512,8 +3447,8 @@
uses Kpathsea rather straightforwardly, but is of course complicated
by the Web to C translation.
</p>
-<a name="index-re_002dentrant-API"></a>
-<a name="index-API_002c-re_002dentrant"></a>
+<span id="index-re_002dentrant-API"></span>
+<span id="index-API_002c-re_002dentrant"></span>
<p>When looking at these program sources, you should know that previous
versions of the library had a different programming interface; the
current interface supports re-entrancy. Historically, the library
@@ -3524,10 +3459,10 @@
they do for the programs above. The main application using the
re-entrant API is the MetaPost library used by MetaPost and LuaTeX.
</p>
-<a name="index-pathsearch_002eh"></a>
-<a name="index-tex_002dfile_002eh"></a>
-<a name="index-tex_002dglyph_002eh"></a>
-<a name="index-kpathsea_002eh"></a>
+<span id="index-pathsearch_002eh"></span>
+<span id="index-tex_002dfile_002eh"></span>
+<span id="index-tex_002dglyph_002eh"></span>
+<span id="index-kpathsea_002eh"></span>
<p>Beyond these examples, the <samp>.h</samp> files in the Kpathsea source
describe the interfaces and functionality (and of course the <samp>.c</samp>
files define the actual routines, which are the ultimate documentation).
@@ -3537,8 +3472,8 @@
depend on each other, it is recommended to use <code>#include
<kpathsea/kpathsea.h></code>, which includes every Kpathsea header.
</p>
-<a name="index-config_002eh"></a>
-<a name="index-c_002dauto_002eh"></a>
+<span id="index-config_002eh"></span>
+<span id="index-c_002dauto_002eh"></span>
<p>If you want to include only specific headers, you should still consider
including <samp>kpathsea/config.h</samp> before including any other Kpathsea
header, as it provides symbols used in the other headers. Note that
@@ -3545,7 +3480,7 @@
<samp>kpathsea/config.h</samp> includes <samp>kpathsea/c-auto.h</samp>, which is
generated by Autoconf.
</p>
-<a name="index-file-types_002c-registering-new"></a>
+<span id="index-file-types_002c-registering-new"></span>
<p>The library provides no way for an external program to register new file
types: <samp>tex-file.[ch]</samp> must be modified to do this. For example,
Kpathsea has support for looking up Dvips config files, even though no
@@ -3562,28 +3497,26 @@
</p>
<hr>
-<a name="Calling-sequence"></a>
-<div class="header">
+<span id="Calling-sequence"></span><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>
-<a name="Calling-sequence-1"></a>
-<h3 class="section">7.2 Calling sequence</h3>
+<span id="Calling-sequence-1"></span><h3 class="section">7.2 Calling sequence</h3>
-<a name="index-programming-with-Kpathsea"></a>
-<a name="index-calling-sequence"></a>
+<span id="index-programming-with-Kpathsea"></span>
+<span id="index-calling-sequence"></span>
<p>The typical way to use Kpathsea in your program goes something like this:
</p>
<ol>
-<li> <a name="index-kpathsea_005fnew"></a>
+<li> <span id="index-kpathsea_005fnew"></span>
Call <code>kpathsea_new</code> to create a new library instance. This variable
must be passed as the first argument to all the following library functions.
The rest of this manual will be using <code>kpse</code> as a placeholder for
the name of this variable.
-</li><li> <a name="index-kpathsea_005fset_005fprogram_005fname"></a>
-<a name="index-argv_005b0_005d"></a>
+</li><li> <span id="index-kpathsea_005fset_005fprogram_005fname"></span>
+<span id="index-argv_005b0_005d"></span>
Call <code>kpathsea_set_program_name</code> with <code>argv[0]</code> as the second
argument; the third argument is a string or <code>NULL</code>. The third
argument is used by Kpathsea as the program name for the
@@ -3592,10 +3525,10 @@
is used. This function must be called before any other use of the
Kpathsea library.
-<a name="index-kpse_002d_003einvocation_005fname"></a>
-<a name="index-kpse_002d_003einvocation_005fshort_005fname"></a>
-<a name="index-kpse_002d_003eprogram_005fname"></a>
-<a name="index-error-message-macros"></a>
+<span id="index-kpse_002d_003einvocation_005fname"></span>
+<span id="index-kpse_002d_003einvocation_005fshort_005fname"></span>
+<span id="index-kpse_002d_003eprogram_005fname"></span>
+<span id="index-error-message-macros"></span>
<p><code>kpathsea_set_program_name</code> always sets the variables
<code>kpse->invocation_name</code> and <code>kpse->invocation_short_name</code>.
These variables are used in the error message macros defined in
@@ -3602,15 +3535,15 @@
<samp>kpathsea/lib.h</samp>. It sets the variable
<code>kpse->program_name</code> to the program name it uses.
</p>
-<a name="index-KPATHSEA_005fDEBUG"></a>
+<span id="index-KPATHSEA_005fDEBUG"></span>
<p>It also initializes debugging options based on the environment
variable <code>KPATHSEA_DEBUG</code> (if that is set).
</p>
-<a name="index-SELFAUTOLOC"></a>
-<a name="index-SELFAUTODIR"></a>
-<a name="index-SELFAUTOPARENT"></a>
-<a name="index-symlinks_002c-resolving"></a>
-<a name="index-expanding-symlinks"></a>
+<span id="index-SELFAUTOLOC"></span>
+<span id="index-SELFAUTODIR"></span>
+<span id="index-SELFAUTOPARENT"></span>
+<span id="index-symlinks_002c-resolving"></span>
+<span id="index-expanding-symlinks"></span>
<p>Finally, it sets the environment variables <code>SELFAUTOLOC</code>, <code>SELFAUTODIR</code>
and <code>SELFAUTOPARENT</code> to the location, parent and grandparent
directory of the executable, removing <samp>.</samp> and <samp>..</samp> path
@@ -3619,8 +3552,8 @@
can use ‘<samp>kpsewhich --expand-var=\$SELFAUTOLOC</samp>’, etc., to see the
values.
</p>
-</li><li> <a name="index-kpse_002d_003edebug-variable"></a>
-<a name="index-debugging-options_002c-in-Kpathsea_002dusing-program"></a>
+</li><li> <span id="index-kpse_002d_003edebug-variable"></span>
+<span id="index-debugging-options_002c-in-Kpathsea_002dusing-program"></span>
Set debugging options. See <a href="#Debugging">Debugging</a>. If your program doesn’t have a
debugging option already, you can define one and set
<code>kpse->debug</code> to the number that the user supplies (as in Dviljk
@@ -3628,10 +3561,10 @@
<code>KPATHSEA_DEBUG</code>). If you do have runtime debugging already, you
need to merge Kpathsea’s options with yours (as in Dvipsk and Xdvik).
-</li><li> <a name="index-client_005fpath-in-kpse_002d_003eformat_005finfo"></a>
-<a name="index-kpse_002d_003eformat_005finfo"></a>
-<a name="index-resident_002ec"></a>
-<a name="index-config-files_002c-for-Kpathsea_002dusing-programs"></a>
+</li><li> <span id="index-client_005fpath-in-kpse_002d_003eformat_005finfo"></span>
+<span id="index-kpse_002d_003eformat_005finfo"></span>
+<span id="index-resident_002ec"></span>
+<span id="index-config-files_002c-for-Kpathsea_002dusing-programs"></span>
If your program has its own configuration files that can define search
paths, you should assign those paths to the <code>client_path</code> member in
the appropriate element of the <code>kpse->format_info</code> array. (This
@@ -3638,8 +3571,8 @@
array is indexed by file type; see <samp>tex-file.h</samp>.) See
<samp>resident.c</samp> in Dvipsk for an example.
-</li><li> <a name="index-kpathsea_005finit_005fprog-1"></a>
-<a name="index-proginit_002eh"></a>
+</li><li> <span id="index-kpathsea_005finit_005fprog-1"></span>
+<span id="index-proginit_002eh"></span>
Call <code>kpathsea_init_prog</code> (see <samp>proginit.c</samp>). It’s useful for the
DVI drivers, at least, but for other programs it may be simpler to
extract the parts of it that actually apply. This does not initialize
@@ -3648,7 +3581,7 @@
the first call to find a file of that type; this eliminates much useless
work, e.g., initializing the BibTeX search paths in a DVI driver.)
-</li><li> <a name="index-kpathsea_005ffind_005ffile-1"></a>
+</li><li> <span id="index-kpathsea_005ffind_005ffile-1"></span>
The routine to actually find a file of type <var>format</var> is
<samp>kpathsea_find_file</samp>. You can call
<code>kpathsea_find_file</code> after doing only the first and second of the
@@ -3662,7 +3595,7 @@
resultant filename, because fonts can be found in so many ways. See the
documentation in the source.
-</li><li> <a name="index-kpathsea_005fopen_005ffile"></a>
+</li><li> <span id="index-kpathsea_005fopen_005ffile"></span>
To actually open a file, not just return a filename, call
<code>kpathsea_open_file</code>. This function takes the name to look up and a
Kpathsea file format as arguments, and returns the usual <code>FILE *</code>.
@@ -3671,7 +3604,7 @@
words, if you are looking up a VF or some other file that need not
exist, don’t use this.
-</li><li> <a name="index-kpathsea_005fout_005fname_005fok"></a>
+</li><li> <span id="index-kpathsea_005fout_005fname_005fok"></span>
TeX can write output files, via the <code>\openout</code> primitive; this opens
a security hole vulnerable to Trojan horse attack: an unwitting user could
run a TeX program that overwrites, say, <samp>~/.rhosts</samp>. Analogous
@@ -3690,13 +3623,13 @@
filename as second argument, returns <code>true</code> if that filename is
acceptable to be opend for output or <code>false</code> otherwise.
-</li><li> <a name="index-kpathsea_005fin_005fname_005fok"></a>
+</li><li> <span id="index-kpathsea_005fin_005fname_005fok"></span>
Similarly, the function <code>kpathsea_in_name_ok</code>, with a filename as
second argument, returns <code>true</code> if that filename is acceptable to be
opend for input or <code>false</code> otherwise, depending on the value of the
configuration variable <code>openin_any</code> (with ‘<samp>a</samp>’ as default).
-</li><li> <a name="index-kpathsea_005ffinish"></a>
+</li><li> <span id="index-kpathsea_005ffinish"></span>
To close the kpathsea library instance you are using, call
<code>kpathsea_finish</code>. This function closes any open log files and
frees the memory used by the instance.
@@ -3703,12 +3636,12 @@
</li></ol>
-<a name="index-hash-table-routines"></a>
-<a name="index-memory-allocation-routines"></a>
-<a name="index-string-routines"></a>
-<a name="index-reading-arbitrary_002dlength-lines"></a>
-<a name="index-input-lines_002c-reading"></a>
-<a name="index-lines_002c-reading-arbitrary_002dlength"></a>
+<span id="index-hash-table-routines"></span>
+<span id="index-memory-allocation-routines"></span>
+<span id="index-string-routines"></span>
+<span id="index-reading-arbitrary_002dlength-lines"></span>
+<span id="index-input-lines_002c-reading"></span>
+<span id="index-lines_002c-reading-arbitrary_002dlength"></span>
<p>Kpathsea also provides many utility routines. Some are generic: hash
tables, memory allocation, string concatenation and copying, string
lists, reading input lines of arbitrary length, etc. Others are
@@ -3716,8 +3649,8 @@
<code>stat</code> calls, etc. (Perhaps someday I’ll move the former to a
separate library.)
</p>
-<a name="index-c_002d_002a_002eh"></a>
-<a name="index-autoconf_002c-recommended"></a>
+<span id="index-c_002d_002a_002eh"></span>
+<span id="index-autoconf_002c-recommended"></span>
<p>The <samp>c-*.h</samp> header files can also help your program adapt to many
different systems. You will almost certainly want to use Autoconf and
probably Automake for configuring and building your software if you use
@@ -3726,13 +3659,11 @@
</p>
<hr>
-<a name="Program_002dspecific-files"></a>
-<div class="header">
+<span id="Program_002dspecific-files"></span><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>
-<a name="Program_002dspecific-files-1"></a>
-<h3 class="section">7.3 Program-specific files</h3>
+<span id="Program_002dspecific-files-1"></span><h3 class="section">7.3 Program-specific files</h3>
<p>Many programs will need to find some configuration files. Kpathsea
contains some support to make it easy to place them in their own
@@ -3754,39 +3685,43 @@
</p>
<hr>
-<a name="Programming-with-config-files"></a>
-<div class="header">
+<span id="Programming-with-config-files"></span><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>
-<a name="Programming-with-config-files-1"></a>
-<h3 class="section">7.4 Programming with config files</h3>
+<span id="Programming-with-config-files-1"></span><h3 class="section">7.4 Programming with config files</h3>
-<a name="index-programming-with-config-files"></a>
-<a name="index-config-files_002c-programming-with"></a>
+<span id="index-programming-with-config-files"></span>
+<span id="index-config-files_002c-programming-with"></span>
<p>You can (and probably should) use the same <code>texmf.cnf</code>
configuration file that Kpathsea uses for your program. This helps
installers by keeping all configuration in one place.
</p>
-<a name="index-kpathsea_005fvar_005fvalue"></a>
-<a name="index-variable_002eh"></a>
-<a name="index-shell_005fescape_002c-example-for-code"></a>
-<p>To retrieve a value <var>var</var> from config files, the best way is to call
-<code>kpathsea_var_value</code> on the string <code><var>var</var></code>. This will look
-first for an environment variable <var>var</var>, then a config file value.
-The result will be the value found or ‘<samp>NULL</samp>’. This function is
-declared in <samp>kpathsea/variable.h</samp>. For an example, see the
+<span id="index-kpathsea_005fvar_005fvalue"></span>
+<span id="index-variable_002eh"></span>
+<span id="index-shell_005fescape_002c-example-for-code"></span>
+<p>To retrieve a value for a configuration variable <var>var</var>, the best
+way is to call <code>kpathsea_var_value</code> on the string
+<code><var>var</var></code>. This will look first for an environment variable
+<var>var</var>, then a config file value. The result will be the value
+found or ‘<samp>NULL</samp>’. This function is declared in
+<samp>kpathsea/variable.h</samp>. For an example, see the
<code>shell_escape</code> code in <samp>web2c/lib/texmfmp.c</samp>.
</p>
-<p>The routine to do variable expansion in the context of a search path (as
-opposed to simply retrieving a value) is <code>kpathsea_var_expand</code>, also
-declared in <samp>kpathsea/variable.h</samp>. It’s generally only necessary
-to set the search path structure components as explained in the previous
-section, rather than using this yourself.
+<p>The routine to do full variable and tilde expansion of an arbitrary
+string in the context of a search path (as opposed to simply
+retrieving a value) is <code>kpathsea_var_expand</code>, also declared in
+<samp>kpathsea/variable.h</samp>. However, it’s generally only necessary to
+set the search path structure components as explained in the previous
+section instead of using this directly. Because of its usage with any
+input string, undefined <code>$FOO</code> constructs in the argument to
+<code>kpathsea_var_expand</code> are returned literally (<code>"$FOO"</code>),
+while undefined <code>${FOO}</code> constructs are expanded to the empty
+string.
</p>
-<a name="index-kpathsea_005fcnf_005fget"></a>
-<a name="index-cnf_002eh"></a>
+<span id="index-kpathsea_005fcnf_005fget"></span>
+<span id="index-cnf_002eh"></span>
<p>If for some reason you want to retrieve a value <em>only</em> from a
config file, not automatically looking for a corresponding environment
variable, call <code>kpathsea_cnf_get</code> (declared in <samp>kpathsea/cnf.h</samp>)
@@ -3796,19 +3731,17 @@
</p>
<hr>
-<a name="Reporting-bugs"></a>
-<div class="header">
+<span id="Reporting-bugs"></span><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>
</div>
-<a name="Reporting-bugs-1"></a>
-<h2 class="chapter">8 Reporting bugs</h2>
+<span id="Reporting-bugs-1"></span><h2 class="chapter">8 Reporting bugs</h2>
-<a name="index-reporting-bugs"></a>
-<a name="index-bugs_002c-reporting"></a>
+<span id="index-reporting-bugs"></span>
+<span id="index-bugs_002c-reporting"></span>
-<a name="index-tex_002dk_0040tug_002eorg-_0028bug-address_0029"></a>
-<a name="index-bug-address"></a>
+<span id="index-tex_002dk_0040tug_002eorg-_0028bug-address_0029"></span>
+<span id="index-bug-address"></span>
<p>If you have problems or suggestions, please report them to
<a href="mailto:tex-k at tug.org">tex-k at tug.org</a> using the bug checklist below.
</p>
@@ -3817,30 +3750,28 @@
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.
+<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.
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Bug-checklist"></a>
-<div class="header">
+<span id="Bug-checklist"></span><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>
-<a name="Bug-checklist-1"></a>
-<h3 class="section">8.1 Bug checklist</h3>
+<span id="Bug-checklist-1"></span><h3 class="section">8.1 Bug checklist</h3>
-<a name="index-checklist-for-bug-reports"></a>
-<a name="index-bug-checklist"></a>
+<span id="index-checklist-for-bug-reports"></span>
+<span id="index-bug-checklist"></span>
<p>Before reporting a bug, please check below to be sure it isn’t already
known (see <a href="#Common-problems">Common problems</a>).
@@ -3853,7 +3784,7 @@
investigation, your report should include the following:
</p>
<ul>
-<li> <a name="index-version-numbers_002c-determining"></a>
+<li> <span id="index-version-numbers_002c-determining"></span>
The version number(s) of the program(s) involved, and of Kpathsea
itself. You can get the former by giving a sole option ‘<samp>--version</samp>’
to the program, and the latter by running ‘<samp>kpsewhich --version</samp>’.
@@ -3860,17 +3791,17 @@
The <samp>NEWS</samp> and <samp>ChangeLog</samp> files also contain the version
number.
-</li><li> <a name="index-uname"></a>
+</li><li> <span id="index-uname"></span>
The hardware, operating system (including version), compiler, and
<code>make</code> program you are using (the output of <code>uname -a</code> is a
start on the first two, though incomplete).
-</li><li> <a name="index-config_002elog"></a>
+</li><li> <span id="index-config_002elog"></span>
Any options you gave to <code>configure</code>. This is recorded in the
<samp>config.status</samp> files.
-<a name="index-configuration-bugs"></a>
-<a name="index-config_002estatus"></a>
+<span id="index-configuration-bugs"></span>
+<span id="index-config_002estatus"></span>
<p>If you are reporting a bug in ‘<samp>configure</samp>’ itself, it’s probably
system-dependent, and it will be unlikely the maintainers can do
anything useful if you merely report that thus-and-such is broken.
@@ -3896,20 +3827,20 @@
helpful, but the DVI file is required, because that’s the actual
program input.
-</li><li> <a name="index-context-diff"></a>
-<a name="index-sending-patches"></a>
-<a name="index-ChangeLog-entry"></a>
+</li><li> <span id="index-context-diff"></span>
+<span id="index-sending-patches"></span>
+<span id="index-ChangeLog-entry"></span>
If you are sending a patch (do so if you can!), please do so in the form
of a context diff (‘<samp>diff -c</samp>’) against the original distribution
source. Any other form of diff is either not as complete or harder for
me to understand. Please also include a <samp>ChangeLog</samp> entry.
-</li><li> <a name="index-stack-trace"></a>
-<a name="index-debugger"></a>
-<a name="index-crashes_002c-reporting"></a>
-<a name="index-core-dumps_002c-reporting"></a>
-<a name="index-null-pointers_002c-dereferencing"></a>
-<a name="index-gdb_002c-recommended"></a>
+</li><li> <span id="index-stack-trace"></span>
+<span id="index-debugger"></span>
+<span id="index-crashes_002c-reporting"></span>
+<span id="index-core-dumps_002c-reporting"></span>
+<span id="index-null-pointers_002c-dereferencing"></span>
+<span id="index-gdb_002c-recommended"></span>
If the bug involved is an actual crash (i.e., core dump), it is easy
and useful to include a stack trace from a debugger (I recommend the
GNU debugger GDB (<a href="http://www.gnu.org/software/gdb">http://www.gnu.org/software/gdb</a>). If the
@@ -3926,19 +3857,17 @@
<hr>
-<a name="Mailing-lists"></a>
-<div class="header">
+<span id="Mailing-lists"></span><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>
-<a name="Mailing-lists-1"></a>
-<h3 class="section">8.2 Mailing lists</h3>
+<span id="Mailing-lists-1"></span><h3 class="section">8.2 Mailing lists</h3>
-<a name="index-mailing-lists"></a>
-<a name="index-bug-mailing-list"></a>
-<a name="index-announcement-mailing-list"></a>
+<span id="index-mailing-lists"></span>
+<span id="index-bug-mailing-list"></span>
+<span id="index-announcement-mailing-list"></span>
-<a name="index-tex_002dk_0040tug_002eorg"></a>
+<span id="index-tex_002dk_0040tug_002eorg"></span>
<p>Web2c and Kpathsea in general are discussed on the mailing list
<a href="mailto:tex-k at tug.org">tex-k at tug.org</a>. You can subscribe and peruse the archives on
the web <a href="http://lists.tug.org/tex-k">http://lists.tug.org/tex-k</a>.
@@ -3954,20 +3883,18 @@
</p>
<hr>
-<a name="Debugging"></a>
-<div class="header">
+<span id="Debugging"></span><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>
-<a name="Debugging-1"></a>
-<h3 class="section">8.3 Debugging</h3>
+<span id="Debugging-1"></span><h3 class="section">8.3 Debugging</h3>
-<a name="index-debugging"></a>
-<a name="index-runtime-debugging"></a>
-<a name="index-options-for-debugging"></a>
+<span id="index-debugging"></span>
+<span id="index-runtime-debugging"></span>
+<span id="index-options-for-debugging"></span>
-<a name="index-kpse_002d_003edebug"></a>
-<a name="index-debug_002eh"></a>
+<span id="index-kpse_002d_003edebug"></span>
+<span id="index-debug_002eh"></span>
<p>Kpathsea provides a number of runtime debugging options, detailed below
by their names and corresponding numeric values. When the files you
expect aren’t being found, the thing to do is enable these options and
@@ -3980,20 +3907,20 @@
first, for maximal output. Dvipsk and Xdvik have additional
program-specific debugging options as well.
</p>
-<a name="index-KPATHSEA_005fDEBUG-1"></a>
-<a name="index-kpse_002d_003edebug-1"></a>
+<span id="index-KPATHSEA_005fDEBUG-1"></span>
+<span id="index-kpse_002d_003edebug-1"></span>
<p>You can also set the environment variable <code>KPATHSEA_DEBUG</code>; in this
case, you should use the numbers below. If you run the program under a
debugger and set the instance variable <code>kpse->debug</code>, also use the numbers
below.
</p>
-<a name="index-_002d1-debugging-value"></a>
+<span id="index-_002d1-debugging-value"></span>
<p>In any case, by far the simplest value to use is ‘<samp>-1</samp>’, which will
turn on all debugging output. This is usually better than guessing
which particular values will yield the output you need.
</p>
-<a name="index-debugging-output"></a>
-<a name="index-standard-error-and-debugging-output"></a>
+<span id="index-debugging-output"></span>
+<span id="index-standard-error-and-debugging-output"></span>
<p>Debugging output always goes to standard error, so you can redirect it
easily. For example, in Bourne-compatible shells:
</p><div class="example">
@@ -4000,11 +3927,11 @@
<pre class="example">dvips -d -1 … 2>/tmp/debug
</pre></div>
-<a name="index-Kpsewhich_002c-and-debugging"></a>
+<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.
</p>
-<a name="index-numeric-debugging-values"></a>
+<span id="index-numeric-debugging-values"></span>
<p>In any case, you cannot use the names below; you must always use
somebody’s numbers. (Sorry.) To set more than one option, just sum
the corresponding numbers.
@@ -4011,7 +3938,7 @@
</p>
<dl compact="compact">
<dt><code>KPSE_DEBUG_STAT <span class="roman">(1)</span></code>
-<a name="index-KPSE_005fDEBUG_005fSTAT-_00281_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fSTAT-_00281_0029"></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
@@ -4021,7 +3948,7 @@
</p>
</dd>
<dt><code>KPSE_DEBUG_HASH <span class="roman">(2)</span></code>
-<a name="index-KPSE_005fDEBUG_005fHASH-_00282_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fHASH-_00282_0029"></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
@@ -4031,9 +3958,9 @@
</p>
</dd>
<dt><code>KPSE_DEBUG_FOPEN <span class="roman">(4)</span></code>
-<a name="index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fFOPEN-_00284_0029"></span>
</dt>
-<dd><a name="index-fopen_002c-redefined"></a>
+<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
closed. In case you want to set breakpoints in a debugger: this works by
@@ -4042,9 +3969,9 @@
</p>
</dd>
<dt><code>KPSE_DEBUG_PATHS <span class="roman">(8)</span></code>
-<a name="index-KPSE_005fDEBUG_005fPATHS-_00288_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fPATHS-_00288_0029"></span>
</dt>
-<dd><a name="index-kpse_005fformat_005finfo_005ftype"></a>
+<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
particular path got defined—from <samp>texmf.cnf</samp>, <samp>config.ps</samp>,
@@ -4054,7 +3981,7 @@
</p>
</dd>
<dt><code>KPSE_DEBUG_EXPAND <span class="roman">(16)</span></code>
-<a name="index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fEXPAND-_002816_0029"></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
@@ -4062,7 +3989,7 @@
</p>
</dd>
<dt><code>KPSE_DEBUG_SEARCH <span class="roman">(32)</span></code>
-<a name="index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fSEARCH-_002832_0029"></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
@@ -4074,7 +4001,7 @@
</p>
</dd>
<dt><code>KPSE_DEBUG_VARS <span class="roman">(64)</span></code>
-<a name="index-KPSE_005fDEBUG_005fVARS-_002864_0029"></a>
+<span id="index-KPSE_005fDEBUG_005fVARS-_002864_0029"></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.
@@ -4081,13 +4008,13 @@
</p>
</dd>
<dt><code>GSFTOPK_DEBUG <span class="roman">(128)</span></code>
-<a name="index-GSFTOPK_005fDEBUG-_0028128_0029"></a>
+<span id="index-GSFTOPK_005fDEBUG-_0028128_0029"></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>
-<a name="index-MAKETEX_005fDEBUG-_0028512_0029"></a>
+<span id="index-MAKETEX_005fDEBUG-_0028512_0029"></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
@@ -4099,7 +4026,7 @@
</p>
</dd>
<dt><code>MAKETEX_FINE_DEBUG <span class="roman">(1024)</span></code>
-<a name="index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"></a>
+<span id="index-MAKETEX_005fFINE_005fDEBUG-_00281024_0029"></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.
@@ -4106,9 +4033,9 @@
</p></dd>
</dl>
-<a name="index-kdebug_003a"></a>
-<a name="index-hash_005fsummary_005fonly-variable-for-debugging"></a>
-<a name="index-hash-table-buckets_002c-printing"></a>
+<span id="index-kdebug_003a"></span>
+<span id="index-hash_005fsummary_005fonly-variable-for-debugging"></span>
+<span id="index-hash-table-buckets_002c-printing"></span>
<p>Debugging output from Kpathsea is always written to standard error, and
begins with the string ‘<samp>kdebug:</samp>’. (Except for hash table buckets,
which just start with the number, but you can only get that output
@@ -4117,33 +4044,31 @@
</p>
<hr>
-<a name="Logging"></a>
-<div class="header">
+<span id="Logging"></span><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>
-<a name="Logging-1"></a>
-<h3 class="section">8.4 Logging</h3>
+<span id="Logging-1"></span><h3 class="section">8.4 Logging</h3>
-<a name="index-log-file"></a>
+<span id="index-log-file"></span>
-<a name="index-logging-successful-searches"></a>
-<a name="index-recording-successful-searches"></a>
-<a name="index-usage-patterns_002c-finding"></a>
-<a name="index-disk-usage_002c-reducing"></a>
+<span id="index-logging-successful-searches"></span>
+<span id="index-recording-successful-searches"></span>
+<span id="index-usage-patterns_002c-finding"></span>
+<span id="index-disk-usage_002c-reducing"></span>
<p>Kpathsea can record the time and filename found for each successful
search. This may be useful in finding good candidates for deletion when
your filesystem is full, or in discovering usage patterns
at your site.
</p>
-<a name="index-TEXMFLOG"></a>
+<span id="index-TEXMFLOG"></span>
<p>To do this, define the environment or config file variable
<code>TEXMFLOG</code>. The value is the name of the file to append the
information to. The file is created if it doesn’t exist, and appended
to if it does.
</p>
-<a name="index-epoch_002c-seconds-since"></a>
-<a name="index-time-system-call"></a>
+<span id="index-epoch_002c-seconds-since"></span>
+<span id="index-time-system-call"></span>
<p>Each successful search turns into one line in the log file: two words
separated by a space. The first word is the time of the search, as the
integer number of seconds since “the epoch”, i.e., UTC midnight 1
@@ -4163,7 +4088,7 @@
774455889 /usr/local/share/texmf/dvips/texc.pro
</pre></div>
-<a name="index-privacy_002c-semblance-of"></a>
+<span id="index-privacy_002c-semblance-of"></span>
<p>Only filenames that are absolute are recorded, to preserve
some semblance of privacy.
</p>
@@ -4178,43 +4103,39 @@
</p>
<hr>
-<a name="Common-problems"></a>
-<div class="header">
+<span id="Common-problems"></span><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>
-<a name="Common-problems-1"></a>
-<h3 class="section">8.5 Common problems</h3>
+<span id="Common-problems-1"></span><h3 class="section">8.5 Common problems</h3>
-<a name="index-common-problems"></a>
-<a name="index-problems_002c-common"></a>
-<a name="index-FAQ_002c-Kpathsea"></a>
+<span id="index-common-problems"></span>
+<span id="index-problems_002c-common"></span>
+<span id="index-FAQ_002c-Kpathsea"></span>
<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).
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Unable-to-find-files"></a>
-<div class="header">
+<span id="Unable-to-find-files"></span><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>
-<a name="Unable-to-find-files-1"></a>
-<h4 class="subsection">8.5.1 Unable to find files</h4>
+<span id="Unable-to-find-files-1"></span><h4 class="subsection">8.5.1 Unable to find files</h4>
-<a name="index-unable-to-find-files"></a>
-<a name="index-files_002c-unable-to-find"></a>
+<span id="index-unable-to-find-files"></span>
+<span id="index-files_002c-unable-to-find"></span>
<p>If a program complains it cannot find fonts (or other input files), any
of several things might be wrong. In any case, you may find the
@@ -4225,8 +4146,8 @@
fonts and input files are distributed separately from the programs.
See <a href="#unixtex_002eftp">unixtex.ftp</a>.
-</li><li> <a name="index-_002fetc_002fprofile"></a>
-<a name="index-environment-variables_002c-old"></a>
+</li><li> <span id="index-_002fetc_002fprofile"></span>
+<span id="index-environment-variables_002c-old"></span>
You have (perhaps unknowingly) told Kpathsea to use search paths that
don’t reflect where the files actually are. One common cause is having
environment variables set from a previous installation, thus overriding
@@ -4233,8 +4154,8 @@
what you carefully set in <samp>texmf.cnf</samp> (see <a href="#Supported-file-formats">Supported file formats</a>). System <samp>/etc/profile</samp> or other files such may be the
culprit.
-</li><li> <a name="index-symbolic-links-not-found"></a>
-<a name="index-leaf-directories-wrongly-guessed"></a>
+</li><li> <span id="index-symbolic-links-not-found"></span>
+<span id="index-leaf-directories-wrongly-guessed"></span>
Your files reside in a directory that is only pointed to via a symbolic
link, in a leaf directory and is not listed in <samp>ls-R</samp>.
@@ -4267,17 +4188,15 @@
<hr>
-<a name="Slow-path-searching"></a>
-<div class="header">
+<span id="Slow-path-searching"></span><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>
-<a name="Slow-path-searching-1"></a>
-<h4 class="subsection">8.5.2 Slow path searching</h4>
+<span id="Slow-path-searching-1"></span><h4 class="subsection">8.5.2 Slow path searching</h4>
-<a name="index-excessive-startup-time"></a>
-<a name="index-slow-startup-time"></a>
-<a name="index-startup-time_002c-excessive"></a>
+<span id="index-excessive-startup-time"></span>
+<span id="index-slow-startup-time"></span>
+<span id="index-startup-time_002c-excessive"></span>
<p>If your program takes an excessively long time to find fonts or other
input files, but does eventually succeed, here are some possible culprits:
@@ -4306,16 +4225,14 @@
</p>
<hr>
-<a name="Unable-to-generate-fonts"></a>
-<div class="header">
+<span id="Unable-to-generate-fonts"></span><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>
-<a name="Unable-to-generate-fonts-1"></a>
-<h4 class="subsection">8.5.3 Unable to generate fonts</h4>
+<span id="Unable-to-generate-fonts-1"></span><h4 class="subsection">8.5.3 Unable to generate fonts</h4>
-<a name="index-unable-to-generate-fonts"></a>
-<a name="index-font-generation-failures"></a>
+<span id="index-unable-to-generate-fonts"></span>
+<span id="index-font-generation-failures"></span>
<p>Metafont outputs fonts in bitmap format, tuned for a particular
device at a particular resolution, in order to allow for the
@@ -4323,7 +4240,7 @@
such as Dvips, try to generate these on the fly when they are needed,
but this generation may fail in several cases.
</p>
-<a name="index-mktexpk-can_0027t-guess-mode"></a>
+<span id="index-mktexpk-can_0027t-guess-mode"></span>
<p>If <code>mktexpk</code> runs, but fails with this error:
</p><div class="example">
<pre class="example">mktexpk: Can't guess mode for <var>nnn</var> dpi devices.
@@ -4333,7 +4250,7 @@
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="http://tug.org/texinfohtml/dvips.html#Config-files">Config
+Dvips command line, or in a Dvips configuration file (see <a 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
@@ -4346,8 +4263,8 @@
M lqmed
</pre></div>
-<a name="index-Metafont-using-the-wrong-device"></a>
-<a name="index-device_002c-wrong"></a>
+<span id="index-Metafont-using-the-wrong-device"></span>
+<span id="index-device_002c-wrong"></span>
<p>If Metafont runs, but generates fonts at the wrong resolution or for
the wrong device, most likely <code>mktexpk</code>’s built-in guess for the
mode is wrong, and you should override it as above.
@@ -4355,11 +4272,11 @@
<p>See <a href="http://ctan.org/pkg/modes">http://ctan.org/pkg/modes</a> for a list of resolutions and mode
names for most devices (additional submissions are welcome).
</p>
-<a name="index-_002e2602gf"></a>
-<a name="index-2602gf"></a>
-<a name="index-Metafont-making-too_002dlarge-fonts"></a>
-<a name="index-proof-mode"></a>
-<a name="index-online-Metafont-display_002c-spurious"></a>
+<span id="index-_002e2602gf"></span>
+<span id="index-2602gf"></span>
+<span id="index-Metafont-making-too_002dlarge-fonts"></span>
+<span id="index-proof-mode"></span>
+<span id="index-online-Metafont-display_002c-spurious"></span>
<p>If Metafont runs but generates fonts at a resolution of 2602dpi
(and prints out the name of each character as well as just a character
number, and maybe tries to display the characters), then your Metafont
@@ -4372,31 +4289,29 @@
<pre class="example">inimf "plain; input modes; dump"
</pre></div>
-<p><a name="index-plain_002ebase"></a>
+<p><span id="index-plain_002ebase"></span>
Then copy the <samp>plain.base</samp> file from the current directory to where
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="http://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite>Web2c</cite>.
+See <a href="https://tug.org/texinfohtml/web2c.html#inimf-invocation">inimf invocation</a> in <cite>Web2c</cite>.
</p>
-<a name="index-Metafont-installation"></a>
+<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>).
</p>
<hr>
-<a name="TeX-or-Metafont-failing"></a>
-<div class="header">
+<span id="TeX-or-Metafont-failing"></span><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>
-<a name="TeX-or-Metafont-failing-1"></a>
-<h4 class="subsection">8.5.4 TeX or Metafont failing</h4>
+<span id="TeX-or-Metafont-failing-1"></span><h4 class="subsection">8.5.4 TeX or Metafont failing</h4>
-<a name="index-TeX-failures"></a>
-<a name="index-Metafont-failures"></a>
-<a name="index-compiler-bugs"></a>
+<span id="index-TeX-failures"></span>
+<span id="index-Metafont-failures"></span>
+<span id="index-compiler-bugs"></span>
<p>If TeX or Metafont get a segmentation fault or otherwise fail while
running a normal input file, the problem is usually a compiler bug
(unlikely as that may sound). Even if the trip and trap tests are
@@ -4403,36 +4318,30 @@
passed, problems may lurk. Optimization occasionally causes trouble in
programs other than TeX and Metafont themselves, too.
</p>
-<p>Insufficient swap space may also cause core dumps or other erratic
-behavior.
-</p>
-<a name="index-optimization-caveat"></a>
+<span id="index-optimization-caveat"></span>
<p>For a workaround, if you enabled any optimization flags, it’s best to
omit optimization entirely. In any case, the way to find the facts is
to run the program under the debugger and see where it’s failing.
</p>
-<a name="index-GNU-C-compiler-bugs"></a>
-<a name="index-system-C-compiler-bugs"></a>
+<span id="index-GNU-C-compiler-bugs"></span>
+<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="http://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 href="https://gcc.gnu.org/onlinedocs/gcc/Bugs.html#Bugs">Bugs</a> in <cite>Using and Porting GNU CC</cite>.
</p>
-<a name="index-compiler-bugs_002c-finding"></a>
+<span id="index-compiler-bugs_002c-finding"></span>
<p>To report compiler bugs effectively requires perseverance and
perspicacity: you must find the miscompiled line, and that usually
involves delving backwards in time from the point of error, checking
-through TeX’s (or whatever program’s) data structures. Things are
-not helped by all-too-common bugs in the debugger itself. Good luck.
+through TeX’s (or whatever program’s) data structures. Good luck.
</p>
<hr>
-<a name="Index"></a>
-<div class="header">
+<span id="Index"></span><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>
</div>
-<a name="Index-1"></a>
-<h2 class="unnumbered">Index</h2>
+<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>!</b></a>
@@ -4509,13 +4418,13 @@
<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-1">!</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-1">!</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0021_0021-in-path-specifications"><code>!! <span class="roman">in path specifications</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-2">$</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-2">$</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0024-expansion"><code>$ <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Variable-expansion">Variable expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-3">-</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-3">-</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dall"><code>--all</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dcasefold_002dsearch"><code>--casefold-search</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dcolor_003dtty"><code>--color=tty</code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
@@ -4540,6 +4449,7 @@
<tr><td></td><td valign="top"><a href="#index-_002d_002dsafe_002dout_002dname_003dname"><code>--safe-out-name=<var>name</var></code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dshow_002dpath_003dname"><code>--show-path=<var>name</var></code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dsubdir_003dstring"><code>--subdir=<var>string</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dvar_002dbrace_002dvalue_003dvariable"><code>--var-brace-value=<var>variable</var></code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dvar_002dvalue_003dvariable"><code>--var-value=<var>variable</var></code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dversion"><code>--version</code></a>:</td><td> </td><td valign="top"><a href="#Standard-options">Standard options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dwith_002dmktextex_002ddefault"><code>--with-mktextex-default</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
@@ -4555,7 +4465,7 @@
<tr><td></td><td valign="top"><a href="#index-_002diname_002c-find-predicate"><code>-iname<span class="roman">, find predicate</span></code></a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dL-option-to-ls"><code>-L <span class="roman">option to <code>ls</code></span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-4">.</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-4">.</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002e-directories_002c-ignored"><code>. <span class="roman">directories, ignored</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002e-files"><code>. <span class="roman">files</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002e2602gf"><code>.2602gf</code></a>:</td><td> </td><td valign="top"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
@@ -4609,7 +4519,7 @@
<tr><td></td><td valign="top"><a href="#index-_002eweb"><code>.web</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-_002eweb-1"><code>.web</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-5">/</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-5">/</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002f-may-not-be-_002f"><code>/ <span class="roman">may not be /</span></code></a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002f_002c-trailing-in-home-directory"><code>/<span class="roman">, trailing in home directory</span></code></a>:</td><td> </td><td valign="top"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002f_002f"><code>//</code></a>:</td><td> </td><td valign="top"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
@@ -4617,28 +4527,28 @@
<tr><td></td><td valign="top"><a href="#index-_002fetc_002fprofile-and-aliases"><code>/etc/profile <span class="roman">and aliases</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002fvar_002ftmp_002ftexfonts"><code>/var/tmp/texfonts</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-6">2</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-6">2</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-2602gf"><code>2602gf</code></a>:</td><td> </td><td valign="top"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-7">8</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-7">8</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-8_002e3-filenames_002c-using">8.3 filenames, using</a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-8">:</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-8">:</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003a-may-not-be-_003a"><code>: <span class="roman">may not be :</span></code></a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003a_003a-expansion"><code>:: <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-9">\</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-9">\</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005c_002c-line-continuation-in-texmf_002ecnf"><code>\<span class="roman">, line continuation in <samp>texmf.cnf</samp></span></code></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-_005copenin"><code>\openin</code></a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cspecial_002c-suppressing-warnings-about"><code>\special<span class="roman">, suppressing warnings about</span></code></a>:</td><td> </td><td valign="top"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-10">{</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-10">{</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007b-expansion"><code>{ <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Brace-expansion">Brace expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-11">~</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-11">~</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007e-expansion"><code>~ <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-absolute-filenames">absolute filenames</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-access-system-call"><code>access <span class="roman">system call</span></code></a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-access-warnings">access warnings</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
@@ -4659,7 +4569,7 @@
<tr><td></td><td valign="top"><a href="#index-automounter_002c-and-ls_002dR">automounter, and <samp>ls-R</samp></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-auxiliary-tasks">auxiliary tasks</a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-B">B</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Bach_002c-Johann-Sebastian">Bach, Johann Sebastian</a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-backslash_002dnewline">backslash-newline</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-basic-glyph-lookup">basic glyph lookup</a>:</td><td> </td><td valign="top"><a href="#Basic-glyph-lookup">Basic glyph lookup</a></td></tr>
@@ -4677,7 +4587,7 @@
<tr><td></td><td valign="top"><a href="#index-bug-mailing-list">bug mailing list</a>:</td><td> </td><td valign="top"><a href="#Mailing-lists">Mailing lists</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bugs_002c-reporting">bugs, reporting</a>:</td><td> </td><td valign="top"><a href="#Reporting-bugs">Reporting bugs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-C">C</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-c_002d_002a_002eh"><code>c-*.h</code></a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-c_002dauto_002eh"><code>c-auto.h</code></a>:</td><td> </td><td valign="top"><a href="#Programming-overview">Programming overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cache-of-fonts_002c-local">cache of fonts, local</a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr>
@@ -4724,7 +4634,7 @@
<tr><td></td><td valign="top"><a href="#index-crashes_002c-reporting">crashes, reporting</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-CWEBINPUTS"><code>CWEBINPUTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-D">D</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-database-search">database search</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-database_002c-for-filenames">database, for filenames</a>:</td><td> </td><td valign="top"><a href="#Filename-database">Filename database</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-database_002c-format-of">database, format of</a>:</td><td> </td><td valign="top"><a href="#Database-format">Database format</a></td></tr>
@@ -4758,7 +4668,7 @@
<tr><td></td><td valign="top"><a href="#index-DVIPSSIZES"><code>DVIPSSIZES</code></a>:</td><td> </td><td valign="top"><a href="#Fallback-font">Fallback font</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dynamic-creation-of-files">dynamic creation of files</a>:</td><td> </td><td valign="top"><a href="#mktex-scripts">mktex scripts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-EC-fonts_002c-and-dynamic-source-creation">EC fonts, and dynamic source creation</a>:</td><td> </td><td valign="top"><a href="#mktex-scripts">mktex scripts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-elt_002ddirs_002ec"><code>elt-dirs.c</code></a>:</td><td> </td><td valign="top"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-elt_002ddirs_002ec-1"><code>elt-dirs.c</code></a>:</td><td> </td><td valign="top"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
@@ -4786,7 +4696,7 @@
<tr><td></td><td valign="top"><a href="#index-externally_002dbuilt-filename-database">externally-built filename database</a>:</td><td> </td><td valign="top"><a href="#Filename-database">Filename database</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-extra-colons">extra colons</a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-F">F</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-failed-mktex_2026-script-invocation">failed <code>mktex…</code> script invocation</a>:</td><td> </td><td valign="top"><a href="#mktex-script-names">mktex script names</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fallback-font">fallback font</a>:</td><td> </td><td valign="top"><a href="#Fallback-font">Fallback font</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fallback-resolutions">fallback resolutions</a>:</td><td> </td><td valign="top"><a href="#Fallback-font">Fallback font</a></td></tr>
@@ -4826,7 +4736,7 @@
<tr><td></td><td valign="top"><a href="#index-ftp_002etug_002eorg"><code>ftp.tug.org</code></a>:</td><td> </td><td valign="top"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fundamental-purpose-of-Kpathsea">fundamental purpose of Kpathsea</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-G">G</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-gdb_002c-recommended"><code>gdb<span class="roman">, recommended</span></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-gf"><code>gf</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-GFFONTS"><code>GFFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
@@ -4841,7 +4751,7 @@
<tr><td></td><td valign="top"><a href="#index-group_002dwritable-directories">group-writable directories</a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GSFTOPK_005fDEBUG-_0028128_0029"><code>GSFTOPK_DEBUG <span class="roman">(128)</span></code></a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-H">H</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-H">H</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-hash-table-buckets_002c-printing">hash table buckets, printing</a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hash-table-routines">hash table routines</a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hash_005fsummary_005fonly-variable-for-debugging"><code>hash_summary_only <span class="roman">variable for debugging</span></code></a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
@@ -4850,7 +4760,7 @@
<tr><td></td><td valign="top"><a href="#index-home-directories-in-paths">home directories in paths</a>:</td><td> </td><td valign="top"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HOME_002c-as-_007e-expansion"><code>HOME<span class="roman">, as ~ expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#Tilde-expansion">Tilde expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-I">I</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-identifiers_002c-characters-valid-in">identifiers, characters valid in</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-include-fontmap-directive"><code>include <span class="roman">fontmap directive</span></code></a>:</td><td> </td><td valign="top"><a href="#Fontmap">Fontmap</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-INDEXSTYLE"><code>INDEXSTYLE</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
@@ -4859,7 +4769,7 @@
<tr><td></td><td valign="top"><a href="#index-interface_002c-not-frozen">interface, not frozen</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-introduction">introduction</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-K">K</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-K">K</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-kdebug_003a">‘<samp>kdebug:</samp>’</a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kdefault_002ec"><code>kdefault.c</code></a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Knuth_002c-Donald-E_002e">Knuth, Donald E.</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
@@ -4902,7 +4812,7 @@
<tr><td></td><td valign="top"><a href="#index-KPSE_005fDOT-expansion"><code>KPSE_DOT <span class="roman">expansion</span></code></a>:</td><td> </td><td valign="top"><a href="#KPSE_005fDOT-expansion">KPSE_DOT expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpse_005fformat_005finfo_005ftype"><code>kpse_format_info_type</code></a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-L">L</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-last_002dresort-font">last-resort font</a>:</td><td> </td><td valign="top"><a href="#Fallback-font">Fallback font</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lcircle10"><code>lcircle10</code></a>:</td><td> </td><td valign="top"><a href="#Fontmap">Fontmap</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-leading-colons">leading colons</a>:</td><td> </td><td valign="top"><a href="#Default-expansion">Default expansion</a></td></tr>
@@ -4921,7 +4831,7 @@
<tr><td></td><td valign="top"><a href="#index-ls_002dR-database-file"><code>ls-R <span class="roman">database file</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ls_002dR_002c-simplest-build"><code>ls-R<span class="roman">, simplest build</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Mac-filesystem_002c-case_002dinsensitive">Mac filesystem, case-insensitive</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-MacKenzie_002c-David">MacKenzie, David</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-MacKenzie_002c-David-1">MacKenzie, David</a>:</td><td> </td><td valign="top"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr>
@@ -4972,7 +4882,7 @@
<tr><td></td><td valign="top"><a href="#index-multiple-TeX-hierarchies">multiple TeX hierarchies</a>:</td><td> </td><td valign="top"><a href="#Brace-expansion">Brace expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-must-exist">must exist</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-N">N</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-names-for-mktex-scripts">names for <samp>mktex</samp> scripts</a>:</td><td> </td><td valign="top"><a href="#mktex-script-names">mktex script names</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Neumann_002c-Gustaf">Neumann, Gustaf</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-NFS-and-ls_002dR">NFS and <samp>ls-R</samp></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
@@ -4982,7 +4892,7 @@
<tr><td></td><td valign="top"><a href="#index-null-pointers_002c-dereferencing">null pointers, dereferencing</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-numeric-debugging-values">numeric debugging values</a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-O">O</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-obtaining-TeX">obtaining TeX</a>:</td><td> </td><td valign="top"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-OCPINPUTS"><code>OCPINPUTS</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-OFMFONTS"><code>OFMFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
@@ -4996,7 +4906,7 @@
<tr><td></td><td valign="top"><a href="#index-OVFFONTS"><code>OVFFONTS</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-OVPFONTS"><code>OVPFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-P">P</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-path-expansion">path expansion</a>:</td><td> </td><td valign="top"><a href="#Path-expansion">Path expansion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-path-searching">path searching</a>:</td><td> </td><td valign="top"><a href="#Path-searching">Path searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-path-searching-options">path searching options</a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr>
@@ -5026,10 +4936,10 @@
<tr><td></td><td valign="top"><a href="#index-PSHEADERS"><code>PSHEADERS</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-pxp-Pascal-preprocessor"><code>pxp <span class="roman">Pascal preprocessor</span></code></a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Q">Q</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Q">Q</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-quoting-variable-values">quoting variable values</a>:</td><td> </td><td valign="top"><a href="#Variable-expansion">Variable expansion</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-rationale-for-casefolding-fallback">rationale for casefolding fallback</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-re_002dentrant-API">re-entrant API</a>:</td><td> </td><td valign="top"><a href="#Programming-overview">Programming overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-readable"><code>readable</code></a>:</td><td> </td><td valign="top"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr>
@@ -5048,7 +4958,7 @@
<tr><td></td><td valign="top"><a href="#index-runtime-configuration-files">runtime 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-runtime-debugging">runtime debugging</a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-S">S</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Sauter-fonts_002c-and-dynamic-source-creation">Sauter fonts, and dynamic source creation</a>:</td><td> </td><td valign="top"><a href="#mktex-scripts">mktex scripts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-scripts-for-file-creation">scripts for file creation</a>:</td><td> </td><td valign="top"><a href="#mktex-scripts">mktex scripts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-search-path_002c-defined">search path, defined</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr>
@@ -5099,7 +5009,7 @@
<tr><td></td><td valign="top"><a href="#index-system-C-compiler-bugs">system C compiler bugs</a>:</td><td> </td><td valign="top"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-system_002ddependent-casefolding-behavior">system-dependent casefolding behavior</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-T1FONTS"><code>T1FONTS</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-T1INPUTS"><code>T1INPUTS</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-T42FONTS"><code>T42FONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr>
@@ -5177,7 +5087,7 @@
<tr><td></td><td valign="top"><a href="#index-typeface-directory_002c-omitting">typeface directory, omitting</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-typeface-directory_002c-omitting-1">typeface directory, omitting</a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-U">U</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-U">U</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-unable-to-find-files">unable to find files</a>:</td><td> </td><td valign="top"><a href="#Unable-to-find-files">Unable to find files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-unable-to-generate-fonts">unable to generate fonts</a>:</td><td> </td><td valign="top"><a href="#Unable-to-generate-fonts">Unable to generate fonts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-uname"><code>uname</code></a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr>
@@ -5191,7 +5101,7 @@
<tr><td></td><td valign="top"><a href="#index-USE_005fTEXMFVAR"><code>USE_TEXMFVAR</code></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-USE_005fVARTEXFONTS"><code>USE_VARTEXFONTS</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-V">V</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-V">V</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-varfonts"><code>varfonts</code></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-variable-expansion">variable expansion</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-variable_002ec"><code>variable.c</code></a>:</td><td> </td><td valign="top"><a href="#Variable-expansion">Variable expansion</a></td></tr>
@@ -5203,7 +5113,7 @@
<tr><td></td><td valign="top"><a href="#index-VFFONTS"><code>VFFONTS</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-Vojta_002c-Paul">Vojta, Paul</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-W">W</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-W">W</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Walsh_002c-Norman">Walsh, Norman</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-warning-about-unusable-ls_002dR">warning about unusable <samp>ls-R</samp></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-warning_002c-about-missing-texmf_002ecnf">warning, about missing <samp>texmf.cnf</samp></a>:</td><td> </td><td valign="top"><a href="#Config-files">Config files</a></td></tr>
@@ -5217,13 +5127,13 @@
<tr><td></td><td valign="top"><a href="#index-Windows-and-casefolding">Windows and casefolding</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-www_002etug_002eorg"><code>www.tug.org</code></a>:</td><td> </td><td valign="top"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-X">X</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-X">X</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-XDvi"><code>XDvi</code></a>:</td><td> </td><td valign="top"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-XDVIFONTS"><code>XDVIFONTS</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-XDVIMAKEPK"><code>XDVIMAKEPK</code></a>:</td><td> </td><td valign="top"><a href="#mktex-script-names">mktex script names</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-XDVISIZES"><code>XDVISIZES</code></a>:</td><td> </td><td valign="top"><a href="#Fallback-font">Fallback font</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Z">Z</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Z">Z</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-zuhn_002c-david">zuhn, david</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
Modified: trunk/Master/texmf-dist/doc/kpathsea/kpathsea.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
===================================================================
--- trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html 2019-02-28 19:09:21 UTC (rev 50169)
+++ trunk/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html 2019-02-28 19:14:13 UTC (rev 50170)
@@ -2,7 +2,7 @@
<html>
<!-- This file documents the TeX Live build system and more.
-Copyright (C) 2016-2018 Karl Berry.
+Copyright (C) 2016-2019 Karl Berry.
Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner.
@@ -20,13 +20,13 @@
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.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>Building TeX Live (2018)</title>
+<title>Building TeX Live (2019)</title>
-<meta name="description" content="Building TeX Live (2018)">
-<meta name="keywords" content="Building TeX Live (2018)">
+<meta name="description" content="Building TeX Live (2019)">
+<meta name="keywords" content="Building TeX Live (2019)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -38,23 +38,14 @@
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
-blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
-blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
-div.smalldisplay {margin-left: 3.2em}
-div.smallexample {margin-left: 3.2em}
-div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
-pre.smalldisplay {font-family: inherit; font-size: smaller}
-pre.smallexample {font-size: smaller}
-pre.smallformat {font-family: inherit; font-size: smaller}
-pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
@@ -66,7 +57,7 @@
</head>
<body lang="en">
-<h1 class="settitle" align="center">Building TeX Live (2018)</h1>
+<h1 class="settitle" align="center">Building TeX Live (2019)</h1>
@@ -76,275 +67,272 @@
-<a name="SEC_Overview"></a>
+<span id="SEC_Overview"></span>
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
<ul class="no-bullet">
-<li><a name="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li>
-<li><a name="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li>
-<li><a name="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li>
-<li><a name="stoc-Building-1" href="#toc-Building-1">4 Building</a></li>
-<li><a name="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li>
-<li><a name="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li>
-<li><a name="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li>
-<li><a name="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li>
-<li><a name="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li>
-<li><a name="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li>
-<li><a name="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li>
-<li><a name="stoc-Index-1" href="#toc-Index-1">Index</a></li>
+<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li>
+<li><a id="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li>
+<li><a id="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li>
+<li><a id="stoc-Building-1" href="#toc-Building-1">4 Building</a></li>
+<li><a id="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li>
+<li><a id="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li>
+<li><a id="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li>
+<li><a id="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li>
+<li><a id="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li>
+<li><a id="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li>
+<li><a id="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li>
+<li><a id="stoc-Index-1" href="#toc-Index-1">Index</a></li>
</ul>
</div>
-<a name="SEC_Contents"></a>
+<span id="SEC_Contents"></span>
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="no-bullet">
- <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
- <li><a name="toc-Overview-of-build-system-1" href="#Overview-of-build-system">2 Overview of build system</a></li>
- <li><a name="toc-Prerequisites-1" href="#Prerequisites">3 Prerequisites</a></li>
- <li><a name="toc-Building-1" href="#Building">4 Building</a>
+ <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
+ <li><a id="toc-Overview-of-build-system-1" href="#Overview-of-build-system">2 Overview of build system</a></li>
+ <li><a id="toc-Prerequisites-1" href="#Prerequisites">3 Prerequisites</a></li>
+ <li><a id="toc-Building-1" href="#Building">4 Building</a>
<ul class="no-bullet">
- <li><a name="toc-Build-iteration-1" href="#Build-iteration">4.1 Build iteration</a></li>
- <li><a name="toc-Build-problems-1" href="#Build-problems">4.2 Build problems</a></li>
- <li><a name="toc-Build-in-parallel-1" href="#Build-in-parallel">4.3 Build in parallel</a></li>
- <li><a name="toc-Build-distribution-1" href="#Build-distribution">4.4 Build distribution</a></li>
- <li><a name="toc-Build-one-package-1" href="#Build-one-package">4.5 Build one package</a></li>
- <li><a name="toc-Cross-compilation-1" href="#Cross-compilation">4.6 Cross compilation</a>
+ <li><a id="toc-Build-iteration-1" href="#Build-iteration">4.1 Build iteration</a></li>
+ <li><a id="toc-Build-problems-1" href="#Build-problems">4.2 Build problems</a></li>
+ <li><a id="toc-Build-in-parallel-1" href="#Build-in-parallel">4.3 Build in parallel</a></li>
+ <li><a id="toc-Build-distribution-1" href="#Build-distribution">4.4 Build distribution</a></li>
+ <li><a id="toc-Build-one-package-1" href="#Build-one-package">4.5 Build one package</a></li>
+ <li><a id="toc-Build-one-engine-1" href="#Build-one-engine">4.6 Build one engine</a></li>
+ <li><a id="toc-Cross-compilation-1" href="#Cross-compilation">4.7 Cross compilation</a>
<ul class="no-bullet">
- <li><a name="toc-Cross-configuring-1" href="#Cross-configuring">4.6.1 Cross configuring</a></li>
- <li><a name="toc-Cross-problems-1" href="#Cross-problems">4.6.2 Cross problems</a></li>
+ <li><a id="toc-Cross-configuring-1" href="#Cross-configuring">4.7.1 Cross configuring</a></li>
+ <li><a id="toc-Cross-problems-1" href="#Cross-problems">4.7.2 Cross problems</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Installing-1" href="#Installing">5 Installing</a>
+ <li><a id="toc-Installing-1" href="#Installing">5 Installing</a>
<ul class="no-bullet">
- <li><a name="toc-Installation-directories-1" href="#Installation-directories">5.1 Installation directories</a></li>
- <li><a name="toc-Linked-scripts-1" href="#Linked-scripts">5.2 Linked scripts</a></li>
- <li><a name="toc-Distro-builds-1" href="#Distro-builds">5.3 Distro builds</a></li>
+ <li><a id="toc-Installation-directories-1" href="#Installation-directories">5.1 Installation directories</a></li>
+ <li><a id="toc-Linked-scripts-1" href="#Linked-scripts">5.2 Linked scripts</a></li>
+ <li><a id="toc-Distro-builds-1" href="#Distro-builds">5.3 Distro builds</a></li>
</ul></li>
- <li><a name="toc-Layout-and-infrastructure-1" href="#Layout-and-infrastructure">6 Layout and infrastructure</a>
+ <li><a id="toc-Layout-and-infrastructure-1" href="#Layout-and-infrastructure">6 Layout and infrastructure</a>
<ul class="no-bullet">
- <li><a name="toc-Build-system-tools-1" href="#Build-system-tools">6.1 Build system tools</a></li>
- <li><a name="toc-Top_002dlevel-directories-1" href="#Top_002dlevel-directories">6.2 Top-level directories</a></li>
- <li><a name="toc-Autoconf-macros-1" href="#Autoconf-macros">6.3 Autoconf macros</a>
+ <li><a id="toc-Build-system-tools-1" href="#Build-system-tools">6.1 Build system tools</a></li>
+ <li><a id="toc-Top_002dlevel-directories-1" href="#Top_002dlevel-directories">6.2 Top-level directories</a></li>
+ <li><a id="toc-Autoconf-macros-1" href="#Autoconf-macros">6.3 Autoconf macros</a>
<ul class="no-bullet">
- <li><a name="toc-General-setup-macros-1" href="#General-setup-macros">6.3.1 General setup macros</a></li>
- <li><a name="toc-Macros-for-programs-1" href="#Macros-for-programs">6.3.2 Macros for programs</a></li>
- <li><a name="toc-Macros-for-compilers-1" href="#Macros-for-compilers">6.3.3 Macros for compilers</a></li>
- <li><a name="toc-Macros-for-libraries-1" href="#Macros-for-libraries">6.3.4 Macros for libraries</a></li>
- <li><a name="toc-Macros-for-library-and-header-flags-1" href="#Macros-for-library-and-header-flags">6.3.5 Macros for library and header flags</a></li>
- <li><a name="toc-Macros-for-Windows-1" href="#Macros-for-Windows">6.3.6 Macros for Windows</a></li>
+ <li><a id="toc-General-setup-macros-1" href="#General-setup-macros">6.3.1 General setup macros</a></li>
+ <li><a id="toc-Macros-for-programs-1" href="#Macros-for-programs">6.3.2 Macros for programs</a></li>
+ <li><a id="toc-Macros-for-compilers-1" href="#Macros-for-compilers">6.3.3 Macros for compilers</a></li>
+ <li><a id="toc-Macros-for-libraries-1" href="#Macros-for-libraries">6.3.4 Macros for libraries</a></li>
+ <li><a id="toc-Macros-for-library-and-header-flags-1" href="#Macros-for-library-and-header-flags">6.3.5 Macros for library and header flags</a></li>
+ <li><a id="toc-Macros-for-Windows-1" href="#Macros-for-Windows">6.3.6 Macros for Windows</a></li>
</ul></li>
- <li><a name="toc-Library-modules-1" href="#Library-modules">6.4 Library modules</a>
+ <li><a id="toc-Library-modules-1" href="#Library-modules">6.4 Library modules</a>
<ul class="no-bullet">
- <li><a name="toc-The-png-library-in-libs_002flibpng" href="#png-library">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></a></li>
- <li><a name="toc-The-zlib-library-in-libs_002fzlib" href="#zlib-library">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></a></li>
- <li><a name="toc-The-freetype-library-in-libs_002ffreetype2" href="#freetype-library">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></a></li>
- <li><a name="toc-The-kpathsea-library-in-texk_002fkpathsea" href="#kpathsea-library">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a></li>
+ <li><a id="toc-The-png-library-in-libs_002flibpng" href="#png-library">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></a></li>
+ <li><a id="toc-The-zlib-library-in-libs_002fzlib" href="#zlib-library">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></a></li>
+ <li><a id="toc-The-freetype-library-in-libs_002ffreetype2" href="#freetype-library">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></a></li>
+ <li><a id="toc-The-kpathsea-library-in-texk_002fkpathsea" href="#kpathsea-library">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a></li>
</ul></li>
- <li><a name="toc-Program-modules-1" href="#Program-modules">6.5 Program modules</a>
+ <li><a id="toc-Program-modules-1" href="#Program-modules">6.5 Program modules</a>
<ul class="no-bullet">
- <li><a name="toc-The-t1utils-package-in-utils_002ft1utils" href="#t1utils-package">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></a></li>
- <li><a name="toc-The-xindy-package-in-utils_002fxindy" href="#xindy-package">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></a></li>
- <li><a name="toc-The-xdvik-package-in-texk_002fxdvik" href="#xdvik-package">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li>
- <li><a name="toc-The-subdirectory-utils_002fasymptote" href="#asymptote">6.5.4 The subdirectory <samp>utils/asymptote</samp></a></li>
+ <li><a id="toc-The-t1utils-package-in-utils_002ft1utils" href="#t1utils-package">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></a></li>
+ <li><a id="toc-The-xindy-package-in-utils_002fxindy" href="#xindy-package">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></a></li>
+ <li><a id="toc-The-xdvik-package-in-texk_002fxdvik" href="#xdvik-package">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li>
+ <li><a id="toc-The-subdirectory-utils_002fasymptote" href="#asymptote">6.5.4 The subdirectory <samp>utils/asymptote</samp></a></li>
</ul></li>
- <li><a name="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX Live</a>
+ <li><a id="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX Live</a>
<ul class="no-bullet">
- <li><a name="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li>
- <li><a name="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.2 Adding a new generic library module</a></li>
- <li><a name="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.3 Adding a new TeX-specific library module</a></li>
+ <li><a id="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li>
+ <li><a id="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.2 Adding a new generic library module</a></li>
+ <li><a id="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.3 Adding a new TeX-specific library module</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Configure-options-1" href="#Configure-options">7 Configure options</a>
+ <li><a id="toc-Configure-options-1" href="#Configure-options">7 Configure options</a>
<ul class="no-bullet">
- <li><a name="toc-Global-configure-options-1" href="#Global-configure-options">7.1 Global configure options</a>
+ <li><a id="toc-Global-configure-options-1" href="#Global-configure-options">7.1 Global configure options</a>
<ul class="no-bullet">
- <li><a name="toc-_002d_002ddisable_002dnative_002dtexlive_002dbuild-1" href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">7.1.1 <code>--disable-native-texlive-build</code></a></li>
- <li><a name="toc-_002d_002dprefix_002c-_002d_002dbindir_002c-_2026" href="#g_t_002d_002dprefix-_002d_002dbindir-_2026">7.1.2 <code>--prefix</code>, <code>--bindir</code>, …</a></li>
- <li><a name="toc-_002d_002ddisable_002dlargefile-1" href="#g_t_002d_002ddisable_002dlargefile">7.1.3 <code>--disable-largefile</code></a></li>
- <li><a name="toc-_002d_002ddisable_002dmissing-1" href="#g_t_002d_002ddisable_002dmissing">7.1.4 <code>--disable-missing</code></a></li>
- <li><a name="toc-_002d_002denable_002dcompiler_002dwarnings_003dlevel-1" href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></a></li>
- <li><a name="toc-_002d_002denable_002dcxx_002druntime_002dhack-1" href="#g_t_002d_002denable_002dcxx_002druntime_002dhack">7.1.6 <code>--enable-cxx-runtime-hack</code></a></li>
- <li><a name="toc-_002d_002denable_002dmaintainer_002dmode-1" href="#g_t_002d_002denable_002dmaintainer_002dmode">7.1.7 <code>--enable-maintainer-mode</code></a></li>
- <li><a name="toc-_002d_002denable_002dmultiplatform-1" href="#g_t_002d_002denable_002dmultiplatform">7.1.8 <code>--enable-multiplatform</code></a></li>
- <li><a name="toc-_002d_002denable_002dshared-1" href="#g_t_002d_002denable_002dshared">7.1.9 <code>--enable-shared</code></a></li>
- <li><a name="toc-_002d_002denable_002dsilent_002drules-1" href="#g_t_002d_002denable_002dsilent_002drules">7.1.10 <code>--enable-silent-rules</code></a></li>
- <li><a name="toc-_002d_002dwithout_002dln_002ds-1" href="#g_t_002d_002dwithout_002dln_002ds">7.1.11 <code>--without-ln-s</code></a></li>
- <li><a name="toc-_002d_002dwithout_002dx-1" href="#g_t_002d_002dwithout_002dx">7.1.12 <code>--without-x</code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dnative_002dtexlive_002dbuild-1" href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">7.1.1 <code>--disable-native-texlive-build</code></a></li>
+ <li><a id="toc-_002d_002dprefix_002c-_002d_002dbindir_002c-_2026" href="#g_t_002d_002dprefix-_002d_002dbindir-_2026">7.1.2 <code>--prefix</code>, <code>--bindir</code>, …</a></li>
+ <li><a id="toc-_002d_002ddisable_002dlargefile-1" href="#g_t_002d_002ddisable_002dlargefile">7.1.3 <code>--disable-largefile</code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dmissing-1" href="#g_t_002d_002ddisable_002dmissing">7.1.4 <code>--disable-missing</code></a></li>
+ <li><a id="toc-_002d_002denable_002dcompiler_002dwarnings_003dlevel-1" href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></a></li>
+ <li><a id="toc-_002d_002denable_002dcxx_002druntime_002dhack-1" href="#g_t_002d_002denable_002dcxx_002druntime_002dhack">7.1.6 <code>--enable-cxx-runtime-hack</code></a></li>
+ <li><a id="toc-_002d_002denable_002dmaintainer_002dmode-1" href="#g_t_002d_002denable_002dmaintainer_002dmode">7.1.7 <code>--enable-maintainer-mode</code></a></li>
+ <li><a id="toc-_002d_002denable_002dmultiplatform-1" href="#g_t_002d_002denable_002dmultiplatform">7.1.8 <code>--enable-multiplatform</code></a></li>
+ <li><a id="toc-_002d_002denable_002dshared-1" href="#g_t_002d_002denable_002dshared">7.1.9 <code>--enable-shared</code></a></li>
+ <li><a id="toc-_002d_002denable_002dsilent_002drules-1" href="#g_t_002d_002denable_002dsilent_002drules">7.1.10 <code>--enable-silent-rules</code></a></li>
+ <li><a id="toc-_002d_002dwithout_002dln_002ds-1" href="#g_t_002d_002dwithout_002dln_002ds">7.1.11 <code>--without-ln-s</code></a></li>
+ <li><a id="toc-_002d_002dwithout_002dx-1" href="#g_t_002d_002dwithout_002dx">7.1.12 <code>--without-x</code></a></li>
</ul></li>
- <li><a name="toc-Program_002dspecific-configure-options-1" href="#Program_002dspecific-configure-options">7.2 Program-specific configure options</a>
+ <li><a id="toc-Program_002dspecific-configure-options-1" href="#Program_002dspecific-configure-options">7.2 Program-specific configure options</a>
<ul class="no-bullet">
- <li><a name="toc-_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog" href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></a></li>
- <li><a name="toc-_002d_002ddisable_002dall_002dpkgs-1" href="#g_t_002d_002ddisable_002dall_002dpkgs">7.2.2 <code>--disable-all-pkgs</code></a></li>
- <li><a name="toc-Configure-options-for-texk_002fweb2c-1" href="#Configure-options-for-texk_002fweb2c">7.2.3 Configure options for <samp>texk/web2c</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fbibtex_002dx-1" href="#Configure-options-for-texk_002fbibtex_002dx">7.2.4 Configure options for <samp>texk/bibtex-x</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fdvipdfm_002dx-1" href="#Configure-options-for-texk_002fdvipdfm_002dx">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fdvisvgm-1" href="#Configure-options-for-texk_002fdvisvgm">7.2.6 Configure options for <samp>texk/dvisvgm</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002ftexlive-1" href="#Configure-options-for-texk_002ftexlive">7.2.7 Configure options for <samp>texk/texlive</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fxdvik-1" href="#Configure-options-for-texk_002fxdvik">7.2.8 Configure options for <samp>texk/xdvik</samp></a></li>
- <li><a name="toc-Configure-options-for-utils_002fxindy-1" href="#Configure-options-for-utils_002fxindy">7.2.9 Configure options for <samp>utils/xindy</samp></a></li>
+ <li><a id="toc-_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog" href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dall_002dpkgs-1" href="#g_t_002d_002ddisable_002dall_002dpkgs">7.2.2 <code>--disable-all-pkgs</code></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fweb2c-1" href="#Configure-options-for-texk_002fweb2c">7.2.3 Configure options for <samp>texk/web2c</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fbibtex_002dx-1" href="#Configure-options-for-texk_002fbibtex_002dx">7.2.4 Configure options for <samp>texk/bibtex-x</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fdvipdfm_002dx-1" href="#Configure-options-for-texk_002fdvipdfm_002dx">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fdvisvgm-1" href="#Configure-options-for-texk_002fdvisvgm">7.2.6 Configure options for <samp>texk/dvisvgm</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002ftexlive-1" href="#Configure-options-for-texk_002ftexlive">7.2.7 Configure options for <samp>texk/texlive</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fxdvik-1" href="#Configure-options-for-texk_002fxdvik">7.2.8 Configure options for <samp>texk/xdvik</samp></a></li>
+ <li><a id="toc-Configure-options-for-utils_002fxindy-1" href="#Configure-options-for-utils_002fxindy">7.2.9 Configure options for <samp>utils/xindy</samp></a></li>
</ul></li>
- <li><a name="toc-Library_002dspecific-configure-options-1" href="#Library_002dspecific-configure-options">7.3 Library-specific configure options</a>
+ <li><a id="toc-Library_002dspecific-configure-options-1" href="#Library_002dspecific-configure-options">7.3 Library-specific configure options</a>
<ul class="no-bullet">
- <li><a name="toc-Configure-options-for-kpathsea-1" href="#Configure-options-for-kpathsea">7.3.1 Configure options for <code>kpathsea</code></a></li>
- <li><a name="toc-Configure-options-for-system-poppler-1" href="#Configure-options-for-system-poppler">7.3.2 Configure options for system <code>poppler</code></a></li>
+ <li><a id="toc-Configure-options-for-kpathsea-1" href="#Configure-options-for-kpathsea">7.3.1 Configure options for <code>kpathsea</code></a></li>
+ <li><a id="toc-Configure-options-for-system-poppler-1" href="#Configure-options-for-system-poppler">7.3.2 Configure options for system <code>poppler</code></a></li>
</ul></li>
- <li><a name="toc-Variables-for-configure-1" href="#Variables-for-configure">7.4 Variables for configure</a></li>
+ <li><a id="toc-Variables-for-configure-1" href="#Variables-for-configure">7.4 Variables for configure</a></li>
</ul></li>
- <li><a name="toc-Coding-conventions-1" href="#Coding-conventions">8 Coding conventions</a>
+ <li><a id="toc-Coding-conventions-1" href="#Coding-conventions">8 Coding conventions</a>
<ul class="no-bullet">
- <li><a name="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
- <li><a name="toc-Const-1" href="#Const">8.2 Const</a></li>
+ <li><a id="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
+ <li><a id="toc-Const-1" href="#Const">8.2 Const</a></li>
</ul></li>
- <li><a name="toc-Continuous-integration-1" href="#Continuous-integration">9 Continuous integration</a>
+ <li><a id="toc-Continuous-integration-1" href="#Continuous-integration">9 Continuous integration</a>
<ul class="no-bullet">
- <li><a name="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
- <li><a name="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
- <li><a name="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
+ <li><a id="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
+ <li><a id="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
+ <li><a id="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
</ul></li>
- <li><a name="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
+ <li><a id="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
<ul class="no-bullet">
- <li><a name="toc-NAME" href="#install_002dtl-NAME">A.1 NAME</a></li>
- <li><a name="toc-SYNOPSIS" href="#install_002dtl-SYNOPSIS">A.2 SYNOPSIS</a></li>
- <li><a name="toc-DESCRIPTION" href="#install_002dtl-DESCRIPTION">A.3 DESCRIPTION</a></li>
- <li><a name="toc-REFERENCES" href="#install_002dtl-REFERENCES">A.4 REFERENCES</a></li>
- <li><a name="toc-OPTIONS" href="#install_002dtl-OPTIONS">A.5 OPTIONS</a></li>
- <li><a name="toc-PROFILES" href="#install_002dtl-PROFILES">A.6 PROFILES</a></li>
- <li><a name="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.7 ENVIRONMENT VARIABLES</a></li>
- <li><a name="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.8 AUTHORS AND COPYRIGHT</a></li>
+ <li><a id="toc-NAME" href="#install_002dtl-NAME">A.1 NAME</a></li>
+ <li><a id="toc-SYNOPSIS" href="#install_002dtl-SYNOPSIS">A.2 SYNOPSIS</a></li>
+ <li><a id="toc-DESCRIPTION" href="#install_002dtl-DESCRIPTION">A.3 DESCRIPTION</a></li>
+ <li><a id="toc-REFERENCES" href="#install_002dtl-REFERENCES">A.4 REFERENCES</a></li>
+ <li><a id="toc-OPTIONS" href="#install_002dtl-OPTIONS">A.5 OPTIONS</a></li>
+ <li><a id="toc-PROFILES" href="#install_002dtl-PROFILES">A.6 PROFILES</a></li>
+ <li><a id="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.7 ENVIRONMENT VARIABLES</a></li>
+ <li><a id="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.8 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
- <li><a name="toc-tlmgr-1" href="#tlmgr">Appendix B tlmgr</a>
+ <li><a id="toc-tlmgr-1" href="#tlmgr">Appendix B tlmgr</a>
<ul class="no-bullet">
- <li><a name="toc-NAME-1" href="#tlmgr-NAME">B.1 NAME</a></li>
- <li><a name="toc-SYNOPSIS-1" href="#tlmgr-SYNOPSIS">B.2 SYNOPSIS</a></li>
- <li><a name="toc-DESCRIPTION-1" href="#tlmgr-DESCRIPTION">B.3 DESCRIPTION</a></li>
- <li><a name="toc-EXAMPLES" href="#tlmgr-EXAMPLES">B.4 EXAMPLES</a></li>
- <li><a name="toc-OPTIONS-1" href="#tlmgr-OPTIONS">B.5 OPTIONS</a></li>
- <li><a name="toc-ACTIONS" href="#tlmgr-ACTIONS">B.6 ACTIONS</a>
+ <li><a id="toc-NAME-1" href="#tlmgr-NAME">B.1 NAME</a></li>
+ <li><a id="toc-SYNOPSIS-1" href="#tlmgr-SYNOPSIS">B.2 SYNOPSIS</a></li>
+ <li><a id="toc-DESCRIPTION-1" href="#tlmgr-DESCRIPTION">B.3 DESCRIPTION</a></li>
+ <li><a id="toc-EXAMPLES" href="#tlmgr-EXAMPLES">B.4 EXAMPLES</a></li>
+ <li><a id="toc-OPTIONS-1" href="#tlmgr-OPTIONS">B.5 OPTIONS</a></li>
+ <li><a id="toc-ACTIONS" href="#tlmgr-ACTIONS">B.6 ACTIONS</a>
<ul class="no-bullet">
- <li><a name="toc-help" href="#tlmgr-help">B.6.1 help</a></li>
- <li><a name="toc-version" href="#tlmgr-version">B.6.2 version</a></li>
- <li><a name="toc-backup" href="#tlmgr-backup">B.6.3 backup</a></li>
- <li><a name="toc-candidates-pkg" href="#tlmgr-candidates-pkg">B.6.4 candidates <em>pkg</em></a></li>
- <li><a name="toc-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></li>
- <li><a name="toc-conf" href="#tlmgr-conf">B.6.6 conf</a></li>
- <li><a name="toc-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">B.6.7 dump-tlpdb [<em>option</em>...] [–json]</a></li>
- <li><a name="toc-generate" href="#tlmgr-generate">B.6.8 generate</a></li>
- <li><a name="toc-gui" href="#tlmgr-gui">B.6.9 gui</a></li>
- <li><a name="toc-info" href="#tlmgr-info">B.6.10 info</a></li>
- <li><a name="toc-init_002dusertree" href="#tlmgr-init_002dusertree">B.6.11 init-usertree</a></li>
- <li><a name="toc-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.12 install [<em>option</em>...] <em>pkg</em>...</a></li>
- <li><a name="toc-key" href="#tlmgr-key">B.6.13 key</a></li>
- <li><a name="toc-list" href="#tlmgr-list">B.6.14 list</a></li>
- <li><a name="toc-option" href="#tlmgr-option">B.6.15 option</a></li>
- <li><a name="toc-paper" href="#tlmgr-paper">B.6.16 paper</a></li>
- <li><a name="toc-path" href="#tlmgr-path">B.6.17 path</a></li>
- <li><a name="toc-pinning" href="#tlmgr-pinning">B.6.18 pinning</a></li>
- <li><a name="toc-platform" href="#tlmgr-platform">B.6.19 platform</a></li>
- <li><a name="toc-postaction" href="#tlmgr-postaction">B.6.20 postaction</a></li>
- <li><a name="toc-print_002dplatform" href="#tlmgr-print_002dplatform">B.6.21 print-platform</a></li>
- <li><a name="toc-print_002dplatform_002dinfo" href="#tlmgr-print_002dplatform_002dinfo">B.6.22 print-platform-info</a></li>
- <li><a name="toc-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</a></li>
- <li><a name="toc-repository" href="#tlmgr-repository">B.6.24 repository</a></li>
- <li><a name="toc-restore" href="#tlmgr-restore">B.6.25 restore</a></li>
- <li><a name="toc-search" href="#tlmgr-search">B.6.26 search</a></li>
- <li><a name="toc-shell" href="#tlmgr-shell">B.6.27 shell</a></li>
- <li><a name="toc-show" href="#tlmgr-show">B.6.28 show</a></li>
- <li><a name="toc-uninstall" href="#tlmgr-uninstall">B.6.29 uninstall</a></li>
- <li><a name="toc-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</a></li>
+ <li><a id="toc-help" href="#tlmgr-help">B.6.1 help</a></li>
+ <li><a id="toc-version" href="#tlmgr-version">B.6.2 version</a></li>
+ <li><a id="toc-backup" href="#tlmgr-backup">B.6.3 backup</a></li>
+ <li><a id="toc-candidates-pkg" href="#tlmgr-candidates-pkg">B.6.4 candidates <em>pkg</em></a></li>
+ <li><a id="toc-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></li>
+ <li><a id="toc-conf" href="#tlmgr-conf">B.6.6 conf</a></li>
+ <li><a id="toc-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">B.6.7 dump-tlpdb [<em>option</em>...] [–json]</a></li>
+ <li><a id="toc-generate" href="#tlmgr-generate">B.6.8 generate</a></li>
+ <li><a id="toc-gui" href="#tlmgr-gui">B.6.9 gui</a></li>
+ <li><a id="toc-info" href="#tlmgr-info">B.6.10 info</a></li>
+ <li><a id="toc-init_002dusertree" href="#tlmgr-init_002dusertree">B.6.11 init-usertree</a></li>
+ <li><a id="toc-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.12 install [<em>option</em>...] <em>pkg</em>...</a></li>
+ <li><a id="toc-key" href="#tlmgr-key">B.6.13 key</a></li>
+ <li><a id="toc-list" href="#tlmgr-list">B.6.14 list</a></li>
+ <li><a id="toc-option" href="#tlmgr-option">B.6.15 option</a></li>
+ <li><a id="toc-paper" href="#tlmgr-paper">B.6.16 paper</a></li>
+ <li><a id="toc-path" href="#tlmgr-path">B.6.17 path</a></li>
+ <li><a id="toc-pinning" href="#tlmgr-pinning">B.6.18 pinning</a></li>
+ <li><a id="toc-platform" href="#tlmgr-platform">B.6.19 platform</a></li>
+ <li><a id="toc-postaction" href="#tlmgr-postaction">B.6.20 postaction</a></li>
+ <li><a id="toc-print_002dplatform" href="#tlmgr-print_002dplatform">B.6.21 print-platform</a></li>
+ <li><a id="toc-print_002dplatform_002dinfo" href="#tlmgr-print_002dplatform_002dinfo">B.6.22 print-platform-info</a></li>
+ <li><a id="toc-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</a></li>
+ <li><a id="toc-repository" href="#tlmgr-repository">B.6.24 repository</a></li>
+ <li><a id="toc-restore" href="#tlmgr-restore">B.6.25 restore</a></li>
+ <li><a id="toc-search" href="#tlmgr-search">B.6.26 search</a></li>
+ <li><a id="toc-shell" href="#tlmgr-shell">B.6.27 shell</a></li>
+ <li><a id="toc-show" href="#tlmgr-show">B.6.28 show</a></li>
+ <li><a id="toc-uninstall" href="#tlmgr-uninstall">B.6.29 uninstall</a></li>
+ <li><a id="toc-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</a></li>
</ul></li>
- <li><a name="toc-CONFIGURATION-FILE-FOR-TLMGR" href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR">B.7 CONFIGURATION FILE FOR TLMGR</a></li>
- <li><a name="toc-CRYPTOGRAPHIC-VERIFICATION" href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION">B.8 CRYPTOGRAPHIC VERIFICATION</a>
+ <li><a id="toc-CONFIGURATION-FILE-FOR-TLMGR" href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR">B.7 CONFIGURATION FILE FOR TLMGR</a></li>
+ <li><a id="toc-CRYPTOGRAPHIC-VERIFICATION" href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION">B.8 CRYPTOGRAPHIC VERIFICATION</a>
<ul class="no-bullet">
- <li><a name="toc-Configuration-of-GnuPG-invocation" href="#tlmgr-Configuration-of-GnuPG-invocation">B.8.1 Configuration of GnuPG invocation</a></li>
+ <li><a id="toc-Configuration-of-GnuPG-invocation" href="#tlmgr-Configuration-of-GnuPG-invocation">B.8.1 Configuration of GnuPG invocation</a></li>
</ul></li>
- <li><a name="toc-USER-MODE" href="#tlmgr-USER-MODE">B.9 USER MODE</a>
+ <li><a id="toc-USER-MODE" href="#tlmgr-USER-MODE">B.9 USER MODE</a>
<ul class="no-bullet">
- <li><a name="toc-User-mode-install" href="#tlmgr-User-mode-install">B.9.1 User mode install</a></li>
- <li><a name="toc-User-mode-backup_002c-restore_002c-remove_002c-update" href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update">B.9.2 User mode backup, restore, remove, update</a></li>
- <li><a name="toc-User-mode-generate_002c-option_002c-paper" href="#tlmgr-User-mode-generate_002c-option_002c-paper">B.9.3 User mode generate, option, paper</a></li>
+ <li><a id="toc-User-mode-install" href="#tlmgr-User-mode-install">B.9.1 User mode install</a></li>
+ <li><a id="toc-User-mode-backup_002c-restore_002c-remove_002c-update" href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update">B.9.2 User mode backup, restore, remove, update</a></li>
+ <li><a id="toc-User-mode-generate_002c-option_002c-paper" href="#tlmgr-User-mode-generate_002c-option_002c-paper">B.9.3 User mode generate, option, paper</a></li>
</ul></li>
- <li><a name="toc-MULTIPLE-REPOSITORIES" href="#tlmgr-MULTIPLE-REPOSITORIES">B.10 MULTIPLE REPOSITORIES</a>
+ <li><a id="toc-MULTIPLE-REPOSITORIES" href="#tlmgr-MULTIPLE-REPOSITORIES">B.10 MULTIPLE REPOSITORIES</a>
<ul class="no-bullet">
- <li><a name="toc-Pinning" href="#tlmgr-Pinning">B.10.1 Pinning</a></li>
+ <li><a id="toc-Pinning" href="#tlmgr-Pinning">B.10.1 Pinning</a></li>
</ul></li>
- <li><a name="toc-GUI-FOR-TLMGR" href="#tlmgr-GUI-FOR-TLMGR">B.11 GUI FOR TLMGR</a>
+ <li><a id="toc-GUI-FOR-TLMGR" href="#tlmgr-GUI-FOR-TLMGR">B.11 GUI FOR TLMGR</a>
<ul class="no-bullet">
- <li><a name="toc-Main-display" href="#tlmgr-Main-display">B.11.1 Main display</a>
+ <li><a id="toc-Main-display" href="#tlmgr-Main-display">B.11.1 Main display</a>
<ul class="no-bullet">
- <li><a name="toc-Display-configuration-area" href="#tlmgr-Display-configuration-area">B.11.1.1 Display configuration area</a></li>
- <li><a name="toc-Package-list-area" href="#tlmgr-Package-list-area">B.11.1.2 Package list area</a></li>
- <li><a name="toc-Main-display-action-buttons" href="#tlmgr-Main-display-action-buttons">B.11.1.3 Main display action buttons</a></li>
+ <li><a id="toc-Display-configuration-area" href="#tlmgr-Display-configuration-area">B.11.1.1 Display configuration area</a></li>
+ <li><a id="toc-Package-list-area" href="#tlmgr-Package-list-area">B.11.1.2 Package list area</a></li>
+ <li><a id="toc-Main-display-action-buttons" href="#tlmgr-Main-display-action-buttons">B.11.1.3 Main display action buttons</a></li>
</ul></li>
- <li><a name="toc-Menu-bar" href="#tlmgr-Menu-bar">B.11.2 Menu bar</a></li>
- <li><a name="toc-GUI-options" href="#tlmgr-GUI-options">B.11.3 GUI options</a></li>
+ <li><a id="toc-Menu-bar" href="#tlmgr-Menu-bar">B.11.2 Menu bar</a></li>
+ <li><a id="toc-GUI-options" href="#tlmgr-GUI-options">B.11.3 GUI options</a></li>
</ul></li>
- <li><a name="toc-MACHINE_002dREADABLE-OUTPUT" href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">B.12 MACHINE-READABLE OUTPUT</a>
+ <li><a id="toc-MACHINE_002dREADABLE-OUTPUT" href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">B.12 MACHINE-READABLE OUTPUT</a>
<ul class="no-bullet">
- <li><a name="toc-Machine_002dreadable-update-and-install-output" href="#tlmgr-Machine_002dreadable-update-and-install-output">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</a></li>
- <li><a name="toc-Machine_002dreadable-option-output" href="#tlmgr-Machine_002dreadable-option-output">B.12.2 Machine-readable <code>option</code> output</a></li>
+ <li><a id="toc-Machine_002dreadable-update-and-install-output" href="#tlmgr-Machine_002dreadable-update-and-install-output">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</a></li>
+ <li><a id="toc-Machine_002dreadable-option-output" href="#tlmgr-Machine_002dreadable-option-output">B.12.2 Machine-readable <code>option</code> output</a></li>
</ul></li>
- <li><a name="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.13 AUTHORS AND COPYRIGHT</a></li>
+ <li><a id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.13 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
- <li><a name="toc-Index-1" href="#Index">Index</a></li>
+ <li><a id="toc-Index-1" href="#Index">Index</a></li>
</ul>
</div>
-<a name="Top"></a>
-<div class="header">
+<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>
-<a name="Building-TeX-Live-_00282018_0029"></a>
-<h1 class="top">Building TeX Live (2018)</h1>
+<span id="Building-TeX-Live-_00282019_0029"></span><h1 class="top">Building TeX Live (2019)</h1>
<p>For an overview of this manual, see <a href="#Introduction">Introduction</a>.
</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">About this manual.
+<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">About this manual.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Overview-of-build-system" accesskey="2">Overview of build system</a>:</td><td> </td><td align="left" valign="top">The TeX Live build system.
+<tr><td align="left" valign="top">• <a href="#Overview-of-build-system" accesskey="2">Overview of build system</a></td><td> </td><td align="left" valign="top">The TeX Live build system.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="3">Prerequisites</a>:</td><td> </td><td align="left" valign="top">Requirements for building TeX Live.
+<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="3">Prerequisites</a></td><td> </td><td align="left" valign="top">Requirements for building TeX Live.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Building" accesskey="4">Building</a>:</td><td> </td><td align="left" valign="top">The overall build process.
+<tr><td align="left" valign="top">• <a href="#Building" accesskey="4">Building</a></td><td> </td><td align="left" valign="top">The overall build process.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Installing" accesskey="5">Installing</a>:</td><td> </td><td align="left" valign="top">How and where installation happens (or not).
+<tr><td align="left" valign="top">• <a href="#Installing" accesskey="5">Installing</a></td><td> </td><td align="left" valign="top">How and where installation happens (or not).
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Layout-and-infrastructure" accesskey="6">Layout and infrastructure</a>:</td><td> </td><td align="left" valign="top">Autoconf macros, etc., in detail.
+<tr><td align="left" valign="top">• <a href="#Layout-and-infrastructure" accesskey="6">Layout and infrastructure</a></td><td> </td><td align="left" valign="top">Autoconf macros, etc., in detail.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options" accesskey="7">Configure options</a>:</td><td> </td><td align="left" valign="top">List of all configure options.
+<tr><td align="left" valign="top">• <a href="#Configure-options" accesskey="7">Configure options</a></td><td> </td><td align="left" valign="top">List of all configure options.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Coding-conventions" accesskey="8">Coding conventions</a>:</td><td> </td><td align="left" valign="top">Conventions to follow.
+<tr><td align="left" valign="top">• <a href="#Coding-conventions" accesskey="8">Coding conventions</a></td><td> </td><td align="left" valign="top">Conventions to follow.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Continuous-integration" accesskey="9">Continuous integration</a>:</td><td> </td><td align="left" valign="top">Automated build testing.
+<tr><td align="left" valign="top">• <a href="#Continuous-integration" accesskey="9">Continuous integration</a></td><td> </td><td align="left" valign="top">Automated build testing.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl">install-tl</a>:</td><td> </td><td align="left" valign="top">The TeX Live installer.
+<tr><td align="left" valign="top">• <a href="#install_002dtl">install-tl</a></td><td> </td><td align="left" valign="top">The TeX Live installer.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr">tlmgr</a>:</td><td> </td><td align="left" valign="top">The native TeX Live package manager.
+<tr><td align="left" valign="top">• <a href="#tlmgr">tlmgr</a></td><td> </td><td align="left" valign="top">The native TeX Live package manager.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Index">Index</a>:</td><td> </td><td align="left" valign="top">General index.
+<tr><td align="left" valign="top">• <a href="#Index">Index</a></td><td> </td><td align="left" valign="top">General index.
</td></tr>
</table>
<hr>
-<a name="Introduction"></a>
-<div class="header">
+<span id="Introduction"></span><div class="header">
<p>
Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</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>
</div>
-<a name="Introduction-1"></a>
-<h2 class="chapter">1 Introduction</h2>
+<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
-<a name="index-introduction"></a>
+<span id="index-introduction"></span>
-<p>This manual (dated April 2018) corresponds to the TeX Live
-2018 release.
+<p>This manual (dated February 2019) corresponds to the TeX Live
+2019 release.
</p>
<p>This manual is aimed at system installers and programmers, and focuses
on how to configure, build, and develop the TeX Live (TL) sources. It is
@@ -351,64 +339,63 @@
also available as plain text files in the source tree:
<samp>source/README.*</samp>.
</p>
-<p>The <samp>source/README</samp> file in the TL source tree provides the
+<p>The main <samp>source/README</samp> file in the TL source tree provides
maximally-terse information for doing a build, and portability
information for different systems, along with
<samp>source/doc/README.solaris</samp>.
</p>
<p>For information on acquiring the TL sources, see
-<a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>.
+<a href="https://tug.org/texlive/svn">https://tug.org/texlive/svn</a>. The canonical source repository
+uses Subversion, and we have no plans to change this.
</p>
<p>This manual does not duplicate the information found in other TL
documentation resources, such as:
</p>
<ul>
-<li> The TeX Live web pages: <a href="http://tug.org/texlive">http://tug.org/texlive</a>.
+<li> The TeX Live web pages: <a href="https://tug.org/texlive">https://tug.org/texlive</a>.
</li><li> The web page describing how to build the binaries which
-are distributed with TeX Live: <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>.
+are distributed with TeX Live: <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a>.
-</li><li> The TeX Live user manual: <a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>, or
+</li><li> The TeX Live user manual: <a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>, or
run <code>texdoc texlive</code>.
-</li><li> Other TeX-related Texinfo manuals (see <cite><a href="http://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>,
-<cite><a href="http://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.):
-<a href="http://tug.org/texinfohtml/">http://tug.org/texinfohtml/</a>, or check the ‘<samp>TeX</samp>’ category in
+</li><li> Other TeX-related Texinfo manuals (see <cite><a href="https://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>,
+<cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.):
+<a href="https://tug.org/texinfohtml/">https://tug.org/texinfohtml/</a>, or check the ‘<samp>TeX</samp>’ category in
the GNU Info system.
</li><li> Package documentation:
-<a href="http://tug.org/texlive/Contents/live/doc.html">http://tug.org/texlive/Contents/live/doc.html</a>, or the
+<a href="https://tug.org/texlive/Contents/live/doc.html">https://tug.org/texlive/Contents/live/doc.html</a>, or the
<samp>doc.html</samp> file at the top level of the installed TL.
</li></ul>
<p>As an exception, the full documentation for <code>install-tl</code> and
-<code>tlmgr</code> is included here, just because it is convenient to do so.
-The same text is available online (linked from
-<a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>, or by invoking the program with
-‘<samp>--help</samp>’ (or look at the end of the source).
+<code>tlmgr</code> is included here as appendices, simply because it is easy
+to do so. The same text is available online (linked from
+<a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>, or by invoking the program
+with ‘<samp>--help</samp>’ (or look at the end of the source).
</p>
<hr>
-<a name="Overview-of-build-system"></a>
-<div class="header">
+<span id="Overview-of-build-system"></span><div class="header">
<p>
Next: <a href="#Prerequisites" accesskey="n" rel="next">Prerequisites</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>
</div>
-<a name="Overview-of-build-system-1"></a>
-<h2 class="chapter">2 Overview of build system</h2>
+<span id="Overview-of-build-system-1"></span><h2 class="chapter">2 Overview of build system</h2>
-<a name="index-build-system_002c-design-of"></a>
+<span id="index-build-system_002c-design-of"></span>
-<a name="index-Autoconf"></a>
-<a name="index-Automake"></a>
-<a name="index-Libtool"></a>
-<a name="index-tests_002c-running"></a>
-<p>The TeX Live build system was redesigned in 2009, consistently using
-Autoconf, Automake, and Libtool. Thus<br> <code>configure &&
-make && make check && make install</code><br>or the basically-equivalent
-top-level <code>Build</code> script suffice to build and install the TL
+<span id="index-Autoconf"></span>
+<span id="index-Automake"></span>
+<span id="index-Libtool"></span>
+<span id="index-tests_002c-running"></span>
+<p>The TeX Live build system was redesigned in 2009 to consistently use
+Autoconf, Automake, and Libtool. Thus, running<br> <code>configure
+&& make && make check && make install</code><br>or the essentially-equivalent
+top-level <code>Build</code> script suffices to build and install the TL
programs. The <code>make check</code> clause performs various tests of the
generated programs—not strictly required but strongly recommended.
Running <code>configure --help</code> will display a comprehensive list of
@@ -436,13 +423,13 @@
</dd>
</dl>
-<a name="index-kpse_002dpkgs_002em4"></a>
+<span id="index-kpse_002dpkgs_002em4"></span>
<p>The primary design goal of the build system is modularity. Each
program and library module (or package) specifies its own requirements
and properties, such as required libraries, whether an installed
(system) version of a library can be used, <code>configure</code> options to
be seen at the top level, and more. An explicit list of all available
-modules is kept in only one central place, namely <samp>m4/kpse-pkgs.m4</samp>.
+modules is kept in a single central place: <samp>m4/kpse-pkgs.m4</samp>.
</p>
<p>A second, related goal is to configure and build each library before
configuring any other (program or library) module which uses that
@@ -455,62 +442,60 @@
distributed source tree and document any modifications of that source.
</p>
<p>All this is for the sake of simplifying both upgrading of modules and
-integrating new modules into the TL build system. (Not to say that
-either task is trivial.)
+integrating new modules into the TL build system. (Despite all
+efforts, neither task is easy.)
</p>
<hr>
-<a name="Prerequisites"></a>
-<div class="header">
+<span id="Prerequisites"></span><div class="header">
<p>
Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a href="#Overview-of-build-system" accesskey="p" rel="prev">Overview of build system</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>
</div>
-<a name="Prerequisites-1"></a>
-<h2 class="chapter">3 Prerequisites</h2>
+<span id="Prerequisites-1"></span><h2 class="chapter">3 Prerequisites</h2>
-<a name="index-prerequisites-for-building"></a>
-<a name="index-requirements-for-building"></a>
+<span id="index-prerequisites-for-building"></span>
+<span id="index-requirements-for-building"></span>
-<a name="index-compilers_002c-C-and-C_002b_002b"></a>
+<span id="index-compilers_002c-C-and-C_002b_002b11"></span>
<p>Overall, building the TeX Live programs, when using all libraries from
-the TL source tree, requires only C and C++ compilers and GNU
-<code>make</code>. (If <code>make</code> from your <code>PATH</code> is not GNU make,
-you can set <code>MAKE</code> in the environment to whatever is necessary.)
+the TL source tree, requires C and C++11 compilers and GNU
+<code>make</code>. If <code>make</code> from your <code>PATH</code> is not GNU make,
+you can set the <code>MAKE</code> environment variable to whatever is necessary.
</p>
-<a name="index-GNU-make_002c-required"></a>
-<a name="index-gmake_002c-required"></a>
-<a name="index-FreeType"></a>
+<span id="index-GNU-make_002c-required"></span>
+<span id="index-gmake_002c-required"></span>
+<span id="index-FreeType"></span>
<p>GNU <code>make</code> is required only because of some third-party
libraries, notably FreeType; all the TL-maintained directories (and
-Automake/Autoconf output in general) should work with any reasonable
+Automake/Autoconf output in general) work with any reasonable
<code>make</code>.
</p>
+<span id="index-C_002b_002b11_002c-required"></span>
+<p>A C++11 compiler is similarly required because of the third-party
+libraries ICU and Poppler; the program <code>dvisvgm</code> also requires
+C++11. It is possible to build everything else with older compilers;
+<a href="https://tug.org/texlive/custom-bin.html">https://tug.org/texlive/custom-bin.html</a> links to a build script
+for doing this.
+</p>
<p>However, a few programs in the tree have additional requirements:
</p>
<dl compact="compact">
-<dt><samp>dvisvgm</samp></dt>
-<dd><a name="index-dvisvgm-requirement-for-C_002b_002b11"></a>
-<a name="index-C_002b_002b11_002c-required-by-dvisvgm"></a>
-<p>requires a C++11 compiler, such as gcc 4.8.1 (or later) or clang 3.3
-(or later).
-</p>
-</dd>
<dt><samp>web2c</samp></dt>
-<dd><a name="index-perl_002c-required-by-web2c_002c-etc_002e"></a>
+<dd><span id="index-perl_002c-required-by-web2c_002c-etc_002e"></span>
<p>requires <code>perl</code> for some tests run by <code>make check</code>.
</p>
</dd>
<dt><samp>xdvik</samp></dt>
<dt><samp>xpdfopen</samp></dt>
-<dd><a name="index-X11_002c-required-by-X-clients"></a>
+<dd><span id="index-X11-development_002c-required-by-X-clients"></span>
<p>require X11 headers and libraries, often in “development” packages
that are not installed by default.
</p>
</dd>
<dt><samp>xetex</samp></dt>
-<dd><a name="index-fontconfig-library_002c-required-by-xetex"></a>
-<a name="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></a>
-<a name="index-Cocoa-Mac-framework_002c-required-by-xetex"></a>
+<dd><span id="index-fontconfig-library_002c-required-by-xetex"></span>
+<span id="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></span>
+<span id="index-Cocoa-Mac-framework_002c-required-by-xetex"></span>
<p>requires <samp>fontconfig</samp> (again both headers and library), or, for
MacOSX only, the <code>ApplicationServices</code> and <code>Cocoa</code>
frameworks.
@@ -517,10 +502,11 @@
</p>
</dd>
<dt><samp>xindy</samp></dt>
-<dd><a name="index-clisp_002c-required-by-xindy"></a>
-<a name="index-ffcall_002c-required-by-xindy"></a>
-<p>requires GNU <code>clisp</code> and in addition <code>perl</code>, <code>latex</code>,
-and <code>pdflatex</code> to build the rules and/or documentation.
+<dd><span id="index-clisp_002c-required-by-xindy"></span>
+<span id="index-libsigsegv_002c-required-by-xindy"></span>
+<p>requires GNU <code>clisp</code>, <code>libsigsegv</code>, and <code>libiconv</code>;
+additionally, to build the rules and/or documentation: <code>perl</code>,
+<code>latex</code>, and <code>pdflatex</code>
</p>
</dd>
</dl>
@@ -533,7 +519,7 @@
</p>
<ul>
<li> Modification of any <code>.y</code> or <code>.l</code> source files requires
-<samp>bison</samp> or <samp>flex</samp> to updatete the corresponding C sources.
+<samp>bison</samp> or <samp>flex</samp> to update the corresponding C sources.
</li><li> Modification of the sources for <code>.info</code> files requires
<code>makeinfo</code>.
@@ -541,7 +527,9 @@
</li><li> Modification of any part of the build system (M4 macros,
<samp>configure.ac</samp>, <samp>Makefile.am</samp>, or their fragments) requires
GNU M4, GNU Autoconf, GNU Automake, and GNU Libtool to update the
-generated files. See <a href="#Build-system-tools">Build system tools</a>.
+generated files. Furthermore, to reliably reproduce the build files,
+the original GNU releases of these tools must be used, not any distro
+packaging of them. See <a href="#Build-system-tools">Build system tools</a>, for more discussion.
</li></ul>
@@ -551,80 +539,70 @@
<code>yes</code> in your Subversion configuration (see <a href="#Build-system-tools">Build system tools</a>). Barring buggy commits, no infrastructure tools are needed to
do a normal build.
</p>
-<a name="index-Debian-installation-of-build-prerequisites"></a>
-<p>As an example, on Debian systems the necessary build dependencies can
-be installed via:
-</p>
-<div class="example">
-<pre class="example">apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
-</pre></div>
-
<hr>
-<a name="Building"></a>
-<div class="header">
+<span id="Building"></span><div class="header">
<p>
Next: <a href="#Installing" accesskey="n" rel="next">Installing</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</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>
</div>
-<a name="Building-1"></a>
-<h2 class="chapter">4 Building</h2>
+<span id="Building-1"></span><h2 class="chapter">4 Building</h2>
-<a name="index-building"></a>
-<a name="index-overall-build-process"></a>
+<span id="index-building"></span>
+<span id="index-overall-build-process"></span>
-<a name="index-Build-script"></a>
+<span id="index-Build-script"></span>
<p>The top-level <samp>Build</samp> script is intended to simplify building the
binaries distributed with TeX Live itself—we call this the “native”
-TL build. It configures and makes everything in a subdirectory of the
-main build tree (default <samp>Work/</samp>), installs everything in another
-subdirectory (default <samp>inst/</samp>), and finally runs <code>make
-check</code>. The exact directory and command names can be specified via
-environment variables and a few leading options. All remaining
-arguments (assignments or options) are passed to the <samp>configure</samp>
-script. Please take a look at the <samp>./Build</samp> source file itself
-for more information; it is a straightforward shell script.
+TL build. It runs <code>configure && make world</code>, which builds
+everything in a subdirectory of the main source tree (default
+<samp>Work/</samp>), installs everything in another subdirectory (default
+<samp>inst/</samp>), and finally runs <code>make check</code>. The exact
+directory and command names can be specified via environment variables
+and a few leading options. All remaining arguments (assignments or
+options) are passed to the <samp>configure</samp> script. Please take a
+look at the <samp>./Build</samp> source file for more information; it is a
+straightforward shell script.
</p>
-<a name="index-source-directory-building_002c-not-supported"></a>
-<a name="index-build-directory_002c-required"></a>
+<span id="index-source-directory-building_002c-not-supported"></span>
+<span id="index-build-directory_002c-required"></span>
<p>An alternative, and the one we will mainly discuss here, is to run
-<code>configure</code> and <code>make</code> oneself in a suitable empty
-subdirectory. Building in the source directory itself is not
-supported (sorry).
+<code>configure</code> and <code>make</code> in a suitable empty subdirectory.
+Building in the source directory itself is not supported (sorry).
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Build-iteration" accesskey="1">Build iteration</a>:</td><td> </td><td align="left" valign="top">What <code>configure</code> and <code>make</code> do.
+<tr><td align="left" valign="top">• <a href="#Build-iteration" accesskey="1">Build iteration</a></td><td> </td><td align="left" valign="top">What <code>configure</code> and <code>make</code> do in TL.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Build-problems" accesskey="2">Build problems</a>:</td><td> </td><td align="left" valign="top">If the build fails.
+<tr><td align="left" valign="top">• <a href="#Build-problems" accesskey="2">Build problems</a></td><td> </td><td align="left" valign="top">If the build fails.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Build-in-parallel" accesskey="3">Build in parallel</a>:</td><td> </td><td align="left" valign="top">Simultaneous <code>make</code> processes.
+<tr><td align="left" valign="top">• <a href="#Build-in-parallel" accesskey="3">Build in parallel</a></td><td> </td><td align="left" valign="top">Simultaneous <code>make</code> processes.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Build-distribution" accesskey="4">Build distribution</a>:</td><td> </td><td align="left" valign="top">Making a distribution tarball.
+<tr><td align="left" valign="top">• <a href="#Build-distribution" accesskey="4">Build distribution</a></td><td> </td><td align="left" valign="top">Making a distribution tarball.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Build-one-package" accesskey="5">Build one package</a>:</td><td> </td><td align="left" valign="top">Example of working on just one program.
+<tr><td align="left" valign="top">• <a href="#Build-one-package" accesskey="5">Build one package</a></td><td> </td><td align="left" valign="top">Example of working on just one program.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Cross-compilation" accesskey="6">Cross compilation</a>:</td><td> </td><td align="left" valign="top">Building on host X for target Y.
+<tr><td align="left" valign="top">• <a href="#Build-one-engine" accesskey="6">Build one engine</a></td><td> </td><td align="left" valign="top">Example of building just one TeX engine.
</td></tr>
+<tr><td align="left" valign="top">• <a href="#Cross-compilation" accesskey="7">Cross compilation</a></td><td> </td><td align="left" valign="top">Building on host X for target Y.
+</td></tr>
</table>
<hr>
-<a name="Build-iteration"></a>
-<div class="header">
+<span id="Build-iteration"></span><div class="header">
<p>
Next: <a href="#Build-problems" accesskey="n" rel="next">Build problems</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-iteration-1"></a>
-<h3 class="section">4.1 Build iteration</h3>
+<span id="Build-iteration-1"></span><h3 class="section">4.1 Build iteration</h3>
-<a name="index-build-iteration"></a>
-<a name="index-iteration-through-sources_002c-by-configure-and-make"></a>
+<span id="index-build-iteration"></span>
+<span id="index-iteration-through-sources_002c-by-configure-and-make"></span>
<p>Running the top-level <samp>configure</samp> script configures the top level
and the subdirectories <samp>libs</samp>, <samp>utils</samp>, and <samp>texk</samp>.
-Running <code>make</code> at the top-level first iterates over all
-TeX-specific libraries, and then runs <code>make</code> in
-<samp>libs</samp>, <samp>utils</samp>, and <samp>texk</samp> to iterate over all generic
-libraries, utility programs, and TeX-specific programs. These
+Running <code>make</code> at the top level first iterates over the
+TeX-specific libraries, and then runs <code>make</code> in <samp>libs</samp>,
+<samp>utils</samp>, and <samp>texk</samp> to iterate over the generic libraries,
+utility programs, and TeX-specific programs, respectively. These
iterations consist of two steps:
</p>
<ol>
@@ -640,70 +618,65 @@
</li></ol>
<p>Running the top-level <code>make</code> a second time iterates again over
-all the library and program modules, but finds (should find) nothing
-to be done unless some source files have been modified.
+all the library and program modules, and finds (should find) nothing
+to be done.
</p>
<hr>
-<a name="Build-problems"></a>
-<div class="header">
+<span id="Build-problems"></span><div class="header">
<p>
Next: <a href="#Build-in-parallel" accesskey="n" rel="next">Build in parallel</a>, Previous: <a href="#Build-iteration" accesskey="p" rel="prev">Build iteration</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-problems-1"></a>
-<h3 class="section">4.2 Build problems</h3>
+<span id="Build-problems-1"></span><h3 class="section">4.2 Build problems</h3>
-<a name="index-build-problems"></a>
-<a name="index-problems-with-build"></a>
-<a name="index-failure-to-build"></a>
-<a name="index-_002d_002dno_002dclean-Build-option"></a>
-<p>If configuring or building a module fails, you should first find and fix the
-problem, then perhaps remove the subdirectory for that module from the build
-tree, and finally rerun the top level <code>make</code> (or <samp>Build</samp> with
-<code>--no-clean</code> as its first argument).
+<span id="index-build-problems"></span>
+<span id="index-problems-with-build"></span>
+<span id="index-failure-to-build"></span>
+<span id="index-_002d_002dno_002dclean-Build-option"></span>
+<p>If configuring or building a module fails, you should first try to
+find and fix the problem. Failing that, a possible workaround is to
+remove the subdirectory for that module from the build tree (so
+<code>configure</code> won’t try to run there, and finally rerun the top
+level <code>make</code> (or <samp>./Build</samp> <code>--no-clean</code>).
</p>
<hr>
-<a name="Build-in-parallel"></a>
-<div class="header">
+<span id="Build-in-parallel"></span><div class="header">
<p>
Next: <a href="#Build-distribution" accesskey="n" rel="next">Build distribution</a>, Previous: <a href="#Build-problems" accesskey="p" rel="prev">Build problems</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-in-parallel-1"></a>
-<h3 class="section">4.3 Build in parallel</h3>
+<span id="Build-in-parallel-1"></span><h3 class="section">4.3 Build in parallel</h3>
-<a name="index-building-in-parallel"></a>
-<a name="index-parallel-build"></a>
-<a name="index-cache-for-configure"></a>
+<span id="index-building-in-parallel"></span>
+<span id="index-parallel-build"></span>
+<span id="index-cache-for-configure"></span>
-<a name="index-dependencies_002c-with-several-output-files"></a>
-<a name="index-_002dj-make-option"></a>
+<span id="index-dependencies_002c-with-several-output-files"></span>
+<span id="index-_002dj-make-option"></span>
<p>The TL build system carefully formulates dependencies as well as
<code>make</code> rules when a tool (such as <code>tangle</code>, <code>ctangle</code>,
-or <code>convert</code>) creates several output files. This allows for
+and <code>convert</code>) creates several output files. This allows for
parallel builds (<code>make -j <var>n</var></code> with <em><var>n</var>>1</em> or even
<code>make -j</code>) that can considerably speed up the TL build.
</p>
-<a name="index-cache-file_002c-for-configure"></a>
-<a name="index-_002dC-configure-option"></a>
-<p>Incidentally, a noticeable speed-up can also be (independently) gained
-by using a configure cache file, i.e., with the option <code>-C</code>
-(recommended).
+<span id="index-cache-file_002c-for-configure"></span>
+<span id="index-_002dC-configure-option"></span>
+<p>Incidentally, a noticeable speed-up can be independently gained by
+using a configure cache file, i.e., specifying the <code>configure</code>
+option <code>-C</code> (recommended).
</p>
<hr>
-<a name="Build-distribution"></a>
-<div class="header">
+<span id="Build-distribution"></span><div class="header">
<p>
Next: <a href="#Build-one-package" accesskey="n" rel="next">Build one package</a>, Previous: <a href="#Build-in-parallel" accesskey="p" rel="prev">Build in parallel</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-distribution-1"></a>
-<h3 class="section">4.4 Build distribution</h3>
+<span id="Build-distribution-1"></span><h3 class="section">4.4 Build distribution</h3>
-<a name="index-building-a-distribution"></a>
-<a name="index-distribution-tarball_002c-making"></a>
+<span id="index-building-a-distribution"></span>
+<span id="index-distribution-tarball_002c-making"></span>
-<a name="index-dist-and-distcheck-targets-for-make"></a>
+<span id="index-dist-and-distcheck-targets-for-make"></span>
<p>Running <code>make dist</code> at the top level creates a tarball
<samp>tex-live-<var>yyyy</var>-<var>mm</var>-<var>dd</var>.tar.xz</samp> from the TL source
tree. Running <code>make distcheck</code> also verifies that this tarball
@@ -712,36 +685,36 @@
<p>This is useful for checking consistency of the source tree and
Makefiles, but the result is not a complete or even usable TeX
system, since all the support files are lacking; see <a href="#Installing">Installing</a>.
+We do not actually distribute any such tarball, and have no plans to
+do so.
</p>
<hr>
-<a name="Build-one-package"></a>
-<div class="header">
+<span id="Build-one-package"></span><div class="header">
<p>
-Next: <a href="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Build-distribution" accesskey="p" rel="prev">Build distribution</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="#Build-one-engine" accesskey="n" rel="next">Build one engine</a>, Previous: <a href="#Build-distribution" accesskey="p" rel="prev">Build distribution</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-one-package-1"></a>
-<h3 class="section">4.5 Build one package</h3>
+<span id="Build-one-package-1"></span><h3 class="section">4.5 Build one package</h3>
-<a name="index-build-one-package"></a>
-<a name="index-one-package_002c-building"></a>
+<span id="index-build-one-package"></span>
+<span id="index-one-package_002c-building"></span>
-<a name="index-_002d_002ddisable_002dall_002dpackages"></a>
-<a name="index-build-on-demand"></a>
+<span id="index-_002d_002ddisable_002dall_002dpackages"></span>
+<span id="index-build-on-demand"></span>
<p>To build one package, the basic idea is to use the <code>configure</code>
option <code>--disable-all-pkgs</code> (see <a href="#g_t_002d_002ddisable_002dall_002dpkgs"><code>--disable-all-pkgs</code></a>).
Then all program and library modules are configured but none are made.
However, the <samp>Makefile</samp>s still contain all build rules and
dependencies and can be invoked to build an individual program or
-library and causes to first build any required libraries.
+library, first building any required libraries.
</p>
<p>This “build-on-demand” procedure is used, e.g., in the upstream
-LuaTeX repository to build LuaTeX, essentially from a subset of
-the complete TeX Live tree. Similarly, when, e.g., building the original
+LuaTeX repository to build LuaTeX, from a subset of the complete
+TeX Live source tree. As another example, when building the original
e-TeX has been disabled (as it is by default), one can run
<code>make etex</code> (or <code>make etex.exe</code>) in <samp>texk/web2c/</samp> to
-build e-TeX (although there is no comparably simple way to install
-e-TeX).
+build e-TeX (although there is no comparably simple way to
+<em>install</em> e-TeX).
</p>
<p>If you want to work on a single program within the TL sources, this is
the recommended way to do it. Here is an example from start to
@@ -750,7 +723,7 @@
<div class="example">
<pre class="example">mkdir mydir && cd mydir # new working directory
-# Get sources (<a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>)
+# Get sources (<a href="https://tug.org/texlive/svn">https://tug.org/texlive/svn</a>), e.g.:
rsync -a --delete --exclude=.svn --exclude=Work \
tug.org::tldevsrc/Build/source/ .
@@ -759,10 +732,10 @@
# Do the configure:
../configure --disable-all-pkgs --enable-dvipdfm-x \
- -C CFLAGS=-g CXXFLAGS=-g >&outc
+ -C CFLAGS=-g CXXFLAGS=-g >&outc || echo fail
# Do the make:
-make >&outm
+make >&outm || echo fail
# Test:
cd texk/dvipdfm-x
@@ -769,62 +742,101 @@
make check
</pre></div>
-<p>Then you modify source files in <samp>mydir/texk/dvipdfm-x</samp> and rerun
-<code>make</code> in <samp>mydir/Work/texk/dvipdfm-x</samp> to rebuild.
+<p>Then you can modify source files in <samp>mydir/texk/dvipdfm-x</samp> and
+rerun <code>make</code> in <samp>mydir/Work/texk/dvipdfm-x</samp> to rebuild; that
+build directory is where the binary ends up and where you can run a
+debugger, etc.
</p>
<p>The second line of the <code>configure</code> invocation shows examples of
extra things you likely want to specify if you intend to hack the
-sources (and not just build binaries): the <code>-C</code> speeds up
-<code>configure</code>, and the <code>CFLAGS</code> and <code>CXXFLAGS</code> settings
-eliminate compiler optimization for debugging purposes.
+sources (and not just build binaries): the <code>-C</code> speeds
+<code>configure</code> by enabling a cache file, and the <code>CFLAGS</code> and
+<code>CXXFLAGS</code> settings eliminate compiler optimization for debugging
+purposes.
</p>
-<p>Of course, one should actually look at the output and check that
+<p>Of course, you need to actually look at the output and check that
things are working. There are many <code>configure</code> options you can
-tweak as desired; check the output from <code>configure --help</code>.
+tweak as desired; check the output from <code>configure --help</code>. It
+is also a good idea to run <code>make check</code> after making any changes,
+to ensure that whatever tests have been written still pass.
</p>
-<a name="index-size-of-source-tree"></a>
+
+<span id="index-size-of-source-tree"></span>
<p>Finally, the above retrieves the entire TL source tree (several
-hundred megabytes). It is natural to ask if this is really necessary.
+hundred megabytes). It is natural to ask if this is really necessary.
Strictly speaking, the answer is no, but it is vastly more convenient
-to do so. If you cut down the source tree, you must also give
+to do so. If you cut down the source tree, you must also give
additional <code>configure</code> flags to individually disable using system
versions of libraries, or the intricacies of the dependencies (such as
<code>teckit</code> requiring <code>zlib</code>) will have undesired side effects.
-For an example, see the <code>build-pdftex.sh</code> script in the
-<code>pdftex</code> development source (<a href="http://pdftex.org">http://pdftex.org</a>), which is
-indeed a cut-down TL source tree.
+For an example of this approach, see the <code>build-pdftex.sh</code> script
+in the <code>pdftex</code> development source (details at
+<a href="http://pdftex.org">http://pdftex.org</a>), which is indeed such a cut-down TL source
+tree.
</p>
-<a name="index-_002d_002denable_002dmissing-to-ignore-dependencies"></a>
+<span id="index-_002d_002denable_002dmissing-to-ignore-dependencies"></span>
<p>Even with <code>--disable-all-pkgs</code>, dependencies will be checked.
-For instance, if a non-MacOSX system does not have <code>fontconfig</code>,
-XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>) and <code>configure</code>
-will terminate. To proceed without such dependencies, specify
-<code>--enable-missing</code> also. (Arguably this should happen
-automatically.)
+For instance, if a (non-MacOSX) system does not have
+<code>fontconfig</code>, XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>)
+and <code>configure</code> will terminate. To proceed without such
+dependencies, specify <code>--enable-missing</code> also.
</p>
-<a name="index-CC_003dc_002dcompiler"></a>
-<a name="index-CXX_003dc_002b_002b_002dcompiler"></a>
-<a name="index-OBJCXX_003dobjc_002dcompiler"></a>
+<span id="index-CC_003dc_002dcompiler"></span>
+<span id="index-CXX_003dc_002b_002b_002dcompiler"></span>
+<span id="index-OBJCXX_003dobjc_002dcompiler"></span>
+<span id="index-gcc_002c-default-compilers"></span>
<p>By default, the <code>gcc</code> compilers will be used if present;
otherwise, individual packages may use something different. You can
explicitly specify the compilers to be used with the environment
variables <code>CC</code>, <code>CXX</code>, and <code>OBJCXX</code>.
</p>
+
<hr>
-<a name="Cross-compilation"></a>
-<div class="header">
+<span id="Build-one-engine"></span><div class="header">
<p>
-Previous: <a href="#Build-one-package" accesskey="p" rel="prev">Build one package</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Build-one-package" accesskey="p" rel="prev">Build one package</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Cross-compilation-1"></a>
-<h3 class="section">4.6 Cross compilation</h3>
+<span id="Build-one-engine-1"></span><h3 class="section">4.6 Build one engine</h3>
-<a name="index-cross-compilation"></a>
+<span id="index-build-one-engine"></span>
+<span id="index-one-engine_002c-building"></span>
+<span id="index-engine_002c-building-one"></span>
+
+<p>Unfortunately, there is one common case where the steps in the
+preceding section to build one package (see <a href="#Build-one-package">Build one package</a>) do
+not suffice: wanting to build one, or a subset, of the TeX engines
+(or other Web2c programs).
+</p>
+<p>The simplest way to do this is to disable everything and then
+explicitly specify what to make. For example, to build only LuaTeX:
+</p>
+<div class="example">
+<pre class="example">./configure --disable-all-pkgs # or ./Build
+cd Work/texk/web2c # build directory
+make luatex # specify target
+</pre></div>
+
+<p>This works because the <code>make</code> automatically runs <code>configure</code>
+as necessary for the dependencies and target. Furthermore, the source
+tree can be cut down to just what is needed for the given engine (as
+the separate pdfTeX and LuaTeX source repositories do).
+</p>
+<p>We hope to improve the situation in the future. Patches are welcome.
+</p>
+
+<hr>
+<span id="Cross-compilation"></span><div class="header">
+<p>
+Previous: <a href="#Build-one-engine" accesskey="p" rel="prev">Build one engine</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</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="Cross-compilation-1"></span><h3 class="section">4.7 Cross compilation</h3>
+
+<span id="index-cross-compilation"></span>
<p>In a cross compilation a <em>build</em> system is used to create
binaries to be executed on a <em>host</em> system with different
hardware and/or operating system.
</p>
-<a name="index-native-cross-compilation"></a>
+<span id="index-native-cross-compilation"></span>
<p>In simple cases, the build system can execute binaries for the host
system. This typically occurs for bi-arch systems where, e.g.,
<code>i386-linux</code> binaries can run on <code>x86_64-linux</code> systems and
@@ -834,7 +846,7 @@
suitable compiler flags. It might be useful to add the configure
option <code>--build=<var>host</var></code> to get the correct canonical host
name, but note that this should <em>not</em> be <code>--host=<var>host</var></code>
-(see <a href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
+(see <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
</p>
<p>In order to build, e.g., 32-bit binaries with <code>clang</code> on a 64-bit
MacOSX system one could use:
@@ -847,26 +859,24 @@
</pre></div>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Cross-configuring" accesskey="1">Cross configuring</a>:</td><td> </td><td align="left" valign="top">Configuring for cross compilation.
+<tr><td align="left" valign="top">• <a href="#Cross-configuring" accesskey="1">Cross configuring</a></td><td> </td><td align="left" valign="top">Configuring for cross compilation.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Cross-problems" accesskey="2">Cross problems</a>:</td><td> </td><td align="left" valign="top">Cross compilation problems.
+<tr><td align="left" valign="top">• <a href="#Cross-problems" accesskey="2">Cross problems</a></td><td> </td><td align="left" valign="top">Cross compilation problems.
</td></tr>
</table>
<hr>
-<a name="Cross-configuring"></a>
-<div class="header">
+<span id="Cross-configuring"></span><div class="header">
<p>
Next: <a href="#Cross-problems" accesskey="n" rel="next">Cross problems</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Cross-configuring-1"></a>
-<h4 class="subsection">4.6.1 Cross configuring</h4>
+<span id="Cross-configuring-1"></span><h4 class="subsection">4.7.1 Cross configuring</h4>
-<a name="index-cross-compilation-configuring"></a>
-<a name="index-configuring_002c-for-cross-compilation"></a>
+<span id="index-cross-compilation-configuring"></span>
+<span id="index-configuring_002c-for-cross-compilation"></span>
-<a name="index-_002d_002dhost_003dhost"></a>
-<a name="index-_002d_002dbuild_003dhost"></a>
+<span id="index-_002d_002dhost_003dhost"></span>
+<span id="index-_002d_002dbuild_003dhost"></span>
<p>In a standard cross compilation, binaries for the host system cannot
execute on the build system and it is necessary to specify the
configure options <code>--host=<var>host</var></code> and
@@ -892,7 +902,7 @@
<code>strip</code> STRIP
</pre></div>
-<a name="index-mingw32"></a>
+<span id="index-mingw32"></span>
<p>In order to, e.g., build <code>mingw32</code> binaries on
<code>x86_64-linux</code> with a cross compiler found as
<samp>i386-pc-mingw32-gcc</samp> one would specify
@@ -914,7 +924,7 @@
few auxiliary C and C++ programs required for the build process as
configure arguments
</p>
-<a name="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></a>
+<span id="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></span>
<div class="example">
<pre class="example">BUILDCC=…
BUILDCPPFLAGS=…
@@ -925,15 +935,13 @@
</pre></div>
<hr>
-<a name="Cross-problems"></a>
-<div class="header">
+<span id="Cross-problems"></span><div class="header">
<p>
Previous: <a href="#Cross-configuring" accesskey="p" rel="prev">Cross configuring</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Cross-problems-1"></a>
-<h4 class="subsection">4.6.2 Cross problems</h4>
+<span id="Cross-problems-1"></span><h4 class="subsection">4.7.2 Cross problems</h4>
-<a name="index-cross-compilation-problems"></a>
+<span id="index-cross-compilation-problems"></span>
<p>The fact that binaries for the host system cannot be executed on the
build system causes some problems.
@@ -943,10 +951,10 @@
should be avoided if possible and otherwise must supply a pessimistic
test result.
</p>
-<a name="index-squeeze"></a>
-<a name="index-web2c-program"></a>
-<a name="index-freetype-cross-compiling"></a>
-<a name="index-CC_005fBUILD"></a>
+<span id="index-squeeze"></span>
+<span id="index-web2c-program"></span>
+<span id="index-freetype-cross-compiling"></span>
+<span id="index-CC_005fBUILD"></span>
<p>Another problem arises if the build process must execute some
(auxiliary or installable) programs. Auxiliary programs can be placed
into a subdirectory that is configured natively as is done for
@@ -955,7 +963,7 @@
value of <code>CC_BUILD</code>, <samp><var>build</var>-gcc</samp>, <samp>gcc</samp>, or
<samp>cc</samp> as the compiler for the auxiliary program.
</p>
-<a name="index-ICU-cross-compiling"></a>
+<span id="index-ICU-cross-compiling"></span>
<p>The situation for installable programs needed by the build process is
somewhat different. A rather expensive possibility, chosen for the ICU
libraries in module <samp>libs/icu</samp>, is to first compile natively for
@@ -962,73 +970,69 @@
the build system and in a second step to use these (uninstalled)
programs during the cross compilation.
</p>
-<a name="index-tangle"></a>
-<a name="index-ctangle"></a>
-<a name="index-otangle"></a>
-<a name="index-tie"></a>
+<span id="index-tangle"></span>
+<span id="index-ctangle"></span>
+<span id="index-otangle"></span>
+<span id="index-tie"></span>
<p>This approach would also be possible for the tools such as
<samp>tangle</samp> used in the module <samp>texk/web2c</samp> to build the WEB
programs, but that would require first building a native
<code>kpathsea</code> library. To avoid this complication, cross
-compilation of the WEB or CWEB programs requires sufficiently recent
+compilation of programs written in (C)WEB requires sufficiently recent
installed versions of <samp>tangle</samp>, <samp>ctangle</samp>, <samp>otangle</samp>,
and <samp>tie</samp>.
</p>
-<a name="index-xindy-cross-compiling-impossible"></a>
-<p>Building <code>xindy</code> requires running the host system <samp>clisp</samp>
-binary, thus cross compilation is not possible.
+<span id="index-xindy-cross-compiling-requires-clisp"></span>
+<p>Building <code>xindy</code> requires running the host system <code>clisp</code>
+binary, thus cross compilation is painful, but possible.
</p>
<hr>
-<a name="Installing"></a>
-<div class="header">
+<span id="Installing"></span><div class="header">
<p>
Next: <a href="#Layout-and-infrastructure" accesskey="n" rel="next">Layout and infrastructure</a>, Previous: <a href="#Building" accesskey="p" rel="prev">Building</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>
</div>
-<a name="Installing-1"></a>
-<h2 class="chapter">5 Installing</h2>
+<span id="Installing-1"></span><h2 class="chapter">5 Installing</h2>
-<a name="index-installing"></a>
+<span id="index-installing"></span>
<p>This section discusses the results of <code>make install</code> in the
source tree.
</p>
-<a name="index-support-files_002c-separate-from-build"></a>
-<a name="index-texlive_002etlpdb_002c-TeX-Live-database"></a>
-<a name="index-install_002dtl_002c-TeX-Live-installer"></a>
-<a name="index-plain_002etex_002c-not-in-source-tree"></a>
+<span id="index-support-files_002c-separate-from-build"></span>
+<span id="index-texlive_002etlpdb_002c-TeX-Live-database"></span>
+<span id="index-install_002dtl_002c-TeX-Live-installer"></span>
+<span id="index-plain_002etex_002c-not-in-source-tree"></span>
<p>The main consideration is that <code>make install</code> is not enough to
make a usable TeX installation. Beyond the compiled binaries,
-(thousands of) support files are needed; just as a first example
+(thousands of) support files are needed; just as a first example,
<samp>plain.tex</samp> is not in the source tree.
</p>
<p>These support files are maintained completely independently and are
-not present in the source tree. The best basis for dealing with them
+not present in the TL source tree. The best basis for dealing with them
is the TeX Live (plain text) database in
<samp>Master/tlpkg/texlive.tlpdb</samp>, and/or the TeX Live installer,
<code>install-tl</code>. More information is under <samp>Master/tlpkg</samp> and
-at <a href="http://tug.org/texlive/distro.html">http://tug.org/texlive/distro.html</a>.
+at <a href="https://tug.org/texlive/distro.html">https://tug.org/texlive/distro.html</a>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Installation-directories" accesskey="1">Installation directories</a>:</td><td> </td><td align="left" valign="top">The prefix, <code>bindir</code>, etc., directories.
+<tr><td align="left" valign="top">• <a href="#Installation-directories" accesskey="1">Installation directories</a></td><td> </td><td align="left" valign="top">The prefix, <code>bindir</code>, etc., directories.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Linked-scripts" accesskey="2">Linked scripts</a>:</td><td> </td><td align="left" valign="top">Scripts not maintained in the sources.
+<tr><td align="left" valign="top">• <a href="#Linked-scripts" accesskey="2">Linked scripts</a></td><td> </td><td align="left" valign="top">Scripts not maintained in the sources.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Distro-builds" accesskey="3">Distro builds</a>:</td><td> </td><td align="left" valign="top">Configuring and building for OS distributions.
+<tr><td align="left" valign="top">• <a href="#Distro-builds" accesskey="3">Distro builds</a></td><td> </td><td align="left" valign="top">Configuring and building for OS distributions.
</td></tr>
</table>
<hr>
-<a name="Installation-directories"></a>
-<div class="header">
+<span id="Installation-directories"></span><div class="header">
<p>
Next: <a href="#Linked-scripts" accesskey="n" rel="next">Linked scripts</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Installation-directories-1"></a>
-<h3 class="section">5.1 Installation directories</h3>
+<span id="Installation-directories-1"></span><h3 class="section">5.1 Installation directories</h3>
-<a name="index-installation-directories"></a>
-<a name="index-directories_002c-for-installation"></a>
-<a name="index-paths_002c-for-installation"></a>
+<span id="index-installation-directories"></span>
+<span id="index-directories_002c-for-installation"></span>
+<span id="index-paths_002c-for-installation"></span>
<p>Running <code>make install</code> (or <code>make install-strip</code>) installs
executables in <code><var>bindir</var></code>, libraries in <code><var>libdir</var></code>,
@@ -1038,7 +1042,7 @@
and Info files in <code><var>infodir</var></code>.
</p>
<p>The values of these directories are determined by <code>configure</code>
-and can be specified explictly as options such as
+and can be specified explicitly as options such as
<code>--prefix=<var>prefix</var></code> or <code>--bindir=<var>bindir</var></code>;
otherwise, they are given by their usual Autoconf defaults:
</p>
@@ -1073,7 +1077,7 @@
installation paths.
</p>
<p>For the native TL build, the <code>Build</code> script leaves the binaries
-in <samp>./inst/bin/<var>std-platform-name</var></samp>. The new binaries are
+in <samp>./inst/bin/<var>std-system-triplet</var></samp>. The new binaries are
not directly usable from that location; they need to be copied to
<samp>Master/bin/<var>tl-platform</var></samp>. The other files and directories
that end up in <samp>./inst/</samp> are ignored.
@@ -1080,20 +1084,18 @@
</p>
<hr>
-<a name="Linked-scripts"></a>
-<div class="header">
+<span id="Linked-scripts"></span><div class="header">
<p>
Next: <a href="#Distro-builds" accesskey="n" rel="next">Distro builds</a>, Previous: <a href="#Installation-directories" accesskey="p" rel="prev">Installation directories</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Linked-scripts-1"></a>
-<h3 class="section">5.2 Linked scripts</h3>
+<span id="Linked-scripts-1"></span><h3 class="section">5.2 Linked scripts</h3>
-<a name="index-linked-scripts"></a>
-<a name="index-scripts_002c-linked-and-not-maintained"></a>
+<span id="index-linked-scripts"></span>
+<span id="index-scripts_002c-linked-and-not-maintained"></span>
-<a name="index-symlinks_002c-used-for-scripts"></a>
-<a name="index-wrapper-binary-for-scripts-on-Windows"></a>
-<a name="index-Windows_002c-invoking-scripts-on"></a>
+<span id="index-symlinks_002c-used-for-scripts"></span>
+<span id="index-wrapper-binary-for-scripts-on-Windows"></span>
+<span id="index-Windows_002c-invoking-scripts-on"></span>
<p>Quite a few executables are architecture-independent shell, Perl, or
other interpreted scripts, rather than compiled binaries. A few are
maintained as part of the TL source tree, but most are maintained
@@ -1104,57 +1106,55 @@
symbolic link is made in <code><var>bindir</var></code>. For example, a symlink
points from <code><var>bindir</var>/ps2eps</code> to
<code><var>datarootdir</var>/texmf-dist/scripts/ps2eps/ps2eps.pl</code>. For
-Windows, a standard wrapper binary (e.g.,
-<code><var>bindir</var>/ps2eps.exe</code>) serves the same purpose. (The source
-for the wrapper is in <samp>texk/texlive/w32_wrapper</samp>.)
+Windows, a standard wrapper binary (copied to, e.g.,
+<code><var>bindir</var>/ps2eps.exe</code>) serves the same purpose. The source
+for the wrapper is in <samp>texk/texlive/w32_wrapper</samp>.
</p>
<p>One reason for this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
stay in sync across the different supported operating systems.
</p>
-<a name="index-asymptote"></a>
-<a name="index-biber"></a>
-<a name="index-xindy"></a>
-<a name="index-xz"></a>
-<a name="index-wget"></a>
+<span id="index-asymptote"></span>
+<span id="index-biber"></span>
+<span id="index-xindy"></span>
+<span id="index-xz"></span>
+<span id="index-wget"></span>
<p>Most important of all, we want the <code><var>bindir</var></code> resulting from
the build to be as close as possible to what is in the TL
distribution. At present, there are a few exceptions—Asymptote,
Biber, Xindy—and each one creates considerable extra work. We don’t
-want to add more. (See <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a> for
+want to add more. (See <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a> for
information about building those exceptions, as well as the <code>xz</code>
and <code>wget</code> programs that are used in the TL infrastructure.)
</p>
<hr>
-<a name="Distro-builds"></a>
-<div class="header">
+<span id="Distro-builds"></span><div class="header">
<p>
Previous: <a href="#Linked-scripts" accesskey="p" rel="prev">Linked scripts</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Distro-builds-1"></a>
-<h3 class="section">5.3 Distro builds</h3>
+<span id="Distro-builds-1"></span><h3 class="section">5.3 Distro builds</h3>
-<a name="index-distro_002c-building-for"></a>
-<a name="index-operating-system-distribution_002c-building-for"></a>
-<a name="index-system-distribution_002c-building-for"></a>
+<span id="index-distro_002c-building-for"></span>
+<span id="index-operating-system-distribution_002c-building-for"></span>
+<span id="index-system-distribution_002c-building-for"></span>
-<a name="index-GNU_002fLinux-distro"></a>
-<a name="index-BSD-distro"></a>
+<span id="index-GNU_002fLinux-distro"></span>
+<span id="index-BSD-distro"></span>
<p>Although they use the same code base, building for the native TL
distribution as shipped by the TeX user groups is typically quite
different from a “distro” build needed by, e.g., a full GNU/Linux or
BSD operating system distribution.
</p>
-<a name="index-shared-libraries_002c-using-vs_002e-avoiding"></a>
+<span id="index-shared-libraries_002c-using-vs_002e-avoiding"></span>
<p>The native TL distribution uses shared libraries only when absolutely
necessary (<samp>libc</samp>, <samp>libm</samp>, X11 libraries, and
-<samp>libfontconfig</samp>). However, a distro typically wants to use as
-many shared libraries as possible from elsewhere on the system,
+<samp>libfontconfig</samp>). In contrast, a distro typically wants to use
+as many shared libraries as possible from elsewhere on the system,
including TeX-specific libraries such as <samp>libkpathsea</samp> (even
though Kpathsea has never officially been released as a shared
-library, but we digress). In addition, the installation paths will,
-in general, be completely different.
+library). In addition, the installation paths will, in general, be
+completely different.
</p>
<p>Here are the <code>configure</code> options that distro builds are likely to
find most relevant:
@@ -1180,7 +1180,7 @@
</p>
</dd>
<dt><code>--with-system-<var>lib</var></code></dt>
-<dd><p>Use system versions for as many libraries <var>lib</var> as possible.
+<dd><p>Look for and use a system version of the library <var>lib</var>.
<code>configure --help</code> will give you the list of possibilities.
</p>
</dd>
@@ -1202,28 +1202,26 @@
</dd>
</dl>
-<a name="index-Preining_002c-Norbert"></a>
-<a name="index-adapting-TeX-Live-for-distros"></a>
+<span id="index-Preining_002c-Norbert"></span>
+<span id="index-adapting-TeX-Live-for-distros"></span>
<p>You will need to take care of the support files mentioned above
(see <a href="#Installing">Installing</a>), and many other issues, such as font maps,
languages, and formats, independently of the build. Norbert Preining
has written a detailed article on adapting TL for distros:
-<a href="http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf">http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf</a>. (If the
+<a href="https://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf">https://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf</a>. (If the
article needs updating in the future, perhaps we will merge it into
this document.)
</p>
<hr>
-<a name="Layout-and-infrastructure"></a>
-<div class="header">
+<span id="Layout-and-infrastructure"></span><div class="header">
<p>
Next: <a href="#Configure-options" accesskey="n" rel="next">Configure options</a>, Previous: <a href="#Installing" accesskey="p" rel="prev">Installing</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>
</div>
-<a name="Layout-and-infrastructure-1"></a>
-<h2 class="chapter">6 Layout and infrastructure</h2>
+<span id="Layout-and-infrastructure-1"></span><h2 class="chapter">6 Layout and infrastructure</h2>
-<a name="index-layout-of-sources"></a>
-<a name="index-source-tree"></a>
+<span id="index-layout-of-sources"></span>
+<span id="index-source-tree"></span>
<p>The TeX Live source tree is the subtree rooted at <samp>Build/source</samp> of
the complete TL distribution and contains the sources for all executables
@@ -1232,36 +1230,34 @@
files.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Build-system-tools" accesskey="1">Build system tools</a>:</td><td> </td><td align="left" valign="top">Modifying infrastructure files.
+<tr><td align="left" valign="top">• <a href="#Build-system-tools" accesskey="1">Build system tools</a></td><td> </td><td align="left" valign="top">Modifying infrastructure files.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Top_002dlevel-directories" accesskey="2">Top-level directories</a>:</td><td> </td><td align="left" valign="top">libs texk utils; am auxdir build-aux m4; doc extra.
+<tr><td align="left" valign="top">• <a href="#Top_002dlevel-directories" accesskey="2">Top-level directories</a></td><td> </td><td align="left" valign="top">libs texk utils; am auxdir build-aux m4; doc extra.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Autoconf-macros" accesskey="3">Autoconf macros</a>:</td><td> </td><td align="left" valign="top">TL-specific Autoconf macros.
+<tr><td align="left" valign="top">• <a href="#Autoconf-macros" accesskey="3">Autoconf macros</a></td><td> </td><td align="left" valign="top">TL-specific Autoconf macros.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Library-modules" accesskey="4">Library modules</a>:</td><td> </td><td align="left" valign="top">Handling libraries, with examples.
+<tr><td align="left" valign="top">• <a href="#Library-modules" accesskey="4">Library modules</a></td><td> </td><td align="left" valign="top">Handling libraries, with examples.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Program-modules" accesskey="5">Program modules</a>:</td><td> </td><td align="left" valign="top">Handling programs, with examples.
+<tr><td align="left" valign="top">• <a href="#Program-modules" accesskey="5">Program modules</a></td><td> </td><td align="left" valign="top">Handling programs, with examples.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Extending-TeX-Live" accesskey="6">Extending TeX Live</a>:</td><td> </td><td align="left" valign="top">Adding a new module.
+<tr><td align="left" valign="top">• <a href="#Extending-TeX-Live" accesskey="6">Extending TeX Live</a></td><td> </td><td align="left" valign="top">Adding a new module.
</td></tr>
</table>
<hr>
-<a name="Build-system-tools"></a>
-<div class="header">
+<span id="Build-system-tools"></span><div class="header">
<p>
Next: <a href="#Top_002dlevel-directories" accesskey="n" rel="next">Top-level directories</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-system-tools-1"></a>
-<h3 class="section">6.1 Build system tools</h3>
+<span id="Build-system-tools-1"></span><h3 class="section">6.1 Build system tools</h3>
-<a name="index-tools_002c-for-building"></a>
-<a name="index-GNU-tools_002c-needed-for-building"></a>
-<a name="index-infrastructure_002c-tools-needed-for"></a>
+<span id="index-tools_002c-for-building"></span>
+<span id="index-GNU-tools_002c-needed-for-building"></span>
+<span id="index-infrastructure_002c-tools-needed-for"></span>
-<p>As mentioned above (see <a href="#Prerequisites">Prerequisites</a>), a normal build requires
-very little. On the other hand, if you want to modify the TeX Live
+<p>As mentioned above (see <a href="#Prerequisites">Prerequisites</a>), a normal build has few
+requirements. On the other hand, if you want to modify the TeX Live
infrastructure sources, such as <samp>configure.ac</samp> or
<samp>Makefile.am</samp> files, you will need to have several additional
tools installed.
@@ -1278,16 +1274,16 @@
</p>
<div class="display">
<pre class="display">autoconf (GNU Autoconf) 2.69
-automake (GNU automake) 1.15.1
-bison (GNU Bison) 3.0.4
+automake (GNU automake) 1.16.1
+bison (GNU Bison) 3.3.1
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.18
-makeinfo (GNU texinfo) 6.5
+makeinfo (GNU texinfo) 6.6
</pre></div>
-<a name="index-reautoconf"></a>
-<a name="index-_002d_002denable_002dmaintainer_002dmode"></a>
+<span id="index-reautoconf"></span>
+<span id="index-_002d_002denable_002dmaintainer_002dmode"></span>
<p>These versions should be used to update the generated files (e.g.,
<samp>configure</samp> or <samp>Makefile.in</samp>) in all or parts of the TL tree
after their dependencies have been changed. This can be done
@@ -1294,37 +1290,40 @@
explicitly with the top-level <code>reautoconf</code> script or implicitly
by using the configure option <code>--enable-maintainer-mode</code>.
</p>
-<a name="index-Subversion-repository"></a>
-<a name="index-timestamps_002c-in-repository"></a>
-<a name="index-use_002dcommit_002dtimes_002c-Subversion"></a>
+<p>It has often turned out that the bison and flex versions are not
+critical; however, the autotools versions are. If you don’t have the
+given versions, get them before modifying the build infrastructure.
+</p>
+<span id="index-Subversion-repository"></span>
+<span id="index-timestamps_002c-in-repository"></span>
+<span id="index-use_002dcommit_002dtimes_002c-Subversion"></span>
<p>The files in the Subversion repository (see
-<a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>) are all up to date, but
-unfortunately this may not be reflected by their timestamps. (For
-starters, be sure to set <samp>use-commit-times=yes</samp> in
-<samp>~/.subversion/config</samp> or the equivalent.)
+<a href="https://tug.org/texlive/svn">https://tug.org/texlive/svn</a>) are all up to date (barring
+bugs). For this to be reflected by their timestamps in your checkout,
+be sure to set <samp>use-commit-times=yes</samp> in
+<samp>~/.subversion/config</samp> or the equivalent.
</p>
-<a name="index-touching-files-to-avoid-rerunning"></a>
-<a name="index-make-_002dt"></a>
-<p>To avoid unnecessary runs of <code>bison</code>, <code>flex</code>, or
-<code>makeinfo</code> it may be necessary to <code>touch</code> the generated
-(<samp>.c</samp>, <samp>.h</samp>, or <samp>.info</samp>) files. With
-<code>--enable-maintainer-mode</code> it may also be necessary to
-<code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp> and
+
+<span id="index-touching-files-to-avoid-rerunning"></span>
+<span id="index-make-_002dt"></span>
+<p>If timestamps are wrong, you may also be able to avoid unnecessary
+runs of <code>bison</code>, <code>flex</code>, or <code>makeinfo</code> with
+<code>touch</code> of the generated (<samp>.c</samp>, <samp>.h</samp>, or <samp>.info</samp>)
+files. With <code>--enable-maintainer-mode</code> it may also be necessary
+to <code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp> and
<samp>config.h.in</samp> (or <samp>c-auto.in</samp>), and finally all
<samp>Makefile.in</samp> files. Perhaps <code>make -t</code> will help.
</p>
<hr>
-<a name="Top_002dlevel-directories"></a>
-<div class="header">
+<span id="Top_002dlevel-directories"></span><div class="header">
<p>
Next: <a href="#Autoconf-macros" accesskey="n" rel="next">Autoconf macros</a>, Previous: <a href="#Build-system-tools" accesskey="p" rel="prev">Build system tools</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Top_002dlevel-directories-1"></a>
-<h3 class="section">6.2 Top-level directories</h3>
+<span id="Top_002dlevel-directories-1"></span><h3 class="section">6.2 Top-level directories</h3>
-<a name="index-directories_002c-top_002dlevel"></a>
-<a name="index-top_002dlevel-directories"></a>
+<span id="index-directories_002c-top_002dlevel"></span>
+<span id="index-top_002dlevel-directories"></span>
<p>Here is a brief description of the top-level directories in the TeX Live
source tree.
@@ -1333,8 +1332,8 @@
(TeX-specific programs and libraries), <samp>utils/</samp> (additional
programs), and <samp>libs/</samp> (generic libraries).
</p>
-<a name="index-am_002f-top_002dlevel-directory"></a>
-<a name="index-m4_002f-top_002dlevel-directory"></a>
+<span id="index-am_002f-top_002dlevel-directory"></span>
+<span id="index-m4_002f-top_002dlevel-directory"></span>
<p>In addition, the top-level directories <samp>am/</samp> and <samp>m4/</samp>
contain <samp>Makefile.am</samp> fragments and Autoconf macros,
respectively, used in many places. Specifically, the file
@@ -1352,83 +1351,75 @@
be built—although all modules must be configured for the benefit of
<samp>make</samp> targets such as <code>dist</code> or <code>distcheck</code>.
</p>
-<a name="index-build_002daux_002f-top_002dlevel-directory"></a>
-<a name="index-config_002eguess_002c-config_002esub_002c-_2026"></a>
-<a name="index-Gnulib_002c-used-for-common-files"></a>
+<span id="index-build_002daux_002f-top_002dlevel-directory"></span>
+<span id="index-config_002eguess_002c-config_002esub_002c-_2026"></span>
+<span id="index-Gnulib_002c-used-for-common-files"></span>
<p>The top-level <samp>build-aux/</samp> directory contains the common files
<samp>compile</samp>, <samp>config.guess</samp>, <samp>config.sub</samp>,
-<samp>depcomp</samp>, etc. used by most packages. These are from the GNU
-Gnulib sources (<a href="http://www.gnu.org/software/gnulib">http://www.gnu.org/software/gnulib</a>), which in
-turn synchronizes with the appropriate ultimate upstream repository.
-There are, however, independent copies in, e.g.,
-<samp>libs/freetype2/freetype-*/builds/unix/</samp>, and a few other places.
-The <code>reautoconf</code> script does not touch those, but a TL cron job
-keeps them in sync (nightly).
+<samp>depcomp</samp>, etc. used by most packages. These are taken from the
+GNU Gnulib sources (<a href="https://www.gnu.org/software/gnulib">https://www.gnu.org/software/gnulib</a>), which
+in turn synchronizes with any ultimate upstream repository. There are
+independent copies of some of these in a few other places, e.g.,
+<samp>libs/freetype2/freetype-*/builds/unix/</samp>. The <code>reautoconf</code>
+script does not touch those, but a TL cron job keeps them in sync
+(nightly).
</p>
-<a name="index-extra_002f-top_002dlevel-directory"></a>
-<p>The directory <samp>extra/</samp> contains things which are not part of the
-TL build, but are present just for (someone’s) convenience, e.g.,
-is <samp>epstopdf</samp> development source is here.
-</p>
-<a name="index-Work_002f-top_002dlevel-directory"></a>
-<a name="index-inst_002f-top_002dlevel-directory"></a>
+<span id="index-Work_002f-top_002dlevel-directory"></span>
+<span id="index-inst_002f-top_002dlevel-directory"></span>
<p>When the top-level <samp>./Build</samp> script is used to build TL, two more
two more top-level directories appear: <samp>Work/</samp> for the build tree,
and <samp>inst/</samp> for the install tree (from <code>make install</code>).
These names (and everything else about <samp>Build</samp>’s operation) can
be changed by setting environment variables before running it; see the
-script file.
+script source.
</p>
<hr>
-<a name="Autoconf-macros"></a>
-<div class="header">
+<span id="Autoconf-macros"></span><div class="header">
<p>
Next: <a href="#Library-modules" accesskey="n" rel="next">Library modules</a>, Previous: <a href="#Top_002dlevel-directories" accesskey="p" rel="prev">Top-level directories</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Autoconf-macros-1"></a>
-<h3 class="section">6.3 Autoconf macros</h3>
+<span id="Autoconf-macros-1"></span><h3 class="section">6.3 Autoconf macros</h3>
-<a name="index-autoconf-macros"></a>
+<span id="index-autoconf-macros"></span>
-<p>Here we describe some of the Autoconf macros used in several
-modules–not a complete list, by any means. These general macros are
-supplemented by module-specific macros in directories such as
-<samp>texk/dvipng/m4/</samp>; some of those are described in <a href="#Library-modules">Library modules</a> and see <a href="#Program-modules">Program modules</a>.
+<p>Here we describe a few of the Autoconf macros used in several
+modules—many more are defined in the sources; see the top-level
+<code>m4/</code> directory. These general macros are supplemented by
+module-specific macros in directories such as <samp>texk/dvipng/m4/</samp>;
+some of those are described in following sections (see <a href="#Library-modules">Library modules</a> and <a href="#Program-modules">Program modules</a>).
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#General-setup-macros" accesskey="1">Setup</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#General-setup-macros" accesskey="1">Setup</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Macros-for-programs" accesskey="2">Programs</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Macros-for-programs" accesskey="2">Programs</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Macros-for-compilers" accesskey="3">Compilers</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Macros-for-compilers" accesskey="3">Compilers</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Macros-for-libraries" accesskey="4">Libraries</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Macros-for-libraries" accesskey="4">Libraries</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Macros-for-library-and-header-flags" accesskey="5">Flags</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Macros-for-library-and-header-flags" accesskey="5">Flags</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Macros-for-Windows" accesskey="6">Windows</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Macros-for-Windows" accesskey="6">Windows</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="General-setup-macros"></a>
-<div class="header">
+<span id="General-setup-macros"></span><div class="header">
<p>
Next: <a href="#Macros-for-programs" accesskey="n" rel="next">Macros for programs</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="General-setup-macros-1"></a>
-<h4 class="subsection">6.3.1 General setup macros</h4>
+<span id="General-setup-macros-1"></span><h4 class="subsection">6.3.1 General setup macros</h4>
-<a name="index-general-setup-macros"></a>
-<a name="index-setup-macros_002c-general"></a>
-<a name="index-macros_002c-general-setup"></a>
+<span id="index-general-setup-macros"></span>
+<span id="index-setup-macros_002c-general"></span>
+<span id="index-macros_002c-general-setup"></span>
<p>The TL sources use two general setup macros:
</p>
<dl>
-<dt><a name="index-KPSE_005fBASIC"></a>Macro: <strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
+<dt id="index-KPSE_005fBASIC">Macro: <strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
<dd><p>Initialize the basic TL infrastructure for module <var>name</var>:<br> <code>AM_INIT_AUTOMAKE([foreign <var>more-options</var>])</code><br> <code>AM_MAINTAINER_MODE</code><br> <code>KPSE_COMPILER_WARNINGS</code><br>
and make sure the C compiler understands function prototypes. This is
used for all generic library and program modules.
@@ -1435,8 +1426,8 @@
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOMMON"></a>Macro: <strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
-<dd><p>Like <code>KPSE_BASIC</code> but add:<br> <code>LT_PREREQ([2.2.6])</code><br> <code>LT_INIT([win32-dll])</code><br> <code>AC_SYS_LARGEFILE</code><br> <code>AC_FUNC_FSEEKO</code><br>and check for frequently used functions,
+<dt id="index-KPSE_005fCOMMON">Macro: <strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
+<dd><p>Like <code>KPSE_BASIC</code> but add:<br> <code>LT_PREREQ([2.2.6])</code><br> <code>LT_INIT([win32-dll])</code><br> <code>AC_SYS_LARGEFILE</code><br> <code>AC_FUNC_FSEEKO</code><br>along with checks for frequently used functions,
headers, types, and structures. This is used for TeX-specific
modules.
</p></dd></dl>
@@ -1443,114 +1434,107 @@
<hr>
-<a name="Macros-for-programs"></a>
-<div class="header">
+<span id="Macros-for-programs"></span><div class="header">
<p>
Next: <a href="#Macros-for-compilers" accesskey="n" rel="next">Macros for compilers</a>, Previous: <a href="#General-setup-macros" accesskey="p" rel="prev">General setup macros</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-programs-1"></a>
-<h4 class="subsection">6.3.2 Macros for programs</h4>
+<span id="Macros-for-programs-1"></span><h4 class="subsection">6.3.2 Macros for programs</h4>
-<a name="index-macros_002c-for-programs"></a>
+<span id="index-macros_002c-for-programs"></span>
<p>Macros for program checks:
</p>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fLATEX"></a>Macro: <strong>KPSE_CHECK_LATEX</strong></dt>
-<dd><p>Set <code>LATEX</code> to the name of the first of <code>latex</code>,
-<code>elatex</code>, or <code>lambda</code> which exists in <code>PATH</code>, or to
-<code>no</code> if none of them exists. Call <code>AC_SUBST</code> for
-<code>LATEX</code>. The result of this test can be overridden by setting
-the <code>LATEX</code> environment variable or the cache variable
-<code>ac_cv_prog_LATEX</code>.
+<dt id="index-KPSE_005fCHECK_005fLATEX">Macro: <strong>KPSE_CHECK_LATEX</strong></dt>
+<dd><p>Set <code>LATEX</code> to the first of <code>latex</code>, <code>elatex</code>, or
+<code>lambda</code> which exists in <code>PATH</code>, or to <code>no</code> if none of
+them exists. Call <code>AC_SUBST</code> for <code>LATEX</code>. The result of
+this test can be overridden by setting the <code>LATEX</code> environment
+variable or the cache variable <code>ac_cv_prog_LATEX</code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fPDFLATEX"></a>Macro: <strong>KPSE_CHECK_PDFLATEX</strong></dt>
+<dt id="index-KPSE_005fCHECK_005fPDFLATEX">Macro: <strong>KPSE_CHECK_PDFLATEX</strong></dt>
<dd><p>Check for <code>pdflatex</code> in <code>PATH</code> and set <code>PDFLATEX</code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fPERL"></a>Macro: <strong>KPSE_CHECK_PERL</strong></dt>
+<dt id="index-KPSE_005fCHECK_005fPERL">Macro: <strong>KPSE_CHECK_PERL</strong></dt>
<dd><p>Check for <code>perl</code> or <code>perl5</code> in <code>PATH</code> and set
<code>PERL</code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fPROG_005fLEX"></a>Macro: <strong>KPSE_PROG_LEX</strong></dt>
+<dt id="index-KPSE_005fPROG_005fLEX">Macro: <strong>KPSE_PROG_LEX</strong></dt>
<dd><p>Call <code>AC_PROG_LEX</code> and add the flag <code>-l</code> for <code>flex</code>.
</p></dd></dl>
<hr>
-<a name="Macros-for-compilers"></a>
-<div class="header">
+<span id="Macros-for-compilers"></span><div class="header">
<p>
Next: <a href="#Macros-for-libraries" accesskey="n" rel="next">Macros for libraries</a>, Previous: <a href="#Macros-for-programs" accesskey="p" rel="prev">Macros for programs</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-compilers-1"></a>
-<h4 class="subsection">6.3.3 Macros for compilers</h4>
+<span id="Macros-for-compilers-1"></span><h4 class="subsection">6.3.3 Macros for compilers</h4>
-<a name="index-macros_002c-for-compilers"></a>
+<span id="index-macros_002c-for-compilers"></span>
<p>Macros for compiler-related checks:
</p>
<dl>
-<dt><a name="index-KPSE_005fCOMPILER_005fWARNINGS"></a>Macro: <strong>KPSE_COMPILER_WARNINGS</strong></dt>
-<dd><a name="index-WARNING_005fC_005bXX_005dFLAGS"></a>
+<dt id="index-KPSE_005fCOMPILER_005fWARNINGS">Macro: <strong>KPSE_COMPILER_WARNINGS</strong></dt>
+<dd><span id="index-WARNING_005fC_005bXX_005dFLAGS"></span>
<p>When using the (Objective) C/C++ compiler, set
<code>WARNING_[OBJ]C[XX]FLAGS</code> to suitable warning flags (depending on
the value given to or implied for <code>--enable-compiler-warnings</code>).
-Call <code>AC_SUBST</code> for them. At the moment this only works for GNU
-compilers, but could be extended to others if necessary.
+Call <code>AC_SUBST</code> for them. At present this assumes GNU compiler
+warning options, but could be extended to others if necessary.
</p>
-<a name="index-kpse_005fcv_005fwarning_005fcflags"></a>
+<span id="index-kpse_005fcv_005fwarning_005fcflags"></span>
<p>This macro caches its results in the <code>kpse_cv_warning_cflags</code>,
… variables.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOMPILER_005fVISIBILITY"></a>Macro: <strong>KPSE_COMPILER_VISIBILITY</strong></dt>
+<dt id="index-KPSE_005fCOMPILER_005fVISIBILITY">Macro: <strong>KPSE_COMPILER_VISIBILITY</strong></dt>
<dd><p>When using the C or C++ compiler, try to set
<code>VISIBILITY_C[XX]FLAGS</code> to flags to hide external symbols. Call
-<code>AC_SUBST</code> for this variable. At the moment this only tests for
-the compiler option <code>-fvisibility=hidden</code>, but that could be
-extended with more checks if necessary.
+<code>AC_SUBST</code> for this variable. At present this only tests for
+the compiler option <code>-fvisibility=hidden</code>, but could be
+extended if necessary.
</p>
-<a name="index-kpse_005fcv_005fvisibility_005fc_005bxx_005dflags"></a>
+<span id="index-kpse_005fcv_005fvisibility_005fc_005bxx_005dflags"></span>
<p>This macro caches its results in the <code>kpse_cv_visibility_cflags</code>
or <code>kpse_cv_visibility_cxxflags</code> variable.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCXX_005fHACK"></a>Macro: <strong>KPSE_CXX_HACK</strong></dt>
-<dd><a name="index-static-linking-for-C_002b_002b"></a>
-<a name="index-linking-C_002b_002b-libraries-statically"></a>
-<a name="index-_002d_002denable_002dcxx_002druntime_002dhack"></a>
-<a name="index-libstc_002b_002b_002c-statically-linking"></a>
+<dt id="index-KPSE_005fCXX_005fHACK">Macro: <strong>KPSE_CXX_HACK</strong></dt>
+<dd><span id="index-static-linking-for-C_002b_002b"></span>
+<span id="index-linking-C_002b_002b-libraries-statically"></span>
+<span id="index-_002d_002denable_002dcxx_002druntime_002dhack"></span>
+<span id="index-libstc_002b_002b_002c-statically-linking"></span>
<p>Provide the configure option <code>--enable-cxx-runtime-hack</code>. If
enabled and when using <code>g++</code>, try to statically link with
-<samp>libstdc++</samp>, somewhat improving portability of the resulting
+<samp>libstdc++</samp>, notably improving portability of the resulting
binary.
</p>
-<a name="index-kpse_005fcv_005fcxx_005fhack"></a>
+<span id="index-kpse_005fcv_005fcxx_005fhack"></span>
<p>This macro caches its result in the <code>kpse_cv_cxx_hack</code> variable.
</p></dd></dl>
<hr>
-<a name="Macros-for-libraries"></a>
-<div class="header">
+<span id="Macros-for-libraries"></span><div class="header">
<p>
Next: <a href="#Macros-for-library-and-header-flags" accesskey="n" rel="next">Macros for library and header flags</a>, Previous: <a href="#Macros-for-compilers" accesskey="p" rel="prev">Macros for compilers</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-libraries-1"></a>
-<h4 class="subsection">6.3.4 Macros for libraries</h4>
+<span id="Macros-for-libraries-1"></span><h4 class="subsection">6.3.4 Macros for libraries</h4>
-<a name="index-macros_002c-for-libraries"></a>
+<span id="index-macros_002c-for-libraries"></span>
<p>One macro for a library check:
</p>
<dl>
-<dt><a name="index-KPSE_005fLARGEFILE"></a>Macro: <strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em></dt>
+<dt id="index-KPSE_005fLARGEFILE">Macro: <strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em></dt>
<dd><p>Call <code>AC_SYS_LARGEFILE</code> and <code>AC_FUNC_FSEEKO</code> and append
suitable <code>-D</code> flags (optionally including
<code>-D<var>extra-define</var></code>) to <var>variable</var>.
@@ -1558,17 +1542,15 @@
<hr>
-<a name="Macros-for-library-and-header-flags"></a>
-<div class="header">
+<span id="Macros-for-library-and-header-flags"></span><div class="header">
<p>
Next: <a href="#Macros-for-Windows" accesskey="n" rel="next">Macros for Windows</a>, Previous: <a href="#Macros-for-libraries" accesskey="p" rel="prev">Macros for libraries</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-library-and-header-flags-1"></a>
-<h4 class="subsection">6.3.5 Macros for library and header flags</h4>
+<span id="Macros-for-library-and-header-flags-1"></span><h4 class="subsection">6.3.5 Macros for library and header flags</h4>
-<a name="index-macros_002c-for-library-and-header-flags"></a>
-<a name="index-flags_002c-macros-for-library-and-header"></a>
-<a name="index-KPSE_005fLIB_005fFLAGS"></a>
+<span id="index-macros_002c-for-library-and-header-flags"></span>
+<span id="index-flags_002c-macros-for-library-and-header"></span>
+<span id="index-KPSE_005fLIB_005fFLAGS"></span>
<p>Each library module <samp>libs/<var>lib</var></samp> or <samp>texk/<var>lib</var></samp> is
supplemented by a macro <code>KPSE_<var>LIB</var>_FLAGS</code> (all uppercase)
that provides make variables for that library. E.g., for
@@ -1575,23 +1557,27 @@
<samp>libs/libpng</samp>:
</p>
<dl>
-<dt><a name="index-KPSE_005fLIBPNG_005fFLAGS"></a>Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt>
+<dt id="index-KPSE_005fLIBPNG_005fFLAGS">Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt>
<dd><p>Provide the configure option <code>--with-system-libpng</code>. Set and
<code>AC_SUBST</code> <code>make</code> variables for modules using this library (either
-an installed version or from the TeX Live tree): <code>LIBPNG_INCLUDES</code> for use
-in <code>CPPFLAGS</code>, <code>LIBPNG_LIBS</code> for use in <code>LDADD</code>,
-<code>LIBPNG_DEPEND</code> for use as dependency, and <code>LIBPNG_RULE</code> defining
-<code>make</code> rules to rebuild the library.
-</p></dd></dl>
+an installed version or from the TeX Live tree):
+</p>
+<table>
+<tr><td><code>LIBPNG_INCLUDES</code></td><td>for use in <code>CPPFLAGS</code>,</td></tr>
+<tr><td><code>LIBPNG_LIBS</code></td><td>for use in <code>LDADD</code>,</td></tr>
+<tr><td><code>LIBPNG_DEPEND</code></td><td>for use as a Makefile dependency,</td></tr>
+<tr><td><code>LIBPNG_RULE</code></td><td>for the <code>make</code> rules to rebuild the library.</td></tr>
+</table>
+</dd></dl>
<dl>
-<dt><a name="index-KPSE_005fADD_005fFLAGS"></a>Macro: <strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em></dt>
+<dt id="index-KPSE_005fADD_005fFLAGS">Macro: <strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em></dt>
<dd><p>Temporarily extend <code>CPPFLAGS</code> and <code>LIBS</code> with the values required
for the library module <code><var>name</var></code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fRESTORE_005fFLAGS"></a>Macro: <strong>KPSE_RESTORE_FLAGS</strong></dt>
+<dt id="index-KPSE_005fRESTORE_005fFLAGS">Macro: <strong>KPSE_RESTORE_FLAGS</strong></dt>
<dd><p>Restore <code>CPPFLAGS</code> and <code>LIBS</code> to their original values.
</p></dd></dl>
@@ -1615,7 +1601,7 @@
@LIBPNG_RULE@
</pre></div>
-<p>If it was necessary to examine whether certain <samp>zlib</samp> or
+<p>If it were necessary to examine whether certain <samp>zlib</samp> or
<samp>libpng</samp> features were available, <samp>configure.ac</samp> should be
continued this way:
</p><div class="example">
@@ -1628,31 +1614,29 @@
<hr>
-<a name="Macros-for-Windows"></a>
-<div class="header">
+<span id="Macros-for-Windows"></span><div class="header">
<p>
Previous: <a href="#Macros-for-library-and-header-flags" accesskey="p" rel="prev">Macros for library and header flags</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-Windows-1"></a>
-<h4 class="subsection">6.3.6 Macros for Windows</h4>
+<span id="Macros-for-Windows-1"></span><h4 class="subsection">6.3.6 Macros for Windows</h4>
-<a name="index-macros_002c-for-Windows"></a>
-<a name="index-Windows_002c-macros-for"></a>
+<span id="index-macros_002c-for-Windows"></span>
+<span id="index-Windows_002c-macros-for"></span>
<p>Windows differs in several aspects from Unix-like systems, many of
them due to the lack of symbolic links.
</p>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fWIN32"></a>Macro: <strong>KPSE_CHECK_WIN32</strong></dt>
-<dd><a name="index-kpse_005fcv_005fhave_005fwin32"></a>
-<p>Check if compiling for a Windows system. The result is <code>no</code> for
-Unix-like systems (including Cygwin), <code>mingw32</code> for Windows with
-GCC, or <code>native</code> for Windows with MSVC. The result is cached in
-the <code>kpse_cv_have_win32</code> variable.
+<dt id="index-KPSE_005fCHECK_005fWIN32">Macro: <strong>KPSE_CHECK_WIN32</strong></dt>
+<dd><span id="index-kpse_005fcv_005fhave_005fwin32"></span>
+<p>Check if compiling for a Windows system. The result is either
+<code>no</code> for Unix-like systems (including Cygwin), <code>mingw32</code> for
+Windows with GCC, or <code>native</code> for Windows with MSVC. The result
+is cached in the <code>kpse_cv_have_win32</code> variable.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOND_005fWIN32"></a>Macro: <strong>KPSE_COND_WIN32</strong></dt>
-<dd><a name="index-WIN32_002c-Automake-conditional"></a>
+<dt id="index-KPSE_005fCOND_005fWIN32">Macro: <strong>KPSE_COND_WIN32</strong></dt>
+<dd><span id="index-WIN32_002c-Automake-conditional"></span>
<p>Call <code>KPSE_CHECK_WIN32</code> and define the Automake conditional
<code>WIN32</code> (<code>true</code> if the value of <code>kpse_cv_have_win32</code> is
not <code>no</code>).
@@ -1659,8 +1643,8 @@
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOND_005fMINGW32"></a>Macro: <strong>KPSE_COND_MINGW32</strong></dt>
-<dd><a name="index-MINGW32_002c-Automake-conditional"></a>
+<dt id="index-KPSE_005fCOND_005fMINGW32">Macro: <strong>KPSE_COND_MINGW32</strong></dt>
+<dd><span id="index-MINGW32_002c-Automake-conditional"></span>
<p>Call <code>KPSE_COND_WIN32</code> and define the Automake conditional
<code>MINGW32</code> (<code>true</code> if the value of <code>kpse_cv_have_win32</code> is
<code>mingw32</code>).
@@ -1667,9 +1651,9 @@
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOND_005fWIN32_005fWRAP"></a>Macro: <strong>KPSE_COND_WIN32_WRAP</strong></dt>
-<dd><a name="index-WIN32_005fWRAP_002c-Automake-conditional"></a>
-<a name="index-runscript_002eexe"></a>
+<dt id="index-KPSE_005fCOND_005fWIN32_005fWRAP">Macro: <strong>KPSE_COND_WIN32_WRAP</strong></dt>
+<dd><span id="index-WIN32_005fWRAP_002c-Automake-conditional"></span>
+<span id="index-runscript_002eexe"></span>
<p>Call <code>KPSE_COND_WIN32</code> and define the Automake conditional
<code>WIN32_WRAP</code> (<code>true</code> if the standard Windows wrapper
(<samp>texk/texlive/w32_wrapper/runscript.exe</samp>) exists. This wrapper
@@ -1678,9 +1662,9 @@
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fWIN32_005fCALL"></a>Macro: <strong>KPSE_WIN32_CALL</strong></dt>
-<dd><a name="index-callexe_002ec"></a>
-<p>Call <code>KPSE_COND_WIN32</code>, check if the file
+<dt id="index-KPSE_005fWIN32_005fCALL">Macro: <strong>KPSE_WIN32_CALL</strong></dt>
+<dd><span id="index-callexe_002ec"></span>
+<p>Call <code>KPSE_COND_WIN32</code> and check if the file
<samp>texk/texlive/w32_wrapper/callexe.c</samp> exists; if it does, create a
symlink in the build tree. Compiling <samp>callexe.c</samp> with
<code>-DEXEPROG='"<var>foo</var>.exe"'</code> and installing <samp>callexe.exe</samp>
@@ -1690,45 +1674,41 @@
<hr>
-<a name="Library-modules"></a>
-<div class="header">
+<span id="Library-modules"></span><div class="header">
<p>
Next: <a href="#Program-modules" accesskey="n" rel="next">Program modules</a>, Previous: <a href="#Autoconf-macros" accesskey="p" rel="prev">Autoconf macros</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Library-modules-1"></a>
-<h3 class="section">6.4 Library modules</h3>
+<span id="Library-modules-1"></span><h3 class="section">6.4 Library modules</h3>
-<a name="index-library-modules"></a>
-<a name="index-modules_002c-for-libraries"></a>
+<span id="index-library-modules"></span>
+<span id="index-modules_002c-for-libraries"></span>
<p>Here we discuss some specifics for a few of the libraries in TL, both
for the details themselves, and as a way of illuminating the general
structure and variation.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#png-library" accesskey="1"><code>png</code> library</a>:</td><td> </td><td align="left" valign="top"><samp>libs/libpng</samp>
+<tr><td align="left" valign="top">• <a href="#png-library" accesskey="1"><code>png</code> library</a></td><td> </td><td align="left" valign="top"><samp>libs/libpng</samp>
</td></tr>
-<tr><td align="left" valign="top">• <a href="#zlib-library" accesskey="2"><code>zlib</code> library</a>:</td><td> </td><td align="left" valign="top"><samp>libs/zlib</samp>
+<tr><td align="left" valign="top">• <a href="#zlib-library" accesskey="2"><code>zlib</code> library</a></td><td> </td><td align="left" valign="top"><samp>libs/zlib</samp>
</td></tr>
-<tr><td align="left" valign="top">• <a href="#freetype-library" accesskey="3"><code>freetype</code> library</a>:</td><td> </td><td align="left" valign="top"><samp>libs/freetype2</samp>
+<tr><td align="left" valign="top">• <a href="#freetype-library" accesskey="3"><code>freetype</code> library</a></td><td> </td><td align="left" valign="top"><samp>libs/freetype2</samp>
</td></tr>
-<tr><td align="left" valign="top">• <a href="#kpathsea-library" accesskey="4"><code>kpathsea</code> library</a>:</td><td> </td><td align="left" valign="top"><samp>texk/kpathsea</samp>
+<tr><td align="left" valign="top">• <a href="#kpathsea-library" accesskey="4"><code>kpathsea</code> library</a></td><td> </td><td align="left" valign="top"><samp>texk/kpathsea</samp>
</td></tr>
</table>
<hr>
-<a name="png-library"></a>
-<div class="header">
+<span id="png-library"></span><div class="header">
<p>
Next: <a href="#zlib-library" accesskey="n" rel="next"><code>zlib</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-png-library-in-libs_002flibpng"></a>
-<h4 class="subsection">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></h4>
+<span id="The-png-library-in-libs_002flibpng"></span><h4 class="subsection">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></h4>
-<a name="index-png-library"></a>
-<a name="index-libpng-library"></a>
-<p>This generic library uses the source tree in, e.g., the subdirectory
-<samp>libpng-src/</samp> with all modifications for TL recorded in
-<samp>TLpatches/*</samp>. The <samp>configure.ac</samp> fragment
+<span id="index-png-library"></span>
+<span id="index-libpng-library"></span>
+<p>The “generic” <code>png</code> library uses the source tree in the
+subdirectory <samp>libpng-src/</samp>, with all modifications for TL
+recorded in <samp>TLpatches/*</samp>. The <samp>configure.ac</samp> fragment
<samp>ac/withenable.ac</samp> contains
</p>
<div class="example">
@@ -1735,13 +1715,13 @@
<pre class="example">KPSE_WITH_LIB([libpng], [zlib])
</pre></div>
-<p>specifying the module name, and indicating the dependency on
-<code>zlib</code>. A third literal argument <code>tree</code> would specify that
+<p>to specify the module name and indicate the dependency on
+<code>zlib</code>. A third literal argument ‘<code>tree</code>’ would specify that
the library from the TeX Live tree cannot be replaced by a system
version. That not being the case here, a second fragment
<samp>ac/libpng.ac</samp> contains
</p>
-<a name="index-KPSE_005fTRY_005fLIB"></a>
+<span id="index-KPSE_005fTRY_005fLIB"></span>
<div class="example">
<pre class="example">KPSE_TRY_LIB([libpng],
[#include <png.h>],
@@ -1759,23 +1739,27 @@
return 0; }
</pre></div>
-<a name="index-KPSE_005fTRY_005fLIBXX"></a>
+<span id="index-KPSE_005fTRY_005fLIBXX"></span>
<p>which Autoconf uses to verify the usability of a system
version with C code. The analogous macro <code>KPSE_TRY_LIBXX</code> would
-check using C++ code. These fragments are included by
-<samp>configure.ac</samp> at the top level.
+check using C++. These fragments are included by the
+<samp>configure.ac</samp> at the top level of TL
+(<code>Build/source/configure.ac</code>).
</p>
-<p>For this library, among many other modules, a proxy build system for
-TL is used (<samp>configure.ac</samp>, <samp>Makefile.am</samp>, and
-<samp>include/Makefile.am</samp>), ignoring the distributed one.
-Consequently, a few generated files and auxiliary scripts are removed
-from the distributed source tree. The public headers <samp>png.h</samp>,
-<samp>pngconf.h</samp>, and <samp>pnglibconf.h</samp> are “installed” (as
-symlinks) under <samp>include/</samp> in the build tree exactly as they are
-for a system version under, e.g., <samp>/usr/include/</samp>.
+<span id="index-proxy-build-system"></span>
+<p>For this library, like many other modules, a proxy build system for TL
+is used, consisting of our own <samp>configure.ac</samp>,
+<samp>Makefile.am</samp>, <samp>include/Makefile.am</samp>; the distributed build
+system is not used. (Consequently, a few generated files and
+auxiliary scripts are removed from the distributed source tree.)
</p>
-<a name="index-kpse_002dlibpng_002dflags_002em4"></a>
-<a name="index-KPSE_005fLIBPNG_005fFLAGS-1"></a>
+<p>The public headers <samp>png.h</samp>, <samp>pngconf.h</samp>, and
+<samp>pnglibconf.h</samp> are “installed” (as symlinks) under
+<samp>include/</samp> in the build tree exactly as they are for a system
+version under, e.g., <samp>/usr/include/</samp>.
+</p>
+<span id="index-kpse_002dlibpng_002dflags_002em4"></span>
+<span id="index-KPSE_005fLIBPNG_005fFLAGS-1"></span>
<p>The module is supplemented by the file <samp>m4/kpse-libpng-flags.m4</samp>
that defines the M4 macro <code>KPSE_LIBPNG_FLAGS</code> used by all modules
depending on this library in their <samp>configure.ac</samp> to generate the
@@ -1782,25 +1766,23 @@
<code>make</code> variables <code>LIBPNG_INCLUDES</code> for use in
<code>CPPFLAGS</code>, <code>LIBPNG_LIBS</code> for use in <code>LDADD</code>,
<code>LIBPNG_DEPEND</code> for use as dependencies, and <code>LIBPNG_RULE</code>
-defining <code>make</code> rules to rebuild the library.
+for the <code>make</code> rules to rebuild the library.
</p>
<p><samp>m4/kpse-libpng-flags.m4</samp> also supplies the configure option
-<code>--with-system-libpng</code> and uses <code>pkg-config</code> to determine
-the flags required for the system library.
+<code>--with-system-libpng</code>, which then uses <code>pkg-config</code> to
+determine the flags required for the system library.
</p>
<hr>
-<a name="zlib-library"></a>
-<div class="header">
+<span id="zlib-library"></span><div class="header">
<p>
Next: <a href="#freetype-library" accesskey="n" rel="next"><code>freetype</code> library</a>, Previous: <a href="#png-library" accesskey="p" rel="prev"><code>png</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-zlib-library-in-libs_002fzlib"></a>
-<h4 class="subsection">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></h4>
+<span id="The-zlib-library-in-libs_002fzlib"></span><h4 class="subsection">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></h4>
-<a name="index-zlib-library"></a>
+<span id="index-zlib-library"></span>
-<a name="index-kpse_002dzlib_002dflags_002em4"></a>
+<span id="index-kpse_002dzlib_002dflags_002em4"></span>
<p>This generic library is very much analogous to <code>libpng</code>, but
without the dependency on any other library. The file
<samp>m4/kpse-zlib-flags.m4</samp> supplies the configure option
@@ -1810,105 +1792,104 @@
</p>
<hr>
-<a name="freetype-library"></a>
-<div class="header">
+<span id="freetype-library"></span><div class="header">
<p>
Next: <a href="#kpathsea-library" accesskey="n" rel="next"><code>kpathsea</code> library</a>, Previous: <a href="#zlib-library" accesskey="p" rel="prev"><code>zlib</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-freetype-library-in-libs_002ffreetype2"></a>
-<h4 class="subsection">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></h4>
+<span id="The-freetype-library-in-libs_002ffreetype2"></span><h4 class="subsection">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></h4>
-<a name="index-freetype-library"></a>
+<span id="index-freetype-library"></span>
+<span id="index-wrapper-build-system"></span>
-<a name="index-freetype_002dconfig"></a>
-<p>This module uses a wrapper build system with an almost trivial
-<samp>configure.ac</samp> and with a <samp>Makefile.am</samp> that invokes
-<code>configure</code> and <code>make</code> for the distributed source, followed
-by <code>make install</code> with the build tree as destination. The flags
-required for the system library are obtained through
+<p>This module uses a wrapper build system. In contrast to the proxy
+build described earlier, the wrapper build has an almost trivial
+<samp>configure.ac</samp> and a <samp>Makefile.am</samp> which invokes the
+<code>configure</code> and <code>make</code> in the distributed source, followed
+by <code>make install</code> with the TL build tree as destination. In
+other words, this actually uses the build system provided by upstream
+(possibly patched).
+</p>
+<span id="index-freetype_002dconfig"></span>
+<p>The flags required for the system library are obtained through
<code>freetype-config</code>.
</p>
<hr>
-<a name="kpathsea-library"></a>
-<div class="header">
+<span id="kpathsea-library"></span><div class="header">
<p>
Previous: <a href="#freetype-library" accesskey="p" rel="prev"><code>freetype</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-kpathsea-library-in-texk_002fkpathsea"></a>
-<h4 class="subsection">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></h4>
+<span id="The-kpathsea-library-in-texk_002fkpathsea"></span><h4 class="subsection">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></h4>
-<a name="index-kpathsea-library"></a>
+<span id="index-kpathsea-library"></span>
<p>This is one of the TeX-specific libraries that are maintained as
-part of TeX Live (see <cite><a href="http://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>). Despite being a core
-part of the TeX system, it is not a terribly special case in the
-infrastructure. The TeX libraries are Libtool libraries (static
-and/or shared) and are installed by <code>make install</code> together with
-the programs. They are, however, not part of the TL DVD as
-distributed by TeX user groups, and have never been officially
-released for standalone use.
+part of TeX Live (see <cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea
+<span class="roman">(<a href="tug.org/kpathsea">tug.org/kpathsea</a>)</span></a></cite>); the other is <code>ptexenc</code>. These
+TeX libraries are Libtool libraries (static and/or shared) and are
+installed by <code>make install</code> together with the programs. They
+are, however, not part of the TL DVD as distributed by TeX user
+groups, and have never been officially released for standalone use.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dkpathsea"></a>
-<p>It is possible, and perhaps even useful for distro builds (see <a href="#Distro-builds">Distro builds</a>), to specify the configure option <code>--with-system-kpathsea</code> in
-order to use a system version of the library. Programs outside the TL tree
-should use <code>pkg-config</code> for the required flags.
+<span id="index-_002d_002dwith_002dsystem_002dkpathsea"></span>
+<p>It is possible, and probably useful for distro builds (see <a href="#Distro-builds">Distro builds</a>), to specify the configure option
+<code>--with-system-kpathsea</code> in order to use a system version of the
+library. Programs outside the TL tree should use <code>pkg-config</code>
+for the required flags.
</p>
-<a name="index-kpathsea_002eac"></a>
-<a name="index-mktex_002eac"></a>
-<a name="index-_002d_002denable_002dmktextfm_002ddefault"></a>
-<a name="index-mktextfm"></a>
-<p>In addition to <samp>ac/withenable.ac</samp> and <samp>ac/kpathsea.ac</samp> there
-is a third fragment <samp>ac/mktex.ac</samp> included by both
-<samp>ac/withenable.ac</samp> and <samp>configure.ac</samp> that supplies
-configure options such as <code>--enable-mktextfm-default</code>, which
-determine the compile time default of whether or not to run
-<code>mktextfm</code> to generate a missing <samp>.tfm</samp> file. In any case,
+<span id="index-kpathsea_002eac"></span>
+<span id="index-mktex_002eac"></span>
+<span id="index-_002d_002denable_002dmktextfm_002ddefault"></span>
+<span id="index-mktextfm"></span>
+<p>In addition to <samp>kpathsea/ac/withenable.ac</samp> and
+<samp>kpathsea/ac/kpathsea.ac</samp> here there is a third fragment
+<samp>kpathsea.ac/mktex.ac</samp>, included by both <samp>withenable.ac</samp> and
+<samp>configure.ac</samp>, which supplies configure options such as
+<code>--enable-mktextfm-default</code>. These determine the compile time
+default of whether or not to run <code>mktextfm</code> (and similar) to
+generate a missing <samp>.tfm</samp> (or whatever) file. In any case,
however, the command line options <code>-mktex=tfm</code> or
-<code>-no-mktex=tfm</code> for the TeX-like engines override this default.
+<code>-no-mktex=tfm</code> for the TeX-like engines override this
+default.
</p>
<hr>
-<a name="Program-modules"></a>
-<div class="header">
+<span id="Program-modules"></span><div class="header">
<p>
Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX Live</a>, Previous: <a href="#Library-modules" accesskey="p" rel="prev">Library modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Program-modules-1"></a>
-<h3 class="section">6.5 Program modules</h3>
+<span id="Program-modules-1"></span><h3 class="section">6.5 Program modules</h3>
-<a name="index-program-modules"></a>
-<a name="index-modules_002c-for-programs"></a>
+<span id="index-program-modules"></span>
+<span id="index-modules_002c-for-programs"></span>
<p>As with libraries (see <a href="#Library-modules">Library modules</a>), here we discuss the
details for a few of the programs in TL.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#t1utils-package" accesskey="1"><code>t1utils</code> package</a>:</td><td> </td><td align="left" valign="top"><samp>utils/t1utils</samp>
+<tr><td align="left" valign="top">• <a href="#t1utils-package" accesskey="1"><code>t1utils</code> package</a></td><td> </td><td align="left" valign="top"><samp>utils/t1utils</samp>
</td></tr>
-<tr><td align="left" valign="top">• <a href="#xindy-package" accesskey="2"><code>xindy</code> package</a>:</td><td> </td><td align="left" valign="top"><samp>utils/xindy</samp>
+<tr><td align="left" valign="top">• <a href="#xindy-package" accesskey="2"><code>xindy</code> package</a></td><td> </td><td align="left" valign="top"><samp>utils/xindy</samp>
</td></tr>
-<tr><td align="left" valign="top">• <a href="#xdvik-package" accesskey="3"><code>xdvik</code> package</a>:</td><td> </td><td align="left" valign="top"><samp>texk/xdvik</samp>
+<tr><td align="left" valign="top">• <a href="#xdvik-package" accesskey="3"><code>xdvik</code> package</a></td><td> </td><td align="left" valign="top"><samp>texk/xdvik</samp>
</td></tr>
-<tr><td align="left" valign="top">• <a href="#asymptote" accesskey="4"><code>asymptote</code></a>:</td><td> </td><td align="left" valign="top"><samp>utils/asymptote</samp>
+<tr><td align="left" valign="top">• <a href="#asymptote" accesskey="4"><code>asymptote</code></a></td><td> </td><td align="left" valign="top"><samp>utils/asymptote</samp>
</td></tr>
</table>
<hr>
-<a name="t1utils-package"></a>
-<div class="header">
+<span id="t1utils-package"></span><div class="header">
<p>
Next: <a href="#xindy-package" accesskey="n" rel="next"><code>xindy</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-t1utils-package-in-utils_002ft1utils"></a>
-<h4 class="subsection">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></h4>
+<span id="The-t1utils-package-in-utils_002ft1utils"></span><h4 class="subsection">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></h4>
-<a name="index-t1utils-package"></a>
+<span id="index-t1utils-package"></span>
-<p>Once again we use the distributed source tree <samp>t1utils-src</samp>
-with modifications documented in <samp>TLpatches/*</samp> and
-a proxy build system consisting of <samp>configure.ac</samp> and
-<samp>Makefile.am</samp>. The fragment <samp>ac/withenable.ac</samp> contains
+<p>Here we use the distributed source tree <samp>t1utils-src</samp> with
+modifications documented in <samp>TLpatches/*</samp> and a proxy build
+system consisting of <samp>configure.ac</samp> and <samp>Makefile.am</samp>. The
+fragment <samp>ac/withenable.ac</samp> contains
</p>
<div class="example">
<pre class="example">KPSE_ENABLE_PROG([t1utils])
@@ -1919,26 +1900,26 @@
</p>
<hr>
-<a name="xindy-package"></a>
-<div class="header">
+<span id="xindy-package"></span><div class="header">
<p>
Next: <a href="#xdvik-package" accesskey="n" rel="next"><code>xdvik</code> package</a>, Previous: <a href="#t1utils-package" accesskey="p" rel="prev"><code>t1utils</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-xindy-package-in-utils_002fxindy"></a>
-<h4 class="subsection">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></h4>
+<span id="The-xindy-package-in-utils_002fxindy"></span><h4 class="subsection">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></h4>
-<a name="index-xindy-1"></a>
+<span id="index-xindy-1"></span>
<p>This module uses the distributed source tree <samp>xindy-src/</samp> with
-modifications documented in <samp>TLpatches/*</samp>, a proxy
-<samp>configure.ac</samp>, and a wrapper <samp>Makefile.am</samp> that descends
-into <samp>xindy-src</samp>. The <code>xindy</code> build requires a <samp>make</samp>
-that supports a <code>VPATH</code> build, can handle all targets, and do not
-refer to <code>${top_srcdir}</code> or <code>${top_builddir}</code>. The
-fragment <code>ac/withenable.ac</code> contains
+modifications documented in <samp>TLpatches/*</samp>, and a wrapper
+<samp>configure.ac</samp> and <samp>Makefile.am</samp> that descends into
+<samp>xindy-src</samp>.
</p>
+<p>The <code>xindy</code> build requires a <samp>make</samp> that supports a
+<code>VPATH</code> build, can handle all targets, and do not refer to
+<code>${top_srcdir}</code> or <code>${top_builddir}</code>. The fragment
+<code>xindy/ac/withenable.ac</code> contains
+</p>
<div class="example">
-<pre class="example">KPSE_ENABLE_PROG([xindy], , [disable native])
+<pre class="example">KPSE_ENABLE_PROG([xindy], , [disable])
m4_include(kpse_TL[utils/xindy/ac/xindy.ac])
m4_include(kpse_TL[utils/xindy/ac/clisp.ac])
</pre></div>
@@ -1945,28 +1926,26 @@
<p>where <code>disable</code> in the third argument indicates that
<code>xindy</code> is only built if explicitly enabled by the user with
-<code>configure --enable-xindy</code> (the need for <code>clisp</code> is too
-painful to require by default), and <code>native</code> disallows cross
-compilation. The additional fragments <samp>ac/xindy.ac</samp> and
-<samp>ac/clisp.ac</samp> specify more <code>configure</code> options to be seen at
-the top level with <samp>ac/xindy.ac</samp> also included by
-<samp>configure.ac</samp>.
+<code>configure --enable-xindy</code> (the need for <code>clisp</code> makes it
+too painful to enable by default).
</p>
+<p>The additional fragments <samp>ac/xindy.ac</samp> and <samp>ac/clisp.ac</samp>
+specify more <code>configure</code> options to be seen at the top level,
+with <samp>ac/xindy.ac</samp> also included by <samp>configure.ac</samp>.
+</p>
<hr>
-<a name="xdvik-package"></a>
-<div class="header">
+<span id="xdvik-package"></span><div class="header">
<p>
Next: <a href="#asymptote" accesskey="n" rel="next"><code>asymptote</code></a>, Previous: <a href="#xindy-package" accesskey="p" rel="prev"><code>xindy</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-xdvik-package-in-texk_002fxdvik"></a>
-<h4 class="subsection">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></h4>
+<span id="The-xdvik-package-in-texk_002fxdvik"></span><h4 class="subsection">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></h4>
-<a name="index-xdvik"></a>
+<span id="index-xdvik"></span>
<p>This package is maintained as part of the TeX Live tree with sources in
-its top level directory and the subdirectory <samp>gui</samp>. The fragment
-<code>ac/withenable.ac</code> contains
+its own directory (<samp>texk/xdvik/</samp>). The fragment
+<code>xdvik/ac/withenable.ac</code> contains
</p>
<div class="example">
<pre class="example">dnl extra_dirs = texk/xdvik/squeeze
@@ -1974,101 +1953,95 @@
m4_include(kpse_TL[texk/xdvik/ac/xdvik.ac])
</pre></div>
-<a name="index-squeeze_002fconfigure_002eac"></a>
-<a name="index-cross-compilation_002c-with-host-binary"></a>
-<p>thus specifying the dependency on the <code>kpathsea</code>,
+<span id="index-squeeze_002fconfigure_002eac"></span>
+<span id="index-cross-compilation_002c-with-host-binary"></span>
+<p>thus specifying dependencies on the <code>kpathsea</code>,
<code>freetype</code>, and X11 libraries. The M4 comment (following
<code>dnl</code>) signals the subsidiary <samp>squeeze/configure.ac</samp>. This
is needed because the main executable <samp>xdvi-bin</samp> (to be installed
as, e.g., <samp>xdvi-xaw</samp>) is for the <code>host</code> system whereas the
auxiliary program <samp>squeeze/squeeze</samp> has to run on the
-<code>build</code> system and in a cross compilation they differ.
+<code>build</code> system; in a cross compilation, these differ.
</p>
-<a name="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit"></a>
+<span id="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit"></span>
<p>The additional fragment <code>ac/xdvik.ac</code> is also included by
<samp>configure.ac</samp> and supplies the configure option
-<code>--with-xdvi-x-toolkit</code> also seen at the top-level.
+<code>--with-xdvi-x-toolkit</code> also seen at the top level.
</p>
<hr>
-<a name="asymptote"></a>
-<div class="header">
+<span id="asymptote"></span><div class="header">
<p>
Previous: <a href="#xdvik-package" accesskey="p" rel="prev"><code>xdvik</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-subdirectory-utils_002fasymptote"></a>
-<h4 class="subsection">6.5.4 The subdirectory <samp>utils/asymptote</samp></h4>
+<span id="The-subdirectory-utils_002fasymptote"></span><h4 class="subsection">6.5.4 The subdirectory <samp>utils/asymptote</samp></h4>
-<a name="index-asymptote-1"></a>
-<a name="index-xasy"></a>
+<span id="index-asymptote-1"></span>
+<span id="index-xasy"></span>
-<a name="index-OpenGL_002c-required-for-Asymptote"></a>
+<span id="index-OpenGL_002c-required-for-Asymptote"></span>
<p>This subdirectory contains the sources for <samp>asy</samp> and <samp>xasy</samp>
but due to its complexity and prerequisites (e.g., OpenGL) it is
not part of the TL build system. These programs must be built and
installed independently, but are included on the TL DVD together with
-their support files.
+their support files. See <a href="https://tug.org/build.html#asymptote">https://tug.org/build.html#asymptote</a>.
</p>
<hr>
-<a name="Extending-TeX-Live"></a>
-<div class="header">
+<span id="Extending-TeX-Live"></span><div class="header">
<p>
Previous: <a href="#Program-modules" accesskey="p" rel="prev">Program modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Extending-TeX-Live-1"></a>
-<h3 class="section">6.6 Extending TeX Live</h3>
+<span id="Extending-TeX-Live-1"></span><h3 class="section">6.6 Extending TeX Live</h3>
-<a name="index-extending-TeX-Live"></a>
-<a name="index-adding-to-TeX-Live"></a>
+<span id="index-extending-TeX-Live"></span>
+<span id="index-adding-to-TeX-Live"></span>
<p>This section outlines the basic process for adding new packages to the
TL build system.
</p>
<p>In any case, a new package directory <samp>foo</samp> should contain the
-original sources, as modified for TL, in <samp>foo/foo-src</samp>, and the
-changes should be documented in <samp>foo/TLpatches/*</samp>; changes should
-also be submitted upstream whenever reasonable, of course. In
-addition, <samp>foo/</samp> will need the usual Automake build-related files
-(<samp>configure.ac</samp>, <samp>Makefile.am</samp>, etc. Please keep a
-<samp>ChangeLog</samp> for all TL changes.
+original sources, modified only with changes necessary for TL, in
+<samp>foo/foo-src</samp>. The changes should be documented in
+<samp>foo/TLpatches/*</samp>, and also be submitted upstream whenever
+reasonable. In addition, <samp>foo/</samp> will need the usual Automake
+build-related files (<samp>configure.ac</samp>, <samp>Makefile.am</samp>, etc.
+Please maintain <samp>foo/ChangeLog</samp> for all TL changes.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Adding-a-new-program-module" accesskey="1">Adding a new program module</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Adding-a-new-program-module" accesskey="1">Adding a new program module</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Adding-a-new-generic-library-module" accesskey="2">Adding a new generic library module</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Adding-a-new-generic-library-module" accesskey="2">Adding a new generic library module</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="3">Adding a new TeX-specific library module</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="3">Adding a new TeX-specific library module</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Adding-a-new-program-module"></a>
-<div class="header">
+<span id="Adding-a-new-program-module"></span><div class="header">
<p>
Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Adding-a-new-program-module-1"></a>
-<h4 class="subsection">6.6.1 Adding a new program module</h4>
+<span id="Adding-a-new-program-module-1"></span><h4 class="subsection">6.6.1 Adding a new program module</h4>
-<a name="index-adding-a-new-program"></a>
-<a name="index-program-module_002c-adding"></a>
+<span id="index-adding-a-new-program"></span>
+<span id="index-program-module_002c-adding"></span>
-<a name="index-kpse_005ftexk_005fpkgs"></a>
+<span id="index-kpse_005ftexk_005fpkgs"></span>
<p>A TeX-specific program module in a subdirectory
<samp>texk/<var>prog</var></samp> may use the TeX-specific libraries and is
included by adding its name <samp><var>prog</var></samp> to the M4 list
<code>kpse_texk_pkgs</code> defined in <samp>m4/kpse-pkgs.m4</samp>.
</p>
-<a name="index-kpse_005futils_005fpkgs"></a>
+<span id="index-kpse_005futils_005fpkgs"></span>
<p>A generic program module in a subdirectory <samp>utils/<var>prog</var></samp>
must not use the TeX-specific libraries and is included by adding
its name <samp><var>prog</var></samp> to the M4 list <code>kpse_utils_pkgs</code> in
<samp>m4/kpse-pkgs.m4</samp>.
</p>
-<a name="index-withenable_002eac_002c-for-new-modules"></a>
-<a name="index-KPSE_005fENABLE_005fPROG"></a>
+<span id="index-withenable_002eac_002c-for-new-modules"></span>
+<span id="index-KPSE_005fENABLE_005fPROG"></span>
<p>In either case, the subdirectory <samp>texk/<var>prog</var></samp> or
<samp>utils/<var>prog</var></samp> must provide a fragment
<samp>ac/withenable.ac</samp> that contains the M4 macro
@@ -2079,28 +2052,28 @@
<ol>
<li> a list of required libraries from the TL tree;
-</li><li> a list of options (<code>disable</code> if this module is not to be
+</li><li> a list of options: <code>disable</code> if this module is not to be
built without the configure option <code>--enable-<var>prog</var></code>,
<code>native</code> if cross compilation is not possible, <code>x</code> if the
-program requires X11 libraries);
+program requires X11 libraries;
</li><li> a comment added to the help text for the <code>configure</code>
option <code>--enable-<var>prog</var></code> or <code>--disable-<var>prog</var></code>.
</li></ol>
-<p>If the module requires specific configure options to be seen at the
-top level, they should be defined in an additional fragment
+<p>If the module requires specific <code>configure</code> options to be seen at
+the top level, they should be defined in an additional fragment
<samp>ac/<var>prog</var>.ac</samp> included from <samp>ac/withenable.ac</samp> and
<samp>configure.ac</samp>.
</p>
<p>Usually, the new program is maintained somewhere outside of TeX Live. In
-that case, we put the upstream sources into a subdirectory
+that case, as above, we put the upstream sources into a subdirectory
<samp><var>prog</var>-src</samp> (e.g., <samp>utils/newprog/newprog-src</samp>). We do
-not run <code>configure</code> in this original <code>...-src</code> directory,
-only in our own directory, but we do compile using the source files in
-<code>...-src</code>.
+not typically run <code>configure</code> in this original <code>...-src</code>
+directory, but only in our own directory; but we do compile using the
+source files in <code>...-src</code>.
</p>
-<p>So, these are the files that we must generally create:
+<p>So, to summarize the files that we must (usually) create:
</p>
<dl compact="compact">
<dt><samp>ac/withenable.ac</samp></dt>
@@ -2133,10 +2106,10 @@
</dl>
<p>Then, run GNU <code>autoreconf</code> in the new directory (see <a href="#Build-system-tools">Build system tools</a>). After that works, <code>svn add</code> the necessary files,
-notably <samp>Makefile.in aclocal.m4 configure</samp>, and <code>svn:ignore</code>
-the Automake cache <samp>autom4te.cache</samp>. (This is so people checking
-out the TL source tree do not have to run any autotools, but can
-simply run <code>configure</code>.)
+including the generated <samp>Makefile.in aclocal.m4 configure</samp>, and
+<code>svn:ignore</code> the Automake cache <samp>autom4te.cache</samp>. (This is
+so people checking out the TL source tree do not have to run any
+autotools, but can simply run <code>configure</code>.)
</p>
<p>Then, run the TL tool <code>reautoconf</code> in the top-level TL
<code>source/</code> directory, to incorporate the new program into the
@@ -2150,26 +2123,24 @@
</p>
<hr>
-<a name="Adding-a-new-generic-library-module"></a>
-<div class="header">
+<span id="Adding-a-new-generic-library-module"></span><div class="header">
<p>
Next: <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel="next">Adding a new TeX-specific library module</a>, Previous: <a href="#Adding-a-new-program-module" accesskey="p" rel="prev">Adding a new program module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Adding-a-new-generic-library-module-1"></a>
-<h4 class="subsection">6.6.2 Adding a new generic library module</h4>
+<span id="Adding-a-new-generic-library-module-1"></span><h4 class="subsection">6.6.2 Adding a new generic library module</h4>
-<a name="index-adding-a-new-generic-library"></a>
-<a name="index-generic-library-module_002c-adding"></a>
-<a name="index-library-module_002c-generic_002c-adding"></a>
+<span id="index-adding-a-new-generic-library"></span>
+<span id="index-generic-library-module_002c-adding"></span>
+<span id="index-library-module_002c-generic_002c-adding"></span>
-<a name="index-kpse_005flibs_005fpkgs"></a>
+<span id="index-kpse_005flibs_005fpkgs"></span>
<p>A generic library module in a subdirectory <samp>libs/<var>lib</var></samp> must
not depend on TeX-specific libraries, by definition. It is
-included by adding its name <samp><var>lib</var></samp> to the M4 list
+included by adding its name <samp><var>lib</var></samp> to the M4 macro
<code>kpse_libs_pkgs</code> in <samp>m4/kpse-pkgs.m4</samp>—before any other
libraries from the TeX Live tree on which it depends.
</p>
-<a name="index-KPSE_005fWITH_005fLIB"></a>
+<span id="index-KPSE_005fWITH_005fLIB"></span>
<p>As with program modules, the subdirectory <samp>libs/<var>lib</var></samp> must
contain the sources and build system for the library (and any
installable support programs) and a fragment <samp>ac/withenable.ac</samp>
@@ -2176,12 +2147,12 @@
that contains the M4 macro <code>KPSE_WITH_LIB</code> defined in
<samp>m4/kpse-setup.m4</samp> with <code><var>lib</var></code> as the mandatory first
argument and two optional arguments: a list of required libraries from
-the TL tree, and a list of options (currently there is only one:
-specify <code>tree</code> if this library cannot be replaced by a system
-version).
+the TL tree, and a list of options: for libraries, currently there is
+only one—specify <code>tree</code> if this library cannot be replaced by a
+system version.
</p>
-<a name="index-KPSE_005fTRY_005fLIB-1"></a>
-<a name="index-KPSE_005fTRY_005fLIBXX-1"></a>
+<span id="index-KPSE_005fTRY_005fLIB-1"></span>
+<span id="index-KPSE_005fTRY_005fLIBXX-1"></span>
<p>If a system version can be used, a second fragment
<samp>ac/<var>lib</var>.ac</samp> is needed, containing the M4 macro
<code>KPSE_TRY_LIB</code> (or <code>KPSE_TRY_LIBXX</code>) with <code><var>lib</var></code>
@@ -2189,7 +2160,7 @@
Autoconf macro <code>AC_LANG_PROGRAM</code> used to compile and link a small
C (or C++) program as sanity check for using the system library.
</p>
-<a name="index-KPSE_005fLIB_005fFLAGS-1"></a>
+<span id="index-KPSE_005fLIB_005fFLAGS-1"></span>
<p>In addition a file <samp>m4/kpse-<var>lib</var>-flags</samp> (at the top level)
must define the M4 macro <code>KPSE_<var>LIB</var>_FLAGS</code> (all uppercase)
setting up the <code>make</code> variables <code><var>LIB</var>_INCLUDES</code>,
@@ -2199,29 +2170,27 @@
rebuild the library when necessary. All of that is needed for the
library from the TL tree and, if supported, for a system version.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dlib"></a>
-<a name="index-KPSE_005fLIB_005fSYSTEM_005fFLAGS"></a>
-<a name="index-KPSE_005fALL_005fSYSTEM_005fFLAGS"></a>
+<span id="index-_002d_002dwith_002dsystem_002dlib"></span>
+<span id="index-KPSE_005fLIB_005fSYSTEM_005fFLAGS"></span>
+<span id="index-KPSE_005fALL_005fSYSTEM_005fFLAGS"></span>
<p>If a system library is allowed, <code>KPSE_<var>LIB</var>_FLAGS</code> also
provides the configure option <code>--with-system-<var>lib</var></code> and uses
the additional M4 macro <code>KPSE_<var>LIB</var>_SYSTEM_FLAGS</code> to generate
-the <code>make</code> variables for a system library. Furthermore the
+the <code>make</code> variables for a system library. In addition, the
definition of the M4 macro <code>KPSE_ALL_SYSTEM_FLAGS</code> in
<samp>m4/kpse-pkgs.m4</samp> must be extended by the line:<br> <code>AC_REQUIRE([KPSE_<var>LIB</var>_SYSTEM_FLAGS])</code>
</p>
<hr>
-<a name="Adding-a-new-TeX_002dspecific-library-module"></a>
-<div class="header">
+<span id="Adding-a-new-TeX_002dspecific-library-module"></span><div class="header">
<p>
Previous: <a href="#Adding-a-new-generic-library-module" accesskey="p" rel="prev">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Adding-a-new-TeX_002dspecific-library-module-1"></a>
-<h4 class="subsection">6.6.3 Adding a new TeX-specific library module</h4>
+<span id="Adding-a-new-TeX_002dspecific-library-module-1"></span><h4 class="subsection">6.6.3 Adding a new TeX-specific library module</h4>
-<a name="index-adding-a-new-TeX_002dspecific-library"></a>
-<a name="index-TeX_002dspecific-library-module_002c-adding"></a>
-<a name="index-library-module_002c-TeX_002dspecific_002c-adding"></a>
+<span id="index-adding-a-new-TeX_002dspecific-library"></span>
+<span id="index-TeX_002dspecific-library-module_002c-adding"></span>
+<span id="index-library-module_002c-TeX_002dspecific_002c-adding"></span>
<p>A TeX-specific library module in a subdirectory
<samp>texk/<var>lib</var></samp> may depend on other TeX-specific libraries
@@ -2230,25 +2199,23 @@
previous section), with these modifications:
</p>
<ul>
-<li> <a name="index-kpse_005ftexlibs_005fpkgs"></a>
-The library name <code><var>lib</var></code> is added to the M4 list
-<code>kpse_texlibs_pkgs</code> also in <samp>m4/kpse-pkgs.m4</samp>.
+<li> <span id="index-kpse_005ftexlibs_005fpkgs"></span>
+The library name <code><var>lib</var></code> is added to the M4 macro
+<code>kpse_texlibs_pkgs</code>, which is also in <samp>m4/kpse-pkgs.m4</samp>.
-</li><li> <a name="index-KPSE_005fWITH_005fTEXLIB"></a>
+</li><li> <span id="index-KPSE_005fWITH_005fTEXLIB"></span>
The fragment <code>ac/withenable.ac</code> must use <code>KPSE_WITH_TEXLIB</code>.
</li></ul>
<hr>
-<a name="Configure-options"></a>
-<div class="header">
+<span id="Configure-options"></span><div class="header">
<p>
Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</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>
</div>
-<a name="Configure-options-1"></a>
-<h2 class="chapter">7 Configure options</h2>
+<span id="Configure-options-1"></span><h2 class="chapter">7 Configure options</h2>
-<a name="index-configure-options"></a>
+<span id="index-configure-options"></span>
<p>Corresponding to the large number of program and library modules there
are a large number <code>configure</code> options, most of which are
@@ -2256,11 +2223,11 @@
top level gives an exhaustive list of all global options and a few
important module-specific ones, whereas, e.g.,<br> <code>texk/lcdf-typetools/configure --help</code><br> also displays the
<code>lcdf-typetools</code> specific options, which are not shown at the
-top-level.
+top level.
</p>
-<a name="index-environment-variables_002c-for-configure"></a>
+<span id="index-environment-variables_002c-for-configure"></span>
<p>The help text also mentions several influential environment variables,
-but for TeX Live it is better to specify them as assigments on the
+but for TeX Live it is better to specify them as assignments on the
command line.
</p>
<p>The <samp>./Build</samp> script used to make the binaries shipped with TeX Live
@@ -2267,7 +2234,7 @@
invokes the top-level <code>configure</code> with a few additional options
(see <a href="#Building">Building</a>). The defaults discussed below are those for the
actual <code>configure</code> script; invoking <code>configure</code> via
-<samp>./Build</samp> may yield different results.
+<samp>./Build</samp> yields different results.
</p>
<p>Defaults for most options are set at the top level and propagated
explicitly to all subdirectories. Options specified on the command
@@ -2274,68 +2241,64 @@
line are checked for consistency but never modified.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Global-configure-options" accesskey="1">Global configure options</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Global-configure-options" accesskey="1">Global configure options</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Program_002dspecific-configure-options" accesskey="2">Program-specific configure options</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Program_002dspecific-configure-options" accesskey="2">Program-specific configure options</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Library_002dspecific-configure-options" accesskey="3">Library-specific configure options</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Library_002dspecific-configure-options" accesskey="3">Library-specific configure options</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Variables-for-configure" accesskey="4">Variables for configure</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Variables-for-configure" accesskey="4">Variables for configure</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Global-configure-options"></a>
-<div class="header">
+<span id="Global-configure-options"></span><div class="header">
<p>
Next: <a href="#Program_002dspecific-configure-options" accesskey="n" rel="next">Program-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Global-configure-options-1"></a>
-<h3 class="section">7.1 Global configure options</h3>
+<span id="Global-configure-options-1"></span><h3 class="section">7.1 Global configure options</h3>
-<a name="index-global-configure-options"></a>
-<a name="index-configure-options_002c-global"></a>
+<span id="index-global-configure-options"></span>
+<span id="index-configure-options_002c-global"></span>
<p>Here are the global configure options.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="1"><code>--disable-native-texlive-build</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="1"><code>--disable-native-texlive-build</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="2"><code>--prefix</code> <code>--bindir</code> …</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="2"><code>--prefix</code> <code>--bindir</code> …</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="3"><code>--disable-largefile</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="3"><code>--disable-largefile</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dmissing" accesskey="4"><code>--disable-missing</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dmissing" accesskey="4"><code>--disable-missing</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="5"><code>--enable-compiler-warnings=</code><var>level</var></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="5"><code>--enable-compiler-warnings=</code><var>level</var></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="6"><code>--enable-cxx-runtime-hack</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="6"><code>--enable-cxx-runtime-hack</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="7"><code>--enable-maintainer-mode</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="7"><code>--enable-maintainer-mode</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="8"><code>--enable-multiplatform</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="8"><code>--enable-multiplatform</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dshared" accesskey="9"><code>--enable-shared</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dshared" accesskey="9"><code>--enable-shared</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002dwithout_002dx"><code>--without-x</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002dwithout_002dx"><code>--without-x</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="n" rel="next"><code>--prefix</code> <code>--bindir</code> …</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild-1"></a>
-<h4 class="subsection">7.1.1 <code>--disable-native-texlive-build</code></h4>
+<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild-1"></span><h4 class="subsection">7.1.1 <code>--disable-native-texlive-build</code></h4>
-<a name="index-_002d_002ddisable_002dnative_002dtexlive_002dbuild"></a>
+<span id="index-_002d_002ddisable_002dnative_002dtexlive_002dbuild"></span>
<p>If enabled (the default), build for a TL binary distribution as
shipped by the TeX user groups. This requires GNU <code>make</code> and
implies <code>--enable-multiplatform</code> and
@@ -2343,57 +2306,53 @@
and enforces <code>--disable-shared</code>.
</p>
<p>If building TL for a GNU/Linux or other distribution, this should be
-disabled and system versions of most libraries would be used
-(see <a href="#Distro-builds">Distro builds</a>). This may fail without GNU <code>make</code>, but
-will be tried regardless.
+disabled and system versions of most libraries should be used
+(see <a href="#Distro-builds">Distro builds</a>).
</p>
-<a name="index-_002d_002denable_002dtexlive_002dbuild"></a>
+<span id="index-_002d_002denable_002dtexlive_002dbuild"></span>
<p>A related option, <code>--enable-texlive-build</code>, is automatically
passed to all subdirectories (and cannot be disabled). Subdirectories
that can also be built independently from the TL tree (such as
-<samp>utils/xindy</samp> and <samp>texk/dvipng</samp>) can use this option, e.g.,
-to choose TL-specific installation paths.
+<samp>utils/xindy</samp> and <samp>texk/dvipng</samp>) but cooperate with TL can
+use this option to enable TL-specific adaptations, such as
+installation paths.
</p>
<hr>
-<a name="g_t_002d_002dprefix-_002d_002dbindir-_2026"></a>
-<div class="header">
+<span id="g_t_002d_002dprefix-_002d_002dbindir-_2026"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="n" rel="next"><code>--disable-largefile</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="p" rel="prev"><code>--disable-native-texlive-build</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_2026"></a>
-<h4 class="subsection">7.1.2 <code>--prefix</code>, <code>--bindir</code>, …</h4>
+<span id="g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_2026"></span><h4 class="subsection">7.1.2 <code>--prefix</code>, <code>--bindir</code>, …</h4>
-<a name="index-_002d_002dprefix-configure-option"></a>
-<a name="index-_002d_002dbindir-configure-option"></a>
+<span id="index-_002d_002dprefix-configure-option"></span>
+<span id="index-_002d_002dbindir-configure-option"></span>
<p>These standard Autoconf options specify various installation
directories as usual. For the complete list, see <a href="#Installation-directories">Installation directories</a>.
</p>
-<a name="index-DESTDIR"></a>
+<span id="index-DESTDIR"></span>
<p>Also as usual, all values are prefixed by the value of <code>DESTDIR</code>,
-if set, on the <code>make</code> command line (see <a href="http://www.gnu.org/software/automake/manual/automake.html#Staged-Installs">Installation in a temporary location</a> in <cite>GNU Automake</cite>).
+if set, on the <code>make</code> command line (see <a href="https://www.gnu.org/software/automake/manual/automake.html#Staged-Installs">Installation in a temporary location</a> in <cite>GNU Automake</cite>).
</p>
<hr>
-<a name="g_t_002d_002ddisable_002dlargefile"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dlargefile"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="n" rel="next"><code>--disable-missing</code></a>, Previous: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="p" rel="prev"><code>--prefix</code> <code>--bindir</code> …</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002ddisable_002dlargefile-1"></a>
-<h4 class="subsection">7.1.3 <code>--disable-largefile</code></h4>
+<span id="g_t_002d_002ddisable_002dlargefile-1"></span><h4 class="subsection">7.1.3 <code>--disable-largefile</code></h4>
-<a name="index-_002d_002ddisable_002dlargefile"></a>
-<a name="index-large-file-support"></a>
-<a name="index-LFS-_0028large-file-support_0029"></a>
-<p>Omit large file support (LFS), needed on most 32-bit Unix systems for
-files with 2GB or more. Regardless of this, the size of <code>DVI</code>
-and <code>GF</code> files must always be <em><2</em>GB, due to the file format
-specifications.
+<span id="index-_002d_002ddisable_002dlargefile"></span>
+<span id="index-large-file-support"></span>
+<span id="index-LFS-_0028large-file-support_0029"></span>
+<p>Omit large file support (LFS), which is needed on most 32-bit Unix
+systems for files with 2GB or more. Regardless of this option, the
+size of <code>DVI</code> and <code>GF</code> files must always be <em><2</em>GB, due
+to the file format specifications.
</p>
-<a name="index-size-of-PDF-and-PS-files"></a>
-<a name="index-PDF-files_002c-size-of"></a>
-<a name="index-PostScript-files_002c-size-of"></a>
+<span id="index-size-of-PDF-and-PS-files"></span>
+<span id="index-PDF-files_002c-size-of"></span>
+<span id="index-PostScript-files_002c-size-of"></span>
<p>With LFS, there is no fixed limit on the size of PDF files created by
<samp>pdftex</samp> or PostScript files created by <samp>dvips</samp>. The size
of PDF images included by <samp>pdftex</samp> or <samp>luatex</samp> must, however,
@@ -2402,15 +2361,13 @@
</p>
<hr>
-<a name="g_t_002d_002ddisable_002dmissing"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dmissing"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="n" rel="next"><code>--enable-compiler-warnings=</code><var>level</var></a>, Previous: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="p" rel="prev"><code>--disable-largefile</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002ddisable_002dmissing-1"></a>
-<h4 class="subsection">7.1.4 <code>--disable-missing</code></h4>
+<span id="g_t_002d_002ddisable_002dmissing-1"></span><h4 class="subsection">7.1.4 <code>--disable-missing</code></h4>
-<a name="index-_002d_002ddisable_002dmissing"></a>
+<span id="index-_002d_002ddisable_002dmissing"></span>
<p>Immediately terminate the build process if a requested program or feature
must be disabled, e.g., due to missing libraries. This can help when
figuring out a specific (sub)set of modules to enable.
@@ -2417,72 +2374,62 @@
</p>
<hr>
-<a name="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="n" rel="next"><code>--enable-cxx-runtime-hack</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="p" rel="prev"><code>--disable-missing</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel-1"></a>
-<h4 class="subsection">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></h4>
+<span id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel-1"></span><h4 class="subsection">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></h4>
-<a name="index-_002d_002denable_002dcompiler_002dwarnings_003dlevel"></a>
-<p>Enable various levels of compiler warnings for (Objective) C and C++:
-the <var>level</var> value can be one of: <code>no min yes max all</code>.
-The default is <code>yes</code> in <code>maintainer-mode</code> (see below) and
-<code>min</code> otherwise. This option defines
-<code>WARNING_[OBJ]C[XX]FLAGS</code> but these flags are not used in all
-library and program modules. Using them should help to resolve
-portability problems.
+<span id="index-_002d_002denable_002dcompiler_002dwarnings_003dlevel"></span>
+<p>Enable various levels of compiler warnings for C, C++, and/or
+Objective C: the <var>level</var> value can be one of: <code>no min
+yes max all</code>. The default is <code>yes</code> in <code>maintainer-mode</code>
+(see below) and <code>min</code> otherwise. This option defines the
+variables <code>WARNING_[OBJ]C[XX]FLAGS</code>, but these variables are not
+consistently used in all library and program modules. At present,
+these warning flags assume options from the GNU compilers.
</p>
-<p>At present, these warning flags are only defined for the GNU compilers
-but flags for other compilers could be added when needed.
-</p>
<hr>
-<a name="g_t_002d_002denable_002dcxx_002druntime_002dhack"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dcxx_002druntime_002dhack"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="n" rel="next"><code>--enable-maintainer-mode</code></a>, Previous: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="p" rel="prev"><code>--enable-compiler-warnings=</code><var>level</var></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dcxx_002druntime_002dhack-1"></a>
-<h4 class="subsection">7.1.6 <code>--enable-cxx-runtime-hack</code></h4>
+<span id="g_t_002d_002denable_002dcxx_002druntime_002dhack-1"></span><h4 class="subsection">7.1.6 <code>--enable-cxx-runtime-hack</code></h4>
-<p>If enabled (as it is for the native TL build) and when using
-<code>g++</code>, try to statically link with <code>libstdc++</code>, somewhat
-improving portability of the resulting binary. See <a href="#Macros-for-compilers">Macros for compilers</a>.
+<p>If enabled (as it is for the native TL build), when using <code>g++</code>,
+try to statically link with <code>libstdc++</code>, thus improving
+portability of the resulting binary. See <a href="#Macros-for-compilers">Macros for compilers</a>.
</p>
<hr>
-<a name="g_t_002d_002denable_002dmaintainer_002dmode"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dmaintainer_002dmode"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="n" rel="next"><code>--enable-multiplatform</code></a>, Previous: <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="p" rel="prev"><code>--enable-cxx-runtime-hack</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dmaintainer_002dmode-1"></a>
-<h4 class="subsection">7.1.7 <code>--enable-maintainer-mode</code></h4>
+<span id="g_t_002d_002denable_002dmaintainer_002dmode-1"></span><h4 class="subsection">7.1.7 <code>--enable-maintainer-mode</code></h4>
-<a name="index-_002d_002denable_002dmaintainer_002dmode-1"></a>
+<span id="index-_002d_002denable_002dmaintainer_002dmode-1"></span>
<p>Enable <samp>make</samp> rules and dependencies not useful (and sometimes
confusing) to the casual user. This requires current versions of the
GNU build tools (see <a href="#Build-system-tools">Build system tools</a>), as it automatically
-rebuilds infrastructure files as needed. See <a href="http://www.gnu.org/software/automake/manual/automake.html#maintainer_002dmode"><code>missing</code> and <code>AM_MAINTAINER_MODE</code></a> in <cite>GNU Automake</cite>.
+rebuilds infrastructure files as needed. See <a href="https://www.gnu.org/software/automake/manual/automake.html#maintainer_002dmode"><code>missing</code> and <code>AM_MAINTAINER_MODE</code></a> in <cite>GNU Automake</cite>.
</p>
<hr>
-<a name="g_t_002d_002denable_002dmultiplatform"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dmultiplatform"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dshared" accesskey="n" rel="next"><code>--enable-shared</code></a>, Previous: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="p" rel="prev"><code>--enable-maintainer-mode</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dmultiplatform-1"></a>
-<h4 class="subsection">7.1.8 <code>--enable-multiplatform</code></h4>
+<span id="g_t_002d_002denable_002dmultiplatform-1"></span><h4 class="subsection">7.1.8 <code>--enable-multiplatform</code></h4>
-<a name="index-_002d_002denable_002dmultiplatform"></a>
-<a name="index-exec_005fprefix"></a>
-<a name="index-_002d_002dbindir-configure-option-1"></a>
-<a name="index-_002d_002dlibdir-configure-option"></a>
-<p>If enabled and <code>--bindir=<var>dir</var></code> or <code>--libdir=<var>dir</var></code>
-are not specified, install executables and libraries in per-platform
+<span id="index-_002d_002denable_002dmultiplatform"></span>
+<span id="index-exec_005fprefix"></span>
+<span id="index-_002d_002dbindir-configure-option-1"></span>
+<span id="index-_002d_002dlibdir-configure-option"></span>
+<p>If enabled (as it is for the native TL build) and
+<code>--bindir=<var>dir</var></code> or <code>--libdir=<var>dir</var></code> are not
+specified, install executables and libraries in per-platform
subdirectories of <samp><var>eprefix</var>/bin</samp> and
<samp><var>eprefix</var>/lib</samp> where <var>eprefix</var> is the value given or
implied for <code>exec_prefix</code>. In any case, the values for
@@ -2491,15 +2438,13 @@
</p>
<hr>
-<a name="g_t_002d_002denable_002dshared"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dshared"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="n" rel="next"><code>--enable-silent-rules</code></a>, Previous: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="p" rel="prev"><code>--enable-multiplatform</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dshared-1"></a>
-<h4 class="subsection">7.1.9 <code>--enable-shared</code></h4>
+<span id="g_t_002d_002denable_002dshared-1"></span><h4 class="subsection">7.1.9 <code>--enable-shared</code></h4>
-<a name="index-_002d_002denable_002dshared"></a>
+<span id="index-_002d_002denable_002dshared"></span>
<p>Build shared versions of the TeX-specific libraries such as
<samp>libkpathsea</samp>. This is not allowed for a native TL build (i.e.,
<code>--disable-native-texlive-build</code> must also be specified).
@@ -2506,119 +2451,104 @@
</p>
<hr>
-<a name="g_t_002d_002denable_002dsilent_002drules"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dsilent_002drules"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="n" rel="next"><code>--without-ln-s</code></a>, Previous: <a href="#g_t_002d_002denable_002dshared" accesskey="p" rel="prev"><code>--enable-shared</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dsilent_002drules-1"></a>
-<h4 class="subsection">7.1.10 <code>--enable-silent-rules</code></h4>
+<span id="g_t_002d_002denable_002dsilent_002drules-1"></span><h4 class="subsection">7.1.10 <code>--enable-silent-rules</code></h4>
-<a name="index-_002d_002denable_002dsilent_002drules"></a>
+<span id="index-_002d_002denable_002dsilent_002drules"></span>
+<span id="index-make-rules_002c-verbose-vs_002e-silent"></span>
<p>Enable the use of less verbose build rules. When using GNU
-<code>make</code> (or another <code>make</code> implementation supporting nested
-variable expansions), you can specify <code>V=1</code> on the <code>make</code> command
-line to get more verbosity, or <code>V=0</code> to get less, regardless of
-this option.
+<code>make</code> (or any <code>make</code> implementation supporting nested
+variable expansions), you can specify <code>V=1</code> on the <code>make</code>
+command line to get more verbosity, or <code>V=0</code> to get less,
+regardless of this option.
</p>
<hr>
-<a name="g_t_002d_002dwithout_002dln_002ds"></a>
-<div class="header">
+<span id="g_t_002d_002dwithout_002dln_002ds"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002dwithout_002dx" accesskey="n" rel="next"><code>--without-x</code></a>, Previous: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="p" rel="prev"><code>--enable-silent-rules</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002dwithout_002dln_002ds-1"></a>
-<h4 class="subsection">7.1.11 <code>--without-ln-s</code></h4>
+<span id="g_t_002d_002dwithout_002dln_002ds-1"></span><h4 class="subsection">7.1.11 <code>--without-ln-s</code></h4>
-<a name="index-_002d_002dwithout_002dln_002ds"></a>
+<span id="index-_002d_002dwithout_002dln_002ds"></span>
<p>Required when using a system without a working <code>ln -s</code> to build
binaries for a Unix-like system. However, <code>make install</code> will
-not create anything useful and might even fail.
+not create anything useful, and might fail.
</p>
<hr>
-<a name="g_t_002d_002dwithout_002dx"></a>
-<div class="header">
+<span id="g_t_002d_002dwithout_002dx"></span><div class="header">
<p>
Previous: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="p" rel="prev"><code>--without-ln-s</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002dwithout_002dx-1"></a>
-<h4 class="subsection">7.1.12 <code>--without-x</code></h4>
+<span id="g_t_002d_002dwithout_002dx-1"></span><h4 class="subsection">7.1.12 <code>--without-x</code></h4>
-<a name="index-_002d_002dwithout_002dx"></a>
+<span id="index-_002d_002dwithout_002dx"></span>
<p>Disable all programs using the X Window System.
</p>
<hr>
-<a name="Program_002dspecific-configure-options"></a>
-<div class="header">
+<span id="Program_002dspecific-configure-options"></span><div class="header">
<p>
Next: <a href="#Library_002dspecific-configure-options" accesskey="n" rel="next">Library-specific configure options</a>, Previous: <a href="#Global-configure-options" accesskey="p" rel="prev">Global configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Program_002dspecific-configure-options-1"></a>
-<h3 class="section">7.2 Program-specific configure options</h3>
+<span id="Program_002dspecific-configure-options-1"></span><h3 class="section">7.2 Program-specific configure options</h3>
-<a name="index-program_002dspecific-configure-options"></a>
-<a name="index-configure-options_002c-program_002dspecific"></a>
+<span id="index-program_002dspecific-configure-options"></span>
+<span id="index-configure-options_002c-program_002dspecific"></span>
<p>Here are (some of) the program-specific <code>configure</code> options.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="1"><code>--enable-<var>prog</var></code> <code>--disable-<var>prog</var></code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="1"><code>--enable-<var>prog</var></code> <code>--disable-<var>prog</var></code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="2"><code>--disable-all-pkgs</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="2"><code>--disable-all-pkgs</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fweb2c" accesskey="3">Configure options for <samp>texk/web2c</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fweb2c" accesskey="3">Configure options for <samp>texk/web2c</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="4">Configure options for <samp>texk/bibtex-x</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="4">Configure options for <samp>texk/bibtex-x</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="5">Configure options for <samp>texk/dvipdfm-x</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="5">Configure options for <samp>texk/dvipdfm-x</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="6">Configure options for <samp>texk/dvisvgm</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="6">Configure options for <samp>texk/dvisvgm</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002ftexlive" accesskey="7">Configure options for <samp>texk/texlive</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002ftexlive" accesskey="7">Configure options for <samp>texk/texlive</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fxdvik" accesskey="8">Configure options for <samp>texk/xdvik</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-texk_002fxdvik" accesskey="8">Configure options for <samp>texk/xdvik</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-utils_002fxindy" accesskey="9">Configure options for <samp>utils/xindy</samp></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-utils_002fxindy" accesskey="9">Configure options for <samp>utils/xindy</samp></a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="n" rel="next"><code>--disable-all-pkgs</code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog"></a>
-<h4 class="subsection">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></h4>
+<span id="g_t_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog"></span><h4 class="subsection">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></h4>
-<a name="index-_002d_002denable_002dprog"></a>
-<a name="index-_002d_002ddisable_002dprog"></a>
-<p>Do or do not build and install the program(s) of the module <code><var>prog</var></code>.
+<span id="index-_002d_002denable_002dprog"></span>
+<span id="index-_002d_002ddisable_002dprog"></span>
+<p>Do or do not build and install the program(s) of module <code><var>prog</var></code>.
</p>
<hr>
-<a name="g_t_002d_002ddisable_002dall_002dpkgs"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dall_002dpkgs"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fweb2c" accesskey="n" rel="next">Configure options for <samp>texk/web2c</samp></a>, Previous: <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="p" rel="prev"><code>--enable-<var>prog</var></code> <code>--disable-<var>prog</var></code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002ddisable_002dall_002dpkgs-1"></a>
-<h4 class="subsection">7.2.2 <code>--disable-all-pkgs</code></h4>
+<span id="g_t_002d_002ddisable_002dall_002dpkgs-1"></span><h4 class="subsection">7.2.2 <code>--disable-all-pkgs</code></h4>
-<a name="index-_002d_002ddisable_002dall_002dpkgs"></a>
+<span id="index-_002d_002ddisable_002dall_002dpkgs"></span>
<p>Do not build any program modules by default—only those explicitly
enabled. This is useful when one wants to work on only a single
program, which is specified with an additional <code>--enable</code> option,
e.g., <code>--enable-dvipdfm-x</code>. It’s still simplest to check out and
configure the whole source tree, but at least only the program you are
-interested in, and its dependencies, are built. The <code>configure</code>
-will generally take less than a minute with everything disabled. (It
-is a good idea to run <code>make check</code> after doing this, and after
-making any changes, to ensure that whatever tests have been written
-still pass.)
+interested in, and its dependencies, are built. See <a href="#Build-one-package">Build one package</a>.
</p>
<p>Without this option, all modules are built except those that are
explicitly disabled or specify <code>disable</code> in their
@@ -2626,31 +2556,29 @@
</p>
<hr>
-<a name="Configure-options-for-texk_002fweb2c"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fweb2c"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="n" rel="next">Configure options for <samp>texk/bibtex-x</samp></a>, Previous: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="p" rel="prev"><code>--disable-all-pkgs</code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fweb2c-1"></a>
-<h4 class="subsection">7.2.3 Configure options for <samp>texk/web2c</samp></h4>
+<span id="Configure-options-for-texk_002fweb2c-1"></span><h4 class="subsection">7.2.3 Configure options for <samp>texk/web2c</samp></h4>
-<a name="index-configure-options_002c-for-web2c"></a>
+<span id="index-configure-options_002c-for-web2c"></span>
-<a name="index-_002d_002dwith_002dbanner_002dadd_003dstr"></a>
+<span id="index-_002d_002dwith_002dbanner_002dadd_003dstr"></span>
<p><code>--with-banner-add=<var>str</var></code><br>Add <code><var>str</var></code> to the
-default version string (<code>TeX Live <var>year</var></code> or <code>Web2C
-<var>year</var></code>) appended to banner lines. This is ignored for a native
-TL build, but distro builds should specify, e.g.,
+default version string (which is ‘<code>TeX Live <var>year</var></code>’ or
+‘<code>Web2C <var>year</var></code>’) appended to banner lines. This is ignored
+for a native TL build, but distro builds should specify, e.g.,
<code>/<var>SomeDistro</var></code>.
</p>
-<a name="index-_002d_002dwith_002deditor_003dcmd"></a>
+<span id="index-_002d_002dwith_002deditor_003dcmd"></span>
<p><code>--with-editor=<var>cmd</var></code><br>Specify the command
-<code><var>cmd</var></code> to invoke from the <code>e</code> option of TeX-like engines,
+<code><var>cmd</var></code> to invoke from the <code>e</code> option of TeX and friends,
replacing the default <code>vi +%d '%s'</code> for Unix or <code>texworks
--position=%d "%s"</code> for Windows.
</p>
-<a name="index-_002d_002dwith_002dfontconfig_002dincludes_003ddir"></a>
-<a name="index-_002d_002dwith_002dfontconfig_002dlibdir_003ddir"></a>
+<span id="index-_002d_002dwith_002dfontconfig_002dincludes_003ddir"></span>
+<span id="index-_002d_002dwith_002dfontconfig_002dlibdir_003ddir"></span>
<p><code>--with-fontconfig-includes=<var>dir</var></code>,
<code>--with-fontconfig-libdir=<var>dir</var></code><br>Building XeTeX on
non-Mac systems requires the <code>fontconfig</code> library headers and
@@ -2658,109 +2586,109 @@
are derived from them; otherwise, they are determined via
<samp>pkg-config</samp> (if present).
</p>
-<a name="index-X-toolkit"></a>
-<a name="index-libXt"></a>
-<a name="index-Xlib"></a>
+<span id="index-X-toolkit"></span>
+<span id="index-libXt"></span>
+<span id="index-Xlib"></span>
<p><code>--with-mf-x-toolkit</code><br>Use the X toolkit (<samp>libXt</samp>) for
Metafont (the default is to use the lowest-level <samp>Xlib</samp> support;
it seems this has the best chance of working across X installations
nowadays).
</p>
-<a name="index-_002d_002ddisable_002ddump_002dshare"></a>
-<a name="index-LittleEndian-architectures"></a>
+<span id="index-_002d_002ddisable_002ddump_002dshare"></span>
+<span id="index-LittleEndian-architectures"></span>
<p><code>--disable-dump-share</code><br>Make the <code>fmt</code>/<code>base</code>
dump files architecture dependent (somewhat faster on LittleEndian
architectures).
</p>
-<a name="index-_002d_002ddisable_002dipc"></a>
-<a name="index-interprocess-communication"></a>
+<span id="index-_002d_002ddisable_002dipc"></span>
+<span id="index-interprocess-communication"></span>
<p><code>--disable-ipc</code><br>Disable TeX’s <code>--ipc</code> option.
</p>
-<a name="index-_002d_002ddisable_002dmf_002dnowin"></a>
-<a name="index-mf_002dnowin"></a>
+<span id="index-_002d_002ddisable_002dmf_002dnowin"></span>
+<span id="index-mf_002dnowin"></span>
<p><code>--disable-mf-nowin</code><br>Do not build a separate
non-graphically-capable Metafont (<samp>mf-nowin</samp>).
</p>
-<a name="index-_002d_002ddisable_002dtex"></a>
-<a name="index-_002d_002denable_002detex"></a>
-<a name="index-web2c_002eac"></a>
+<span id="index-_002d_002ddisable_002dtex"></span>
+<span id="index-_002d_002denable_002detex"></span>
+<span id="index-web2c_002eac"></span>
<p><code>--disable-tex</code>, <code>--enable-etex</code>, …<br>Do not or
do build the various TeX, Metafont, and MetaPost engines (defaults are
defined in the fragment <samp>texk/web2c/ac/web2c.ac</samp>).
</p>
-<a name="index-_002d_002ddisable_002dweb_002dprogs"></a>
-<p><code>--disable-web-progs</code><br>Do not build the core WEB programs
+<span id="index-_002d_002ddisable_002dweb_002dprogs"></span>
+<p><code>--disable-web-progs</code><br>Do not build the original WEB programs
<samp>bibtex</samp>, …, <samp>weave</samp>. Useful if, e.g., you only want
to (re)build some engines.
</p>
-<a name="index-_002d_002denable_002dauto_002dcore"></a>
-<a name="index-preloaded-binaries"></a>
+<span id="index-_002d_002denable_002dauto_002dcore"></span>
+<span id="index-preloaded-binaries"></span>
<p><code>--enable-auto-core</code><br>This option causes TeX and Metafont
to produce a core dump when a particular hacky filename is
encountered, for use in creating preloaded binaries. This is rarely
done nowadays.
</p>
-<a name="index-_002d_002denable_002dlibtool_002dhack"></a>
-<a name="index-libtool_002c-hack-for-avoiding-excessive-linking"></a>
+<span id="index-_002d_002denable_002dlibtool_002dhack"></span>
+<span id="index-libtool_002c-hack-for-avoiding-excessive-linking"></span>
+<span id="index-libfontconfig_002c-hack-for-avoiding-linking-dependencies"></span>
+<span id="index-libexpat_002c-dependency-of-libfontconfig"></span>
<p><code>--enable-libtool-hack</code><br>
If enabled (which is the default for all platforms), prevents
<code>libtool</code> from linking explicitly with dependencies of
<samp>libfontconfig</samp> such as <samp>libexpat</samp>.
</p>
-<a name="index-_002d_002denable_002d_002awin-for-Metafont-window-support"></a>
-<p><code>--enable-*win</code><br>Include various types of other window
-support for Metafont (EPSF output, <code>mftalk</code>, old terminals, …).
+<span id="index-_002d_002denable_002d_002awin-for-Metafont-window-support"></span>
+<p><code>--enable-*win</code><br>Include various types of non-X window
+support for Metafont (EPSF output, <code>mftalk</code>, old graphics
+terminals, …).
</p>
-<a name="index-_002d_002denable_002dtex_002dsynctex"></a>
-<a name="index-_002d_002ddisable_002detex_002dsynctex"></a>
-<a name="index-synctex"></a>
+<span id="index-_002d_002denable_002dtex_002dsynctex"></span>
+<span id="index-_002d_002ddisable_002detex_002dsynctex"></span>
+<span id="index-synctex"></span>
<p><code>--enable-tex-synctex</code>, <code>--disable-etex-synctex</code>,
…<br>Build the TeX engines with or without <code>SyncTeX</code>
-support; ignored for a native TeX Live build, defaults are again defined
-in <samp>texk/web2c/ac/web2c.ac</samp>.
+support; ignored for a native TeX Live build. Defaults are defined in
+<samp>texk/web2c/ac/web2c.ac</samp>.
</p>
-<a name="index-_002d_002ddisable_002dsynctex"></a>
-<a name="index-synctex-1"></a>
+<span id="index-_002d_002ddisable_002dsynctex"></span>
+<span id="index-synctex-1"></span>
<p><code>--disable-synctex</code>
<br>Do not build the <code>SyncTeX</code> library and tool.
</p>
<hr>
-<a name="Configure-options-for-texk_002fbibtex_002dx"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fbibtex_002dx"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="n" rel="next">Configure options for <samp>texk/dvipdfm-x</samp></a>, Previous: <a href="#Configure-options-for-texk_002fweb2c" accesskey="p" rel="prev">Configure options for <samp>texk/web2c</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fbibtex_002dx-1"></a>
-<h4 class="subsection">7.2.4 Configure options for <samp>texk/bibtex-x</samp></h4>
+<span id="Configure-options-for-texk_002fbibtex_002dx-1"></span><h4 class="subsection">7.2.4 Configure options for <samp>texk/bibtex-x</samp></h4>
-<a name="index-configure-options_002c-for-bibtex_002dx"></a>
-<a name="index-bibtex8"></a>
-<a name="index-bibtexu"></a>
-<a name="index-bibtex_002dx"></a>
+<span id="index-configure-options_002c-for-bibtex_002dx"></span>
+<span id="index-bibtex8"></span>
+<span id="index-bibtexu"></span>
+<span id="index-bibtex_002dx"></span>
<p>The programs <code>bibtex8</code> and <code>bibtexu</code> have been merged into the
module <code>bibtex-x</code> (extended BibTeX).
</p>
-<a name="index-_002d_002ddisable_002dbibtex8"></a>
+<span id="index-_002d_002ddisable_002dbibtex8"></span>
<p><code>--disable-bibtex8</code><br>Do not build the <samp>bibtex8</samp> program.
</p>
-<a name="index-_002d_002ddisable_002dbibtexu"></a>
+<span id="index-_002d_002ddisable_002dbibtexu"></span>
<p><code>--disable-bibtexu</code><br>Do not build the <samp>bibtexu</samp> program
(building <samp>bibtexu</samp> requires <code>ICU</code> libraries).
</p>
<hr>
-<a name="Configure-options-for-texk_002fdvipdfm_002dx"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fdvipdfm_002dx"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="n" rel="next">Configure options for <samp>texk/dvisvgm</samp></a>, Previous: <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="p" rel="prev">Configure options for <samp>texk/bibtex-x</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fdvipdfm_002dx-1"></a>
-<h4 class="subsection">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></h4>
+<span id="Configure-options-for-texk_002fdvipdfm_002dx-1"></span><h4 class="subsection">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></h4>
-<a name="index-configure-options_002c-for-dvipdfm_002dx"></a>
-<a name="index-dvipdfmx"></a>
-<a name="index-xdvipdfmx"></a>
+<span id="index-configure-options_002c-for-dvipdfm_002dx"></span>
+<span id="index-dvipdfm_002dx"></span>
+<span id="index-dvipdfmx"></span>
+<span id="index-xdvipdfmx"></span>
<p>The former modules <code>dvipdfmx</code> (extended DVI to PDF converter) and
<code>xdvipdfmx</code> (the same, as used by XeTeX) have been merged into
@@ -2769,40 +2697,38 @@
symlink to <samp>dvipdfmx</samp>, with backward-compatible (very slightly
different) behavior.
</p>
-<a name="index-_002d_002ddisable_002ddvipdfmx"></a>
+<span id="index-_002d_002ddisable_002ddvipdfmx"></span>
<p><code>--disable-dvipdfmx</code><br>Do not build the <samp>dvipdfmx</samp>
-program with the <samp>dvipdfm</samp> symlink.
+program or make the <samp>dvipdfm</samp> symlink.
</p>
-<a name="index-_002d_002ddisable_002dxdvipdfmx"></a>
+<span id="index-_002d_002ddisable_002dxdvipdfmx"></span>
<p><code>--disable-xdvipdfmx</code><br>Do not build the <samp>xdvipdfmx</samp>
program.
</p>
<hr>
-<a name="Configure-options-for-texk_002fdvisvgm"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fdvisvgm"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002ftexlive" accesskey="n" rel="next">Configure options for <samp>texk/texlive</samp></a>, Previous: <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="p" rel="prev">Configure options for <samp>texk/dvipdfm-x</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fdvisvgm-1"></a>
-<h4 class="subsection">7.2.6 Configure options for <samp>texk/dvisvgm</samp></h4>
+<span id="Configure-options-for-texk_002fdvisvgm-1"></span><h4 class="subsection">7.2.6 Configure options for <samp>texk/dvisvgm</samp></h4>
-<a name="index-configure-options_002c-for-dvisvgm"></a>
-<a name="index-dvisvgm"></a>
+<span id="index-configure-options_002c-for-dvisvgm"></span>
+<span id="index-dvisvgm"></span>
-<a name="index-_002d_002dwith_002dsystem_002dlibgs"></a>
+<span id="index-_002d_002dwith_002dsystem_002dlibgs"></span>
<p><code>--with-system-libgs</code><br>Build <samp>dvisvgm</samp> using installed
Ghostscript (<code>gs</code>) headers and library (not allowed for a native
TL build). The default is to load the <code>gs</code> library at runtime if
-possible, or otherwise disable support for PostScript specials.
+possible, else to disable support for PostScript specials.
</p>
-<a name="index-_002d_002dwithout_002dlibgs"></a>
+<span id="index-_002d_002dwithout_002dlibgs"></span>
<p><code>--without-libgs</code><br>Build <samp>dvisvgm</samp> without PostScript
support at all. Because the dynamic loading just mentioned defeats all
attempts at static linking, the result can crash due to library
incompatibilities, e.g., on CentOS 5.
</p>
-<a name="index-_002d_002dwith_002dlibgs_002dincludes_002c-_002dlibdir"></a>
+<span id="index-_002d_002dwith_002dlibgs_002dincludes_002c-_002dlibdir"></span>
<p><code>--with-libgs-includes=<var>dir</var></code>,
<code>--with-libgs-libdir=<var>dir</var></code><br>Specify non-standard locations
of the Ghostscript headers and library.
@@ -2809,16 +2735,14 @@
</p>
<hr>
-<a name="Configure-options-for-texk_002ftexlive"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002ftexlive"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fxdvik" accesskey="n" rel="next">Configure options for <samp>texk/xdvik</samp></a>, Previous: <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="p" rel="prev">Configure options for <samp>texk/dvisvgm</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002ftexlive-1"></a>
-<h4 class="subsection">7.2.7 Configure options for <samp>texk/texlive</samp></h4>
+<span id="Configure-options-for-texk_002ftexlive-1"></span><h4 class="subsection">7.2.7 Configure options for <samp>texk/texlive</samp></h4>
-<a name="index-configure-options_002c-for-texk_002ftexlive"></a>
-<a name="index-_002d_002ddisable_002dlinked_002dscripts"></a>
+<span id="index-configure-options_002c-for-texk_002ftexlive"></span>
+<span id="index-_002d_002ddisable_002dlinked_002dscripts"></span>
<p><code>--disable-linked-scripts</code><br>Do not install the “linked
scripts” (see <a href="#Linked-scripts">Linked scripts</a>), except for the TL scripts required
to run <code>texlinks</code>.
@@ -2825,91 +2749,86 @@
</p>
<hr>
-<a name="Configure-options-for-texk_002fxdvik"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fxdvik"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-utils_002fxindy" accesskey="n" rel="next">Configure options for <samp>utils/xindy</samp></a>, Previous: <a href="#Configure-options-for-texk_002ftexlive" accesskey="p" rel="prev">Configure options for <samp>texk/texlive</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fxdvik-1"></a>
-<h4 class="subsection">7.2.8 Configure options for <samp>texk/xdvik</samp></h4>
+<span id="Configure-options-for-texk_002fxdvik-1"></span><h4 class="subsection">7.2.8 Configure options for <samp>texk/xdvik</samp></h4>
-<a name="index-configure-options_002c-for-xdvik"></a>
-<a name="index-xdvik-1"></a>
+<span id="index-configure-options_002c-for-xdvik"></span>
+<span id="index-xdvik-1"></span>
-<a name="index-_002d_002dwith_002dgs_003dfilename"></a>
+<span id="index-_002d_002dwith_002dgs_003dfilename"></span>
+<span id="index-Ghostscript-location-for-Xdvik"></span>
<p><code>--with-gs=<var>filename</var></code><br>Hardwire the location of Ghostscript
-(<samp>gs</samp>).
+(<samp>gs</samp>) as called by Xdvik.
</p>
-<a name="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit_003dkit"></a>
-<a name="index-motif"></a>
-<a name="index-xaw"></a>
+<span id="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit_003dkit"></span>
+<span id="index-motif"></span>
+<span id="index-xaw"></span>
<p><code>--with-xdvi-x-toolkit=<var>kit</var></code><br>Use toolkit
<code><var>kit</var></code> for <samp>xdvik</samp>, one of: <code>motif xaw xaw3d
neXtaw</code>. The default is <code>motif</code> if available, else <code>xaw</code>.
</p>
-<a name="index-_002d_002denable_002dxi2_002dscrolling"></a>
-<a name="index-XInput"></a>
-<a name="index-scrolling"></a>
+<span id="index-_002d_002denable_002dxi2_002dscrolling"></span>
+<span id="index-XInput"></span>
+<span id="index-scrolling_002c-smooth"></span>
<p><code>--enable-xi2-scrolling</code><br>Use XInput 2.1 “smooth scrolling”
-if available. (default: yes, except for a native TL build).
+if available (default: yes, except for a native TL build).
</p>
<hr>
-<a name="Configure-options-for-utils_002fxindy"></a>
-<div class="header">
+<span id="Configure-options-for-utils_002fxindy"></span><div class="header">
<p>
Previous: <a href="#Configure-options-for-texk_002fxdvik" accesskey="p" rel="prev">Configure options for <samp>texk/xdvik</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-utils_002fxindy-1"></a>
-<h4 class="subsection">7.2.9 Configure options for <samp>utils/xindy</samp></h4>
+<span id="Configure-options-for-utils_002fxindy-1"></span><h4 class="subsection">7.2.9 Configure options for <samp>utils/xindy</samp></h4>
-<a name="index-configure-options_002c-for-xindy"></a>
-<a name="index-xindy-2"></a>
+<span id="index-configure-options_002c-for-xindy"></span>
+<span id="index-xindy-2"></span>
-<a name="index-_002d_002denable_002dxindy_002drules"></a>
+<span id="index-_002d_002denable_002dxindy_002drules"></span>
<p><code>--enable-xindy-rules</code><br>Build and install <code>xindy</code> rules
(default: yes, except for a native TL build).
</p>
-<a name="index-_002d_002denable_002dxindy_002ddocs"></a>
+<span id="index-_002d_002denable_002dxindy_002ddocs"></span>
<p><code>--enable-xindy-docs</code><br>Build and install <code>xindy</code>
documentation (default: yes, except for a native TL build).
</p>
-<a name="index-_002d_002dwith_002dclisp_002druntime_003dfilename"></a>
-<a name="index-lisp_002erun_002c-lisp_002eexe"></a>
-<a name="index-CLISP"></a>
+<span id="index-_002d_002dwith_002dclisp_002druntime_003dfilename"></span>
+<span id="index-lisp_002erun_002c-lisp_002eexe"></span>
+<span id="index-CLISP"></span>
<p><code>--with-clisp-runtime=<var>filename</var></code><br>Specifies the
-Full path for the CLISP runtime file (<samp>lisp.run</samp> or
+full path for the Clisp runtime file (<samp>lisp.run</samp> or
<samp>lisp.exe</samp>) to be installed. When specified as <code>default</code>
(the default for a native TL build) the path is determined by the
-CLISP executable; the value <code>system</code> (not allowed for a native TL
-build, but the default for a non-native one) indicates that
-<samp>xindy</samp> will use the installed version of <samp>clisp</samp> (which
-must be identical to the one used to build <samp>xindy</samp>).
+Clisp executable; the value <code>system</code> (not allowed for a native TL
+build, but the default otherwise) indicates that <samp>xindy</samp> will use
+the installed version of <samp>clisp</samp> (which must be identical to the
+one used to build <samp>xindy</samp>).
</p>
<hr>
-<a name="Library_002dspecific-configure-options"></a>
-<div class="header">
+<span id="Library_002dspecific-configure-options"></span><div class="header">
<p>
Next: <a href="#Variables-for-configure" accesskey="n" rel="next">Variables for configure</a>, Previous: <a href="#Program_002dspecific-configure-options" accesskey="p" rel="prev">Program-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Library_002dspecific-configure-options-1"></a>
-<h3 class="section">7.3 Library-specific configure options</h3>
+<span id="Library_002dspecific-configure-options-1"></span><h3 class="section">7.3 Library-specific configure options</h3>
-<a name="index-library_002dspecific-configure-options"></a>
-<a name="index-configure-options_002c-library_002dspecific"></a>
+<span id="index-library_002dspecific-configure-options"></span>
+<span id="index-configure-options_002c-library_002dspecific"></span>
<p>Here are (some of) the library-specific <code>configure</code> options,
starting with this generic one:
</p>
-<a name="index-_002d_002dwith_002dsystem_002dlib-1"></a>
+<span id="index-_002d_002dwith_002dsystem_002dlib-1"></span>
<p><code>--with-system-<var>lib</var></code>
</p>
<p>Use an installed (system) version of the library <code><var>lib</var></code>;
this option exists for most libraries, but is not allowed for a native
TL build. Using a system version implies also using the system
-versions of all libraries (if any) that <var>lib</var> depends on.
+versions of all libraries that <var>lib</var> depends on.
</p>
-<a name="index-_002d_002dwith_002dlib_002dincludes_003ddir_002c-_002dlibdir"></a>
+<span id="index-_002d_002dwith_002dlib_002dincludes_003ddir_002c-_002dlibdir"></span>
<p>For many libraries <code>--with-<var>lib</var>-includes=<var>dir</var></code> and
<code>--with-<var>lib</var>-libdir=<var>dir</var></code> can specify non-standard
search locations; others use <samp>pkg-config</samp> or similar to determine
@@ -2919,27 +2838,25 @@
required system libraries and bails out if tests fail.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-kpathsea" accesskey="1">Configure options for <code>kpathsea</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-kpathsea" accesskey="1">Configure options for <code>kpathsea</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Configure-options-for-system-poppler" accesskey="2">Configure options for system <code>poppler</code></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Configure-options-for-system-poppler" accesskey="2">Configure options for system <code>poppler</code></a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Configure-options-for-kpathsea"></a>
-<div class="header">
+<span id="Configure-options-for-kpathsea"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-system-poppler" accesskey="n" rel="next">Configure options for system <code>poppler</code></a>, Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Library-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-kpathsea-1"></a>
-<h4 class="subsection">7.3.1 Configure options for <code>kpathsea</code></h4>
+<span id="Configure-options-for-kpathsea-1"></span><h4 class="subsection">7.3.1 Configure options for <code>kpathsea</code></h4>
-<a name="index-configure-options_002c-for-kpathsea"></a>
+<span id="index-configure-options_002c-for-kpathsea"></span>
<p><code>--enable-<var>cmd</var>-default</code>,
<code>--disable-<var>cmd</var>-default</code><br>Determine the compile time default
-whether or not to run <var>cmd</var>, one of:
+for whether or not to run <var>cmd</var>, which is one of:
</p><dl compact="compact">
<dt><code>mkocp</code></dt>
<dd><p>(Omega compiled translation process file)
@@ -2965,48 +2882,44 @@
</dl>
<p>to generate the specified type of file dynamically.
-The default can be overridden by the user in any case.
+The default can be overridden by the user in any case
+(see <a href="#kpathsea-library"><code>kpathsea</code> library</a>).
</p>
-
<hr>
-<a name="Configure-options-for-system-poppler"></a>
-<div class="header">
+<span id="Configure-options-for-system-poppler"></span><div class="header">
<p>
Previous: <a href="#Configure-options-for-kpathsea" accesskey="p" rel="prev">Configure options for <code>kpathsea</code></a>, Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Library-specific configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-system-poppler-1"></a>
-<h4 class="subsection">7.3.2 Configure options for system <code>poppler</code></h4>
+<span id="Configure-options-for-system-poppler-1"></span><h4 class="subsection">7.3.2 Configure options for system <code>poppler</code></h4>
-<a name="index-configure-options_002c-for-system-poppler"></a>
+<span id="index-configure-options_002c-for-system-poppler"></span>
-<a name="index-poppler"></a>
-<a name="index-xpdf-as-library"></a>
-<p>Building LuaTeX (or LuaJITTeX) and XeTeX requires
-<code>poppler</code>, either from the TL tree or system headers and
-library. Building pdfTeX requires either <code>xpdf</code> from
-the TeX Live tree or system <code>poppler</code> headers and library.
+<span id="index-poppler"></span>
+<span id="index-xpdf-as-library"></span>
+<p>Building XeTeX requires <code>poppler</code>, either from the TL tree or
+system headers and library. Building pdfTeX requires either
+<code>xpdf</code> from the TeX Live tree or system <code>poppler</code> headers and
+library.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dpoppler"></a>
+<span id="index-_002d_002dwith_002dsystem_002dpoppler"></span>
<p><code>--with-system-poppler</code><br>Use a system version (0.18 or
newer) of <code>poppler</code> for LuaTeX (or LuaJITTeX) and XeTeX,
and use <samp>pkg-config</samp> to obtain the required flags.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dxpdf"></a>
-<p><code>--with-system-xpdf</code><br>Use a system version (0.12 or better)
+<span id="index-_002d_002dwith_002dsystem_002dxpdf"></span>
+<p><code>--with-system-xpdf</code><br>Use a system version (0.12 or newer)
of <code>poppler</code> (and <samp>pkg-config</samp>) for pdfTeX instead of
<code>xpdf</code> from the TL tree. See <a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a>.
</p>
<hr>
-<a name="Variables-for-configure"></a>
-<div class="header">
+<span id="Variables-for-configure"></span><div class="header">
<p>
Previous: <a href="#Library_002dspecific-configure-options" accesskey="p" rel="prev">Library-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Variables-for-configure-1"></a>
-<h3 class="section">7.4 Variables for configure</h3>
+<span id="Variables-for-configure-1"></span><h3 class="section">7.4 Variables for configure</h3>
-<a name="index-variables-for-configure"></a>
-<a name="index-configure-variables"></a>
+<span id="index-variables-for-configure"></span>
+<span id="index-configure-variables"></span>
<p>The values for these variables can be specified as <code>configure</code>
arguments of the form <code><var>VAR</var>=<var>value</var></code>. They can also be
@@ -3015,50 +2928,50 @@
</p>
<dl compact="compact">
<dt><code>CC</code>
-<a name="index-CC"></a>
+<span id="index-CC"></span>
</dt>
<dt><code>CXX</code>
-<a name="index-CXX"></a>
+<span id="index-CXX"></span>
</dt>
<dt><code>CPPFLAGS</code>
-<a name="index-CPPFLAGS"></a>
+<span id="index-CPPFLAGS"></span>
</dt>
<dd><p>And plenty more. As usual with Autoconf, these variables specify the
name (or full path) of compilers, preprocessor flags, and similar.
-See <a href="GNU Autoconf.html#Preset-Output-Variables">(GNU Autoconf)autoconf</a>.
+See <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Preset-Output-Variables">Preset Output Variables</a> in <cite>GNU Autoconf</cite>.
</p>
</dd>
<dt><code>CLISP</code>
-<a name="index-CLISP-1"></a>
+<span id="index-CLISP-1"></span>
</dt>
-<dd><a name="index-clisp"></a>
+<dd><span id="index-clisp"></span>
<p>Name (or full path) of the <samp>clisp</samp> executable, used to build
<code>xindy</code>.
</p>
</dd>
<dt><code>FT2_CONFIG</code>
-<a name="index-FT2_005fCONFIG"></a>
+<span id="index-FT2_005fCONFIG"></span>
</dt>
<dt><code>ICU_CONFIG</code>
-<a name="index-ICU_005fCONFIG"></a>
+<span id="index-ICU_005fCONFIG"></span>
</dt>
<dt><code>PKG_CONFIG</code>
-<a name="index-PKG_005fCONFIG"></a>
+<span id="index-PKG_005fCONFIG"></span>
</dt>
-<dd><a name="index-freetype_002dconfig-1"></a>
-<a name="index-icu_002dconfig"></a>
-<a name="index-libfreetype"></a>
-<a name="index-ICU-libraries"></a>
+<dd><span id="index-freetype_002dconfig-1"></span>
+<span id="index-icu_002dconfig"></span>
+<span id="index-libfreetype"></span>
+<span id="index-ICU-libraries"></span>
<p>These specify the name (or path) for the <samp>freetype-config</samp>,
<samp>icu-config</samp>, and <samp>pkg-config</samp> commands used to determine the
flags required for system versions of <samp>libfreetype</samp>, the ICU
-libraries, or many other libraries.
+libraries, and other libraries, respectively.
</p>
</dd>
<dt><code>KPSEWHICH</code>
-<a name="index-KPSEWHICH"></a>
+<span id="index-KPSEWHICH"></span>
</dt>
-<dd><a name="index-kpsewhich"></a>
+<dd><span id="index-kpsewhich"></span>
<p>Name (or path) of an installed <samp>kpsewhich</samp> binary, used by
<code>make check</code> to determine the location of, e.g.,
<samp>cmbx10.tfm</samp>.
@@ -3065,10 +2978,10 @@
</p>
</dd>
<dt><code>MAKE</code>
-<a name="index-MAKE"></a>
+<span id="index-MAKE"></span>
</dt>
<dt><code>SED</code>
-<a name="index-SED"></a>
+<span id="index-SED"></span>
</dt>
<dd><p>And more. Name (or path) of the <code>make</code>, <code>sed</code>, and similar
programs; used at the top level and propagated to all subdirectories.
@@ -3075,13 +2988,13 @@
</p>
</dd>
<dt><code>PERL</code>
-<a name="index-PERL"></a>
+<span id="index-PERL"></span>
</dt>
<dt><code>LATEX</code>
-<a name="index-LATEX"></a>
+<span id="index-LATEX"></span>
</dt>
<dt><code>PDFLATEX</code>
-<a name="index-PDFLATEX"></a>
+<span id="index-PDFLATEX"></span>
</dt>
<dd><p>Name (or full path) for the <samp>perl</samp>, <samp>latex</samp>, and <samp>pdflatex</samp>
commands used, e.g., to build the <code>xindy</code> documentation.
@@ -3091,51 +3004,47 @@
<hr>
-<a name="Coding-conventions"></a>
-<div class="header">
+<span id="Coding-conventions"></span><div class="header">
<p>
Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</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>
</div>
-<a name="Coding-conventions-1"></a>
-<h2 class="chapter">8 Coding conventions</h2>
+<span id="Coding-conventions-1"></span><h2 class="chapter">8 Coding conventions</h2>
-<a name="index-coding-conventions"></a>
-<a name="index-conventions_002c-coding"></a>
+<span id="index-coding-conventions"></span>
+<span id="index-conventions_002c-coding"></span>
-<p>Ideally, building all of TeX Live with <code>--enable-compiler-warnings=max</code>
-should produce no (GCC) compiler warnings at all. In spite of
-considerable efforts into that direction we are still far from that goal and
-there are reasons that we may never fully reach it. Below are some rules
-about declarations of functions or variables and the use of <code>const</code>.
-These rules should be applied to most of the TeX Live tree, the exception
-being code that is maintained independently and whose maintainers
-don’t want to accept patches.
+<p>Ideally, building all of TeX Live with
+<code>--enable-compiler-warnings=max</code> should produce no (GCC) compiler
+warnings at all. In spite of considerable efforts into that direction
+we are still far from that goal and there are reasons that we may
+never fully reach it. Below are some rules about declarations of
+functions or variables and the use of <code>const</code>. These rules
+should be applied to the code maintained in the TeX Live tree and for
+other packages whose maintainers are willing to accept patches.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Declarations-and-definitions" accesskey="1">Declarations and definitions</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Declarations-and-definitions" accesskey="1">Declarations and definitions</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Const" accesskey="2">Const</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Const" accesskey="2">Const</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Declarations-and-definitions"></a>
-<div class="header">
+<span id="Declarations-and-definitions"></span><div class="header">
<p>
Next: <a href="#Const" accesskey="n" rel="next">Const</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Declarations-and-definitions-1"></a>
-<h3 class="section">8.1 Declarations and definitions</h3>
+<span id="Declarations-and-definitions-1"></span><h3 class="section">8.1 Declarations and definitions</h3>
-<a name="index-declarations-and-definitions_002c-in-source-code"></a>
-<a name="index-source-code-declarations"></a>
-<a name="index-ANSI-C"></a>
-<a name="index-C_002c-ANSI_002c-required"></a>
-<a name="index-C99_002c-avoided"></a>
+<span id="index-declarations-and-definitions_002c-in-source-code"></span>
+<span id="index-source-code-declarations"></span>
+<span id="index-ANSI-C"></span>
+<span id="index-declarations-before-statements_002c-avoiding"></span>
+<span id="index-C_002c-ANSI_002c-required"></span>
+<span id="index-C99_002c-avoided"></span>
-<a name="C-standards"></a>
-<h4 class="subsubheading">C standards</h4>
+<span id="C-standards"></span><h4 class="subsubheading">C standards</h4>
<p>The TeX Live build system no longer supports pre-ANSI C compilers. Thus
all function prototypes and definitions must conform to the ANSI C
@@ -3143,18 +3052,18 @@
no parameters). On the other hand, TL is built for a wide variety of
systems, not all of which support the C99 standard. Therefore using
C99 features should be avoided if that can easily be done. In
-particular C code must not contain declarations after statements or
+particular, C code must not contain declarations after statements or
C++-style comments.
</p>
-<a name="index-chktex"></a>
-<a name="index-stpcpy"></a>
+<span id="index-chktex"></span>
+<span id="index-stpcpy"></span>
<p>If some C99 (or later) constructs must be used, the module should
verify that they are available and otherwise provide an alternative.
For example, the module <samp>texk/chktex</samp> uses the C99 function
<code>stpcpy()</code> that may or may not be available on a particular
system. It uses <code>AC_CHECK_DECLS([stpcpy])</code> in
-<samp>configure.ac</samp> to test this, and provides the perhaps slightly
-less efficient alternative
+<samp>configure.ac</samp> to test this, and provides a perhaps
+less efficient alternative (in the file <samp>Utility.h</samp>):
</p>
<div class="example">
<pre class="example">#if !(defined HAVE_DECL_STPCPY && HAVE_DECL_STPCPY)
@@ -3165,20 +3074,15 @@
#endif
</pre></div>
-<p>in the file <samp>Utility.h</samp>.
-</p>
+<span id="Static-functions"></span><h4 class="subsubheading">Static functions</h4>
-<a name="Static-functions"></a>
-<h4 class="subsubheading">Static functions</h4>
-
-<a name="index-static-functions"></a>
+<span id="index-static-functions"></span>
<p>Functions used in only one file should be declared <code>static</code>; they
-require no prototype except as forward declaration.
+require no prototype except in forward declarations.
</p>
-<a name="Extern-functions"></a>
-<h4 class="subsubheading">Extern functions</h4>
+<span id="Extern-functions"></span><h4 class="subsubheading">Extern functions</h4>
-<a name="index-extern-functions"></a>
+<span id="index-extern-functions"></span>
<p>Functions not declared <code>static</code>, usually because they are used in
several files, require an (<code>extern</code>) prototype in exactly one
header file, which is included in the file defining the function and
@@ -3187,10 +3091,9 @@
<code>extern</code> declarations sprinkled throughout the C code (with or
without comments as to where that function is defined).
</p>
-<a name="Variable-declarations"></a>
-<h4 class="subsubheading">Variable declarations</h4>
+<span id="Variable-declarations"></span><h4 class="subsubheading">Variable declarations</h4>
-<a name="index-variable-declarations_002c-in-source-code"></a>
+<span id="index-variable-declarations_002c-in-source-code"></span>
<p>The declaration of global variables follows analogous rules: they are
either declared <code>static</code> if used in only one file or declared
<code>extern</code> in exactly one header and instantiated in exactly one
@@ -3197,20 +3100,17 @@
file.
</p>
<hr>
-<a name="Const"></a>
-<div class="header">
+<span id="Const"></span><div class="header">
<p>
Previous: <a href="#Declarations-and-definitions" accesskey="p" rel="prev">Declarations and definitions</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Const-1"></a>
-<h3 class="section">8.2 Const</h3>
+<span id="Const-1"></span><h3 class="section">8.2 Const</h3>
-<a name="index-const"></a>
+<span id="index-const"></span>
<p>The <code>const</code> feature of C is valuable, but easy to mis-use.
</p>
-<a name="Function-parameters"></a>
-<h4 class="subsubheading">Function parameters</h4>
+<span id="Function-parameters"></span><h4 class="subsubheading">Function parameters</h4>
<p>Ideally, a function parameter not modified by the function should be
declared as <code>const</code>. This is important in particular for strings
@@ -3223,29 +3123,27 @@
since that might cause modification of a quantity supposed to be
constant.
</p>
-<a name="index-X11-headers_002c-and-const"></a>
-<a name="index-libfreetype_002c-and-const"></a>
+<span id="index-X11-headers_002c-and-const"></span>
+<span id="index-libfreetype_002c-and-const"></span>
<p>Getting all <code>const</code> qualifiers right can get quite involved but
can almost always be done. There are only a couple notable
exceptions: the X11 headers are full of declarations that ought to use
-<code>const</code> but do not, and the same is true to some extent for
-<samp>libfreetype</samp> (but, thankfully, not for <code>zlib</code> nowadays).
+<code>const</code> but do not; at one time, <samp>libfreetype</samp> also did not
+fully specify <code>const</code>, but this has not been checked recently.
</p>
-<a name="What-must-be-avoided-with-const"></a>
-<h4 class="subsubheading">What must be avoided with <code>const</code></h4>
+<span id="What-must-be-avoided-with-const"></span><h4 class="subsubheading">What must be avoided with <code>const</code></h4>
-<a name="index-warning_002c-discards-qualifiers"></a>
-<a name="index-discards-qualifiers-warning"></a>
+<span id="index-warning_002c-discards-qualifiers"></span>
+<span id="index-discards-qualifiers-warning"></span>
<p>The GCC compiler warnings “assignment discards qualifiers…”
and analogous warnings for “initialization”, “passing arg”, or
-“return” must be strenously avoided in our own code. The only
-exception is when they are caused by X11 headers or macros or other
-third party code.
+“return” must be strenuously avoided in our own code. The only
+exception is when they are caused by X11 declarations or other third
+party code.
</p>
-<a name="What-should-be-avoided-with-const"></a>
-<h4 class="subsubheading">What should be avoided with <code>const</code></h4>
+<span id="What-should-be-avoided-with-const"></span><h4 class="subsubheading">What should be avoided with <code>const</code></h4>
-<a name="index-type-cast_002c-avoiding"></a>
+<span id="index-type-cast-from-const_002c-avoiding"></span>
<p>A type cast, e.g., from <code>const char*</code> to <code>char*</code> does not
solve any problems; depending on warning options, it may only hide
them. Therefore such casts should be avoided whenever possible and
@@ -3254,84 +3152,81 @@
</p>
<hr>
-<a name="Continuous-integration"></a>
-<div class="header">
+<span id="Continuous-integration"></span><div class="header">
<p>
Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</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>
</div>
-<a name="Continuous-integration-1"></a>
-<h2 class="chapter">9 Continuous integration</h2>
+<span id="Continuous-integration-1"></span><h2 class="chapter">9 Continuous integration</h2>
-<a name="index-ci"></a>
-<a name="index-continuous-integration"></a>
-<a name="index-Travis_002dCI"></a>
+<span id="index-continuous-integration"></span>
+<span id="index-Travis_002dCI"></span>
-<p>Overview: the sources of TeX Live are subjected to continuous integration
-testing on Travis-CI
-(<a href="https://travis-ci.org/TeX-Live/texlive-source">https://travis-ci.org/TeX-Live/texlive-source</a>) via a git-svn
-mirror of the sources that is pushed to Github
+<p>The TeX Live sources are subjected to continuous integration testing on
+Travis-CI (<a href="https://travis-ci.org/TeX-Live/texlive-source">https://travis-ci.org/TeX-Live/texlive-source</a>) via a
+git-svn mirror of the sources that is pushed to Github
(<a href="https://github.com/TeX-Live/texlive-source">https://github.com/TeX-Live/texlive-source</a>). The git-svn mirror
is updated (currently) at 30 minute intervals, and only the last
commit pushed is tested on Travis-CI.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
+
<hr>
-<a name="Transfer-from-Subversion-to-Github"></a>
-<div class="header">
+<span id="Transfer-from-Subversion-to-Github"></span><div class="header">
<p>
Next: <a href="#Automatic-update-of-the-Git-mirror" accesskey="n" rel="next">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Transfer-from-Subversion-to-Github-1"></a>
-<h3 class="section">9.1 Transfer from Subversion to Github</h3>
+<span id="Transfer-from-Subversion-to-Github-1"></span><h3 class="section">9.1 Transfer from Subversion to Github</h3>
-<p>git-svn (<a href="https://git-scm.com/docs/git-svn">https://git-scm.com/docs/git-svn</a>) is used to check out
-the subtree <code>Build/source</code> of the Subversion repository. The
-author index file used is not maintained in either Git or Subversion
-but can be provided on request.
+<span id="index-git_002dsvn"></span>
+<p>The git-svn program (<a href="https://git-scm.com/docs/git-svn">https://git-scm.com/docs/git-svn</a>) is used
+to check out the subtree <code>Build/source</code> of the canonical
+Subversion repository. The author index file used is not maintained
+in either Git or Subversion but can be provided on request.
</p>
<p>The initial checkout was done by invoking
</p><div class="example">
-<pre class="example">git svn --authors-file usermap clone svn://USER@tug.org/texlive/trunk/Build/source
+<pre class="example">git svn --authors-file usermap clone \
+ svn://<var>user</var>@tug.org/texlive/trunk/Build/source
</pre></div>
<p>where the <code>usermap</code> file maps Subversion user names to
-name and emails of the authors. If no user account at <a href="tug.org">tug.org</a> is
-available, anonymous checkout is possible, too:
+name and emails of the authors. Anonymous checkout is also possible:
</p><div class="example">
-<pre class="example">git svn --authors-file usermap clone svn://tug.org/texlive/trunk/Build/source
+<pre class="example">git svn --authors-file usermap clone \
+ svn://tug.org/texlive/trunk/Build/source
</pre></div>
<p>In the following, we will use <em>admin</em> to refer to a user who has
read/write access to the TeX Live subversion repository, and is also an
-administrator of the <code>TeX-Live</code> Team on Github. The above initial
-checkout has been carried out by <em>admin</em> on the server
+administrator of the ‘<code>TeX-Live</code>’ team at Github. The above
+initial checkout has been carried out by <em>admin</em> on the server
<code>texlive.info</code>.
</p>
-<p>On Github (<a href="https://github.com">https://github.com</a>), a new git repository named
-<code>texlive-source</code> was created by <em>admin</em> within the
-<code>TeX-Live</code> “organization” (<a href="https://github.com/TeX-Live">https://github.com/TeX-Live</a>).
-The remote was added to the checkout with <code>git remote add origin
+<p>On Github, a new git repository named <code>texlive-source</code> was
+created by <em>admin</em> within the <code>TeX-Live</code> “organization”
+(<a href="https://github.com/TeX-Live">https://github.com/TeX-Live</a>). The remote was added to the
+checkout with <code>git remote add origin
git at github.com:TeX-Live/texlive-source.git</code>.
</p>
-<p>To automate the update on Github, a new ssh key was generated and added
-to the <code>texlive-source</code> repository on Github as deployment
-key. This way pushes using this key can only go to the
+<p>To automate the update on Github, a new ssh key was generated and
+added to the <code>texlive-source</code> repository on Github as deployment
+key. Thus, pushes using this key can only go to the
<code>texlive-source</code> repository and not anywhere else.
</p>
<p>The usage of <code>git-svn</code> requires a strict discipline to keep a
linear history in the master branch. Since we are aiming at a pure
-mirror facility, we have decided to further restrict the <code>master</code>
-branch of the <code>texlive-source</code> repository on Github to changes by
-<em>admin</em>.
+mirror facility on Github, we have decided to further restrict the
+<code>master</code> branch of the <code>texlive-source</code> repository on Github
+to changes by <em>admin</em>.
</p>
<p>This setup allows other developers to branch off <code>master</code> and
push their branches to the Github repository, but all updates need to
@@ -3340,88 +3235,79 @@
there to Github.
</p>
<hr>
-<a name="Automatic-update-of-the-Git-mirror"></a>
-<div class="header">
+<span id="Automatic-update-of-the-Git-mirror"></span><div class="header">
<p>
Next: <a href="#CI-testing-on-Travis_002dCI" accesskey="n" rel="next">CI testing on Travis-CI</a>, Previous: <a href="#Transfer-from-Subversion-to-Github" accesskey="p" rel="prev">Transfer from Subversion to Github</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Automatic-update-of-the-Git-mirror-1"></a>
-<h3 class="section">9.2 Automatic update of the Git mirror</h3>
+<span id="Automatic-update-of-the-Git-mirror-1"></span><h3 class="section">9.2 Automatic update of the Git mirror</h3>
<p><em>admin</em> has installed a cron job on <code>texlive.info</code> running
every 30 minute which essentially runs <code>git svn rebase</code> and
<code>git push</code> in the <code>master</code> branch of the checkout. The first
command fetches the changes from the Subversion repository and updates
-the <code>master</code> branch with them, the second one pushes changes (if
-available) to Github.
+the <code>master</code> branch with them, and the second pushes changes (if
+any) to Github.
</p>
<hr>
-<a name="CI-testing-on-Travis_002dCI"></a>
-<div class="header">
+<span id="CI-testing-on-Travis_002dCI"></span><div class="header">
<p>
Previous: <a href="#Automatic-update-of-the-Git-mirror" accesskey="p" rel="prev">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="CI-testing-on-Travis_002dCI-1"></a>
-<h3 class="section">9.3 CI testing on Travis-CI</h3>
+<span id="CI-testing-on-Travis_002dCI-1"></span><h3 class="section">9.3 CI testing on Travis-CI</h3>
-<a name="index-_002etravis_002eyml"></a>
+<span id="index-travis_002eyml"></span>
<p>The <code>source</code> tree of TeX Live contains a top-level file
<code>.travis.yml</code> which controls the automatic testing on
-Travis-CI. <em>admin</em> has registered to Travis-CI and allowed access
-to the Github’s <code>TeX-Live</code> organization’s <code>texlive-source</code>
-repository. The default settings are to build the last commit of each
-push. No further action is necessary on Travis-CI.
+Travis-CI. <em>admin</em> has registered with Travis-CI and allowed
+access to the Github’s <code>TeX-Live</code> organization’s
+<code>texlive-source</code> repository. The default settings are to build
+the last commit of each push. No further action is necessary on
+Travis-CI.
</p>
<p>If changes have been pushed via the cron job above, Travis-CI will
automatically checkout the last pushed commit and try building it.
</p>
<hr>
-<a name="install_002dtl"></a>
-<div class="header">
+<span id="install_002dtl"></span><div class="header">
<p>
Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</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>
</div>
-<a name="install_002dtl-1"></a>
-<h2 class="appendix">Appendix A install-tl</h2>
+<span id="install_002dtl-1"></span><h2 class="appendix">Appendix A install-tl</h2>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#install_002dtl-NAME" accesskey="1">install-tl NAME</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-NAME" accesskey="1">install-tl NAME</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-SYNOPSIS" accesskey="2">install-tl SYNOPSIS</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-SYNOPSIS" accesskey="2">install-tl SYNOPSIS</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-DESCRIPTION" accesskey="3">install-tl DESCRIPTION</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-DESCRIPTION" accesskey="3">install-tl DESCRIPTION</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-REFERENCES" accesskey="4">install-tl REFERENCES</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-REFERENCES" accesskey="4">install-tl REFERENCES</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-OPTIONS" accesskey="5">install-tl OPTIONS</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-OPTIONS" accesskey="5">install-tl OPTIONS</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-PROFILES" accesskey="6">install-tl PROFILES</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-PROFILES" accesskey="6">install-tl PROFILES</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">install-tl ENVIRONMENT VARIABLES</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">install-tl ENVIRONMENT VARIABLES</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">install-tl AUTHORS AND COPYRIGHT</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">install-tl AUTHORS AND COPYRIGHT</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="install_002dtl-NAME"></a>
-<div class="header">
+<span id="install_002dtl-NAME"></span><div class="header">
<p>
Next: <a href="#install_002dtl-SYNOPSIS" accesskey="n" rel="next">install-tl SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="NAME"></a>
-<h3 class="appendixsec">A.1 NAME</h3>
+<span id="NAME"></span><h3 class="appendixsec">A.1 NAME</h3>
<p>install-tl - TeX Live cross-platform installer
</p>
<hr>
-<a name="install_002dtl-SYNOPSIS"></a>
-<div class="header">
+<span id="install_002dtl-SYNOPSIS"></span><div class="header">
<p>
Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl DESCRIPTION</a>, Previous: <a href="#install_002dtl-NAME" accesskey="p" rel="prev">install-tl NAME</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="SYNOPSIS"></a>
-<h3 class="appendixsec">A.2 SYNOPSIS</h3>
+<span id="SYNOPSIS"></span><h3 class="appendixsec">A.2 SYNOPSIS</h3>
<p>install-tl [<em>option</em>]...
</p>
@@ -3430,13 +3316,11 @@
<p>install-tl-advanced.bat [<em>option</em>]...
</p>
<hr>
-<a name="install_002dtl-DESCRIPTION"></a>
-<div class="header">
+<span id="install_002dtl-DESCRIPTION"></span><div class="header">
<p>
Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">install-tl REFERENCES</a>, Previous: <a href="#install_002dtl-SYNOPSIS" accesskey="p" rel="prev">install-tl SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="DESCRIPTION"></a>
-<h3 class="appendixsec">A.3 DESCRIPTION</h3>
+<span id="DESCRIPTION"></span><h3 class="appendixsec">A.3 DESCRIPTION</h3>
<p>This installer creates a runnable TeX Live installation from various
media, including over the network, from local hard disk, a DVD, etc.
@@ -3458,13 +3342,11 @@
highly recommended.
</p>
<hr>
-<a name="install_002dtl-REFERENCES"></a>
-<div class="header">
+<span id="install_002dtl-REFERENCES"></span><div class="header">
<p>
Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">install-tl OPTIONS</a>, Previous: <a href="#install_002dtl-DESCRIPTION" accesskey="p" rel="prev">install-tl DESCRIPTION</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="REFERENCES"></a>
-<h3 class="appendixsec">A.4 REFERENCES</h3>
+<span id="REFERENCES"></span><h3 class="appendixsec">A.4 REFERENCES</h3>
<p>Post-installation configuration, package updates, and much more, are
handled through <strong>tlmgr</strong>(1), the TeX Live Manager
@@ -3477,13 +3359,11 @@
<a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
</p>
<hr>
-<a name="install_002dtl-OPTIONS"></a>
-<div class="header">
+<span id="install_002dtl-OPTIONS"></span><div class="header">
<p>
Next: <a href="#install_002dtl-PROFILES" accesskey="n" rel="next">install-tl PROFILES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">install-tl REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="OPTIONS"></a>
-<h3 class="appendixsec">A.5 OPTIONS</h3>
+<span id="OPTIONS"></span><h3 class="appendixsec">A.5 OPTIONS</h3>
<p>As usual, all options can be specified in any order, and with either a
leading <code>-</code> or <code>--</code>. An argument value can be separated from its
@@ -3491,7 +3371,7 @@
</p>
<dl compact="compact">
<dt><strong>-gui</strong> [[=]<em>module</em>]</dt>
-<dd><a name="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></a>
+<dd><span id="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></span>
<p>If no <em>module</em> is given, starts the <code>perltk</code> (see below) GUI installer.
</p>
<p>If <em>module</em> is given loads the given installer module. Currently the
@@ -3499,19 +3379,19 @@
</p>
<dl compact="compact">
<dt><code>text</code></dt>
-<dd><a name="install_002dtl-text"></a>
+<dd><span id="install_002dtl-text"></span>
<p>The text mode user interface (default on Unix systems). Same as the
<code>-no-gui</code> option.
</p>
</dd>
<dt><code>wizard</code></dt>
-<dd><a name="install_002dtl-wizard"></a>
+<dd><span id="install_002dtl-wizard"></span>
<p>The wizard mode user interface (default on Windows), asking only minimal
questions before installing all of TeX Live.
</p>
</dd>
<dt><code>perltk</code></dt>
-<dd><a name="install_002dtl-perltk"></a>
+<dd><span id="install_002dtl-perltk"></span>
<p>The expert GUI installer, providing access to more options.
Can also be invoked on Windows by running <code>install-tl-advanced.bat</code>.
</p>
@@ -3525,12 +3405,12 @@
</p>
</dd>
<dt><strong>-no-gui</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dgui"></a>
+<dd><span id="install_002dtl-_002dno_002dgui"></span>
<p>Use the text mode installer (default except on Windows).
</p>
</dd>
<dt><strong>-lang</strong> <em>llcode</em></dt>
-<dd><a name="install_002dtl-_002dlang-llcode"></a>
+<dd><span id="install_002dtl-_002dlang-llcode"></span>
<p>By default, the GUI tries to deduce your language from the environment
(on Windows via the registry, on Unix via <code>LC_MESSAGES</code>). If that fails
you can select a different language by giving this option with a
@@ -3543,7 +3423,7 @@
</p>
</dd>
<dt><strong>-repository</strong> <em>url|path</em></dt>
-<dd><a name="install_002dtl-_002drepository-url_007cpath"></a>
+<dd><span id="install_002dtl-_002drepository-url_007cpath"></span>
<p>Specify the package repository to be used as the source of the
installation, either a local directory via <code>/path/to/directory</code> or a
<code>file:/</code> url, or a network location via a <code>http://</code>, <code>https://</code>, or
@@ -3584,7 +3464,7 @@
</p>
</dd>
<dt><strong>-select-repository</strong></dt>
-<dd><a name="install_002dtl-_002dselect_002drepository"></a>
+<dd><span id="install_002dtl-_002dselect_002drepository"></span>
<p>This option allows manual selection of a mirror from the current list of
active CTAN mirrors. This option is supported in all installer modes
(text, wizard, perltk), and will also offer to install from local media
@@ -3594,7 +3474,7 @@
</p>
</dd>
<dt><strong>-all-options</strong></dt>
-<dd><a name="install_002dtl-_002dall_002doptions"></a>
+<dd><span id="install_002dtl-_002dall_002doptions"></span>
<p>Normally options not relevant to the current platform are not shown
(e.g., when running on Unix, Windows-specific options are omitted).
Giving this command line option allows configuring such "foreign"
@@ -3602,7 +3482,7 @@
</p>
</dd>
<dt><strong>-custom-bin</strong> <em>path</em></dt>
-<dd><a name="install_002dtl-_002dcustom_002dbin-path"></a>
+<dd><span id="install_002dtl-_002dcustom_002dbin-path"></span>
<p>If you have built your own set of TeX Live binaries (perhaps because
your platform was not supported by TeX Live out of the box), this option
allows you to specify the <em>path</em> to a directory where the binaries for
@@ -3610,7 +3490,7 @@
usual, but at the end all files from <em>path</em> are copied over to
<code>bin/custom/</code> under your installation directory and this <code>bin/custom/</code>
directory is what will be added to the path for the post-install
-actions. To install multiple custom binary sets, manully rename
+actions. To install multiple custom binary sets, manually rename
<code>custom</code> before doing each.
</p>
<p>For more information on custom binaries, see
@@ -3619,7 +3499,7 @@
</p>
</dd>
<dt><strong>-debug-translation</strong></dt>
-<dd><a name="install_002dtl-_002ddebug_002dtranslation"></a>
+<dd><span id="install_002dtl-_002ddebug_002dtranslation"></span>
<p>In GUI mode, this switch makes <code>tlmgr</code> report any missing, or more
likely untranslated, messages to standard error. Helpful for
translators to see what remains to be done.
@@ -3626,7 +3506,7 @@
</p>
</dd>
<dt><strong>-force-platform</strong> <em>platform</em></dt>
-<dd><a name="install_002dtl-_002dforce_002dplatform-platform"></a>
+<dd><span id="install_002dtl-_002dforce_002dplatform-platform"></span>
<p>Instead of auto-detecting the current platform, use <em>platform</em>.
Binaries for this platform must be present and they must actually be
runnable, or installation will fail. <code>-force-arch</code> is a synonym.
@@ -3633,7 +3513,7 @@
</p>
</dd>
<dt><strong>-help</strong>, <strong>–help</strong>, <strong>-?</strong></dt>
-<dd><a name="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></a>
+<dd><span id="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></span>
<p>Display this help and exit. (This help is on the web at
<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>). Sometimes the
<code>perldoc</code> and/or <code>PAGER</code> programs on the system have problems,
@@ -3643,7 +3523,7 @@
</p>
</dd>
<dt><strong>-in-place</strong></dt>
-<dd><a name="install_002dtl-_002din_002dplace"></a>
+<dd><span id="install_002dtl-_002din_002dplace"></span>
<p>This is a quick-and-dirty installation option in case you already have
an rsync or svn checkout of TeX Live. It will use the checkout as-is
and will just do the necessary post-install. Be warned that the file
@@ -3654,7 +3534,7 @@
</p>
</dd>
<dt><strong>-init-from-profile</strong> <em>profile_file</em></dt>
-<dd><a name="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></a>
+<dd><span id="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></span>
<p>Similar to <strong>-profile</strong> (see <a href="#install_002dtl-PROFILES">PROFILES</a> below), but only initializes the
installation configuration from <em>profile_file</em> and then starts the
interactive session.
@@ -3661,7 +3541,7 @@
</p>
</dd>
<dt><strong>-logfile</strong> <em>file</em></dt>
-<dd><a name="install_002dtl-_002dlogfile-file"></a>
+<dd><span id="install_002dtl-_002dlogfile-file"></span>
<p>Write both all messages (informational, debugging, warnings) to <em>file</em>,
in addition to standard output or standard error.
</p>
@@ -3672,21 +3552,21 @@
</p>
</dd>
<dt><strong>-no-cls</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dcls"></a>
+<dd><span id="install_002dtl-_002dno_002dcls"></span>
<p>For the text mode installer only: do not clear the screen when entering
a new menu (for debugging purposes).
</p>
</dd>
<dt><strong>-non-admin</strong></dt>
-<dd><a name="install_002dtl-_002dnon_002dadmin"></a>
+<dd><span id="install_002dtl-_002dnon_002dadmin"></span>
<p>For Windows only: configure for the current user, not for all users.
</p>
</dd>
<dt><strong>-persistent-downloads</strong></dt>
-<dd><a name="install_002dtl-_002dpersistent_002ddownloads"></a>
+<dd><span id="install_002dtl-_002dpersistent_002ddownloads"></span>
</dd>
<dt><strong>-no-persistent-downloads</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dpersistent_002ddownloads"></a>
+<dd><span id="install_002dtl-_002dno_002dpersistent_002ddownloads"></span>
<p>For network installs, activating this option makes the installer try to
set up a persistent connection using the <code>Net::LWP</code> Perl module. This
opens only one connection between your computer and the server per
@@ -3699,7 +3579,7 @@
</p>
</dd>
<dt><strong>-no-verify-downloads</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dverify_002ddownloads"></a>
+<dd><span id="install_002dtl-_002dno_002dverify_002ddownloads"></span>
<p>By default, if a GnuPG <code>gpg</code> binary is found in PATH, downloads are
verified against a cryptographic signature. This option disables such
verification. The full description is in the Crytographic Verification
@@ -3708,13 +3588,13 @@
</p>
</dd>
<dt><strong>-portable</strong></dt>
-<dd><a name="install_002dtl-_002dportable"></a>
+<dd><span id="install_002dtl-_002dportable"></span>
<p>Install for portable use, e.g., on a USB stick. Also selectable from
within the perltk and text installers.
</p>
</dd>
<dt><strong>-print-platform</strong></dt>
-<dd><a name="install_002dtl-_002dprint_002dplatform"></a>
+<dd><span id="install_002dtl-_002dprint_002dplatform"></span>
<p>Print the TeX Live identifier for the detected platform
(hardware/operating system) combination to standard output, and exit.
<code>-print-arch</code> is a synonym.
@@ -3721,18 +3601,18 @@
</p>
</dd>
<dt><strong>-profile</strong> <em>profile_file</em></dt>
-<dd><a name="install_002dtl-_002dprofile-profile_005ffile"></a>
+<dd><span id="install_002dtl-_002dprofile-profile_005ffile"></span>
<p>Load <em>profile_file</em> and do the installation with no user interaction,
that is, a batch (unattended) install. See <a href="#install_002dtl-PROFILES">PROFILES</a> below.
</p>
</dd>
<dt><strong>-q</strong></dt>
-<dd><a name="install_002dtl-_002dq"></a>
+<dd><span id="install_002dtl-_002dq"></span>
<p>Omit normal informational messages.
</p>
</dd>
<dt><strong>-scheme</strong> <em>scheme</em></dt>
-<dd><a name="install_002dtl-_002dscheme-scheme"></a>
+<dd><span id="install_002dtl-_002dscheme-scheme"></span>
<p>Schemes are the highest level of package grouping in TeX Live; the
default is to use the <code>full</code> scheme, which includes everything. This
option overrides that default. You can change the scheme again before
@@ -3743,13 +3623,13 @@
</p>
</dd>
<dt><strong>-v</strong></dt>
-<dd><a name="install_002dtl-_002dv"></a>
+<dd><span id="install_002dtl-_002dv"></span>
<p>Include verbose debugging messages; repeat for maximum debugging: <code>-v
-v</code>. (Further repeats are accepted but ignored.)
</p>
</dd>
<dt><strong>-version</strong>, <strong>–version</strong></dt>
-<dd><a name="install_002dtl-_002dversion_002c-_002d_002dversion"></a>
+<dd><span id="install_002dtl-_002dversion_002c-_002d_002dversion"></span>
<p>Output version information and exit. If <code>-v</code> has also been given the
revisions of the used modules are reported, too.
</p>
@@ -3757,13 +3637,11 @@
</dl>
<hr>
-<a name="install_002dtl-PROFILES"></a>
-<div class="header">
+<span id="install_002dtl-PROFILES"></span><div class="header">
<p>
Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">install-tl ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">install-tl OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="PROFILES"></a>
-<h3 class="appendixsec">A.6 PROFILES</h3>
+<span id="PROFILES"></span><h3 class="appendixsec">A.6 PROFILES</h3>
<p>A <em>profile</em> file contains all the values needed to perform an
installation. After a normal installation has finished, a profile for
@@ -3831,28 +3709,28 @@
</p>
<dl compact="compact">
<dt><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</dt>
-<dd><a name="install_002dtl-instopt_005fadjustpath-_0028default-0-on-Unix_002c-1-on-Windows_0029"></a>
+<dd><span id="install_002dtl-instopt_005fadjustpath-_0028default-0-on-Unix_002c-1-on-Windows_0029"></span>
<p>Adjust <code>PATH</code> environment variable.
</p>
</dd>
<dt><code>instopt_adjustrepo</code> (default 1)</dt>
-<dd><a name="install_002dtl-instopt_005fadjustrepo-_0028default-1_0029"></a>
+<dd><span id="install_002dtl-instopt_005fadjustrepo-_0028default-1_0029"></span>
<p>Set remote repository to a multiplexed CTAN mirror after installation;
see <code>-repository</code> above.
</p>
</dd>
<dt><code>instopt_letter</code> (default 0)</dt>
-<dd><a name="install_002dtl-instopt_005fletter-_0028default-0_0029"></a>
+<dd><span id="install_002dtl-instopt_005fletter-_0028default-0_0029"></span>
<p>Set letter size paper as the default, instead of a4.
</p>
</dd>
<dt><code>instopt_portable</code> (default 0)</dt>
-<dd><a name="install_002dtl-instopt_005fportable-_0028default-0_0029"></a>
+<dd><span id="install_002dtl-instopt_005fportable-_0028default-0_0029"></span>
<p>Install for portable use, e.g., on a USB stick.
</p>
</dd>
<dt><code>instopt_write18_restricted</code> (default 1)</dt>
-<dd><a name="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></a>
+<dd><span id="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></span>
<p>Enable <code>\write18</code> for a restricted set of programs.
</p>
</dd>
@@ -3898,13 +3776,11 @@
installation manual, linked from <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
</p>
<hr>
-<a name="install_002dtl-ENVIRONMENT-VARIABLES"></a>
-<div class="header">
+<span id="install_002dtl-ENVIRONMENT-VARIABLES"></span><div class="header">
<p>
Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">install-tl AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-PROFILES" accesskey="p" rel="prev">install-tl PROFILES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="ENVIRONMENT-VARIABLES"></a>
-<h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3>
+<span id="ENVIRONMENT-VARIABLES"></span><h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3>
<p>For ease in scripting and debugging, <code>install-tl</code> will look for the
following environment variables. They are not of interest for normal
@@ -3912,7 +3788,7 @@
</p>
<dl compact="compact">
<dt><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></span>
<p>Omit the check for environment variables containing the string <code>tex</code>.
People developing TeX-related software are likely to have many such
variables.
@@ -3919,39 +3795,39 @@
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_NO_CONTEXT_CACHE</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fCONTEXT_005fCACHE"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fCONTEXT_005fCACHE"></span>
<p>Omit creating the ConTeXt cache. This is useful for redistributors.
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_NO_WELCOME</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></span>
<p>Omit printing the welcome message after successful installation, e.g.,
for testing.
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_PREFIX</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXDIR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFVAR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFHOME</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFLOCAL</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFLOCAL"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFLOCAL"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFSYSCONFIG</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSCONFIG"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSCONFIG"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSVAR"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSVAR"></span>
<p>Specify the respective directories. <code>TEXLIVE_INSTALL_PREFIX</code> defaults
to <code>/usr/local/texlive</code>, while <code>TEXLIVE_INSTALL_TEXDIR</code> defaults to
the release directory within that prefix, e.g.,
@@ -3960,7 +3836,7 @@
</p>
</dd>
<dt><code>NOPERLDOC</code></dt>
-<dd><a name="install_002dtl-NOPERLDOC"></a>
+<dd><span id="install_002dtl-NOPERLDOC"></span>
<p>Don’t try to run the <code>--help</code> message through <code>perldoc</code>.
</p>
</dd>
@@ -3967,13 +3843,11 @@
</dl>
<hr>
-<a name="install_002dtl-AUTHORS-AND-COPYRIGHT"></a>
-<div class="header">
+<span id="install_002dtl-AUTHORS-AND-COPYRIGHT"></span><div class="header">
<p>
Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">install-tl ENVIRONMENT VARIABLES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="AUTHORS-AND-COPYRIGHT"></a>
-<h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3>
+<span id="AUTHORS-AND-COPYRIGHT"></span><h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3>
<p>This script and its documentation were written for the TeX Live
distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the
@@ -3982,73 +3856,65 @@
<p>$Id: install-tl 46908 2018-03-10 00:46:28Z preining $
</p>
<hr>
-<a name="tlmgr"></a>
-<div class="header">
+<span id="tlmgr"></span><div class="header">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#install_002dtl" accesskey="p" rel="prev">install-tl</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>
</div>
-<a name="tlmgr-1"></a>
-<h2 class="appendix">Appendix B tlmgr</h2>
+<span id="tlmgr-1"></span><h2 class="appendix">Appendix B tlmgr</h2>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-NAME" accesskey="1">tlmgr NAME</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-NAME" accesskey="1">tlmgr NAME</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-SYNOPSIS" accesskey="2">tlmgr SYNOPSIS</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-SYNOPSIS" accesskey="2">tlmgr SYNOPSIS</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-DESCRIPTION" accesskey="3">tlmgr DESCRIPTION</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-DESCRIPTION" accesskey="3">tlmgr DESCRIPTION</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-EXAMPLES" accesskey="4">tlmgr EXAMPLES</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-EXAMPLES" accesskey="4">tlmgr EXAMPLES</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-OPTIONS" accesskey="5">tlmgr OPTIONS</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-OPTIONS" accesskey="5">tlmgr OPTIONS</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-ACTIONS" accesskey="6">tlmgr ACTIONS</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-ACTIONS" accesskey="6">tlmgr ACTIONS</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">tlmgr CONFIGURATION FILE FOR TLMGR</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">tlmgr CONFIGURATION FILE FOR TLMGR</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">tlmgr CRYPTOGRAPHIC VERIFICATION</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">tlmgr CRYPTOGRAPHIC VERIFICATION</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-USER-MODE" accesskey="9">tlmgr USER MODE</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-USER-MODE" accesskey="9">tlmgr USER MODE</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-MULTIPLE-REPOSITORIES">tlmgr MULTIPLE REPOSITORIES</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-MULTIPLE-REPOSITORIES">tlmgr MULTIPLE REPOSITORIES</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-GUI-FOR-TLMGR">tlmgr GUI FOR TLMGR</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-GUI-FOR-TLMGR">tlmgr GUI FOR TLMGR</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">tlmgr MACHINE-READABLE OUTPUT</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">tlmgr MACHINE-READABLE OUTPUT</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-AUTHORS-AND-COPYRIGHT">tlmgr AUTHORS AND COPYRIGHT</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-AUTHORS-AND-COPYRIGHT">tlmgr AUTHORS AND COPYRIGHT</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-NAME"></a>
-<div class="header">
+<span id="tlmgr-NAME"></span><div class="header">
<p>
Next: <a href="#tlmgr-SYNOPSIS" accesskey="n" rel="next">tlmgr SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="NAME-1"></a>
-<h3 class="appendixsec">B.1 NAME</h3>
+<span id="NAME-1"></span><h3 class="appendixsec">B.1 NAME</h3>
<p>tlmgr - the native TeX Live Manager
</p>
<hr>
-<a name="tlmgr-SYNOPSIS"></a>
-<div class="header">
+<span id="tlmgr-SYNOPSIS"></span><div class="header">
<p>
Next: <a href="#tlmgr-DESCRIPTION" accesskey="n" rel="next">tlmgr DESCRIPTION</a>, Previous: <a href="#tlmgr-NAME" accesskey="p" rel="prev">tlmgr NAME</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="SYNOPSIS-1"></a>
-<h3 class="appendixsec">B.2 SYNOPSIS</h3>
+<span id="SYNOPSIS-1"></span><h3 class="appendixsec">B.2 SYNOPSIS</h3>
<p>tlmgr [<em>option</em>...] <em>action</em> [<em>option</em>...] [<em>operand</em>...]
</p>
<hr>
-<a name="tlmgr-DESCRIPTION"></a>
-<div class="header">
+<span id="tlmgr-DESCRIPTION"></span><div class="header">
<p>
Next: <a href="#tlmgr-EXAMPLES" accesskey="n" rel="next">tlmgr EXAMPLES</a>, Previous: <a href="#tlmgr-SYNOPSIS" accesskey="p" rel="prev">tlmgr SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="DESCRIPTION-1"></a>
-<h3 class="appendixsec">B.3 DESCRIPTION</h3>
+<span id="DESCRIPTION-1"></span><h3 class="appendixsec">B.3 DESCRIPTION</h3>
<p><strong>tlmgr</strong> manages an existing TeX Live installation, both packages and
configuration options. For information on initially downloading and
@@ -4070,13 +3936,11 @@
available.
</p>
<hr>
-<a name="tlmgr-EXAMPLES"></a>
-<div class="header">
+<span id="tlmgr-EXAMPLES"></span><div class="header">
<p>
Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">tlmgr OPTIONS</a>, Previous: <a href="#tlmgr-DESCRIPTION" accesskey="p" rel="prev">tlmgr DESCRIPTION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="EXAMPLES"></a>
-<h3 class="appendixsec">B.4 EXAMPLES</h3>
+<span id="EXAMPLES"></span><h3 class="appendixsec">B.4 EXAMPLES</h3>
<p>After successfully installing TeX Live, here are a few common operations
with <code>tlmgr</code>:
@@ -4083,10 +3947,10 @@
</p>
<dl compact="compact">
<dt><code>tlmgr option repository ctan</code></dt>
-<dd><a name="tlmgr-tlmgr-option-repository-ctan"></a>
+<dd><span id="tlmgr-tlmgr-option-repository-ctan"></span>
</dd>
<dt><code>tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet</code></dt>
-<dd><a name="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></a>
+<dd><span id="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span>
<p>Tell <code>tlmgr</code> to use a nearby CTAN mirror for future updates; useful if
you installed TeX Live from the DVD image and want to have continuing
updates. The two commands are equivalent; <code>ctan</code> is just an alias for
@@ -4096,18 +3960,18 @@
</p>
</dd>
<dt><code>tlmgr update --list</code></dt>
-<dd><a name="tlmgr-tlmgr-update-_002d_002dlist"></a>
+<dd><span id="tlmgr-tlmgr-update-_002d_002dlist"></span>
<p>Report what would be updated without actually updating anything.
</p>
</dd>
<dt><code>tlmgr update --all</code></dt>
-<dd><a name="tlmgr-tlmgr-update-_002d_002dall"></a>
+<dd><span id="tlmgr-tlmgr-update-_002d_002dall"></span>
<p>Make your local TeX installation correspond to what is in the package
repository (typically useful when updating from CTAN).
</p>
</dd>
<dt><code>tlmgr info</code> <em>what</em></dt>
-<dd><a name="tlmgr-tlmgr-info-what"></a>
+<dd><span id="tlmgr-tlmgr-info-what"></span>
<p>Display detailed information about a package <em>what</em>, such as the installation
status and description, of searches for <em>what</em> in all packages.
</p>
@@ -4118,13 +3982,11 @@
following voluminous information.
</p>
<hr>
-<a name="tlmgr-OPTIONS"></a>
-<div class="header">
+<span id="tlmgr-OPTIONS"></span><div class="header">
<p>
Next: <a href="#tlmgr-ACTIONS" accesskey="n" rel="next">tlmgr ACTIONS</a>, Previous: <a href="#tlmgr-EXAMPLES" accesskey="p" rel="prev">tlmgr EXAMPLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="OPTIONS-1"></a>
-<h3 class="appendixsec">B.5 OPTIONS</h3>
+<span id="OPTIONS-1"></span><h3 class="appendixsec">B.5 OPTIONS</h3>
<p>The following options to <code>tlmgr</code> are global options, not specific to
any action. All options, whether global or action-specific, can be
@@ -4135,7 +3997,7 @@
</p>
<dl compact="compact">
<dt><strong>–repository</strong> <em>url|path</em></dt>
-<dd><a name="tlmgr-_002d_002drepository-url_007cpath"></a>
+<dd><span id="tlmgr-_002d_002drepository-url_007cpath"></span>
<p>Specifies the package repository from which packages should be installed
or updated, overriding the default package repository found in the
installation’s TeX Live Package Database (a.k.a. the TLPDB, defined
@@ -4152,7 +4014,7 @@
</p>
</dd>
<dt><strong>–gui</strong> [<em>action</em>]</dt>
-<dd><a name="tlmgr-_002d_002dgui-_005baction_005d"></a>
+<dd><span id="tlmgr-_002d_002dgui-_005baction_005d"></span>
<p><code>tlmgr</code> has a graphical interface as well as the command line
interface. You can give this option, <code>--gui</code>, together with an action
to be brought directly into the respective screen of the GUI. For
@@ -4165,7 +4027,7 @@
</p>
</dd>
<dt><strong>–gui-lang</strong> <em>llcode</em></dt>
-<dd><a name="tlmgr-_002d_002dgui_002dlang-llcode"></a>
+<dd><span id="tlmgr-_002d_002dgui_002dlang-llcode"></span>
<p>By default, the GUI tries to deduce your language from the environment
(on Windows via the registry, on Unix via <code>LC_MESSAGES</code>). If that fails
you can select a different language by giving this option with a
@@ -4178,7 +4040,7 @@
</p>
</dd>
<dt><strong>–debug-translation</strong></dt>
-<dd><a name="tlmgr-_002d_002ddebug_002dtranslation"></a>
+<dd><span id="tlmgr-_002d_002ddebug_002dtranslation"></span>
<p>In GUI mode, this switch tells <code>tlmgr</code> to report any untranslated (or
missing) messages to standard error. This can help translators to see
what remains to be done.
@@ -4185,7 +4047,7 @@
</p>
</dd>
<dt><strong>–machine-readable</strong></dt>
-<dd><a name="tlmgr-_002d_002dmachine_002dreadable"></a>
+<dd><span id="tlmgr-_002d_002dmachine_002dreadable"></span>
<p>Instead of the normal output intended for human consumption, write (to
standard output) a fixed format more suitable for machine parsing. See
the <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">MACHINE-READABLE OUTPUT</a> section below.
@@ -4192,7 +4054,7 @@
</p>
</dd>
<dt><strong>–no-execute-actions</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002dexecute_002dactions"></a>
+<dd><span id="tlmgr-_002d_002dno_002dexecute_002dactions"></span>
<p>Suppress the execution of the execute actions as defined in the tlpsrc
files. Documented only for completeness, as this is only useful in
debugging.
@@ -4199,7 +4061,7 @@
</p>
</dd>
<dt><strong>–package-logfile</strong> <em>file</em></dt>
-<dd><a name="tlmgr-_002d_002dpackage_002dlogfile-file"></a>
+<dd><span id="tlmgr-_002d_002dpackage_002dlogfile-file"></span>
<p><code>tlmgr</code> logs all package actions (install, remove, update, failed
updates, failed restores) to a separate log file, by default
<code>TEXMFSYSVAR/web2c/tlmgr.log</code>. This option allows you to specify a
@@ -4207,16 +4069,16 @@
</p>
</dd>
<dt><strong>–pause</strong></dt>
-<dd><a name="tlmgr-_002d_002dpause"></a>
+<dd><span id="tlmgr-_002d_002dpause"></span>
<p>This option makes <code>tlmgr</code> wait for user input before exiting. Useful on
Windows to avoid disappearing command windows.
</p>
</dd>
<dt><strong>–persistent-downloads</strong></dt>
-<dd><a name="tlmgr-_002d_002dpersistent_002ddownloads"></a>
+<dd><span id="tlmgr-_002d_002dpersistent_002ddownloads"></span>
</dd>
<dt><strong>–no-persistent-downloads</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002dpersistent_002ddownloads"></a>
+<dd><span id="tlmgr-_002d_002dno_002dpersistent_002ddownloads"></span>
<p>For network-based installations, this option (on by default) makes
<code>tlmgr</code> try to set up a persistent connection (using the <code>LWP</code> Perl
module). The idea is to open and reuse only one connection per session
@@ -4228,7 +4090,7 @@
</p>
</dd>
<dt><strong>–pin-file</strong></dt>
-<dd><a name="tlmgr-_002d_002dpin_002dfile"></a>
+<dd><span id="tlmgr-_002d_002dpin_002dfile"></span>
<p>Change the pinning file location from <code>TEXMFLOCAL/tlpkg/pinning.txt</code>
(see <a href="#tlmgr-Pinning">Pinning</a> below). Documented only for completeness, as this is
only useful in debugging.
@@ -4235,17 +4097,17 @@
</p>
</dd>
<dt><strong>–usermode</strong></dt>
-<dd><a name="tlmgr-_002d_002dusermode"></a>
+<dd><span id="tlmgr-_002d_002dusermode"></span>
<p>Activates user mode for this run of <code>tlmgr</code>; see <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
</dd>
<dt><strong>–usertree</strong> <em>dir</em></dt>
-<dd><a name="tlmgr-_002d_002dusertree-dir"></a>
+<dd><span id="tlmgr-_002d_002dusertree-dir"></span>
<p>Uses <em>dir</em> for the tree in user mode; see <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
</dd>
<dt><strong>–verify-repo=[none|main|all]</strong></dt>
-<dd><a name="tlmgr-_002d_002dverify_002drepo_003d_005bnone_007cmain_007call_005d"></a>
+<dd><span id="tlmgr-_002d_002dverify_002drepo_003d_005bnone_007cmain_007call_005d"></span>
<p>Defines the level of verification done: If <code>none</code> is specified, no
verification whatsoever is done. If <code>main</code> is given and a working GnuPG
(<code>gpg</code>) binary is available, all repositories are checked, but only the
@@ -4266,85 +4128,81 @@
revision number for the loaded TeX Live Perl modules are shown, too.
</p>
<hr>
-<a name="tlmgr-ACTIONS"></a>
-<div class="header">
+<span id="tlmgr-ACTIONS"></span><div class="header">
<p>
Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">tlmgr OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="ACTIONS"></a>
-<h3 class="appendixsec">B.6 ACTIONS</h3>
+<span id="ACTIONS"></span><h3 class="appendixsec">B.6 ACTIONS</h3>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-help" accesskey="1">tlmgr help</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-help" accesskey="1">tlmgr help</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-version" accesskey="2">tlmgr version</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-version" accesskey="2">tlmgr version</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-backup" accesskey="3">tlmgr backup</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-backup" accesskey="3">tlmgr backup</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-candidates-pkg" accesskey="4">tlmgr candidates <em>pkg</em></a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-candidates-pkg" accesskey="4">tlmgr candidates <em>pkg</em></a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-conf" accesskey="6">tlmgr conf</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-conf" accesskey="6">tlmgr conf</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="7">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="7">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-generate" accesskey="8">tlmgr generate</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-generate" accesskey="8">tlmgr generate</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-gui" accesskey="9">tlmgr gui</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-gui" accesskey="9">tlmgr gui</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-info">tlmgr info</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-info">tlmgr info</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-init_002dusertree">tlmgr init-usertree</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-init_002dusertree">tlmgr init-usertree</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr install [<em>option</em>...] <em>pkg</em>...</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-key">tlmgr key</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-key">tlmgr key</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-list">tlmgr list</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-list">tlmgr list</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-option">tlmgr option</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-option">tlmgr option</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-paper">tlmgr paper</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-paper">tlmgr paper</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-path">tlmgr path</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-path">tlmgr path</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-pinning">tlmgr pinning</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-pinning">tlmgr pinning</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-platform">tlmgr platform</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-platform">tlmgr platform</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-postaction">tlmgr postaction</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-postaction">tlmgr postaction</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-print_002dplatform">tlmgr print-platform</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-print_002dplatform">tlmgr print-platform</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-print_002dplatform_002dinfo">tlmgr print-platform-info</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-print_002dplatform_002dinfo">tlmgr print-platform-info</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-repository">tlmgr repository</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-repository">tlmgr repository</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-restore">tlmgr restore</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-restore">tlmgr restore</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-search">tlmgr search</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-search">tlmgr search</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-shell">tlmgr shell</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-shell">tlmgr shell</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-show">tlmgr show</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-show">tlmgr show</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-uninstall">tlmgr uninstall</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-uninstall">tlmgr uninstall</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-help"></a>
-<div class="header">
+<span id="tlmgr-help"></span><div class="header">
<p>
Next: <a href="#tlmgr-version" accesskey="n" rel="next">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="help"></a>
-<h4 class="appendixsubsec">B.6.1 help</h4>
+<span id="help"></span><h4 class="appendixsubsec">B.6.1 help</h4>
<p>Display this help information and exit (same as <code>--help</code>, and on the
web at <a href="http://tug.org/texlive/doc/tlmgr.html">http://tug.org/texlive/doc/tlmgr.html</a>). Sometimes the
@@ -4354,13 +4212,11 @@
variable and <code>perldoc</code> will not be used.
</p>
<hr>
-<a name="tlmgr-version"></a>
-<div class="header">
+<span id="tlmgr-version"></span><div class="header">
<p>
Next: <a href="#tlmgr-backup" accesskey="n" rel="next">tlmgr backup</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">tlmgr help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="version"></a>
-<h4 class="appendixsubsec">B.6.2 version</h4>
+<span id="version"></span><h4 class="appendixsubsec">B.6.2 version</h4>
<p>Gives version information (same as <code>--version</code>).
</p>
@@ -4367,20 +4223,18 @@
<p>If <code>-v</code> has been given the revisions of the used modules are reported, too.
</p>
<hr>
-<a name="tlmgr-backup"></a>
-<div class="header">
+<span id="tlmgr-backup"></span><div class="header">
<p>
Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">tlmgr candidates <em>pkg</em></a>, Previous: <a href="#tlmgr-version" accesskey="p" rel="prev">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="backup"></a>
-<h4 class="appendixsubsec">B.6.3 backup</h4>
+<span id="backup"></span><h4 class="appendixsubsec">B.6.3 backup</h4>
<dl compact="compact">
<dt><strong>backup [<em>option</em>...] –all</strong></dt>
-<dd><a name="tlmgr-backup-_005boption_002e_002e_002e_005d-_002d_002dall"></a>
+<dd><span id="tlmgr-backup-_005boption_002e_002e_002e_005d-_002d_002dall"></span>
</dd>
<dt><strong>backup [<em>option</em>...] <em>pkg</em>...</strong></dt>
-<dd><a name="tlmgr-backup-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+<dd><span id="tlmgr-backup-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span>
<p>If the <code>--clean</code> option is not specified, this action makes a backup of
the given packages, or all packages given <code>--all</code>. These backups are
saved to the value of the <code>--backupdir</code> option, if that is an existing and
@@ -4399,7 +4253,7 @@
</p>
<dl compact="compact">
<dt><strong>–backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory"></span>
<p>Overrides the <code>backupdir</code> option setting in the TLPDB.
The <em>directory</em> argument is required and must specify an existing,
writable directory where backups are to be placed.
@@ -4406,7 +4260,7 @@
</p>
</dd>
<dt><strong>–all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall"></a>
+<dd><span id="tlmgr-_002d_002dall"></span>
<p>If <code>--clean</code> is not specified, make a backup of all packages in the TeX
Live installation; this will take quite a lot of space and time. If
<code>--clean</code> is specified, all packages are pruned.
@@ -4413,7 +4267,7 @@
</p>
</dd>
<dt><strong>–clean</strong>[=<em>N</em>]</dt>
-<dd><a name="tlmgr-_002d_002dclean_005b_003dN_005d"></a>
+<dd><span id="tlmgr-_002d_002dclean_005b_003dN_005d"></span>
<p>Instead of making backups, prune the backup directory of old backups, as
explained above. The optional integer argument <em>N</em> overrides the
<code>autobackup</code> option set in the TLPDB. You must use <code>--all</code> or a list
@@ -4421,7 +4275,7 @@
</p>
</dd>
<dt><strong>–dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun"></span>
<p>Nothing is actually backed up or removed; instead, the actions to be
performed are written to the terminal.
</p>
@@ -4432,37 +4286,33 @@
</dl>
<hr>
-<a name="tlmgr-candidates-pkg"></a>
-<div class="header">
+<span id="tlmgr-candidates-pkg"></span><div class="header">
<p>
Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">tlmgr backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="candidates-pkg"></a>
-<h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
+<span id="candidates-pkg"></span><h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
<p>Shows the available candidate repositories for package <em>pkg</em>.
See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below.
</p>
<hr>
-<a name="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
-<div class="header">
+<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><div class="header">
<p>
Next: <a href="#tlmgr-conf" accesskey="n" rel="next">tlmgr conf</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">tlmgr candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
-<h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</h4>
+<span id="check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</h4>
<p>Executes one (or all) check(s) on the consistency of the installation.
</p>
<dl compact="compact">
<dt><strong>files</strong></dt>
-<dd><a name="tlmgr-files"></a>
+<dd><span id="tlmgr-files"></span>
<p>Checks that all files listed in the local TLPDB (<code>texlive.tlpdb</code>) are
actually present, and lists those missing.
</p>
</dd>
<dt><strong>depends</strong></dt>
-<dd><a name="tlmgr-depends"></a>
+<dd><span id="tlmgr-depends"></span>
<p>Lists those packages which occur as dependencies in an installed collection,
but are themselves not installed, and those packages which are not
contained in any collection.
@@ -4472,13 +4322,13 @@
</p>
</dd>
<dt><strong>executes</strong></dt>
-<dd><a name="tlmgr-executes"></a>
+<dd><span id="tlmgr-executes"></span>
<p>Check that the files referred to by <code>execute</code> directives in the TeX
Live Database are present.
</p>
</dd>
<dt><strong>runfiles</strong></dt>
-<dd><a name="tlmgr-runfiles"></a>
+<dd><span id="tlmgr-runfiles"></span>
<p>List those filenames that are occurring more than one time in the
runfiles sections.
</p>
@@ -4489,7 +4339,7 @@
</p>
<dl compact="compact">
<dt><strong>–use-svn</strong></dt>
-<dd><a name="tlmgr-_002d_002duse_002dsvn"></a>
+<dd><span id="tlmgr-_002d_002duse_002dsvn"></span>
<p>Use the output of <code>svn status</code> instead of listing the files; for
checking the TL development repository.
</p>
@@ -4497,20 +4347,18 @@
</dl>
<hr>
-<a name="tlmgr-conf"></a>
-<div class="header">
+<span id="tlmgr-conf"></span><div class="header">
<p>
Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="conf"></a>
-<h4 class="appendixsubsec">B.6.6 conf</h4>
+<span id="conf"></span><h4 class="appendixsubsec">B.6.6 conf</h4>
<dl compact="compact">
<dt><strong>conf [texmf|tlmgr|updmap [–conffile <em>file</em>] [–delete] [<em>key</em> [<em>value</em>]]]</strong></dt>
-<dd><a name="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></a>
+<dd><span id="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></span>
</dd>
<dt><strong>conf auxtrees [–conffile <em>file</em>] [show|add|delete] [<em>value</em>]</strong></dt>
-<dd><a name="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></a>
+<dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></span>
<p>With only <code>conf</code>, show general configuration information for TeX Live,
including active configuration files, path settings, and more. This is
like running <code>texconfig conf</code>, but works on all supported platforms.
@@ -4562,13 +4410,11 @@
</dl>
<hr>
-<a name="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></a>
-<div class="header">
+<span id="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><div class="header">
<p>
Next: <a href="#tlmgr-generate" accesskey="n" rel="next">tlmgr generate</a>, Previous: <a href="#tlmgr-conf" accesskey="p" rel="prev">tlmgr conf</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></a>
-<h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [–json]</h4>
+<span id="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [–json]</h4>
<p>Dump complete local or remote TLPDB to standard output, as-is. The
output is analogous to the <code>--machine-readable</code> output; see
@@ -4578,17 +4424,17 @@
</p>
<dl compact="compact">
<dt><strong>–local</strong></dt>
-<dd><a name="tlmgr-_002d_002dlocal"></a>
+<dd><span id="tlmgr-_002d_002dlocal"></span>
<p>Dump the local TLPDB.
</p>
</dd>
<dt><strong>–remote</strong></dt>
-<dd><a name="tlmgr-_002d_002dremote"></a>
+<dd><span id="tlmgr-_002d_002dremote"></span>
<p>Dump the remote TLPDB.
</p>
</dd>
<dt><strong>–json</strong></dt>
-<dd><a name="tlmgr-_002d_002djson"></a>
+<dd><span id="tlmgr-_002d_002djson"></span>
<p>Instead of dumping the actual content, the database is dumped as
JSON. For the format of JSON output see <code>tlpkg/doc/JSON-formats.txt</code>,
format definition <code>TLPDB</code>.
@@ -4609,26 +4455,24 @@
<p>Line endings may be either LF or CRLF depending on the current platform.
</p>
<hr>
-<a name="tlmgr-generate"></a>
-<div class="header">
+<span id="tlmgr-generate"></span><div class="header">
<p>
Next: <a href="#tlmgr-gui" accesskey="n" rel="next">tlmgr gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="p" rel="prev">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="generate"></a>
-<h4 class="appendixsubsec">B.6.8 generate</h4>
+<span id="generate"></span><h4 class="appendixsubsec">B.6.8 generate</h4>
<dl compact="compact">
<dt><strong>generate [<em>option</em>...] language</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></span>
</dd>
<dt><strong>generate [<em>option</em>...] language.dat</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></span>
</dd>
<dt><strong>generate [<em>option</em>...] language.def</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edef"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edef"></span>
</dd>
<dt><strong>generate [<em>option</em>...] language.dat.lua</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></span>
</dd>
</dl>
@@ -4693,7 +4537,7 @@
</p>
<dl compact="compact">
<dt><strong>–dest</strong> <em>output_file</em></dt>
-<dd><a name="tlmgr-_002d_002ddest-output_005ffile"></a>
+<dd><span id="tlmgr-_002d_002ddest-output_005ffile"></span>
<p>specifies the output file (defaults to the respective location in
<code>TEXMFSYSVAR</code>). If <code>--dest</code> is given to <code>generate language</code>, it
serves as a basename onto which <code>.dat</code> will be appended for the name of
@@ -4705,13 +4549,13 @@
</p>
</dd>
<dt><strong>–localcfg</strong> <em>local_conf_file</em></dt>
-<dd><a name="tlmgr-_002d_002dlocalcfg-local_005fconf_005ffile"></a>
+<dd><span id="tlmgr-_002d_002dlocalcfg-local_005fconf_005ffile"></span>
<p>specifies the (optional) local additions (defaults to the respective
location in <code>TEXMFLOCAL</code>).
</p>
</dd>
<dt><strong>–rebuild-sys</strong></dt>
-<dd><a name="tlmgr-_002d_002drebuild_002dsys"></a>
+<dd><span id="tlmgr-_002d_002drebuild_002dsys"></span>
<p>tells <code>tlmgr</code> to run necessary programs after config files have been
regenerated. These are:
<code>fmtutil-sys --all</code> after <code>generate fmtutil</code>,
@@ -4734,34 +4578,30 @@
tex/generic/config/language.dat.lua (and language-local.dat.lua)
</pre>
<hr>
-<a name="tlmgr-gui"></a>
-<div class="header">
+<span id="tlmgr-gui"></span><div class="header">
<p>
Next: <a href="#tlmgr-info" accesskey="n" rel="next">tlmgr info</a>, Previous: <a href="#tlmgr-generate" accesskey="p" rel="prev">tlmgr generate</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="gui"></a>
-<h4 class="appendixsubsec">B.6.9 gui</h4>
+<span id="gui"></span><h4 class="appendixsubsec">B.6.9 gui</h4>
<p>Start the graphical user interface. See <strong>GUI</strong> below.
</p>
<hr>
-<a name="tlmgr-info"></a>
-<div class="header">
+<span id="tlmgr-info"></span><div class="header">
<p>
Next: <a href="#tlmgr-init_002dusertree" accesskey="n" rel="next">tlmgr init-usertree</a>, Previous: <a href="#tlmgr-gui" accesskey="p" rel="prev">tlmgr gui</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="info"></a>
-<h4 class="appendixsubsec">B.6.10 info</h4>
+<span id="info"></span><h4 class="appendixsubsec">B.6.10 info</h4>
<dl compact="compact">
<dt><strong>info [<em>option</em>...] <em>pkg</em>...</strong></dt>
-<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span>
</dd>
<dt><strong>info [<em>option</em>...] collections</strong></dt>
-<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></a>
+<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></span>
</dd>
<dt><strong>info [<em>option</em>...] schemes</strong></dt>
-<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-schemes"></a>
+<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-schemes"></span>
<p>With no argument, lists all packages available at the package
repository, prefixing those already installed with <code>i</code>.
</p>
@@ -4796,7 +4636,7 @@
</p>
<dl compact="compact">
<dt><strong>–list</strong></dt>
-<dd><a name="tlmgr-_002d_002dlist"></a>
+<dd><span id="tlmgr-_002d_002dlist"></span>
<p>If the option <code>--list</code> is given with a package, the list of contained
files is also shown, including those for platform-specific dependencies.
When given with schemes and collections, <code>--list</code> outputs their
@@ -4804,13 +4644,13 @@
</p>
</dd>
<dt><strong>–only-installed</strong></dt>
-<dd><a name="tlmgr-_002d_002donly_002dinstalled"></a>
+<dd><span id="tlmgr-_002d_002donly_002dinstalled"></span>
<p>If this option is given, the installation source will not be used; only
locally installed packages, collections, or schemes are listed.
</p>
</dd>
<dt><strong>–data <code>item1,item2,...</code></strong></dt>
-<dd><a name="tlmgr-_002d_002ddata-item1_002citem2_002c_002e_002e_002e"></a>
+<dd><span id="tlmgr-_002d_002ddata-item1_002citem2_002c_002e_002e_002e"></span>
<p>If the option <code>--data</code> is given, its argument must be a comma separated
list of field names from: <code>name</code>, <code>category</code>, <code>localrev</code>, <code>remoterev</code>,
<code>shortdesc</code>, <code>longdesc</code>, <code>installed</code>, <code>size</code>, <code>relocatable</code>, <code>depends</code>,
@@ -4821,7 +4661,7 @@
</p>
</dd>
<dt><strong>–json</strong></dt>
-<dd><a name="tlmgr-_002d_002djson-1"></a>
+<dd><span id="tlmgr-_002d_002djson-1"></span>
<p>In case <code>--json</code> is specified, the output is a
JSON encoded array where each array element is the JSON representation of
a single <code>TLPOBJ</code> but with additional information. For details see
@@ -4835,13 +4675,11 @@
</dl>
<hr>
-<a name="tlmgr-init_002dusertree"></a>
-<div class="header">
+<span id="tlmgr-init_002dusertree"></span><div class="header">
<p>
Next: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info" accesskey="p" rel="prev">tlmgr info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="init_002dusertree"></a>
-<h4 class="appendixsubsec">B.6.11 init-usertree</h4>
+<span id="init_002dusertree"></span><h4 class="appendixsubsec">B.6.11 init-usertree</h4>
<p>Sets up a texmf tree for so-called user mode management, either the
default user tree (<code>TEXMFHOME</code>), or one specified on the command line
@@ -4848,13 +4686,11 @@
with <code>--usertree</code>. See <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
<hr>
-<a name="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<div class="header">
+<span id="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header">
<p>
Next: <a href="#tlmgr-key" accesskey="n" rel="next">tlmgr key</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">tlmgr init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.12 install [<em>option</em>...] <em>pkg</em>...</h4>
+<span id="install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><h4 class="appendixsubsec">B.6.12 install [<em>option</em>...] <em>pkg</em>...</h4>
<p>Install each <em>pkg</em> given on the command line, if it is not already
installed. (It does not touch existing packages; see the <code>update</code>
@@ -4865,13 +4701,13 @@
</p>
<dl compact="compact">
<dt><strong>–dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-1"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-1"></span>
<p>Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
</p>
</dd>
<dt><strong>–file</strong></dt>
-<dd><a name="tlmgr-_002d_002dfile"></a>
+<dd><span id="tlmgr-_002d_002dfile"></span>
<p>Instead of fetching a package from the installation repository, use
the package files given on the command line. These files must
be standard TeX Live package files (with contained tlpobj file).
@@ -4878,7 +4714,7 @@
</p>
</dd>
<dt><strong>–force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce"></a>
+<dd><span id="tlmgr-_002d_002dforce"></span>
<p>If updates to <code>tlmgr</code> itself (or other parts of the basic
infrastructure) are present, <code>tlmgr</code> will bail out and not perform the
installation unless this option is given. Not recommended.
@@ -4885,13 +4721,13 @@
</p>
</dd>
<dt><strong>–no-depends</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends"></span>
<p>Do not install dependencies. (By default, installing a package ensures
that all dependencies of this package are fulfilled.)
</p>
</dd>
<dt><strong>–no-depends-at-all</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall"></span>
<p>Normally, when you install a package which ships binary files the
respective binary package will also be installed. That is, for a
package <code>foo</code>, the package <code>foo.i386-linux</code> will also be installed on
@@ -4901,7 +4737,7 @@
</p>
</dd>
<dt><strong>–reinstall</strong></dt>
-<dd><a name="tlmgr-_002d_002dreinstall"></a>
+<dd><span id="tlmgr-_002d_002dreinstall"></span>
<p>Reinstall a package (including dependencies for collections) even if it
already seems to be installed (i.e, is present in the TLPDB). This is
useful to recover from accidental removal of files in the hierarchy.
@@ -4911,10 +4747,10 @@
</p>
</dd>
<dt><strong>–with-doc</strong></dt>
-<dd><a name="tlmgr-_002d_002dwith_002ddoc"></a>
+<dd><span id="tlmgr-_002d_002dwith_002ddoc"></span>
</dd>
<dt><strong>–with-src</strong></dt>
-<dd><a name="tlmgr-_002d_002dwith_002dsrc"></a>
+<dd><span id="tlmgr-_002d_002dwith_002dsrc"></span>
<p>While not recommended, the <code>install-tl</code> program provides an option to
omit installation of all documentation and/or source files. (By
default, everything is installed.) After such an installation, you may
@@ -4928,23 +4764,21 @@
</dl>
<hr>
-<a name="tlmgr-key"></a>
-<div class="header">
+<span id="tlmgr-key"></span><div class="header">
<p>
Next: <a href="#tlmgr-list" accesskey="n" rel="next">tlmgr list</a>, Previous: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="key"></a>
-<h4 class="appendixsubsec">B.6.13 key</h4>
+<span id="key"></span><h4 class="appendixsubsec">B.6.13 key</h4>
<dl compact="compact">
<dt><strong>key list</strong></dt>
-<dd><a name="tlmgr-key-list"></a>
+<dd><span id="tlmgr-key-list"></span>
</dd>
<dt><strong>key add <em>file</em></strong></dt>
-<dd><a name="tlmgr-key-add-file"></a>
+<dd><span id="tlmgr-key-add-file"></span>
</dd>
<dt><strong>key remove <em>keyid</em></strong></dt>
-<dd><a name="tlmgr-key-remove-keyid"></a>
+<dd><span id="tlmgr-key-remove-keyid"></span>
<p>The action <code>key</code> allows listing, adding and removing additional GPG
keys to the set of trusted keys, that is, those that are used to verify
the TeX Live databases.
@@ -4963,34 +4797,30 @@
</dl>
<hr>
-<a name="tlmgr-list"></a>
-<div class="header">
+<span id="tlmgr-list"></span><div class="header">
<p>
Next: <a href="#tlmgr-option" accesskey="n" rel="next">tlmgr option</a>, Previous: <a href="#tlmgr-key" accesskey="p" rel="prev">tlmgr key</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="list"></a>
-<h4 class="appendixsubsec">B.6.14 list</h4>
+<span id="list"></span><h4 class="appendixsubsec">B.6.14 list</h4>
<p>Synonym for <a href="#tlmgr-info">info</a>.
</p>
<hr>
-<a name="tlmgr-option"></a>
-<div class="header">
+<span id="tlmgr-option"></span><div class="header">
<p>
Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous: <a href="#tlmgr-list" accesskey="p" rel="prev">tlmgr list</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="option"></a>
-<h4 class="appendixsubsec">B.6.15 option</h4>
+<span id="option"></span><h4 class="appendixsubsec">B.6.15 option</h4>
<dl compact="compact">
<dt><strong>option [–json] [show]</strong></dt>
-<dd><a name="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></a>
+<dd><span id="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></span>
</dd>
<dt><strong>option [–json] showall</strong></dt>
-<dd><a name="tlmgr-option-_005b_002d_002djson_005d-showall"></a>
+<dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall"></span>
</dd>
<dt><strong>option <em>key</em> [<em>value</em>]</strong></dt>
-<dd><a name="tlmgr-option-key-_005bvalue_005d"></a>
+<dd><span id="tlmgr-option-key-_005bvalue_005d"></span>
</dd>
</dl>
@@ -5087,23 +4917,21 @@
instead of only the current user. All three options are on by default.
</p>
<hr>
-<a name="tlmgr-paper"></a>
-<div class="header">
+<span id="tlmgr-paper"></span><div class="header">
<p>
Next: <a href="#tlmgr-path" accesskey="n" rel="next">tlmgr path</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">tlmgr option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="paper"></a>
-<h4 class="appendixsubsec">B.6.16 paper</h4>
+<span id="paper"></span><h4 class="appendixsubsec">B.6.16 paper</h4>
<dl compact="compact">
<dt><strong>paper [a4|letter]</strong></dt>
-<dd><a name="tlmgr-paper-_005ba4_007cletter_005d"></a>
+<dd><span id="tlmgr-paper-_005ba4_007cletter_005d"></span>
</dd>
<dt><strong>[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|–list]<!-- /@w --></strong></dt>
-<dd><a name="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></a>
+<dd><span id="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></span>
</dd>
<dt><strong>paper –json</strong></dt>
-<dd><a name="tlmgr-paper-_002d_002djson"></a>
+<dd><span id="tlmgr-paper-_002d_002djson"></span>
</dd>
</dl>
@@ -5136,20 +4964,18 @@
settings.
</p>
<hr>
-<a name="tlmgr-path"></a>
-<div class="header">
+<span id="tlmgr-path"></span><div class="header">
<p>
Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">tlmgr pinning</a>, Previous: <a href="#tlmgr-paper" accesskey="p" rel="prev">tlmgr paper</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="path"></a>
-<h4 class="appendixsubsec">B.6.17 path</h4>
+<span id="path"></span><h4 class="appendixsubsec">B.6.17 path</h4>
<dl compact="compact">
<dt><strong>path [–w32mode=user|admin] add</strong></dt>
-<dd><a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></a>
+<dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></span>
</dd>
<dt><strong>path [–w32mode=user|admin] remove</strong></dt>
-<dd><a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></a>
+<dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></span>
<p>On Unix, merely adds or removes symlinks for binaries, man pages, and
info pages in the system directories specified by the respective options
(see the <a href="#tlmgr-option">option</a> description above). Does not change any
@@ -5179,36 +5005,34 @@
</dl>
<hr>
-<a name="tlmgr-pinning"></a>
-<div class="header">
+<span id="tlmgr-pinning"></span><div class="header">
<p>
Next: <a href="#tlmgr-platform" accesskey="n" rel="next">tlmgr platform</a>, Previous: <a href="#tlmgr-path" accesskey="p" rel="prev">tlmgr path</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="pinning"></a>
-<h4 class="appendixsubsec">B.6.18 pinning</h4>
+<span id="pinning"></span><h4 class="appendixsubsec">B.6.18 pinning</h4>
<p>The <code>pinning</code> action manages the pinning file, see <a href="#tlmgr-Pinning">Pinning</a> below.
</p>
<dl compact="compact">
<dt><code>pinning show</code></dt>
-<dd><a name="tlmgr-pinning-show"></a>
+<dd><span id="tlmgr-pinning-show"></span>
<p>Shows the current pinning data.
</p>
</dd>
<dt><code>pinning add</code> <em>repo</em> <em>pkgglob</em>...</dt>
-<dd><a name="tlmgr-pinning-add-repo-pkgglob_002e_002e_002e"></a>
+<dd><span id="tlmgr-pinning-add-repo-pkgglob_002e_002e_002e"></span>
<p>Pins the packages matching the <em>pkgglob</em>(s) to the repository
<em>repo</em>.
</p>
</dd>
<dt><code>pinning remove</code> <em>repo</em> <em>pkgglob</em>...</dt>
-<dd><a name="tlmgr-pinning-remove-repo-pkgglob_002e_002e_002e"></a>
+<dd><span id="tlmgr-pinning-remove-repo-pkgglob_002e_002e_002e"></span>
<p>Any packages recorded in the pinning file matching the <pkgglob>s for
the given repository <em>repo</em> are removed.
</p>
</dd>
<dt><code>pinning remove <em>repo</em> --all</code></dt>
-<dd><a name="tlmgr-pinning-remove-repo-_002d_002dall"></a>
+<dd><span id="tlmgr-pinning-remove-repo-_002d_002dall"></span>
<p>Remove all pinning data for repository <em>repo</em>.
</p>
</dd>
@@ -5215,23 +5039,21 @@
</dl>
<hr>
-<a name="tlmgr-platform"></a>
-<div class="header">
+<span id="tlmgr-platform"></span><div class="header">
<p>
Next: <a href="#tlmgr-postaction" accesskey="n" rel="next">tlmgr postaction</a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">tlmgr pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="platform"></a>
-<h4 class="appendixsubsec">B.6.19 platform</h4>
+<span id="platform"></span><h4 class="appendixsubsec">B.6.19 platform</h4>
<dl compact="compact">
<dt><strong>platform list|add|remove <em>platform</em>...</strong></dt>
-<dd><a name="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></a>
+<dd><span id="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></span>
</dd>
<dt><strong>platform set <em>platform</em></strong></dt>
-<dd><a name="tlmgr-platform-set-platform"></a>
+<dd><span id="tlmgr-platform-set-platform"></span>
</dd>
<dt><strong>platform set auto</strong></dt>
-<dd><a name="tlmgr-platform-set-auto"></a>
+<dd><span id="tlmgr-platform-set-auto"></span>
<p><code>platform list</code> lists the TeX Live names of all the platforms
(a.k.a. architectures), (<code>i386-linux</code>, ...) available at the package
repository.
@@ -5257,7 +5079,7 @@
</p>
<dl compact="compact">
<dt><strong>–dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-2"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-2"></span>
<p>Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
</p>
@@ -5268,20 +5090,18 @@
</dl>
<hr>
-<a name="tlmgr-postaction"></a>
-<div class="header">
+<span id="tlmgr-postaction"></span><div class="header">
<p>
Next: <a href="#tlmgr-print_002dplatform" accesskey="n" rel="next">tlmgr print-platform</a>, Previous: <a href="#tlmgr-platform" accesskey="p" rel="prev">tlmgr platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="postaction"></a>
-<h4 class="appendixsubsec">B.6.20 postaction</h4>
+<span id="postaction"></span><h4 class="appendixsubsec">B.6.20 postaction</h4>
<dl compact="compact">
<dt><strong>postaction [<em>option</em>...] install [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt>
-<dd><a name="tlmgr-postaction-_005boption_002e_002e_002e_005d-install-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-postaction-_005boption_002e_002e_002e_005d-install-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></span>
</dd>
<dt><strong>postaction [<em>option</em>...] remove [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt>
-<dd><a name="tlmgr-postaction-_005boption_002e_002e_002e_005d-remove-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-postaction-_005boption_002e_002e_002e_005d-remove-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></span>
<p>Carry out the postaction <code>shortcut</code>, <code>fileassoc</code>, or <code>script</code> given
as the second required argument in install or remove mode (which is the
first required argument), for either the packages given on the command
@@ -5291,7 +5111,7 @@
</p>
<dl compact="compact">
<dt><strong>–w32mode=[user|admin]</strong></dt>
-<dd><a name="tlmgr-_002d_002dw32mode_003d_005buser_007cadmin_005d"></a>
+<dd><span id="tlmgr-_002d_002dw32mode_003d_005buser_007cadmin_005d"></span>
<p>If the option <code>--w32mode</code> is given the value <code>user</code>, all actions will
only be carried out in the user-accessible parts of the
registry/filesystem, while the value <code>admin</code> selects the system-wide
@@ -5300,7 +5120,7 @@
</p>
</dd>
<dt><strong>–fileassocmode=[1|2]</strong></dt>
-<dd><a name="tlmgr-_002d_002dfileassocmode_003d_005b1_007c2_005d"></a>
+<dd><span id="tlmgr-_002d_002dfileassocmode_003d_005b1_007c2_005d"></span>
<p><code>--fileassocmode</code> specifies the action for file associations. If it is
set to 1 (the default), only new associations are added; if it is set to
2, all associations are set to the TeX Live programs. (See also
@@ -5308,7 +5128,7 @@
</p>
</dd>
<dt><strong>–all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-1"></a>
+<dd><span id="tlmgr-_002d_002dall-1"></span>
<p>Carry out the postactions for all packages
</p>
</dd>
@@ -5318,13 +5138,11 @@
</dl>
<hr>
-<a name="tlmgr-print_002dplatform"></a>
-<div class="header">
+<span id="tlmgr-print_002dplatform"></span><div class="header">
<p>
Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">tlmgr print-platform-info</a>, Previous: <a href="#tlmgr-postaction" accesskey="p" rel="prev">tlmgr postaction</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="print_002dplatform"></a>
-<h4 class="appendixsubsec">B.6.21 print-platform</h4>
+<span id="print_002dplatform"></span><h4 class="appendixsubsec">B.6.21 print-platform</h4>
<p>Print the TeX Live identifier for the detected platform
(hardware/operating system) combination to standard output, and exit.
@@ -5331,25 +5149,21 @@
<code>--print-arch</code> is a synonym.
</p>
<hr>
-<a name="tlmgr-print_002dplatform_002dinfo"></a>
-<div class="header">
+<span id="tlmgr-print_002dplatform_002dinfo"></span><div class="header">
<p>
Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">tlmgr print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="print_002dplatform_002dinfo"></a>
-<h4 class="appendixsubsec">B.6.22 print-platform-info</h4>
+<span id="print_002dplatform_002dinfo"></span><h4 class="appendixsubsec">B.6.22 print-platform-info</h4>
<p>Print the TeX Live platform identifier, TL platform long name, and
original output from guess.
</p>
<hr>
-<a name="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<div class="header">
+<span id="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header">
<p>
Next: <a href="#tlmgr-repository" accesskey="n" rel="next">tlmgr repository</a>, Previous: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="p" rel="prev">tlmgr print-platform-info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</h4>
+<span id="remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><h4 class="appendixsubsec">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</h4>
<p>Remove each <em>pkg</em> specified. Removing a collection removes all package
dependencies (unless <code>--no-depends</code> is specified), but not any
@@ -5358,16 +5172,16 @@
</p>
<dl compact="compact">
<dt><strong>–all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-2"></a>
+<dd><span id="tlmgr-_002d_002dall-2"></span>
<p>Uninstalls all of TeX Live, asking for confirmation unless <code>--force</code> is
also specified.
</p>
</dd>
<dt><strong>–backup</strong></dt>
-<dd><a name="tlmgr-_002d_002dbackup"></a>
+<dd><span id="tlmgr-_002d_002dbackup"></span>
</dd>
<dt><strong>–backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-1"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory-1"></span>
<p>These options behave just as with the <a href="update.html#tlmgr-update-_005boption_002e_002e_002e_005d-_005b_002e_002e_002e_005d">(update)update</a> action (q.v.), except they apply to making
backups of packages before they are removed. The default is to make
such a backup, that is, to save a copy of packages before removal.
@@ -5376,17 +5190,17 @@
</p>
</dd>
<dt><strong>–no-depends</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends-1"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends-1"></span>
<p>Do not remove dependent packages.
</p>
</dd>
<dt><strong>–no-depends-at-all</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall-1"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall-1"></span>
<p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware).
</p>
</dd>
<dt><strong>–force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-1"></a>
+<dd><span id="tlmgr-_002d_002dforce-1"></span>
<p>By default, removal of a package or collection that is a dependency of
another collection or scheme is not allowed. With this option, the
package will be removed unconditionally. Use with care.
@@ -5398,7 +5212,7 @@
</p>
</dd>
<dt><strong>–dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-3"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-3"></span>
<p>Nothing is actually removed; instead, the actions to be performed are
written to the terminal.
</p>
@@ -5406,29 +5220,27 @@
</dl>
<hr>
-<a name="tlmgr-repository"></a>
-<div class="header">
+<span id="tlmgr-repository"></span><div class="header">
<p>
Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previous: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="repository"></a>
-<h4 class="appendixsubsec">B.6.24 repository</h4>
+<span id="repository"></span><h4 class="appendixsubsec">B.6.24 repository</h4>
<dl compact="compact">
<dt><strong>repository list</strong></dt>
-<dd><a name="tlmgr-repository-list"></a>
+<dd><span id="tlmgr-repository-list"></span>
</dd>
<dt><strong>repository list <em>path|tag</em></strong></dt>
-<dd><a name="tlmgr-repository-list-path_007ctag"></a>
+<dd><span id="tlmgr-repository-list-path_007ctag"></span>
</dd>
<dt><strong>repository add <em>path</em> [<em>tag</em>]</strong></dt>
-<dd><a name="tlmgr-repository-add-path-_005btag_005d"></a>
+<dd><span id="tlmgr-repository-add-path-_005btag_005d"></span>
</dd>
<dt><strong>repository remove <em>path|tag</em></strong></dt>
-<dd><a name="tlmgr-repository-remove-path_007ctag"></a>
+<dd><span id="tlmgr-repository-remove-path_007ctag"></span>
</dd>
<dt><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></dt>
-<dd><a name="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></span>
<p>This action manages the list of repositories. See <a href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
</p>
<p>The first form (<code>list</code>) lists all configured repositories and the
@@ -5452,20 +5264,18 @@
</dl>
<hr>
-<a name="tlmgr-restore"></a>
-<div class="header">
+<span id="tlmgr-restore"></span><div class="header">
<p>
Next: <a href="#tlmgr-search" accesskey="n" rel="next">tlmgr search</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">tlmgr repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="restore"></a>
-<h4 class="appendixsubsec">B.6.25 restore</h4>
+<span id="restore"></span><h4 class="appendixsubsec">B.6.25 restore</h4>
<dl compact="compact">
<dt><strong>restore [<em>option</em>...] <em>pkg</em> [<em>rev</em>]</strong></dt>
-<dd><a name="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></a>
+<dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></span>
</dd>
<dt><strong>restore [<em>option</em>...] –all</strong></dt>
-<dd><a name="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></a>
+<dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></span>
<p>Restore a package from a previously-made backup.
</p>
<p>If <code>--all</code> is given, try to restore the latest revision of all
@@ -5485,7 +5295,7 @@
</p>
<dl compact="compact">
<dt><strong>–all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-3"></a>
+<dd><span id="tlmgr-_002d_002dall-3"></span>
<p>Try to restore the latest revision of all package backups found in the
backup directory. Additional non-option arguments (like <em>pkg</em>) are not
allowed.
@@ -5492,24 +5302,24 @@
</p>
</dd>
<dt><strong>–backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-2"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory-2"></span>
<p>Specify the directory where the backups are to be found. If not given it
will be taken from the configuration setting in the TLPDB.
</p>
</dd>
<dt><strong>–dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-4"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-4"></span>
<p>Nothing is actually restored; instead, the actions to be performed are
written to the terminal.
</p>
</dd>
<dt><strong>–force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-2"></a>
+<dd><span id="tlmgr-_002d_002dforce-2"></span>
<p>Don’t ask questions.
</p>
</dd>
<dt><strong>–json</strong></dt>
-<dd><a name="tlmgr-_002d_002djson-2"></a>
+<dd><span id="tlmgr-_002d_002djson-2"></span>
<p>When listing backups, the option <code>--json</code> turn on JSON output.
The format is an array of JSON objects (<code>name</code>, <code>rev</code>, <code>date</code>).
For details see <code>tlpkg/doc/JSON-formats.txt</code>, format definition: <code>TLBACKUPS</code>.
@@ -5522,23 +5332,21 @@
</dl>
<hr>
-<a name="tlmgr-search"></a>
-<div class="header">
+<span id="tlmgr-search"></span><div class="header">
<p>
Next: <a href="#tlmgr-shell" accesskey="n" rel="next">tlmgr shell</a>, Previous: <a href="#tlmgr-restore" accesskey="p" rel="prev">tlmgr restore</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="search"></a>
-<h4 class="appendixsubsec">B.6.26 search</h4>
+<span id="search"></span><h4 class="appendixsubsec">B.6.26 search</h4>
<dl compact="compact">
<dt><strong>search [<em>option</em>...] <em>what</em></strong></dt>
-<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-what"></a>
+<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-what"></span>
</dd>
<dt><strong>search [<em>option</em>...] –file <em>what</em></strong></dt>
-<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></a>
+<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></span>
</dd>
<dt><strong>search [<em>option</em>...] –all <em>what</em></strong></dt>
-<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></a>
+<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></span>
<p>By default, search the names, short descriptions, and long descriptions
of all locally installed packages for the argument <em>what</em>, interpreted
as a (Perl) regular expression.
@@ -5547,23 +5355,23 @@
</p>
<dl compact="compact">
<dt><strong>–file</strong></dt>
-<dd><a name="tlmgr-_002d_002dfile-1"></a>
+<dd><span id="tlmgr-_002d_002dfile-1"></span>
<p>List all filenames containing <em>what</em>.
</p>
</dd>
<dt><strong>–all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-4"></a>
+<dd><span id="tlmgr-_002d_002dall-4"></span>
<p>Search everything: package names, descriptions and filenames.
</p>
</dd>
<dt><strong>–global</strong></dt>
-<dd><a name="tlmgr-_002d_002dglobal"></a>
+<dd><span id="tlmgr-_002d_002dglobal"></span>
<p>Search the TeX Live Database of the installation medium, instead of the
local installation.
</p>
</dd>
<dt><strong>–word</strong></dt>
-<dd><a name="tlmgr-_002d_002dword"></a>
+<dd><span id="tlmgr-_002d_002dword"></span>
<p>Restrict the search of package names and descriptions (but not
filenames) to match only full words. For example, searching for
<code>table</code> with this option will not output packages containing the word
@@ -5576,13 +5384,11 @@
</dl>
<hr>
-<a name="tlmgr-shell"></a>
-<div class="header">
+<span id="tlmgr-shell"></span><div class="header">
<p>
Next: <a href="#tlmgr-show" accesskey="n" rel="next">tlmgr show</a>, Previous: <a href="#tlmgr-search" accesskey="p" rel="prev">tlmgr search</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="shell"></a>
-<h4 class="appendixsubsec">B.6.27 shell</h4>
+<span id="shell"></span><h4 class="appendixsubsec">B.6.27 shell</h4>
<p>Starts an interactive mode, where tlmgr prompts for commands. This can
be used directly, or for scripting. The first line of output is
@@ -5599,43 +5405,43 @@
</p>
<dl compact="compact">
<dt>protocol</dt>
-<dd><a name="tlmgr-protocol"></a>
+<dd><span id="tlmgr-protocol"></span>
<p>Print <code>protocol <em>n</em></code>, the current protocol version.
</p>
</dd>
<dt>help</dt>
-<dd><a name="tlmgr-help-1"></a>
+<dd><span id="tlmgr-help-1"></span>
<p>Print pointers to this documentation.
</p>
</dd>
<dt>version</dt>
-<dd><a name="tlmgr-version-1"></a>
+<dd><span id="tlmgr-version-1"></span>
<p>Print tlmgr version information.
</p>
</dd>
<dt>quit, end, bye, byebye, EOF</dt>
-<dd><a name="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></a>
+<dd><span id="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></span>
<p>Exit.
</p>
</dd>
<dt>restart</dt>
-<dd><a name="tlmgr-restart"></a>
+<dd><span id="tlmgr-restart"></span>
<p>Restart <code>tlmgr shell</code> with the original command line; most useful when
developing <code>tlmgr</code>.
</p>
</dd>
<dt>load [local|remote]</dt>
-<dd><a name="tlmgr-load-_005blocal_007cremote_005d"></a>
+<dd><span id="tlmgr-load-_005blocal_007cremote_005d"></span>
<p>Explicitly load the local or remote, respectively, TLPDB.
</p>
</dd>
<dt>save</dt>
-<dd><a name="tlmgr-save"></a>
+<dd><span id="tlmgr-save"></span>
<p>Save the local TLPDB, presumably after other operations have changed it.
</p>
</dd>
<dt>get [<em>var</em>] =item set [<em>var</em> [<em>val</em>]]</dt>
-<dd><a name="tlmgr-get-_005bvar_005d-_003ditem-set-_005bvar-_005bval_005d_005d"></a>
+<dd><span id="tlmgr-get-_005bvar_005d-_003ditem-set-_005bvar-_005bval_005d_005d"></span>
<p>Get the value of <em>var</em>, or set it to <em>val</em>. Possible <em>var</em> names:
<code>debug-translation</code>, <code>machine-readable</code>, <code>no-execute-actions</code>,
<code>require-verification</code>, <code>verify-downloads</code>, <code>repository</code>, and
@@ -5651,35 +5457,29 @@
</dl>
<hr>
-<a name="tlmgr-show"></a>
-<div class="header">
+<span id="tlmgr-show"></span><div class="header">
<p>
Next: <a href="#tlmgr-uninstall" accesskey="n" rel="next">tlmgr uninstall</a>, Previous: <a href="#tlmgr-shell" accesskey="p" rel="prev">tlmgr shell</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="show"></a>
-<h4 class="appendixsubsec">B.6.28 show</h4>
+<span id="show"></span><h4 class="appendixsubsec">B.6.28 show</h4>
<p>Synonym for <a href="#tlmgr-info">info</a>.
</p>
<hr>
-<a name="tlmgr-uninstall"></a>
-<div class="header">
+<span id="tlmgr-uninstall"></span><div class="header">
<p>
Next: <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" accesskey="n" rel="next">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-show" accesskey="p" rel="prev">tlmgr show</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="uninstall"></a>
-<h4 class="appendixsubsec">B.6.29 uninstall</h4>
+<span id="uninstall"></span><h4 class="appendixsubsec">B.6.29 uninstall</h4>
<p>Synonym for <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">remove</a>.
</p>
<hr>
-<a name="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></a>
-<div class="header">
+<span id="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><div class="header">
<p>
Previous: <a href="#tlmgr-uninstall" accesskey="p" rel="prev">tlmgr uninstall</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></a>
-<h4 class="appendixsubsec">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</h4>
+<span id="update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><h4 class="appendixsubsec">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</h4>
<p>Updates the packages given as arguments to the latest version available
at the installation source. Either <code>--all</code> or at least one <em>pkg</em> name
@@ -5687,7 +5487,7 @@
</p>
<dl compact="compact">
<dt><strong>–all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-5"></a>
+<dd><span id="tlmgr-_002d_002dall-5"></span>
<p>Update all installed packages except for <code>tlmgr</code> itself. Thus, if
updates to <code>tlmgr</code> itself are present, this will simply give an error,
unless also the option <code>--force</code> or <code>--self</code> is given. (See below.)
@@ -5720,7 +5520,7 @@
</p>
</dd>
<dt><strong>–self</strong></dt>
-<dd><a name="tlmgr-_002d_002dself"></a>
+<dd><span id="tlmgr-_002d_002dself"></span>
<p>Update <code>tlmgr</code> itself (that is, the infrastructure packages) if updates
to it are present. On Windows this includes updates to the private Perl
interpreter shipped inside TeX Live.
@@ -5739,13 +5539,13 @@
</pre>
</dd>
<dt><strong>–dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-5"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-5"></span>
<p>Nothing is actually installed; instead, the actions to be performed are
written to the terminal. This is a more detailed report than <code>--list</code>.
</p>
</dd>
<dt><strong>–list</strong> [<em>pkg</em>]</dt>
-<dd><a name="tlmgr-_002d_002dlist-_005bpkg_005d"></a>
+<dd><span id="tlmgr-_002d_002dlist-_005bpkg_005d"></span>
<p>Concisely list the packages which would be updated, newly installed, or
removed, without actually changing anything.
If <code>--all</code> is also given, all available updates are listed.
@@ -5760,7 +5560,7 @@
</p>
</dd>
<dt><strong>–exclude</strong> <em>pkg</em></dt>
-<dd><a name="tlmgr-_002d_002dexclude-pkg"></a>
+<dd><span id="tlmgr-_002d_002dexclude-pkg"></span>
<p>Exclude <em>pkg</em> from the update process. If this option is given more
than once, its arguments accumulate.
</p>
@@ -5782,7 +5582,7 @@
</p>
</dd>
<dt><strong>–no-auto-remove</strong> [<em>pkg</em>...]</dt>
-<dd><a name="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></span>
<p>By default, <code>tlmgr</code> tries to remove packages which have disappeared on
the server, as described above under <code>--all</code>. This option prevents
such removals, either for all packages (with <code>--all</code>), or for just the
@@ -5792,7 +5592,7 @@
</p>
</dd>
<dt><strong>–no-auto-install</strong> [<em>pkg</em>...]</dt>
-<dd><a name="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_002e_002e_002e_005d"></span>
<p>Under normal circumstances <code>tlmgr</code> will install packages which are new
on the server, as described above under <code>--all</code>. This option prevents
any such automatic installation, either for all packages (with
@@ -5812,7 +5612,7 @@
</pre>
</dd>
<dt><strong>–reinstall-forcibly-removed</strong></dt>
-<dd><a name="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></a>
+<dd><span id="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></span>
<p>Under normal circumstances <code>tlmgr</code> will not install packages that have
been forcibly removed by the user; that is, removed with <code>remove
--force</code>, or whose installation was prohibited by <code>--no-auto-install</code>
@@ -5826,10 +5626,10 @@
</pre>
</dd>
<dt><strong>–backup</strong></dt>
-<dd><a name="tlmgr-_002d_002dbackup-1"></a>
+<dd><span id="tlmgr-_002d_002dbackup-1"></span>
</dd>
<dt><strong>–backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-3"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory-3"></span>
<p>These two options control the creation of backups of packages <em>before</em>
updating; that is, backup of packages as currently installed. If
neither options is given, no backup will made. If <code>--backupdir</code> is
@@ -5852,7 +5652,7 @@
</p>
</dd>
<dt><strong>–no-depends</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends-2"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends-2"></span>
<p>If you call for updating a package normally all depending packages
will also be checked for updates and updated if necessary. This switch
suppresses this behavior.
@@ -5859,12 +5659,12 @@
</p>
</dd>
<dt><strong>–no-depends-at-all</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall-2"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall-2"></span>
<p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware).
</p>
</dd>
<dt><strong>–force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-3"></a>
+<dd><span id="tlmgr-_002d_002dforce-3"></span>
<p>Force update of normal packages, without updating <code>tlmgr</code> itself
(unless the <code>--self</code> option is also given). Not recommended.
</p>
@@ -5885,13 +5685,11 @@
a possibly different hash), it’s harmless to delete them.
</p>
<hr>
-<a name="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></a>
-<div class="header">
+<span id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></span><div class="header">
<p>
Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">tlmgr ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="CONFIGURATION-FILE-FOR-TLMGR"></a>
-<h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3>
+<span id="CONFIGURATION-FILE-FOR-TLMGR"></span><h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3>
<p>There are two configuration files for <code>tlmgr</code>: One is system-wide in
<code>TEXMFSYSCONFIG/tlmgr/config</code>, and the other is user-specific in
@@ -5915,28 +5713,28 @@
</p>
<dl compact="compact">
<dt><code>auto-remove</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><a name="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
<dt><code>gui-expertmode</code>, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.</dt>
-<dd><a name="tlmgr-gui_002dexpertmode_002c-value-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></a>
+<dd><span id="tlmgr-gui_002dexpertmode_002c-value-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></span>
</dd>
<dt><code>gui-lang</code> <em>llcode</em>, with a language code value as with the command-line option.</dt>
-<dd><a name="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></span>
</dd>
<dt><code>no-checksums</code>, value 0 or 1 (default 0, see below).</dt>
-<dd><a name="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></a>
+<dd><span id="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></span>
</dd>
<dt><code>persistent-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><a name="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
<dt><code>require-verification</code>, value 0 or 1 (default 0), same as command-line option.</dt>
-<dd><a name="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
<dt><code>update-exclude</code>, value: comma-separated list of packages (no space allowed). Same as the command line option <code>--exclude</code> for the action <code>update</code>.</dt>
-<dd><a name="tlmgr-update_002dexclude_002c-value_003a-comma_002dseparated-list-of-packages-_0028no-space-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-action-update_002e"></a>
+<dd><span id="tlmgr-update_002dexclude_002c-value_003a-comma_002dseparated-list-of-packages-_0028no-space-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-action-update_002e"></span>
</dd>
<dt><code>verify-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><a name="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
</dl>
@@ -5944,7 +5742,7 @@
</p>
<dl compact="compact">
<dt><code>allowed-actions</code> <em>action1</em> [,<em>action</em>,...] The value is a comma-separated list of <code>tlmgr</code> actions which are allowed to be executed when <code>tlmgr</code> is invoked in system mode (that is, without <code>--usermode</code>).</dt>
-<dd><a name="tlmgr-allowed_002dactions-action1-_005b_002caction_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e"></a>
+<dd><span id="tlmgr-allowed_002dactions-action1-_005b_002caction_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e"></span>
<p>This allows distributors to include the <code>tlmgr</code> in their packaging, but
allow only a restricted set of actions that do not interfere with their
distro package manager. For native TeX Live installations, it doesn’t
@@ -5969,13 +5767,11 @@
context.) <code>no-checksums</code> avoids the warning.
</p>
<hr>
-<a name="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></a>
-<div class="header">
+<span id="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></span><div class="header">
<p>
Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">tlmgr USER MODE</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="CRYPTOGRAPHIC-VERIFICATION"></a>
-<h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3>
+<span id="CRYPTOGRAPHIC-VERIFICATION"></span><h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3>
<p><code>tlmgr</code> and <code>install-tl</code> perform cryptographic verification if
possible. If verification is performed and successful, the programs
@@ -6013,18 +5809,16 @@
<p>Additional trusted keys can be added using the <code>key</code> action.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">tlmgr Configuration of GnuPG invocation</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">tlmgr Configuration of GnuPG invocation</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-Configuration-of-GnuPG-invocation"></a>
-<div class="header">
+<span id="tlmgr-Configuration-of-GnuPG-invocation"></span><div class="header">
<p>
Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">tlmgr CRYPTOGRAPHIC VERIFICATION</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configuration-of-GnuPG-invocation"></a>
-<h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4>
+<span id="Configuration-of-GnuPG-invocation"></span><h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4>
<p>The executable used for GnuPG is searched as follows: If the environment
variable <code>TL_GNUPG</code> is set, it is tested and used; otherwise <code>gpg</code> is
@@ -6036,13 +5830,11 @@
options <code>--no-secmem-warning --no-permission-warning</code>.
</p>
<hr>
-<a name="tlmgr-USER-MODE"></a>
-<div class="header">
+<span id="tlmgr-USER-MODE"></span><div class="header">
<p>
Next: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">tlmgr MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="p" rel="prev">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="USER-MODE"></a>
-<h3 class="appendixsec">B.9 USER MODE</h3>
+<span id="USER-MODE"></span><h3 class="appendixsec">B.9 USER MODE</h3>
<p><code>tlmgr</code> provides a restricted way, called “user mode”, to manage
arbitrary texmf trees in the same way as the main installation. For
@@ -6097,22 +5889,20 @@
<p>Description of changes of actions in user mode:
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-install" accesskey="1">tlmgr User mode install</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-install" accesskey="1">tlmgr User mode install</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">tlmgr User mode backup, restore, remove, update</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">tlmgr User mode backup, restore, remove, update</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">tlmgr User mode generate, option, paper</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">tlmgr User mode generate, option, paper</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-User-mode-install"></a>
-<div class="header">
+<span id="tlmgr-User-mode-install"></span><div class="header">
<p>
Next: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="n" rel="next">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User-mode-install"></a>
-<h4 class="appendixsubsec">B.9.1 User mode install</h4>
+<span id="User-mode-install"></span><h4 class="appendixsubsec">B.9.1 User mode install</h4>
<p>In user mode, the <code>install</code> action checks that the package and all
dependencies are all either relocated or already installed in the system
@@ -6133,13 +5923,11 @@
regenerated from the list of installed packages.
</p>
<hr>
-<a name="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></a>
-<div class="header">
+<span id="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></span><div class="header">
<p>
Next: <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="n" rel="next">tlmgr User mode generate, option, paper</a>, Previous: <a href="#tlmgr-User-mode-install" accesskey="p" rel="prev">tlmgr User mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User-mode-backup_002c-restore_002c-remove_002c-update"></a>
-<h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4>
+<span id="User-mode-backup_002c-restore_002c-remove_002c-update"></span><h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4>
<p>In user mode, these actions check that all packages to be acted on are
installed in the user tree before proceeding; otherwise, they behave
@@ -6146,13 +5934,11 @@
just as in normal mode.
</p>
<hr>
-<a name="tlmgr-User-mode-generate_002c-option_002c-paper"></a>
-<div class="header">
+<span id="tlmgr-User-mode-generate_002c-option_002c-paper"></span><div class="header">
<p>
Previous: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="p" rel="prev">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User-mode-generate_002c-option_002c-paper"></a>
-<h4 class="appendixsubsec">B.9.3 User mode generate, option, paper</h4>
+<span id="User-mode-generate_002c-option_002c-paper"></span><h4 class="appendixsubsec">B.9.3 User mode generate, option, paper</h4>
<p>In user mode, these actions operate only on the user tree’s
configuration files and/or <code>texlive.tlpdb</code>.
@@ -6159,13 +5945,11 @@
creates configuration files in user tree
</p>
<hr>
-<a name="tlmgr-MULTIPLE-REPOSITORIES"></a>
-<div class="header">
+<span id="tlmgr-MULTIPLE-REPOSITORIES"></span><div class="header">
<p>
Next: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">tlmgr GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">tlmgr USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="MULTIPLE-REPOSITORIES"></a>
-<h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3>
+<span id="MULTIPLE-REPOSITORIES"></span><h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3>
<p>The main TeX Live repository contains a vast array of packages.
Nevertheless, additional local repositories can be useful to provide
@@ -6197,18 +5981,16 @@
rules, described next.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-Pinning" accesskey="1">tlmgr Pinning</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Pinning" accesskey="1">tlmgr Pinning</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-Pinning"></a>
-<div class="header">
+<span id="tlmgr-Pinning"></span><div class="header">
<p>
Up: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="u" rel="up">tlmgr MULTIPLE REPOSITORIES</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Pinning"></a>
-<h4 class="appendixsubsec">B.10.1 Pinning</h4>
+<span id="Pinning"></span><h4 class="appendixsubsec">B.10.1 Pinning</h4>
<p>When a package <code>foo</code> is pinned to a repository, a package <code>foo</code> in any
other repository, even if it has a higher revision number, will not be
@@ -6271,13 +6053,11 @@
<p>A summary of the <code>tlmgr pinning</code> actions is given above.
</p>
<hr>
-<a name="tlmgr-GUI-FOR-TLMGR"></a>
-<div class="header">
+<span id="tlmgr-GUI-FOR-TLMGR"></span><div class="header">
<p>
Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">tlmgr MACHINE-READABLE OUTPUT</a>, Previous: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="p" rel="prev">tlmgr MULTIPLE REPOSITORIES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="GUI-FOR-TLMGR"></a>
-<h3 class="appendixsec">B.11 GUI FOR TLMGR</h3>
+<span id="GUI-FOR-TLMGR"></span><h3 class="appendixsec">B.11 GUI FOR TLMGR</h3>
<p>The graphical user interface for <code>tlmgr</code> requires Perl/Tk
<a href="http://search.cpan.org/search?query=perl%2Ftk">http://search.cpan.org/search?query=perl%2Ftk</a>. For Windows the
@@ -6302,40 +6082,36 @@
information about what is going on.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-Main-display" accesskey="1">tlmgr Main display</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Main-display" accesskey="1">tlmgr Main display</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-Menu-bar" accesskey="2">tlmgr Menu bar</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Menu-bar" accesskey="2">tlmgr Menu bar</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-GUI-options" accesskey="3">tlmgr GUI options</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-GUI-options" accesskey="3">tlmgr GUI options</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-Main-display"></a>
-<div class="header">
+<span id="tlmgr-Main-display"></span><div class="header">
<p>
Next: <a href="#tlmgr-Menu-bar" accesskey="n" rel="next">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Main-display"></a>
-<h4 class="appendixsubsec">B.11.1 Main display</h4>
+<span id="Main-display"></span><h4 class="appendixsubsec">B.11.1 Main display</h4>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-Display-configuration-area" accesskey="1">tlmgr Display configuration area</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Display-configuration-area" accesskey="1">tlmgr Display configuration area</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-Package-list-area" accesskey="2">tlmgr Package list area</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Package-list-area" accesskey="2">tlmgr Package list area</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-Main-display-action-buttons" accesskey="3">tlmgr Main display action buttons</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Main-display-action-buttons" accesskey="3">tlmgr Main display action buttons</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-Display-configuration-area"></a>
-<div class="header">
+<span id="tlmgr-Display-configuration-area"></span><div class="header">
<p>
Next: <a href="#tlmgr-Package-list-area" accesskey="n" rel="next">tlmgr Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Display-configuration-area"></a>
-<h4 class="appendixsubsubsec">B.11.1.1 Display configuration area</h4>
+<span id="Display-configuration-area"></span><h4 class="appendixsubsubsec">B.11.1.1 Display configuration area</h4>
<p>The first part of the main display allows you to specify (filter) which
packages are shown. By default, all are shown. Changes here are
@@ -6343,13 +6119,13 @@
</p>
<dl compact="compact">
<dt>Status</dt>
-<dd><a name="tlmgr-Status"></a>
+<dd><span id="tlmgr-Status"></span>
<p>Select whether to show all packages (the default), only those installed,
only those <em>not</em> installed, or only those with update available.
</p>
</dd>
<dt>Category</dt>
-<dd><a name="tlmgr-Category"></a>
+<dd><span id="tlmgr-Category"></span>
<p>Select which categories are shown: packages, collections, and/or
schemes. These are briefly explained in the <a href="#tlmgr-DESCRIPTION">DESCRIPTION</a> section
above.
@@ -6356,7 +6132,7 @@
</p>
</dd>
<dt>Match</dt>
-<dd><a name="tlmgr-Match"></a>
+<dd><span id="tlmgr-Match"></span>
<p>Select packages matching for a specific pattern. By default, this
searches both descriptions and filenames. You can also select a subset
for searching.
@@ -6363,7 +6139,7 @@
</p>
</dd>
<dt>Selection</dt>
-<dd><a name="tlmgr-Selection"></a>
+<dd><span id="tlmgr-Selection"></span>
<p>Select packages to those selected, those not selected, or all. Here,
“selected” means that the checkbox in the beginning of the line of a
package is ticked.
@@ -6370,7 +6146,7 @@
</p>
</dd>
<dt>Display configuration buttons</dt>
-<dd><a name="tlmgr-Display-configuration-buttons"></a>
+<dd><span id="tlmgr-Display-configuration-buttons"></span>
<p>To the right there are three buttons: select all packages, select none
(a.k.a. deselect all), and reset all these filters to the defaults,
i.e., show all available.
@@ -6379,13 +6155,11 @@
</dl>
<hr>
-<a name="tlmgr-Package-list-area"></a>
-<div class="header">
+<span id="tlmgr-Package-list-area"></span><div class="header">
<p>
Next: <a href="#tlmgr-Main-display-action-buttons" accesskey="n" rel="next">tlmgr Main display action buttons</a>, Previous: <a href="#tlmgr-Display-configuration-area" accesskey="p" rel="prev">tlmgr Display configuration area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Package-list-area"></a>
-<h4 class="appendixsubsubsec">B.11.1.2 Package list area</h4>
+<span id="Package-list-area"></span><h4 class="appendixsubsubsec">B.11.1.2 Package list area</h4>
<p>The second are of the main display lists all installed packages. If a
repository is loaded, those that are available but not installed are
@@ -6398,18 +6172,18 @@
</p>
<dl compact="compact">
<dt>a checkbox</dt>
-<dd><a name="tlmgr-a-checkbox"></a>
+<dd><span id="tlmgr-a-checkbox"></span>
<p>Used to select particular packages; some of the action buttons (see
below) work only on the selected packages.
</p>
</dd>
<dt>package name</dt>
-<dd><a name="tlmgr-package-name"></a>
+<dd><span id="tlmgr-package-name"></span>
<p>The name (identifier) of the package as given in the database.
</p>
</dd>
<dt>local revision (and version)</dt>
-<dd><a name="tlmgr-local-revision-_0028and-version_0029"></a>
+<dd><span id="tlmgr-local-revision-_0028and-version_0029"></span>
<p>If the package is installed the TeX Live revision number for the
installed package will be shown. If there is a catalogue version given
in the database for this package, it will be shown in parentheses.
@@ -6418,7 +6192,7 @@
</p>
</dd>
<dt>remote revision (and version)</dt>
-<dd><a name="tlmgr-remote-revision-_0028and-version_0029"></a>
+<dd><span id="tlmgr-remote-revision-_0028and-version_0029"></span>
<p>If a repository has been loaded the revision of the package in the
repository (if present) is shown. As with the local column, if a
catalogue version is provided it will be displayed. And also as with
@@ -6426,7 +6200,7 @@
</p>
</dd>
<dt>short description</dt>
-<dd><a name="tlmgr-short-description"></a>
+<dd><span id="tlmgr-short-description"></span>
<p>The short description of the package.
</p>
</dd>
@@ -6433,19 +6207,17 @@
</dl>
<hr>
-<a name="tlmgr-Main-display-action-buttons"></a>
-<div class="header">
+<span id="tlmgr-Main-display-action-buttons"></span><div class="header">
<p>
Previous: <a href="#tlmgr-Package-list-area" accesskey="p" rel="prev">tlmgr Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Main-display-action-buttons"></a>
-<h4 class="appendixsubsubsec">B.11.1.3 Main display action buttons</h4>
+<span id="Main-display-action-buttons"></span><h4 class="appendixsubsubsec">B.11.1.3 Main display action buttons</h4>
<p>Below the list of packages are several buttons:
</p>
<dl compact="compact">
<dt>Update all installed</dt>
-<dd><a name="tlmgr-Update-all-installed"></a>
+<dd><span id="tlmgr-Update-all-installed"></span>
<p>This calls <code>tlmgr update --all</code>, i.e., tries to update all available
packages. Below this button is a toggle to allow reinstallation of
previously removed packages as part of this action.
@@ -6455,12 +6227,12 @@
</p>
</dd>
<dt>Update</dt>
-<dd><a name="tlmgr-Update"></a>
+<dd><span id="tlmgr-Update"></span>
<p>Update only the selected packages.
</p>
</dd>
<dt>Install</dt>
-<dd><a name="tlmgr-Install"></a>
+<dd><span id="tlmgr-Install"></span>
<p>Install the selected packages; acts like <code>tlmgr install</code>, i.e., also
installs dependencies. Thus, installing a collection installs all its
constituent packages.
@@ -6467,7 +6239,7 @@
</p>
</dd>
<dt>Remove</dt>
-<dd><a name="tlmgr-Remove"></a>
+<dd><span id="tlmgr-Remove"></span>
<p>Removes the selected packages; acts like <code>tlmgr remove</code>, i.e., it will
also remove dependencies of collections (but not dependencies of normal
packages).
@@ -6474,7 +6246,7 @@
</p>
</dd>
<dt>Backup</dt>
-<dd><a name="tlmgr-Backup"></a>
+<dd><span id="tlmgr-Backup"></span>
<p>Makes a backup of the selected packages; acts like <code>tlmgr backup</code>. This
action needs the option <code>backupdir</code> set (see <code>Options -</code> General>).
</p>
@@ -6482,19 +6254,17 @@
</dl>
<hr>
-<a name="tlmgr-Menu-bar"></a>
-<div class="header">
+<span id="tlmgr-Menu-bar"></span><div class="header">
<p>
Next: <a href="#tlmgr-GUI-options" accesskey="n" rel="next">tlmgr GUI options</a>, Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">tlmgr Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Menu-bar"></a>
-<h4 class="appendixsubsec">B.11.2 Menu bar</h4>
+<span id="Menu-bar"></span><h4 class="appendixsubsec">B.11.2 Menu bar</h4>
<p>The following entries can be found in the menu bar:
</p>
<dl compact="compact">
<dt><code>tlmgr</code> menu</dt>
-<dd><a name="tlmgr-tlmgr-menu"></a>
+<dd><span id="tlmgr-tlmgr-menu"></span>
<p>The items here load various repositories: the default as specified in
the TeX Live database, the default network repository, the repository
specified on the command line (if any), and an arbitrarily
@@ -6502,7 +6272,7 @@
</p>
</dd>
<dt><code>Options menu</code></dt>
-<dd><a name="tlmgr-Options-menu"></a>
+<dd><span id="tlmgr-Options-menu"></span>
<p>Provides access to several groups of options: <code>Paper</code> (configuration of
default paper sizes), <code>Platforms</code> (only on Unix, configuration of the
supported/installed platforms), <code>GUI Language</code> (select language used in
@@ -6522,7 +6292,7 @@
</p>
</dd>
<dt><code>Actions menu</code></dt>
-<dd><a name="tlmgr-Actions-menu"></a>
+<dd><span id="tlmgr-Actions-menu"></span>
<p>Provides access to several actions: update the filename database (aka
<code>ls-R</code>, <code>mktexlsr</code>, <code>texhash</code>), rebuild all formats (<code>fmtutil-sys
--all</code>), update the font map database (<code>updmap-sys</code>), restore from a backup
@@ -6534,7 +6304,7 @@
</p>
</dd>
<dt><code>Help menu</code></dt>
-<dd><a name="tlmgr-Help-menu"></a>
+<dd><span id="tlmgr-Help-menu"></span>
<p>Provides access to the TeX Live manual (also on the web at
<a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>) and the usual “About” box.
</p>
@@ -6542,13 +6312,11 @@
</dl>
<hr>
-<a name="tlmgr-GUI-options"></a>
-<div class="header">
+<span id="tlmgr-GUI-options"></span><div class="header">
<p>
Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="GUI-options"></a>
-<h4 class="appendixsubsec">B.11.3 GUI options</h4>
+<span id="GUI-options"></span><h4 class="appendixsubsec">B.11.3 GUI options</h4>
<p>Some generic Perl/Tk options can be specified with <code>tlmgr gui</code> to
control the display:
@@ -6555,23 +6323,23 @@
</p>
<dl compact="compact">
<dt><code>-background</code> <em>color</em></dt>
-<dd><a name="tlmgr-_002dbackground-color"></a>
+<dd><span id="tlmgr-_002dbackground-color"></span>
<p>Set background color.
</p>
</dd>
<dt><code>-font "</code> <em>fontname</em> <em>fontsize</em> <code>"</code></dt>
-<dd><a name="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></a>
+<dd><span id="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></span>
<p>Set font, e.g., <code>tlmgr gui -font "helvetica 18"</code>. The argument to
<code>-font</code> must be quoted, i.e., passed as a single string.
</p>
</dd>
<dt><code>-foreground</code> <em>color</em></dt>
-<dd><a name="tlmgr-_002dforeground-color"></a>
+<dd><span id="tlmgr-_002dforeground-color"></span>
<p>Set foreground color.
</p>
</dd>
<dt><code>-geometry</code> <em>geomspec</em></dt>
-<dd><a name="tlmgr-_002dgeometry-geomspec"></a>
+<dd><span id="tlmgr-_002dgeometry-geomspec"></span>
<p>Set the X geometry, e.g., <code>tlmgr gui -geometry 1024x512-0+0</code> creates
the window of (approximately) the given size in the upper-right corner
of the display.
@@ -6578,7 +6346,7 @@
</p>
</dd>
<dt><code>-xrm</code> <em>xresource</em></dt>
-<dd><a name="tlmgr-_002dxrm-xresource"></a>
+<dd><span id="tlmgr-_002dxrm-xresource"></span>
<p>Pass the arbitrary X resource string <em>xresource</em>.
</p>
</dd>
@@ -6589,13 +6357,11 @@
complete list, and any X documentation for general information.
</p>
<hr>
-<a name="tlmgr-MACHINE_002dREADABLE-OUTPUT"></a>
-<div class="header">
+<span id="tlmgr-MACHINE_002dREADABLE-OUTPUT"></span><div class="header">
<p>
Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">tlmgr AUTHORS AND COPYRIGHT</a>, Previous: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="p" rel="prev">tlmgr GUI FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="MACHINE_002dREADABLE-OUTPUT"></a>
-<h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3>
+<span id="MACHINE_002dREADABLE-OUTPUT"></span><h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3>
<p>With the <code>--machine-readable</code> option, <code>tlmgr</code> writes to stdout in the
fixed line-oriented format described here, and the usual informational
@@ -6609,20 +6375,18 @@
<a href="#tlmgr-option">option</a> actions.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="1">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="1">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="2">tlmgr Machine-readable <code>option</code> output</a>:</td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="2">tlmgr Machine-readable <code>option</code> output</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-Machine_002dreadable-update-and-install-output"></a>
-<div class="header">
+<span id="tlmgr-Machine_002dreadable-update-and-install-output"></span><div class="header">
<p>
Next: <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="n" rel="next">tlmgr Machine-readable <code>option</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">tlmgr MACHINE-READABLE OUTPUT</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Machine_002dreadable-update-and-install-output"></a>
-<h4 class="appendixsubsec">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</h4>
+<span id="Machine_002dreadable-update-and-install-output"></span><h4 class="appendixsubsec">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</h4>
<p>The output format is as follows:
</p>
@@ -6651,7 +6415,7 @@
</p>
<dl compact="compact">
<dt><code>location-url</code> <em>location</em></dt>
-<dd><a name="tlmgr-location_002durl-location"></a>
+<dd><span id="tlmgr-location_002durl-location"></span>
<p>The <em>location</em> may be a url (including <code>file:///foo/bar/...</code>), or a
directory name (<code>/foo/bar</code>). It is the package repository from which
the new package information was drawn.
@@ -6658,7 +6422,7 @@
</p>
</dd>
<dt><code>total-bytes</code> <em>count</em></dt>
-<dd><a name="tlmgr-total_002dbytes-count"></a>
+<dd><span id="tlmgr-total_002dbytes-count"></span>
<p>The <em>count</em> is simply a decimal number, the sum of the sizes of all the
packages that need updating or installing (which are listed subsequently).
</p>
@@ -6673,7 +6437,7 @@
</p>
<dl compact="compact">
<dt><em>pkgname</em></dt>
-<dd><a name="tlmgr-pkgname"></a>
+<dd><span id="tlmgr-pkgname"></span>
<p>The TeX Live package identifier, with a possible platform suffix for
executables. For instance, <code>pdftex</code> and <code>pdftex.i386-linux</code> are given
as two separate packages, one on each line.
@@ -6680,17 +6444,17 @@
</p>
</dd>
<dt><em>status</em></dt>
-<dd><a name="tlmgr-status"></a>
+<dd><span id="tlmgr-status"></span>
<p>The status of the package update. One character, as follows:
</p>
<dl compact="compact">
<dt><code>d</code></dt>
-<dd><a name="tlmgr-d"></a>
+<dd><span id="tlmgr-d"></span>
<p>The package was removed on the server.
</p>
</dd>
<dt><code>f</code></dt>
-<dd><a name="tlmgr-f"></a>
+<dd><span id="tlmgr-f"></span>
<p>The package was removed in the local installation, even though a
collection depended on it. (E.g., the user ran <code>tlmgr remove
--force</code>.)
@@ -6697,30 +6461,30 @@
</p>
</dd>
<dt><code>u</code></dt>
-<dd><a name="tlmgr-u"></a>
+<dd><span id="tlmgr-u"></span>
<p>Normal update is needed.
</p>
</dd>
<dt><code>r</code></dt>
-<dd><a name="tlmgr-r"></a>
+<dd><span id="tlmgr-r"></span>
<p>Reversed non-update: the locally-installed version is newer than the
version on the server.
</p>
</dd>
<dt><code>a</code></dt>
-<dd><a name="tlmgr-a"></a>
+<dd><span id="tlmgr-a"></span>
<p>Automatically-determined need for installation, the package is new on
the server and is (most probably) part of an installed collection.
</p>
</dd>
<dt><code>i</code></dt>
-<dd><a name="tlmgr-i"></a>
+<dd><span id="tlmgr-i"></span>
<p>Package will be installed and isn’t present in the local installation
(action install).
</p>
</dd>
<dt><code>I</code></dt>
-<dd><a name="tlmgr-I"></a>
+<dd><span id="tlmgr-I"></span>
<p>Package is already present but will be reinstalled (action install).
</p>
</dd>
@@ -6728,30 +6492,30 @@
</dd>
<dt><em>localrev</em></dt>
-<dd><a name="tlmgr-localrev"></a>
+<dd><span id="tlmgr-localrev"></span>
<p>The revision number of the installed package, or <code>-</code> if it is not
present locally.
</p>
</dd>
<dt><em>serverrev</em></dt>
-<dd><a name="tlmgr-serverrev"></a>
+<dd><span id="tlmgr-serverrev"></span>
<p>The revision number of the package on the server, or <code>-</code> if it is not
present on the server.
</p>
</dd>
<dt><em>size</em></dt>
-<dd><a name="tlmgr-size"></a>
+<dd><span id="tlmgr-size"></span>
<p>The size in bytes of the package on the server. The sum of all the
package sizes is given in the <code>total-bytes</code> header field mentioned above.
</p>
</dd>
<dt><em>runtime</em></dt>
-<dd><a name="tlmgr-runtime"></a>
+<dd><span id="tlmgr-runtime"></span>
<p>The run time since start of installations or updates.
</p>
</dd>
<dt><em>esttot</em></dt>
-<dd><a name="tlmgr-esttot"></a>
+<dd><span id="tlmgr-esttot"></span>
<p>The estimated total time.
</p>
</dd>
@@ -6758,13 +6522,11 @@
</dl>
<hr>
-<a name="tlmgr-Machine_002dreadable-option-output"></a>
-<div class="header">
+<span id="tlmgr-Machine_002dreadable-option-output"></span><div class="header">
<p>
Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="p" rel="prev">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">tlmgr MACHINE-READABLE OUTPUT</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Machine_002dreadable-option-output"></a>
-<h4 class="appendixsubsec">B.12.2 Machine-readable <code>option</code> output</h4>
+<span id="Machine_002dreadable-option-output"></span><h4 class="appendixsubsec">B.12.2 Machine-readable <code>option</code> output</h4>
<p>The output format is as follows:
</p>
@@ -6776,13 +6538,11 @@
changes would be helpful, do not hesitate to write the mailing list.
</p>
<hr>
-<a name="tlmgr-AUTHORS-AND-COPYRIGHT"></a>
-<div class="header">
+<span id="tlmgr-AUTHORS-AND-COPYRIGHT"></span><div class="header">
<p>
Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">tlmgr MACHINE-READABLE OUTPUT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="AUTHORS-AND-COPYRIGHT-1"></a>
-<h3 class="appendixsec">B.13 AUTHORS AND COPYRIGHT</h3>
+<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.13 AUTHORS AND COPYRIGHT</h3>
<p>This script and its documentation were written for the TeX Live
distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the
@@ -6792,18 +6552,14 @@
</p>
<hr>
-<a name="Index"></a>
-<div class="header">
+<span id="Index"></span><div class="header">
<p>
Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</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>
</div>
-<a name="Index-1"></a>
-<h2 class="unnumbered">Index</h2>
+<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a>
-<a class="summary-letter" href="#Index_cp_symbol-2"><b>.</b></a>
-
<br>
<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
@@ -6853,7 +6609,7 @@
<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td> </td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-1">-</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-1">-</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dbindir-configure-option"><code>--bindir configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026"><code>--prefix</code> <code>--bindir</code> …</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dbindir-configure-option-1"><code>--bindir configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dbuild_003dhost"><code>--build=<var>host</var></code></a>:</td><td> </td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr>
@@ -6920,10 +6676,7 @@
<tr><td></td><td valign="top"><a href="#index-_002dC-configure-option"><code>-C configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dj-make-option"><code>-j make <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-2">.</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002etravis_002eyml"><code>.travis.yml</code></a>:</td><td> </td><td valign="top"><a href="#CI-testing-on-Travis_002dCI">CI testing on Travis-CI</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-adapting-TeX-Live-for-distros">adapting TeX Live for distros</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-adding-a-new-generic-library">adding a new generic library</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-generic-library-module">Adding a new generic library module</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-adding-a-new-program">adding a new program</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr>
@@ -6938,7 +6691,7 @@
<tr><td></td><td valign="top"><a href="#index-autoconf-macros">autoconf macros</a>:</td><td> </td><td valign="top"><a href="#Autoconf-macros">Autoconf macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Automake">Automake</a>:</td><td> </td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-B">B</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-biber"><code>biber</code></a>:</td><td> </td><td valign="top"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bibtex_002dx"><code>bibtex-x</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp>texk/bibtex-x</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bibtex8"><code>bibtex8</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp>texk/bibtex-x</samp></a></td></tr>
@@ -6947,6 +6700,7 @@
<tr><td></td><td valign="top"><a href="#index-build-directory_002c-required">build directory, required</a>:</td><td> </td><td valign="top"><a href="#Building">Building</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-iteration">build iteration</a>:</td><td> </td><td valign="top"><a href="#Build-iteration">Build iteration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-on-demand">build on demand</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-build-one-engine">build one engine</a>:</td><td> </td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-one-package">build one package</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-problems">build problems</a>:</td><td> </td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Build-script"><code>Build <span class="roman">script</span></code></a>:</td><td> </td><td valign="top"><a href="#Building">Building</a></td></tr>
@@ -6957,8 +6711,8 @@
<tr><td></td><td valign="top"><a href="#index-building-a-distribution">building a distribution</a>:</td><td> </td><td valign="top"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-building-in-parallel">building in parallel</a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-C">C</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-C_002b_002b11_002c-required-by-dvisvgm">C++11, required by <code>dvisvgm</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-C_002b_002b11_002c-required">C++11, required</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002c-ANSI_002c-required">C, ANSI, required</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C99_002c-avoided">C99, avoided</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cache-file_002c-for-configure">cache file, for <code>configure</code></a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
@@ -6968,7 +6722,6 @@
<tr><td></td><td valign="top"><a href="#index-CC_003dc_002dcompiler"><code>CC=<var>c-compiler</var></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-CC_005fBUILD"><code>CC_BUILD</code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-chktex"><code>chktex</code></a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ci">ci</a>:</td><td> </td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clisp"><code>clisp</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-CLISP-1"><code>CLISP</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-CLISP">CLISP</a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-utils_002fxindy">Configure options for <samp>utils/xindy</samp></a></td></tr>
@@ -6975,7 +6728,7 @@
<tr><td></td><td valign="top"><a href="#index-clisp_002c-required-by-xindy"><code>clisp</code>, required by <code>xindy</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Cocoa-Mac-framework_002c-required-by-xetex"><code>Cocoa</code> Mac framework, required by <code>xetex</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-coding-conventions">coding conventions</a>:</td><td> </td><td valign="top"><a href="#Coding-conventions">Coding conventions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compilers_002c-C-and-C_002b_002b">compilers, C and C++</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-compilers_002c-C-and-C_002b_002b11">compilers, C and C++11</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-config_002eguess_002c-config_002esub_002c-_2026"><code>config.guess<span class="roman">,</span> config.sub, …</code></a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-options"><code>configure</code> options</a>:</td><td> </td><td valign="top"><a href="#Configure-options">Configure options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-options_002c-for-bibtex_002dx"><code>configure</code> options, for <code>bibtex-x</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp>texk/bibtex-x</samp></a></td></tr>
@@ -7004,9 +6757,9 @@
<tr><td></td><td valign="top"><a href="#index-CXX"><code>CXX</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-CXX_003dc_002b_002b_002dcompiler"><code>CXX=<var>c++-compiler</var></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-D">D</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Debian-installation-of-build-prerequisites">Debian installation of build prerequisites</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-declarations-and-definitions_002c-in-source-code">declarations and definitions, in source code</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-declarations-before-statements_002c-avoiding">declarations before statements, avoiding</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dependencies_002c-with-several-output-files">dependencies, with several output files</a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-DESTDIR"><code>DESTDIR</code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026"><code>--prefix</code> <code>--bindir</code> …</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-directories_002c-for-installation">directories, for installation</a>:</td><td> </td><td valign="top"><a href="#Installation-directories">Installation directories</a></td></tr>
@@ -7015,20 +6768,19 @@
<tr><td></td><td valign="top"><a href="#index-dist-and-distcheck-targets-for-make"><code>dist</code> and <code>distcheck</code> targets for <code>make</code></a>:</td><td> </td><td valign="top"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-distribution-tarball_002c-making">distribution tarball, making</a>:</td><td> </td><td valign="top"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-distro_002c-building-for">distro, building for</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dvipdfm_002dx"><code>dvipdfm-x</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fdvipdfm_002dx">Configure options for <samp>texk/dvipdfm-x</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dvipdfmx"><code>dvipdfmx</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fdvipdfm_002dx">Configure options for <samp>texk/dvipdfm-x</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dvisvgm"><code>dvisvgm</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fdvisvgm">Configure options for <samp>texk/dvisvgm</samp></a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-dvisvgm-requirement-for-C_002b_002b11"><code>dvisvgm</code> requirement for C++11</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-engine_002c-building-one">engine, building one</a>:</td><td> </td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment-variables_002c-for-configure">environment variables, for <code>configure</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options">Configure options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exec_005fprefix"><code>exec_prefix</code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-extending-TeX-Live">extending TeX Live</a>:</td><td> </td><td valign="top"><a href="#Extending-TeX-Live">Extending TeX Live</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-extern-functions"><code>extern</code> functions</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-extra_002f-top_002dlevel-directory"><samp>extra/</samp> top-level directory</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-F">F</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-failure-to-build">failure to build</a>:</td><td> </td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ffcall_002c-required-by-xindy"><code>ffcall</code>, required by <code>xindy</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-flags_002c-macros-for-library-and-header">flags, macros for library and header</a>:</td><td> </td><td valign="top"><a href="#Macros-for-library-and-header-flags">Macros for library and header flags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fontconfig-library_002c-required-by-xetex"><code>fontconfig</code> library, required by <code>xetex</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-FreeType">FreeType</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
@@ -7038,9 +6790,12 @@
<tr><td></td><td valign="top"><a href="#index-freetype_002dconfig-1"><code>freetype-config</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-FT2_005fCONFIG"><code>FT2_CONFIG</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-G">G</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-gcc_002c-default-compilers"><code>gcc<span class="roman">, default compilers</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-general-setup-macros">general setup macros</a>:</td><td> </td><td valign="top"><a href="#General-setup-macros">General setup macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-generic-library-module_002c-adding">generic library module, adding</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-generic-library-module">Adding a new generic library module</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Ghostscript-location-for-Xdvik">Ghostscript location for Xdvik</a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-git_002dsvn"><code>git-svn</code></a>:</td><td> </td><td valign="top"><a href="#Transfer-from-Subversion-to-Github">Transfer from Subversion to Github</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-configure-options">global <code>configure</code> options</a>:</td><td> </td><td valign="top"><a href="#Global-configure-options">Global configure options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gmake_002c-required"><code>gmake</code>, required</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GNU-make_002c-required">GNU <code>make</code>, required</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
@@ -7048,7 +6803,7 @@
<tr><td></td><td valign="top"><a href="#index-GNU_002fLinux-distro">GNU/Linux distro</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Gnulib_002c-used-for-common-files">Gnulib, used for common files</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-I">I</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ICU-cross-compiling">ICU cross compiling</a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ICU-libraries">ICU libraries</a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-icu_002dconfig"><code>icu-config</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
@@ -7062,7 +6817,7 @@
<tr><td></td><td valign="top"><a href="#index-introduction">introduction</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-iteration-through-sources_002c-by-configure-and-make">iteration through sources, by <code>configure</code> and <code>make</code></a>:</td><td> </td><td valign="top"><a href="#Build-iteration">Build iteration</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-K">K</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-K">K</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpathsea-library"><code>kpathsea <span class="roman">library</span></code></a>:</td><td> </td><td valign="top"><a href="#kpathsea-library"><code>kpathsea</code> library</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpathsea_002eac"><code>kpathsea.ac</code></a>:</td><td> </td><td valign="top"><a href="#kpathsea-library"><code>kpathsea</code> library</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpse_002dlibpng_002dflags_002em4"><code>kpse-libpng-flags.m4</code></a>:</td><td> </td><td valign="top"><a href="#png-library"><code>png</code> library</a></td></tr>
@@ -7109,11 +6864,13 @@
<tr><td></td><td valign="top"><a href="#index-KPSE_005fWITH_005fLIB"><code>KPSE_WITH_LIB</code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-generic-library-module">Adding a new generic library module</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-KPSE_005fWITH_005fTEXLIB"><code>KPSE_WITH_TEXLIB</code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-L">L</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-large-file-support">large file support</a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-LATEX"><code>LATEX</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-layout-of-sources">layout of sources</a>:</td><td> </td><td valign="top"><a href="#Layout-and-infrastructure">Layout and infrastructure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-LFS-_0028large-file-support_0029">LFS (large file support)</a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-libexpat_002c-dependency-of-libfontconfig"><code>libexpat<span class="roman">, dependency of <code>libfontconfig</code></span></code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-libfontconfig_002c-hack-for-avoiding-linking-dependencies"><code>libfontconfig<span class="roman">, hack for avoiding linking dependencies</span></code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-libfreetype"><code>libfreetype</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-libfreetype_002c-and-const"><code>libfreetype</code>, and <code>const</code></a>:</td><td> </td><td valign="top"><a href="#Const">Const</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-libpng-library"><code>libpng <span class="roman">library</span></code></a>:</td><td> </td><td valign="top"><a href="#png-library"><code>png</code> library</a></td></tr>
@@ -7121,6 +6878,7 @@
<tr><td></td><td valign="top"><a href="#index-library-module_002c-TeX_002dspecific_002c-adding">library module, TeX-specific, adding</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-library-modules">library modules</a>:</td><td> </td><td valign="top"><a href="#Library-modules">Library modules</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-library_002dspecific-configure-options">library-specific <code>configure</code> options</a>:</td><td> </td><td valign="top"><a href="#Library_002dspecific-configure-options">Library-specific configure options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-libsigsegv_002c-required-by-xindy"><code>libsigsegv</code>, required by <code>xindy</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-libstc_002b_002b_002c-statically-linking"><code>libstc++<span class="roman">, statically linking</span></code></a>:</td><td> </td><td valign="top"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Libtool">Libtool</a>:</td><td> </td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-libtool_002c-hack-for-avoiding-excessive-linking"><code>libtool<span class="roman">, hack for avoiding excessive linking</span></code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr>
@@ -7130,7 +6888,7 @@
<tr><td></td><td valign="top"><a href="#index-lisp_002erun_002c-lisp_002eexe"><code>lisp.run<span class="roman">,</span> lisp.exe</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-utils_002fxindy">Configure options for <samp>utils/xindy</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-LittleEndian-architectures">LittleEndian architectures</a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-m4_002f-top_002dlevel-directory"><samp>m4/</samp> top-level directory</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-macros_002c-for-compilers">macros, for compilers</a>:</td><td> </td><td valign="top"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-macros_002c-for-libraries">macros, for libraries</a>:</td><td> </td><td valign="top"><a href="#Macros-for-libraries">Macros for libraries</a></td></tr>
@@ -7140,6 +6898,7 @@
<tr><td></td><td valign="top"><a href="#index-macros_002c-general-setup">macros, general setup</a>:</td><td> </td><td valign="top"><a href="#General-setup-macros">General setup macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-MAKE"><code>MAKE</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-make-_002dt"><code>make -t</code></a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-make-rules_002c-verbose-vs_002e-silent"><code>make</code> rules, verbose vs. silent</a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mf_002dnowin"><code>mf-nowin</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mingw32"><code>mingw32</code></a>:</td><td> </td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-MINGW32_002c-Automake-conditional"><code>MINGW32<span class="roman">, Automake conditional</span></code></a>:</td><td> </td><td valign="top"><a href="#Macros-for-Windows">Macros for Windows</a></td></tr>
@@ -7149,11 +6908,12 @@
<tr><td></td><td valign="top"><a href="#index-modules_002c-for-programs">modules, for programs</a>:</td><td> </td><td valign="top"><a href="#Program-modules">Program modules</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-motif"><code>motif</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-N">N</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-native-cross-compilation">native cross compilation</a>:</td><td> </td><td valign="top"><a href="#Cross-compilation">Cross compilation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-O">O</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-OBJCXX_003dobjc_002dcompiler"><code>OBJCXX=<var>objc-compiler</var></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-one-engine_002c-building">one engine, building</a>:</td><td> </td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-one-package_002c-building">one package, building</a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-OpenGL_002c-required-for-Asymptote">OpenGL, required for Asymptote</a>:</td><td> </td><td valign="top"><a href="#asymptote"><code>asymptote</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-operating-system-distribution_002c-building-for">operating system distribution, building for</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
@@ -7160,7 +6920,7 @@
<tr><td></td><td valign="top"><a href="#index-otangle"><code>otangle</code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
@@ Diff output truncated at 1234567 characters. @@
More information about the tex-live-commits
mailing list