diff options
Diffstat (limited to 'Master')
| -rw-r--r-- | Master/texmf-dist/doc/dvipng/dvipng.html | 441 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/dvipng/dvipng.pdf | bin | 220177 -> 220174 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.html | 2326 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/dvips/dvips.pdf | bin | 405414 -> 405527 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/info/dvips.info | 4 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/kpathsea.info | 227 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/tlbuild.info | 1603 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/info/web2c.info | 6 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/kpathsea/kpathsea.html | 2112 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/kpathsea/kpathsea.pdf | bin | 388425 -> 390501 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html | 3579 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf | bin | 493309 -> 496534 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/web2c/web2c.html | 2529 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/web2c/web2c.pdf | bin | 464711 -> 464712 bytes | |||
| -rw-r--r-- | Master/tlpkg/doc/releng.txt | 21 |
15 files changed, 6116 insertions, 6732 deletions
diff --git a/Master/texmf-dist/doc/dvipng/dvipng.html b/Master/texmf-dist/doc/dvipng/dvipng.html index ae4503aa543..f3ff549bb85 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.html +++ b/Master/texmf-dist/doc/dvipng/dvipng.html @@ -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 @@ ul.no-bullet {list-style: none} -<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,38 +106,36 @@ Independent) file into PNG (Portable Network Graphics). </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> <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 @@ PNG, JPEG or GIF images. <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 @@ Next: <a href="#Basic-usage" accesskey="n" rel="next">Basic usage</a>, Previous: <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 @@ any modern system, if not, download them and install them. </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 @@ are located in e.g., <samp>/sw/local/include</samp>, do <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 @@ To install the files into the locations chosen earlier, type 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 adjust these three internally so that kpathsea thinks that 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 @@ access the documentation. </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 @@ your system before, they may be automatically generated; this process 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 @@ of available options, just type </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 @@ These do not correspond to dvips options: <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 @@ page reversal, use ‘<samp>-r0</samp>’. Such options are marked with </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 @@ line. <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 @@ fallback color makes the default border width 1 px. See <a href="#Color">Color</ </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 @@ below). </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 @@ both variants will use the latter behaviour. See <a href="#Color">Color</a>. </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 @@ the first option for maximum output. See <a href="#Debug-options">Debug options< </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 @@ is usually 96 dpi) which means the formula is </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 @@ numbers rather than the physical page number. See the ‘<samp>-o</samp>&rsq </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 @@ See <a href="#Color">Color</a>. </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 @@ DVI. This is similar to ‘<samp>tail -f</samp>’ but for DVI-to-PNG co </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 @@ fonts. </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 @@ fonts will be lighter (more like the background), and for <var>num</var> > </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 @@ option. </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 @@ image is obtained as the sum of the values reported from </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 @@ no matter what the pages are actually numbered. </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 @@ having any effect. </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 @@ turns the call back on. </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 @@ file was ‘<samp><var>file</var>.dvi</samp>’. </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 @@ the paper) by this amount. </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 @@ the document, no matter what the pages are actually numbered. </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 @@ switch if present. </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 @@ missing PK fonts. </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 @@ or more readable, ‘<samp>-pp -1:-1</samp>’. </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,14 +858,14 @@ available, its rendering is unaffected by this option. </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> </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 @@ only include all ink put on the page, producing neat images. </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 @@ used, in addition to the usual output. </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 @@ an integer, for increased precision. </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 @@ correspond directly to the zlib compression levels. </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 @@ tries to handle some of the raw PostScript that is output from various 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 @@ use the ‘<samp>png16m</samp>’ device to produce a cropped opaque ima 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 @@ in this example (using ‘<samp>graphicx</samp>’): <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 @@ wide: </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 @@ is turned off, it gives a warning. It is now possible to use the switch 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 @@ specials start with the keyword ‘<samp>color</samp>’ or the keyword ‘<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 @@ an argument to ‘<samp>--bg</samp>’ to choose transparent background. 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 @@ that color. 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 @@ work. The following sections provide some helpful hints if you find 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@nongnu.org">dvipng@nongnu.org</a>. @@ -1246,17 +1195,15 @@ body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a> access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@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 @@ multiple classes, sum the numbers of the classes you wish to track. To 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 @@ track all classes, you can use <code>-1</code>. </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 @@ Waldeck Schutzer. </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 @@ License along with this program. If not, see <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,37 +1362,37 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href=" <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> <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 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href=" <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 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href=" <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 @@ Previous: <a href="#Copying" accesskey="p" rel="prev">Copying</a>, Up: <a href=" <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> diff --git a/Master/texmf-dist/doc/dvipng/dvipng.pdf b/Master/texmf-dist/doc/dvipng/dvipng.pdf Binary files differindex 96bf29ac4dd..02de03b7565 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.pdf +++ b/Master/texmf-dist/doc/dvipng/dvipng.pdf diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index 37b42f07f0d..c090e788a65 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -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 @@ PostScript. You may freely use, modify and/or distribute this file. --> <!-- 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 @@ ul.no-bullet {list-style: none} -<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 @@ Dvips, the less time will be spent fighting with PostScript and the 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 @@ see <a href="#Debug-options">Debug options</a>. Also see the Dvips home page at 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 @@ printer (output device). Since these are site-specific, <code>make 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,26 +402,24 @@ Z <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 <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 @@ for lots of information about how it works. </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> - -<a name="index-Ghostscript-installation"></a> -<a name="index-gs-installation"></a> - -<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="Ghostscript-installation-1"></span><h3 class="section">2.3 Ghostscript installation</h3> + +<span id="index-Ghostscript-installation"></span> +<span id="index-gs-installation"></span> + +<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 @@ produced by Dvips and render it on your monitor, or for another device 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 @@ and is available from <a href="http://www.gnu.org/software/gv">http://www.gnu.or </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 @@ work. The following sections provide some helpful hints if you find 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 @@ read by Dvips. This way you can be sure it’s finding the files and 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 @@ To track all classes, you can use <code>-1</code>. </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 @@ provided by Kpathsea (see <a href="http://tug.org/texinfohtml/kpathsea.html#Debu <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 @@ generate some output, at the very least a page detailing what error 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 @@ comments and see what happens. </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 @@ See <a href="#Command_002dline-options">Command-line options</a>, and <a href="# </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 @@ section of the PostScript. To fix this, turn off structured comments 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,39 +675,35 @@ might be a problem with the printer itself. </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. </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 @@ of this flag will break graphics from some applications, though, since 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 @@ chapters in this document. 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 @@ progress reports appear by default. The next time that document is 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 @@ of available options, just type <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 @@ Email bug reports to tex-k@mail.tug.org. </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,43 +876,43 @@ page reversal, use ‘<samp>-r0</samp>’. Such options are marked with </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. </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,27 +920,27 @@ do color separations or other neat tricks. </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>’. </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 @@ times. </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 @@ recommended). See <a href="#Debug-options">Debug options</a>, for the possible </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 @@ names for most devices. </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 @@ letters in words. </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 @@ in the single output file. </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 @@ configuration file; use ‘<samp>-F</samp>’ after the ‘<samp>-f< </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,28 +1039,28 @@ recommended. </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. </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>’. </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 @@ memory. See <a href="#Headers-and-memory-usage">Headers and memory usage</a>, f </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 @@ per-font basis (see <a href="#psfonts_002emap">psfonts.map</a>). </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 @@ downloading <samp>crop.pro</samp>. </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 @@ line, searching for a particular comment. </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 @@ no matter what the pages are actually numbered. </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 @@ configuration file value. </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 @@ such as Ghostview. </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 @@ requests to set 2-byte characters. </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,25 +1217,25 @@ larger. If you find this unacceptable or encounter another problem 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 ‘<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,32 +1250,32 @@ See the ‘<samp>-f</samp>’ option for how to override this. </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 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 @@ the document, no matter what the pages are actually numbered. </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 @@ also be ‘<samp>:</samp>’. </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 @@ See <a href="#Configuration-file-searching">Configuration file searching</a>. </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 @@ absolute filenames. ‘<samp>-R0</samp>’ allows both. </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,23 +1357,23 @@ much about the portability of the output to other environments. </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. </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 @@ you can use ‘<samp>-E</samp>’ to get pure EPSF output.) </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 @@ one close enough. To disable this behavior, use ‘<samp>-tunknown</samp>&rs </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 @@ is added at the end. </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 @@ printer. </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 @@ printers that have no resident fonts, i.e., very rarely. </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,30 +1459,30 @@ integer, for increased precision. </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. </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 @@ creating the output. See <a href="#Hypertext">Hypertext</a>. </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 @@ enabled in the configuration file (see <a href="#Configuration-file-commands">Co <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,76 +1517,76 @@ configuration files are read, so they override values in the 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. </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>). </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. </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.) </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,67 +1596,63 @@ platforms.) </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> <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, 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 @@ the name <samp>$HOME/.dvipsrc</samp>, which is in the user’s home director 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 @@ encountered. (On MS-DOS, the printer configuration files are called <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 @@ possible. </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,49 +1735,49 @@ same, we omit the description here. <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. </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 @@ be printed if the option is used (and warnings are not suppressed). </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,20 +1867,20 @@ splitting of the output is desirable. The Dvips config file </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>. </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 @@ program by that name in the current directory or along the <code>PATH</code>. </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 @@ global map file. This can be used for font families. </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 @@ than the preceding one is ignored. This is because it is better to 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,45 +1964,45 @@ the Makefile variable ‘<samp>default_texsizes</samp>’, defined in th </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. </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. </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. </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 @@ about special characteristics of a particular printer. </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,23 +2036,21 @@ on the command line, that takes precedence. <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 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 @@ printer drivers. 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 @@ namely, in (inches), cm (centimeters), mm (millimeters), pt (points), sp (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 @@ reventually the ‘<samp>papersize</samp>’ comment will dominate. 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 @@ behavior of Dvips prior to the 2017 release. </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,27 +2218,27 @@ commands; others (such as the NeXT) want ‘<samp>PaperSize</samp>’ co 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 <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 @@ certain (unknown) printers). Not executing any page size definition 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,81 +2302,75 @@ commands to select the paper trays. On the 4SI, <var>alternatetray</var> is <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 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 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. 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 @@ PostScript units (there are precisely 72 PostScript units to the inch, 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 @@ lines there is a line like 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,15 +2405,15 @@ bounding box is given in this way when the program that generated the 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 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 @@ the file. </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 @@ different TeX engines or DVI converters if you also provide 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 @@ account. </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 @@ package. See <a href="#g_t_005cincludegraphics">\includegraphics</a>. (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 @@ figures you plan to include. <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 @@ comment: 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 @@ default, the graphic will be scaled by any DVI magnification in effect, 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 @@ terminal when it processes each figure, give the command: </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 @@ of the EPS file. <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 @@ convenient for you. That is, put 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 @@ proportionally. 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 @@ instead of <code>\hsize</code>.) </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 @@ being used, and it will cause any PostScript graphics to appear 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 @@ turn clipping on, just use the command <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 @@ specify transformations on the PostScript. </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 @@ operations is to rotate the figure, scale it, then offset it. <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 @@ scale factor. </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 @@ file to standard output. For example: <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 @@ with the ‘<samp>-R</samp>’ command-line option or ‘<samp>R</sa </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 @@ treated as a bitmap. For example, if your figure used the single letter </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 @@ producing any printed output themselves. You can explicitly request 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 @@ comments, squeezing blank lines, etc., for maximum efficiency. If you 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 @@ to ensure that <samp>foo.ps</samp> gets downloaded: <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 @@ the file itself, as follows: <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 @@ which are installed in the <samp>tex/</samp> tree. </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 @@ option ‘<samp>-P <var>header</var></samp>’; this will read the file <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 @@ mode on duplex printers, and setting various screen frequencies; </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 @@ to a very large number. (See the ‘<samp>m</samp>’ item in <a href=" </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 @@ the <code>\vbox</code> above. </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,14 +3226,14 @@ can be used to continue PostScript literals started with ‘<samp>ps:</samp> <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"> <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 @@ it easy to typeset text turned in multiples of 90 degrees. </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,32 +3269,30 @@ literally (the ‘<samp>"</samp>’ special) or through macros (e.g <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 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 @@ possible for them to accumulate information, but if a document must be 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 @@ a light grey ‘DRAFT’ across each page in the document: 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 @@ independent. </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 @@ width\hsize\vskip-2in\special{ps:grestore}\font\big=cminch\big </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 @@ has a useful trick that appears again and again. </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 @@ are supported; Ghostscript includes limited distiller support </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>. -</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> +CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>. +</p> +<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 @@ via the CTAN reference above. </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 @@ any screen or printer resolution. 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 @@ package (e.g., <code>tetex-extra</code> in Debian). Failing that, 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 @@ recommendations are GNU Ghostscript 6.51 or Aladdin Ghostscript 7.0. 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. Van Zandt:<br> </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@aps.org">apsmith@aps.org</a>), Tanmoy Bhattacharya, and Paul @@ -3653,30 +3545,30 @@ html:<base href="<var>xurl</var>"> 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> <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 @@ macros to insert the <code>\special</code> commands; reference above.) </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,16 +3597,16 @@ existing macro packages which take care of all the details, such as </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). </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 @@ the NeXTSTEP DVI viewer. </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 @@ therefore relevant only if you are installing new PostScript fonts not 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 @@ encoding files used together can describe a reencoding that rearranges, 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 @@ character code, and information about sequences of characters. <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 @@ the only common ligatures are fi, fl, ff, ffi, and ffl.) <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 @@ See <a href="#Invoking-afm2tfm">Invoking afm2tfm</a>. </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 @@ know character shapes. <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,27 +3794,27 @@ generated by linearly scaling a single shape. For example, a 10-point 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 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 @@ dots per inch. For example, <samp>cmr10.600pk</samp> contains the bitmaps for 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 @@ format is a historical artifact.) </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 @@ isn’t a reference manual on virtual fonts. For more information: The 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 @@ See <a href="#Encodings">Encodings</a>. 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 @@ character at that position looks like; there are lots of ways to draw an 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 @@ particular character positions. A better solution is to create a new 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 @@ are used by the Afm2tfm program. Encoding files are also downloaded to 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 @@ italics, and <samp>texmsym.enc</samp> for math symbols. </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 @@ what character to typeset, with this mass of metrics, glyphs, encodings, 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 @@ PostScript operation: <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 @@ to do anything with that font.) <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 @@ This vector of 256 names maps each possible input character to a name. </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 @@ information. </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 @@ cp ptmr.pf? <var>fontdir</var>/type1/… <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 @@ output, namely the virtual property list’file <samp>ptmr.vpl</samp>, and t “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 @@ printer, so there’s no need to download any Type 1 file for it. But if 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 @@ the built-in PostScript fonts. </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 @@ results of the conversion are affected by the command-line options and 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 @@ can also obtain special effects such as an oblique font. (<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 @@ PostScript encoding, and ‘<samp>-T</samp>’ changes both simultaneous 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 @@ addition to the ligature and kerning information from the AFM file. <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 @@ encoding.) </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,30 +4288,28 @@ line like the following one to <samp>psfonts.map</samp> (see <a href="#psfonts_0 <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 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 @@ particular PostScript font. </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 @@ then yielding the corresponding number.) The combined mapping of 19 to 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 @@ following definitions. These definitions will not work with the 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 @@ of the distributed <samp>psfonts.sty</samp> for use with LaTeX. \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 @@ ignored by Dvips. </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 @@ PostScript font. Here is a skeletal example: <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 @@ kern information is given in groups of words: each group is terminated 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 @@ particular location. Either or both of the character names can be given 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 @@ operation, so there are a total of eight possibilities: <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 @@ rather than attempting to remake them.) <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 @@ constructed from Times-Roman via the PostScript routine <code>SlantFont</code> </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 @@ constructed from Times-Roman via the PostScript routine <code>SlantFont</code> <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 @@ independently of the rest of the font. If you want a really 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 @@ different output encodings) may be based on it. </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 @@ filename. <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 @@ See <a href="#Making-a-font-available">Making a font available</a>. </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,30 +4680,30 @@ the case.) </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. </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,28 +4711,28 @@ See <a href="#Changing-PostScript-encodings">Changing PostScript encodings</a>. </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). </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>. </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 @@ into otherwise-unused positions, arbitrarily). </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 @@ kerning. <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 @@ files and constructs. Each line has the format: <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 @@ font, see <a href="#Virtual-fonts">Virtual fonts</a>) references the TFM file &l 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,60 +4796,60 @@ file should be <code>StoneInformal</code>. <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 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 @@ name, it is used for both the TeX name and the PostScript name. <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@almaden.ibm.com">hafner@almaden.ibm.com</a>, the color support has gone through many @@ -5065,32 +4919,30 @@ preparer’s point of view and then add some instructions on installation 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 @@ the documentation for the graphics package, available from <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 @@ and Pantones. <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 @@ example: \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 @@ nest too deeply lest you and the reader lose track of the color history. <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 @@ and LaTeX use compatible. </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 @@ and do its best to recover by discarding the current color history. </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 @@ be done by prefixing the color command with <code>\leavevmode</code>. </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 @@ compatible with some form of color support. </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 @@ interpreter) the PostScript commands ‘<samp>setcmykcolor</samp>’ and ‘<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,36 +5202,32 @@ predefine other colors for your users. </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 ‘<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 @@ pattern (assuming such exists.) </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 @@ categories of color-like state. </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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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,21 +6138,21 @@ Previous: <a href="#Color" accesskey="p" rel="prev">Color</a>, Up: <a href="#Top <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> <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> diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf Binary files differindex 516f2bf506f..7f9608ceec8 100644 --- a/Master/texmf-dist/doc/dvips/dvips.pdf +++ b/Master/texmf-dist/doc/dvips/dvips.pdf diff --git a/Master/texmf-dist/doc/info/dvips.info b/Master/texmf-dist/doc/info/dvips.info index 15ad0b2d5c9..e4e99c5ec26 100644 --- a/Master/texmf-dist/doc/info/dvips.info +++ b/Master/texmf-dist/doc/info/dvips.info @@ -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 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) 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. diff --git a/Master/texmf-dist/doc/info/kpathsea.info b/Master/texmf-dist/doc/info/kpathsea.info index 57d9c99d386..401a14dd46c 100644 --- a/Master/texmf-dist/doc/info/kpathsea.info +++ b/Master/texmf-dist/doc/info/kpathsea.info @@ -3,7 +3,7 @@ kpathsea.texi. 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 @@ Kpathsea library **************** 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 @@ File: kpathsea.info, Node: Introduction, Next: unixtex.ftp, Prev: Top, Up: T 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 @@ File: kpathsea.info, Node: Brace expansion, Next: KPSE_DOT expansion, Prev: T 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 @@ example, 'x{A,B}{1,2}y' expands to 'x{A,B}1y:x{A,B}2y', which expands to 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 @@ filename, and returns the first file found. '--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 @@ Kpsewhich provides some features in addition to path lookup as such: 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 @@ Kpsewhich provides some features in addition to path lookup as such: => 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,11 +1472,33 @@ Kpsewhich provides some features in addition to path lookup as such: 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 @@ You can (and probably should) use the same 'texmf.cnf' configuration 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 @@ running a normal input file, the problem is usually a compiler bug 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 @@ also recommend reporting a bug to the GCC mailing list; see *note 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 @@ Index * --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 @@ Index * -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 @@ Index * 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 @@ Index * 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 @@ Index * 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 @@ Index * 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 @@ Index (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 @@ Index * 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 @@ Index * 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 @@ Index * 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 @@ Index * 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: Default expansion27426 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 diff --git a/Master/texmf-dist/doc/info/tlbuild.info b/Master/texmf-dist/doc/info/tlbuild.info index dc2bb104274..9ce25d8b336 100644 --- a/Master/texmf-dist/doc/info/tlbuild.info +++ b/Master/texmf-dist/doc/info/tlbuild.info @@ -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 @@ END-INFO-DIR-ENTRY 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,45 +59,47 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 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) 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 @@ File: tlbuild.info, Node: Overview of build system, Next: Prerequisites, Prev 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 @@ 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, '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 @@ independently. The corresponding modules use (most of) the distributed 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,20 +159,21 @@ File: tlbuild.info, Node: Prerequisites, Next: Building, Prev: Overview of bu *************** 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'. - However, a few programs in the tree have additional requirements: + 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. -'dvisvgm' - requires a C++11 compiler, such as gcc 4.8.1 (or later) or clang - 3.3 (or later). + However, a few programs in the tree have additional requirements: 'web2c' requires 'perl' for some tests run by 'make check'. @@ -185,8 +188,9 @@ Automake/Autoconf output in general) should work with any reasonable 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,14 +199,17 @@ Lacking the required tools, building these programs must avoided, e.g., 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'. * 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 @@ timestamps--notably, 'use-commit-times' must be set to 'yes' in your 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 @@ File: tlbuild.info, Node: Building, Next: Installing, Prev: Prerequisites, U 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 @@ File: tlbuild.info, Node: Build iteration, Next: Build problems, Up: Building 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 @@ iterations consist of two steps: '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 @@ File: tlbuild.info, Node: Build problems, Next: Build in parallel, Prev: Buil 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 @@ File: tlbuild.info, Node: Build in parallel, Next: Build distribution, Prev: ===================== 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 @@ all of TL. 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 @@ To build one package, the basic idea is to use the 'configure' option '--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 @@ finish for working on 'dvipdfm-x'. 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 @@ finish for working on 'dvipdfm-x'. # 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 @@ 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 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 @@ specify the compilers to be used with the environment variables 'CC', '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 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.6 Cross compilation +4.7 Cross compilation ===================== In a cross compilation a "build" system is used to create binaries to be @@ -425,7 +458,7 @@ MacOSX system one could use: 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 @@ C and C++ programs required for the build process as configure arguments 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 @@ during the cross compilation. 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 @@ This section discusses the results of 'make install' in the source tree. 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 @@ Running 'make install' (or 'make install-strip') installs executables in '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 @@ except possibly modified as follows: 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 @@ elsewhere with copies under 'texk/texlive/linked_scripts'. '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 @@ stay in sync across the different supported operating systems. 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 @@ different from a "distro" build needed by, e.g., a full GNU/Linux or BSD 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 @@ find most relevant: 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 @@ find most relevant: (*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 @@ build and install them together with some of their support files. * 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 @@ File: tlbuild.info, Node: Build system tools, Next: Top-level directories, Up 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 @@ many extra hassles, so don't do that, tempting as it may be. 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 @@ dependencies have been changed. This can be done explicitly with the 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 @@ configured for the benefit of 'make' targets such as 'dist' or 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). - - 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. +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). 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 @@ File: tlbuild.info, Node: Autoconf macros, Next: Library modules, Prev: Top-l 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 @@ The TL sources use two general setup macros: '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 @@ File: tlbuild.info, Node: Macros for programs, Next: Macros for compilers, Pr 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 @@ Macros for compiler-related checks: 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 @@ Macros for compiler-related checks: -- 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 @@ Macros for compiler-related checks: -- 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,10 +949,12 @@ library. E.g., for 'libs/libpng': -- 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 @@ -941,7 +978,7 @@ and its 'Makefile.am' would be along these lines: ## 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 @@ Windows differs in several aspects from Unix-like systems, many of them 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 @@ due to the lack of symbolic links. 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 @@ File: tlbuild.info, Node: png library, Next: zlib library, Up: Library module 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 @@ thus providing the simple C code 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, 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.) - 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/'. + 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,11 +1116,15 @@ File: tlbuild.info, Node: freetype library, Next: kpathsea library, Prev: zli 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 @@ File: tlbuild.info, Node: kpathsea library, Prev: freetype library, Up: Libra ----------------------------------------------- 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. - - 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. - - 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. +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 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 '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 @@ File: tlbuild.info, Node: t1utils package, Next: xindy package, Up: Program m 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,23 +1193,24 @@ File: tlbuild.info, Node: xindy package, Next: xdvik package, Prev: t1utils p ------------------------------------------ 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 @@ File: tlbuild.info, Node: xdvik package, Next: asymptote, Prev: xindy package ----------------------------------------- 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 @@ File: tlbuild.info, Node: asymptote, Prev: xdvik package, Up: Program modules 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 @@ This section outlines the basic process for adding new packages to the 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 @@ mandatory first argument and three optional arguments: 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 @@ compile using the source files in '...-src'. 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 @@ File: tlbuild.info, Node: Adding a new generic library module, Next: Adding a 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 @@ sources and build system for the library (and any installable support 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 @@ system version. 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 @@ other TeX-specific libraries but must not depend on any generic library 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 @@ at the top level gives an exhaustive list of all global options and a 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 @@ by the TeX user groups. This requires GNU 'make' and implies 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 @@ File: tlbuild.info, Node: --disable-largefile, Next: --disable-missing, Prev: 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,15 +1534,12 @@ File: tlbuild.info, Node: --enable-compiler-warnings=LEVEL, Next: --enable-cxx 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. - - At present, these warning flags are only defined for the GNU -compilers but flags for other compilers could be added when needed. +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. 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 @@ File: tlbuild.info, Node: --enable-cxx-runtime-hack, Next: --enable-maintainer 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 @@ File: tlbuild.info, Node: --enable-multiplatform, Next: --enable-shared, Prev 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 @@ File: tlbuild.info, Node: --enable-silent-rules, Next: --without-ln-s, Prev: ------------------------------ 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 @@ File: tlbuild.info, Node: --without-ln-s, Next: --without-x, Prev: --enable-s 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 @@ File: tlbuild.info, Node: --enable-PROG --disable-PROG, Next: --disable-all-pk 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 @@ enabled. This is useful when one wants to work on only a single 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 @@ File: tlbuild.info, Node: Configure options for texk/web2c, Next: Configure op ---------------------------------------- '--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 @@ Do not or do build the various TeX, Metafont, and MetaPost engines (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 @@ from linking explicitly with dependencies of 'libfontconfig' such as '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 @@ created by default. In addition, 'dvipdfm' is created as a symlink to '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 @@ File: tlbuild.info, Node: Configure options for texk/dvisvgm, Next: Configure '--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,15 +1798,15 @@ File: tlbuild.info, Node: Configure options for texk/xdvik, Next: Configure op ---------------------------------------- '--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 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 @@ Build and install 'xindy' documentation (default: yes, except for a 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 @@ with this generic one: 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 @@ File: tlbuild.info, Node: Configure options for kpathsea, Next: Configure opti -------------------------------------- '--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 @@ Determine the compile time default whether or not to run CMD, one of: (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,19 +1891,17 @@ File: tlbuild.info, Node: Configure options for system poppler, Prev: Configur 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 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 @@ but that might not work for cross compilations. '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 @@ but that might not work for cross compilations. 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 @@ 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 -'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 @@ all function prototypes and definitions must conform to the ANSI C 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 @@ verify that they are available and otherwise provide an alternative. 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 @@ the perhaps slightly less efficient alternative } #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,16 +2048,16 @@ quantity supposed to be constant. 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' ................................. 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 @@ File: tlbuild.info, Node: Continuous integration, Next: install-tl, Prev: Cod 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 @@ File: tlbuild.info, Node: Transfer from Subversion to Github, Next: Automatic 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@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@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 @@ _admin_ has installed a cron job on 'texlive.info' running every 30 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 @@ File: tlbuild.info, Node: CI testing on Travis-CI, Prev: Automatic update of t 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 @@ by either a space or '='. _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 @@ Index * --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 @@ Index * --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 @@ Index (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 @@ Index * --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,15 +5157,15 @@ Index * 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) * 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 @@ Index * 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 @@ Index * 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,22 +5198,20 @@ Index * 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. (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 @@ Index * 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 @@ Index * 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 @@ Index (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 @@ Index * 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 @@ Index * 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 @@ Index * 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 @@ Index * 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 @@ Index (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 @@ Index * 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 @@ Index * 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 @@ Index * 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,19 +5465,19 @@ Index * 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) * 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 @@ Index * 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 @@ Index * 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 @@ Index (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 @@ Index * 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 @@ Index * 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,18 +5572,18 @@ Index (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. (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 @@ Index 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 diff --git a/Master/texmf-dist/doc/info/web2c.info b/Master/texmf-dist/doc/info/web2c.info index a8c61bf1d05..9403f7e81a1 100644 --- a/Master/texmf-dist/doc/info/web2c.info +++ b/Master/texmf-dist/doc/info/web2c.info @@ -58,7 +58,7 @@ Web2c 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 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 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 diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.html b/Master/texmf-dist/doc/kpathsea/kpathsea.html index 1099a4a469a..64fca6da621 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.html +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.html @@ -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 @@ Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the TeX Users Group. --> -<!-- Created by GNU Texinfo 6.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 @@ approved by the TeX Users Group. --> <!-- 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 @@ ul.no-bullet {list-style: none} -<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 @@ this library: <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 @@ you have to distribute the source to your program using the library, 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,36 +262,34 @@ proceedings, and arranges courses on TeX for all levels of users throughout the world. See <a href="https://tug.org">https://tug.org</a> for information. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#History" accesskey="1">History</a>:</td><td> </td><td align="left" valign="top"> +<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 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 @@ to implement subdirectory searching, since I couldn’t stand putting 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,22 +324,22 @@ They weren’t yet a library, though. I just kept things up to date 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 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 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 @@ smaller than a company with a million-dollar-a-year legal budget. Which 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 @@ where Kpathsea is now maintained. <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@tug.org">tex-k@tug.org</a> with comments or questions. @@ -422,9 +405,9 @@ distributions. 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 @@ Comprehensive TeX Archive Network), <a href="https://ctan.org">https://ctan.org< <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,20 +460,20 @@ and friends. Where do these files get installed? By default, the 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> 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 @@ user). Then users must invoke the scripts to install things. (If 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 @@ always set. </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,50 +592,46 @@ extracted from the TDS document: <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 (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 @@ come from (a combination of) many sources; see below. To look up a file 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 @@ file being searched for. (To help speed future lookups of files in the 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 @@ final check is made for a case-insensitive match. Thus, looking for a 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 @@ magic specifications into the basic directory name or names. This 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,37 +727,35 @@ algorithm when searching for a file of a particular type (see <a href="#File-loo </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> 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 @@ debugging options (see <a href="#Debugging">Debugging</a>). <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 @@ just the first one found; definitions in earlier files override those in 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 @@ to look at the distributed <samp>texmf.cnf</samp>, which uses or at least 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 @@ start a comment. Examples: 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 @@ lines is not ignored. <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 @@ component of <code>argv[0]</code> is) <var>progname</var> or <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.latex2e = $latex2e_inputs 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 @@ advantage in this, since all the information would have to passed back to Kpathsea and parsed there anyway, since the <code>sh</code> process couldn’t affect its parent’s environment. </p> -<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 @@ contain a directory or file <samp>baz</samp>. <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 @@ Or, with Dvips’ configuration files, that an extra colon in 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,26 +993,24 @@ any others in place (they will eventually be ignored). Kpathsea checks 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>. </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 @@ of everything up to the next ‘<samp>}</samp>’ (braces may not be nes 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 @@ setenv TEXINPUTS .:$tex:${tex}prev 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,30 +1080,28 @@ checked instead of <code>HOME</code>. <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>’ 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 @@ For example: </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 @@ separator on the current system; e.g., on a DOS system, it’s ‘<samp> ‘<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 @@ change the working directory. You should not ever define it yourself. </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 @@ subdirectories which match those components are included. For example, <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 @@ and do no more work. 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 @@ be explained without reference to the implementation, so read 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,35 +1234,33 @@ for each path element in turn, if no match is found by the normal 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 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 @@ whatever reason, it has become much more common since Apple also went 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 @@ always been true. </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 @@ tr ':' '\n' </tmp/texdirs >/tmp/texdirlist # colons to newlines 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 @@ only useful for debugging. If your <code>find</code> does not support <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 @@ happens with the elements of the leaf directory. <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 @@ to “8.3” filename conventions in source files. 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 @@ hierarchies. 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 @@ almost certainly want to invoke it via <code>cron</code>, so when you make 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 @@ not contain any usable entries. The usual culprit is running plain 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 @@ is not in any of the default search paths. </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 @@ aliases. </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 @@ btxdoc.bib <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 @@ Options can start with either ‘<samp>-</samp>’ or ‘<samp>--</s 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 @@ filename, and returns the first file found. </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,17 +1689,17 @@ casefolding itself. </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. </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 @@ namely ‘<samp>$TEXMF/web2c{/$engine,}</samp>’.) </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,16 +1803,16 @@ bltxml: .bltxml </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> </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,20 +1821,20 @@ are enabled for TeX. This option implies setting </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. </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,14 +1844,14 @@ directory expansion of a path, instead of doing a one-shot lookup, see </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>). </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 @@ in <samp>/some/coincidental/pkg1/path/</samp>, and we wouldn’t want to mat <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 @@ with their corresponding format: </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,38 +2001,37 @@ look for the file <samp>pdftexconfig.tex</samp> instead.) <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). </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,27 +2049,29 @@ $ kpsewhich --expand-path '/nonesuch' </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> </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,56 +2079,77 @@ settings (see <a href="#Calling-sequence">Calling sequence</a>). </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 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 @@ contents—if a GF file is (mis)named <samp>cmr10.600pk</samp>, it will be found as a PK file. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Supported-file-formats" accesskey="1">Supported file formats</a>:</td><td> </td><td align="left" valign="top">File types Kpathsea knows about. +<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 @@ the search path, and most have a default suffix that plays a role in 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,77 +2214,77 @@ list by giving the ‘<samp>--help-formats</samp>’ option to <code>kps </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>’. </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>’. </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>’. </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>’. </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>’. </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,182 +2292,182 @@ additional suffix ‘<samp>.ch</samp>’. </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>’. </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>’. </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>’. </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>’. </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>’. </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>’. </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>. </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>’. </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>’. </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 @@ dynamic creation program: <code>MakeOmegaOCP</code>. </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,55 +2484,55 @@ dynamic creation program: <code>MakeOmegaOFM</code>. </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>’. </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>’. </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>’. </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>’. </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,34 +2540,34 @@ dynamic creation program: <code>mktexpk</code>. </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>’. </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>’. </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,86 +2575,86 @@ dynamic creation program: <code>mktextex</code>. </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>. </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 @@ additional suffix ‘<samp>.ch</samp>’. </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 @@ this gives us the following table. </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 @@ non-metric) files. </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 @@ Each program has its own font override path as well; e.g., <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 @@ the fontmaps. Example: given ‘<samp>foo.bar</samp>’, we also look f 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 @@ always tried; the difference is the order in which they are tried. 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 @@ debugging options (see <a href="#Debugging">Debugging</a>). </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 @@ generate the font (see <a href="#mktex-scripts">mktex scripts</a>) 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 @@ path for a file ‘<samp><var>name</var>.<var>dpi</var><var>format</var></sa ‘<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 @@ slightly more than the 0.2% minimum allowed by the DVI standard </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 @@ are found are read; earlier definitions override later ones. <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 @@ file is; TeX documents will find their favorite name. <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 @@ The Fontname distribution has much more information on font naming </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> - -<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> - -<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="Fallback-font-1"></span><h4 class="subsection">6.3.3 Fallback font</h4> + +<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> + +<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 @@ Kpathsea looks first for a program-specific environment variable (e.g., 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 @@ must enable this feature by calling <code>kpathsea_init_prog</code> </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 @@ possibilities: </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 @@ appropriate. </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 @@ file it created (and nothing else) to standard output; it can write diagnostics to standard error. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#mktex-configuration" accesskey="1">config</a>:</td><td> </td><td align="left" valign="top"> +<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 @@ absence of <code>configure</code> options specifying otherwise, everything 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 @@ options to change the defaults are: 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 @@ it’s an arbitrary Bourne shell script. The distribution contains a 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,23 +3170,23 @@ directory is used. </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. </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,83 +3207,83 @@ the emulation programs don’t consult <samp>mktex.opt</samp>. </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>). </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. </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 <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. </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,75 +3292,73 @@ feature is enabled, and if set to ‘<samp>0</samp>’, the feature is d <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. </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. </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 @@ configuration file value. </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,41 +3405,37 @@ script. <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 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 @@ its own config files. Web2c is source code I also maintain, so it 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 @@ disappear, and can reliably continue to be used when they suffice, as 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,15 +3472,15 @@ looking up particular kinds of files. In view of the way the headers 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 <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 @@ above, of course. </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,25 +3525,25 @@ If the third argument is <code>NULL</code>, the value of the second argument 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 <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 @@ configuration file to allow people to invoke TeX from anywhere. You 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,18 +3561,18 @@ and Web2c), or you can just omit this altogether (people can always set <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 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 @@ and other random information. (A search path is always initialized at 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 @@ is <code>kpathsea_find_glyph</code>, defined in 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 @@ necessary (unless the search path specified ‘<samp>!!</samp>’, etc.) 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,25 +3623,25 @@ synonyms for ‘<samp>r</samp>’.) The function <code>kpathsea_out_name 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. </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 @@ filename-related: default path, tilde, and variable expansion, <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 @@ They are available from <a href="http://www.gnu.org/software">http://www.gnu.org </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 @@ mode. </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> -<a name="index-kpathsea_005fcnf_005fget"></a> -<a name="index-cnf_002eh"></a> +<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> +<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 @@ with the string <var>var</var>. </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@tug.org">tex-k@tug.org</a> using the bug checklist below. </p> @@ -3817,30 +3750,28 @@ inconsistent behavior, but unclear or incomplete explanations, typos, wrong fonts, … </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Bug-checklist" accesskey="1">Bug checklist</a>:</td><td> </td><td align="left" valign="top">What to include in a good bug report. +<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,24 +3784,24 @@ information necessary for reproduction. Therefore, to enable 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>’. 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 @@ file (and any EPS or other files it uses)—TeX source files are 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 @@ diagnosing, or fixing the bug. <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@tug.org">tex-k@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 @@ full TeX system or how to use LaTeX, please see </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,38 +3907,38 @@ than those below). It’s best to give the ‘<samp>-d</samp>’ (o 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"> <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. </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 @@ nonexistent file that must exist is searched for. </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 @@ using <samp>ls-R</samp>. </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 @@ redefining ‘<samp>fopen</samp>’ (‘<samp>fclose</samp>’) </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 @@ contents of the <code>kpse_format_info_type</code> structure defined in </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 @@ searches. This is only relevant when Kpathsea searches the disk, since </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,20 +4001,20 @@ what is in your input file. </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. </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,16 +4026,16 @@ parameters from <code>mktexnam</code>, filenames added by </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. </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 @@ variable in <samp>kpathsea/db.c</samp>.) </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 @@ call). The second word is the filename. 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 @@ else. </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,16 +4146,16 @@ debugging options helpful. See <a href="#Debugging">Debugging</a>. 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 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 @@ fonts by hand with Metafont, or to grab them from a CTAN site <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 @@ precisely when the disk or network is being pounded. See <a href="#Debugging">D </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 @@ highest-possible quality of output. Some DVI-to-whatever programs, 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 @@ mktexpk: Use a config file to specify the mode, or update me. specifying the resolution, as in <code>-D 360</code>, is not enough. </p> <p>You can specify the mode name with the <code>-mode</code> option on the -Dvips command line, or in a Dvips configuration file (see <a href="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 @@ a configuration file: 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 @@ mode is wrong, and you should override it as above. <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,67 +4289,59 @@ a file <samp>modes.mf</samp>, run the following command (assuming Unix): <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 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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <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> diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf Binary files differindex cf88c22dea7..7e52b1d972b 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html index 223cee7a568..5cdc2124c48 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html @@ -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 @@ Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the TeX Users Group. --> -<!-- Created by GNU Texinfo 6.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 @@ approved by the TeX Users Group. --> <!-- 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 @@ ul.no-bullet {list-style: none} </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,339 +67,335 @@ ul.no-bullet {list-style: none} -<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 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 @@ all <code>configure</code> options. </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,72 +442,71 @@ independently. The corresponding modules use (most of) the 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. </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 @@ programs must avoided, e.g.,<br> </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 @@ programs must avoided, e.g.,<br> </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 @@ your timestamps—notably, <code>use-commit-times</code> must be set to <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. -</p> -<a name="index-source-directory-building_002c-not-supported"></a> -<a name="index-build-directory_002c-required"></a> +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> +<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. </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-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-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-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-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-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="#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-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="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="#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 @@ etc. </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 @@ suffices to build and install all of TL. <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 @@ finish for working on <code>dvipdfm-x</code>. <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,72 +732,111 @@ mkdir Work && cd Work # 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 </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.) -</p> -<a name="index-CC_003dc_002dcompiler"></a> -<a name="index-CXX_003dc_002b_002b_002dcompiler"></a> -<a name="index-OBJCXX_003dobjc_002dcompiler"></a> +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> +<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> +<span id="Build-one-engine"></span><div class="header"> +<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> +<span id="Build-one-engine-1"></span><h3 class="section">4.6 Build one engine</h3> + +<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> -<a name="Cross-compilation"></a> -<div class="header"> +<span id="Cross-compilation"></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> +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> -<a name="Cross-compilation-1"></a> -<h3 class="section">4.6 Cross compilation</h3> +<span id="Cross-compilation-1"></span><h3 class="section">4.7 Cross compilation</h3> -<a name="index-cross-compilation"></a> +<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 @@ compilation at all. In most such cases it suffices to specify 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 @@ MacOSX system one could use: </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 @@ variables: <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 @@ compiler. If necessary, you can specify compilers and flags for the 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 @@ BUILDLDFLAGS=… </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 @@ compile and link the test program but cannot execute it. Such tests 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,80 +963,76 @@ into a subdirectory that is configured natively as is done for 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 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 @@ scripts”, see <a href="#Linked-scripts">Linked scripts</a>) in 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,27 +1077,25 @@ directories used in the TL distribution. 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. </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 @@ elsewhere with copies under <samp>texk/texlive/linked_scripts</samp>. 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 @@ build and your distro can be distinguished from others. </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 @@ you shouldn’t install there for a distro. </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 @@ rules to build and install them together with some of their support 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,53 +1274,56 @@ may be. </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 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.) -</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 +<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> + +<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 @@ source tree. (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,205 +1351,190 @@ library can be used. This ultimately determines which modules need to 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). -</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> +<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> +<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. </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> <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,40 +1542,42 @@ suitable <code>-D</code> flags (optionally including <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 <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 @@ foo_DEPENDENCIES = ${ZLIB_DEPEND} ${LIBPNG_DEPEND} @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,48 +1614,46 @@ KPSE_RESTORE_FLAGS # <span class="roman">restore <code>CPPFLAGS</code> and <code <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>). </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>). </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 @@ is used on Windows instead of symlinks for the “linked scripts” </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,58 +1674,54 @@ as <code><var>bar</var>.exe</code> is used on Windows instead of a symlink <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"> <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,48 +1739,50 @@ int main () 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. -</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>. -</p> -<a name="index-kpse_002dlibpng_002dflags_002em4"></a> -<a name="index-KPSE_005fLIBPNG_005fFLAGS-1"></a> +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> +<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> +<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 <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 @@ without the dependency on any other library. The file </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. -</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. -</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, +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> +<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> +<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,54 +1900,52 @@ supplies the configure option <code>--disable-t1utils</code>. </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> <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 @@ KPSE_ENABLE_PROG([xdvik], [kpathsea freetype2], [x]) 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 @@ arguments: <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 @@ perhaps they won’t have to be. </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,38 +2123,36 @@ directory, <code>make</code> in the build directory, etc. </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> 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 @@ as the mandatory first argument and two additional arguments for the 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 @@ setting up the <code>make</code> variables <code><var>LIB</var>_INCLUDES</code>, 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 @@ included in the same general ways as a generic library (see the 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,86 +2223,82 @@ described here. The command<br> <code>configure --help</code>< 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 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 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 @@ implies <code>--enable-multiplatform</code> and 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,87 +2361,75 @@ be <em><2</em>GB when using <samp>poppler</samp> version 0.22 or before </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. </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. -</p> -<p>At present, these warning flags are only defined for the GNU compilers -but flags for other compilers could be added when needed. +<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> <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,134 +2438,117 @@ subdirectories. </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). </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 @@ explicitly disabled or specify <code>disable</code> in their </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 @@ code. If one or both of these options are given, the required flags 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,147 +2697,138 @@ created by default. In addition, <samp>dvipdfm</samp> is created as a 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. </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>. </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 @@ the required flags. 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 @@ whether or not to run <var>cmd</var>, one of: </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,73 +2928,73 @@ compilations. </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>. </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. </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 @@ commands used, e.g., to build the <code>xindy</code> documentation. <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 @@ standard (including <code>void</code> 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 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 @@ static inline char *stpcpy(char *dest, const char *src) #endif </pre></div> -<p>in the file <samp>Utility.h</samp>. -</p> - -<a name="Static-functions"></a> -<h4 class="subsubheading">Static functions</h4> +<span id="Static-functions"></span><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,30 +3091,26 @@ consistency between definition and use. There should be no <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 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 @@ char*const*</code> variable, but not for a type <code>const char**</code> variab 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 @@ cause the modification of quantities supposed to be constant. </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@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 @@ Subversion, back to <code>master</code> on <code>texlive.info</code>, and from 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 @@ Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl <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 @@ initial installation is complete. 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 @@ Internet at <a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/ <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 @@ option by either a space or <code>=</code>. </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 @@ following modules are supported: </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 @@ available, installation continues in text mode. </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 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW). </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 @@ are accepted as aliases for this option. </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 @@ choose a good host for you. </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 @@ settings. </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 @@ the current system are present. The installation will continue as 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,21 +3499,21 @@ building TeX Live, see <a href="http://tug.org/texlive/build.html">http://tug.or </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. </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. </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 @@ variable and <code>perldoc</code> will not be used. </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,14 +3534,14 @@ installer interfaces. USE AT YOUR OWN RISK. </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. </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 @@ release. </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 @@ LWP and persistent connections, use <code>-no-persistent-downloads</code>. </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,31 +3588,31 @@ section of the <code>tlmgr</code> documentation, e.g., </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. </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 @@ menu list. </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 @@ revisions of the used modules are reported, too. </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 @@ that could cause problems later. </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 @@ written, the names above are always used. 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,46 +3788,46 @@ user installations. </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. </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,20 +3836,18 @@ installer interactively and then typing <code>D</code> for the directory menu. </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> </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 @@ GNU General Public License Version 2 or later. <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,23 +3936,21 @@ A TeX Live installation can be customized and managed at any level. 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>: </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 @@ only daily (at most), and not more often. </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 @@ status and description, of searches for <em>what</em> in all packages. 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 @@ between an option name and its value. </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 @@ are accepted as aliases for this option. </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 @@ GUI will be started at the main screen. </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,28 +4040,28 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW). </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. </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. </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. </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 @@ different file for the log. </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,24 +4090,24 @@ disable these persistent connections, use <code>--no-persistent-downloads</code> </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. </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 @@ release and about the <code>tlmgr</code> script itself. If <code>-v</code> is a 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,33 +4212,29 @@ always be detected, but you can set the <code>NOPERLDOC</code> environment 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> <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,21 +4253,21 @@ the <code>option</code> action. </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. </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. </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 @@ of packages together with this option, as desired. </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 @@ performed are written to the terminal. </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 @@ instead since former versions for <code>tlmgr</code> called it that way. </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 @@ runfiles sections. </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 @@ checking the TL development repository. </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 @@ breakage is possible. </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 @@ output is analogous to the <code>--machine-readable</code> output; see </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 @@ location, in this format: <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 @@ extension recreates only that given language file. </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 @@ recommend invoking <code>tlmgr</code> twice.) </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 @@ succession before invoking these programs. 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 @@ but are still supported for backward compatibility. </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 @@ dependencies in a similar way. </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 @@ the name of all dependencies separated by <code>:</code>. </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,26 +4675,22 @@ If both <code>--json</code> and <code>--data</code> are given, <code>--json</cod </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 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,33 +4701,33 @@ dependent. Options: </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). </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. </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 @@ are doing. </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 @@ useful to recover from accidental removal of files in the hierarchy. </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 @@ after all. You can get them by using these options in conjunction with </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 @@ from the local keyring. </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 @@ to the registry and the menus are done for all users on the system 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 @@ some programs, notably <code>dvips</code>. <code>tlmgr</code> does not support 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,59 +5005,55 @@ is issued that the caller does not have enough privileges. </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> </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 @@ platform instead of auto detection. </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 @@ written to the terminal. </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 @@ line, or for all if <code>--all</code> is given. </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 @@ enough permissions, using <code>--w32mode=admin</code> will not succeed. </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 @@ set to 1 (the default), only new associations are added; if it is set to </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,38 +5138,32 @@ set to 1 (the default), only new associations are added; if it is set to </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. <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 @@ package, dependencies are never removed. Options: </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 @@ such a backup, that is, to save a copy of packages before removal. </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 @@ updated, and will be mentioned as <code>forcibly removed</code> in the output of </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 @@ written to the terminal. </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 @@ otherwise, all operations will fail! </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,31 +5295,31 @@ specified, try to restore the package from the specified backup. </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. </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 @@ If both <code>--json</code> and <code>--data</code> are given, <code>--json</cod </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 @@ as a (Perl) regular expression. </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 @@ filenames) to match only full words. For example, searching for </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 @@ the session. </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 @@ current default prompt. </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 @@ must be specified. Options: </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 @@ due to a slow link), see the <code>--exclude</code> option below. </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 @@ updates. </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 @@ given, those packages are checked for updates. </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 @@ the key <code>update-exclude</code>. </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 @@ authors. Therefore this is not recommend. </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 @@ server, then </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 @@ installation with the server’s idea of what is available: </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,19 +5652,19 @@ incompatibility. </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. </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 @@ fallback information, but if you don’t like them accumulating (e.g., 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 @@ ignored. All other lines must look like: </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 @@ ignored. All other lines must look like: </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 @@ Perl and pure Lua modules, are much too slow to be usable in our 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 @@ of these keys are obtainable from the standard key servers. <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 @@ value for <code>--homedir</code>, and <code>TL_GNUPGARGS</code>, which replaces 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 @@ installed into a user tree. <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,39 +5923,33 @@ the user’s <code>updmap.cfg</code> in <code>USERTREE/web2c/</code> is made 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 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>. 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 @@ taken from the new repository, by specifying so-called “pinning” 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 @@ from a given repository: <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 @@ repository. To load a different repository, see the <code>tlmgr</code> menu ite 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,34 +6119,34 @@ reflected right away. </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. </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. </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. </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 @@ i.e., show all available. </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 @@ further details: the long description, included files, etc. </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 @@ guaranteed to reflect what is actually installed. </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,26 +6200,24 @@ the local column, the catalogue version may be stale. </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> </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,26 +6227,26 @@ where the checkbox at the beginning of the package line is ticked. </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. </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). </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 @@ action needs the option <code>backupdir</code> set (see <code>Options -</code> G </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 @@ manually-entered one. Also has the so-necessary <code>quit</code> operation. </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 @@ installation; e.g., when a package is renamed. </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 @@ on Windows). </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,43 +6312,41 @@ on Windows). </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: </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. </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 @@ the Perl/Tk documentation (<a href="http://search.cpan.org/perldoc?Tk">http://se 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 @@ information it needs by reading stdout. <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,14 +6415,14 @@ and the estimated total time. </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. </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,54 +6437,54 @@ each line are separated by a tab. Here are the fields. </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. </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>.) </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,43 +6492,41 @@ the server and is (most probably) part of an installed collection. </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> </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 @@ Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" access 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 @@ GNU General Public License Version 2 or later. </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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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,14 +6722,13 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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> <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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,18 +6908,19 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <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> <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> <tr><td></td><td valign="top"><a href="#index-overall-build-process">overall build process</a>:</td><td> </td><td valign="top"><a href="#Building">Building</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-parallel-build">parallel build</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-paths_002c-for-installation">paths, for installation</a>:</td><td> </td><td valign="top"><a href="#Installation-directories">Installation directories</a></td></tr> <tr><td></td><td valign="top"><a href="#index-PDF-files_002c-size-of">PDF files, size of</a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a></td></tr> @@ -7179,15 +6939,16 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-program-module_002c-adding">program module, adding</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-program-modules">program modules</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-program_002dspecific-configure-options">program-specific <code>configure</code> options</a>:</td><td> </td><td valign="top"><a href="#Program_002dspecific-configure-options">Program-specific configure options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-proxy-build-system">proxy build system</a>:</td><td> </td><td valign="top"><a href="#png-library"><code>png</code> library</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-reautoconf"><code>reautoconf</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-requirements-for-building">requirements for building</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-runscript_002eexe"><code>runscript.exe</code></a>:</td><td> </td><td valign="top"><a href="#Macros-for-Windows">Macros for Windows</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-scripts_002c-linked-and-not-maintained">scripts, linked and not maintained</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-scrolling"><code>scrolling</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></td><td valign="top"><a href="#index-scrolling_002c-smooth"><code>scrolling, smooth</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></td><td valign="top"><a href="#index-SED"><code>SED</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-setup-macros_002c-general">setup macros, general</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-shared-libraries_002c-using-vs_002e-avoiding">shared libraries, using vs. avoiding</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr> @@ -7208,7 +6969,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-synctex-1">synctex</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-system-distribution_002c-building-for">system distribution, building for</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</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-t1utils-package"><code>t1utils <span class="roman">package</span></code></a>:</td><td> </td><td valign="top"><a href="#t1utils-package"><code>t1utils</code> package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tangle"><code>tangle</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-tests_002c-running">tests, running</a>:</td><td> </td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr> @@ -7220,16 +6981,17 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-top_002dlevel-directories">top-level directories</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-touching-files-to-avoid-rerunning">touching files to avoid rerunning</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-Travis_002dCI">Travis-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-type-cast_002c-avoiding">type cast, avoiding</a>:</td><td> </td><td valign="top"><a href="#Const">Const</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-travis_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></td><td valign="top"><a href="#index-type-cast-from-const_002c-avoiding">type cast from const, avoiding</a>:</td><td> </td><td valign="top"><a href="#Const">Const</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-use_002dcommit_002dtimes_002c-Subversion"><code>use-commit-times<span class="roman">, Subversion</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</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-variable-declarations_002c-in-source-code">variable declarations, 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-variables-for-configure">variables for <code>configure</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-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-warning_002c-discards-qualifiers">warning, discards qualifiers</a>:</td><td> </td><td valign="top"><a href="#Const">Const</a></td></tr> <tr><td></td><td valign="top"><a href="#index-WARNING_005fC_005bXX_005dFLAGS"><code>WARNING_C[XX]FLAGS</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-web2c-program"><code>web2c <span class="roman">program</span></code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> @@ -7242,11 +7004,12 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-withenable_002eac_002c-for-new-modules"><code>withenable.ac<span class="roman">, for new modules</span></code></a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Work_002f-top_002dlevel-directory"><samp>Work/</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-wrapper-binary-for-scripts-on-Windows">wrapper binary for scripts on Windows</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-wrapper-build-system">wrapper build system</a>:</td><td> </td><td valign="top"><a href="#freetype-library"><code>freetype</code> library</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-toolkit">X toolkit</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-X11-development_002c-required-by-X-clients">X11 development, required by X clients</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-X11-headers_002c-and-const">X11 headers, 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-X11_002c-required-by-X-clients">X11, required by X clients</a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xasy"><code>xasy</code></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-xaw"><code>xaw</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></td><td valign="top"><a href="#index-xdvik"><code>xdvik</code></a>:</td><td> </td><td valign="top"><a href="#xdvik-package"><code>xdvik</code> package</a></td></tr> @@ -7255,20 +7018,18 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-xindy"><code>xindy</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-xindy-1"><code>xindy</code></a>:</td><td> </td><td valign="top"><a href="#xindy-package"><code>xindy</code> package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xindy-2"><code>xindy</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-xindy-cross-compiling-impossible"><code>xindy</code> cross compiling impossible</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-xindy-cross-compiling-requires-clisp"><code>xindy</code> cross compiling requires <code>clisp</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-XInput"><code>XInput</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></td><td valign="top"><a href="#index-Xlib"><code>Xlib</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-xpdf-as-library"><code>xpdf <span class="roman">as library</span></code></a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-system-poppler">Configure options for system <code>poppler</code></a></td></tr> <tr><td></td><td valign="top"><a href="#index-xz"><code>xz</code></a>:</td><td> </td><td valign="top"><a href="#Linked-scripts">Linked scripts</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-zlib-library"><code>zlib <span class="roman">library</span></code></a>:</td><td> </td><td valign="top"><a href="#zlib-library"><code>zlib</code> library</a></td></tr> <tr><td colspan="4"> <hr></td></tr> </table> <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> diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf Binary files differindex 6311bde0047..52c01dc18b4 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html index 3149ec75a91..7d2c557a111 100644 --- a/Master/texmf-dist/doc/web2c/web2c.html +++ b/Master/texmf-dist/doc/web2c/web2c.html @@ -19,7 +19,7 @@ permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation --> -<!-- 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>Web2c: A TeX implementation</title> @@ -37,23 +37,14 @@ except that this permission notice may be stated in a translation --> <!-- 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} @@ -75,174 +66,170 @@ ul.no-bullet {list-style: none} -<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-configure-options-1" href="#configure-options">2.1 <code>configure</code> options</a></li> - <li><a name="toc-Compile_002dtime-options-1" href="#Compile_002dtime-options">2.2 Compile-time options</a></li> - <li><a name="toc-Additional-targets-1" href="#Additional-targets">2.3 Additional targets</a></li> - <li><a name="toc-Trip_002c-trap_002c-and-mptrap_003a-Torture-tests" href="#Triptrap">2.4 Trip, trap, and mptrap: Torture tests</a></li> - <li><a name="toc-Runtime-options-1" href="#Runtime-options">2.5 Runtime options</a></li> + <li><a id="toc-configure-options-1" href="#configure-options">2.1 <code>configure</code> options</a></li> + <li><a id="toc-Compile_002dtime-options-1" href="#Compile_002dtime-options">2.2 Compile-time options</a></li> + <li><a id="toc-Additional-targets-1" href="#Additional-targets">2.3 Additional targets</a></li> + <li><a id="toc-Trip_002c-trap_002c-and-mptrap_003a-Torture-tests" href="#Triptrap">2.4 Trip, trap, and mptrap: Torture tests</a></li> + <li><a id="toc-Runtime-options-1" href="#Runtime-options">2.5 Runtime options</a></li> </ul></li> - <li><a name="toc-Commonalities-1" href="#Commonalities">3 Commonalities</a> + <li><a id="toc-Commonalities-1" href="#Commonalities">3 Commonalities</a> <ul class="no-bullet"> - <li><a name="toc-Option-conventions-1" href="#Option-conventions">3.1 Option conventions</a></li> - <li><a name="toc-Common-options-1" href="#Common-options">3.2 Common options</a></li> - <li><a name="toc-Path-searching-1" href="#Path-searching">3.3 Path searching</a></li> - <li><a name="toc-Output-file-location-1" href="#Output-file-location">3.4 Output file location</a></li> - <li><a name="toc-Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX" href="#Three-programs">3.5 Three programs: Metafont, MetaPost, and TeX</a> + <li><a id="toc-Option-conventions-1" href="#Option-conventions">3.1 Option conventions</a></li> + <li><a id="toc-Common-options-1" href="#Common-options">3.2 Common options</a></li> + <li><a id="toc-Path-searching-1" href="#Path-searching">3.3 Path searching</a></li> + <li><a id="toc-Output-file-location-1" href="#Output-file-location">3.4 Output file location</a></li> + <li><a id="toc-Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX" href="#Three-programs">3.5 Three programs: Metafont, MetaPost, and TeX</a> <ul class="no-bullet"> - <li><a name="toc-Initial-and-virgin-1" href="#Initial-and-virgin">3.5.1 Initial and virgin</a></li> - <li><a name="toc-Memory-dumps-1" href="#Memory-dumps">3.5.2 Memory dumps</a> + <li><a id="toc-Initial-and-virgin-1" href="#Initial-and-virgin">3.5.1 Initial and virgin</a></li> + <li><a id="toc-Memory-dumps-1" href="#Memory-dumps">3.5.2 Memory dumps</a> <ul class="no-bullet"> - <li><a name="toc-Creating-memory-dumps-1" href="#Creating-memory-dumps">3.5.2.1 Creating memory dumps</a></li> - <li><a name="toc-Determining-the-memory-dump-to-use-1" href="#Determining-the-memory-dump-to-use">3.5.2.2 Determining the memory dump to use</a></li> - <li><a name="toc-Hardware-and-memory-dumps-1" href="#Hardware-and-memory-dumps">3.5.2.3 Hardware and memory dumps</a></li> + <li><a id="toc-Creating-memory-dumps-1" href="#Creating-memory-dumps">3.5.2.1 Creating memory dumps</a></li> + <li><a id="toc-Determining-the-memory-dump-to-use-1" href="#Determining-the-memory-dump-to-use">3.5.2.2 Determining the memory dump to use</a></li> + <li><a id="toc-Hardware-and-memory-dumps-1" href="#Hardware-and-memory-dumps">3.5.2.3 Hardware and memory dumps</a></li> </ul></li> - <li><a name="toc-Editor-invocation-1" href="#Editor-invocation">3.5.3 Editor invocation</a></li> - <li><a name="toc-_005cinput-filenames-1" href="#g_t_005cinput-filenames">3.5.4 <code>\input</code> filenames</a></li> + <li><a id="toc-Editor-invocation-1" href="#Editor-invocation">3.5.3 Editor invocation</a></li> + <li><a id="toc-_005cinput-filenames-1" href="#g_t_005cinput-filenames">3.5.4 <code>\input</code> filenames</a></li> </ul></li> </ul></li> - <li><a name="toc-TeX_003a-Typesetting" href="#TeX">4 TeX: Typesetting</a> + <li><a id="toc-TeX_003a-Typesetting" href="#TeX">4 TeX: Typesetting</a> <ul class="no-bullet"> - <li><a name="toc-tex-invocation-1" href="#tex-invocation">4.1 <code>tex</code> invocation</a></li> - <li><a name="toc-Initial-TeX-1" href="#Initial-TeX">4.2 Initial TeX</a></li> - <li><a name="toc-Formats-1" href="#Formats">4.3 Formats</a></li> - <li><a name="toc-Languages-and-hyphenation-1" href="#Languages-and-hyphenation">4.4 Languages and hyphenation</a> + <li><a id="toc-tex-invocation-1" href="#tex-invocation">4.1 <code>tex</code> invocation</a></li> + <li><a id="toc-Initial-TeX-1" href="#Initial-TeX">4.2 Initial TeX</a></li> + <li><a id="toc-Formats-1" href="#Formats">4.3 Formats</a></li> + <li><a id="toc-Languages-and-hyphenation-1" href="#Languages-and-hyphenation">4.4 Languages and hyphenation</a> <ul class="no-bullet"> - <li><a name="toc-MLTeX_003a-Multi_002dlingual-TeX" href="#MLTeX">4.4.1 MLTeX: Multi-lingual TeX</a> + <li><a id="toc-MLTeX_003a-Multi_002dlingual-TeX" href="#MLTeX">4.4.1 MLTeX: Multi-lingual TeX</a> <ul class="no-bullet"> - <li><a name="toc-_005ccharsubdef_003a-Character-substitutions" href="#g_t_005ccharsubdef">4.4.1.1 <code>\charsubdef</code>: Character substitutions</a></li> - <li><a name="toc-_005ctracingcharsubdef_003a-Substitution-diagnostics" href="#g_t_005ctracingcharsubdef">4.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</a></li> + <li><a id="toc-_005ccharsubdef_003a-Character-substitutions" href="#g_t_005ccharsubdef">4.4.1.1 <code>\charsubdef</code>: Character substitutions</a></li> + <li><a id="toc-_005ctracingcharsubdef_003a-Substitution-diagnostics" href="#g_t_005ctracingcharsubdef">4.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</a></li> </ul></li> - <li><a name="toc-TCX-files_003a-Character-translations" href="#TCX-files">4.4.2 TCX files: Character translations</a></li> - <li><a name="toc-Patgen_003a-Creating-hyphenation-patterns" href="#patgen-invocation">4.4.3 Patgen: Creating hyphenation patterns</a></li> + <li><a id="toc-TCX-files_003a-Character-translations" href="#TCX-files">4.4.2 TCX files: Character translations</a></li> + <li><a id="toc-Patgen_003a-Creating-hyphenation-patterns" href="#patgen-invocation">4.4.3 Patgen: Creating hyphenation patterns</a></li> </ul></li> - <li><a name="toc-Shell-escapes-1" href="#Shell-escapes">4.5 Shell escapes</a></li> - <li><a name="toc-IPC-and-TeX-1" href="#IPC-and-TeX">4.6 IPC and TeX</a></li> - <li><a name="toc-TeX-extensions-1" href="#TeX-extensions">4.7 TeX extensions</a></li> + <li><a id="toc-Shell-escapes-1" href="#Shell-escapes">4.5 Shell escapes</a></li> + <li><a id="toc-IPC-and-TeX-1" href="#IPC-and-TeX">4.6 IPC and TeX</a></li> + <li><a id="toc-TeX-extensions-1" href="#TeX-extensions">4.7 TeX extensions</a></li> </ul></li> - <li><a name="toc-Metafont_003a-Creating-typeface-families" href="#Metafont">5 Metafont: Creating typeface families</a> + <li><a id="toc-Metafont_003a-Creating-typeface-families" href="#Metafont">5 Metafont: Creating typeface families</a> <ul class="no-bullet"> - <li><a name="toc-mf-invocation-1" href="#mf-invocation">5.1 <code>mf</code> invocation</a></li> - <li><a name="toc-Initial-Metafont-1" href="#Initial-Metafont">5.2 Initial Metafont</a></li> - <li><a name="toc-Modes_003a-Device-definitions-for-Metafont" href="#Modes">5.3 Modes: Device definitions for Metafont</a></li> - <li><a name="toc-Online-Metafont-graphics-1" href="#Online-Metafont-graphics">5.4 Online Metafont graphics</a></li> - <li><a name="toc-GFtoDVI_003a-Character-proofs-of-fonts" href="#gftodvi-invocation">5.5 GFtoDVI: Character proofs of fonts</a></li> - <li><a name="toc-MFT_003a-Prettyprinting-Metafont-source" href="#mft-invocation">5.6 MFT: Prettyprinting Metafont source</a></li> + <li><a id="toc-mf-invocation-1" href="#mf-invocation">5.1 <code>mf</code> invocation</a></li> + <li><a id="toc-Initial-Metafont-1" href="#Initial-Metafont">5.2 Initial Metafont</a></li> + <li><a id="toc-Modes_003a-Device-definitions-for-Metafont" href="#Modes">5.3 Modes: Device definitions for Metafont</a></li> + <li><a id="toc-Online-Metafont-graphics-1" href="#Online-Metafont-graphics">5.4 Online Metafont graphics</a></li> + <li><a id="toc-GFtoDVI_003a-Character-proofs-of-fonts" href="#gftodvi-invocation">5.5 GFtoDVI: Character proofs of fonts</a></li> + <li><a id="toc-MFT_003a-Prettyprinting-Metafont-source" href="#mft-invocation">5.6 MFT: Prettyprinting Metafont source</a></li> </ul></li> - <li><a name="toc-MetaPost_003a-Creating-technical-illustrations" href="#MetaPost">6 MetaPost: Creating technical illustrations</a> + <li><a id="toc-MetaPost_003a-Creating-technical-illustrations" href="#MetaPost">6 MetaPost: Creating technical illustrations</a> <ul class="no-bullet"> - <li><a name="toc-mpost-invocation-1" href="#mpost-invocation">6.1 <code>mpost</code> invocation</a></li> - <li><a name="toc-Initial-MetaPost-1" href="#Initial-MetaPost">6.2 Initial MetaPost</a></li> - <li><a name="toc-DVItoMP_003a-DVI-to-MPX-conversion" href="#dvitomp-invocation">6.3 DVItoMP: DVI to MPX conversion</a></li> + <li><a id="toc-mpost-invocation-1" href="#mpost-invocation">6.1 <code>mpost</code> invocation</a></li> + <li><a id="toc-Initial-MetaPost-1" href="#Initial-MetaPost">6.2 Initial MetaPost</a></li> + <li><a id="toc-DVItoMP_003a-DVI-to-MPX-conversion" href="#dvitomp-invocation">6.3 DVItoMP: DVI to MPX conversion</a></li> </ul></li> - <li><a name="toc-BibTeX_003a-Bibliographies" href="#BibTeX">7 BibTeX: Bibliographies</a> + <li><a id="toc-BibTeX_003a-Bibliographies" href="#BibTeX">7 BibTeX: Bibliographies</a> <ul class="no-bullet"> - <li><a name="toc-BibTeX-invocation" href="#bibtex-invocation">7.1 BibTeX invocation</a></li> - <li><a name="toc-Basic-BibTeX-style-files-1" href="#Basic-BibTeX-style-files">7.2 Basic BibTeX style files</a></li> + <li><a id="toc-BibTeX-invocation" href="#bibtex-invocation">7.1 BibTeX invocation</a></li> + <li><a id="toc-Basic-BibTeX-style-files-1" href="#Basic-BibTeX-style-files">7.2 Basic BibTeX style files</a></li> </ul></li> - <li><a name="toc-WEB_003a-Literate-programming" href="#WEB">8 WEB: Literate programming</a> + <li><a id="toc-WEB_003a-Literate-programming" href="#WEB">8 WEB: Literate programming</a> <ul class="no-bullet"> - <li><a name="toc-Tangle_003a-Translate-WEB-to-Pascal" href="#tangle-invocation">8.1 Tangle: Translate WEB to Pascal</a></li> - <li><a name="toc-Weave_003a-Translate-WEB-to-TeX" href="#weave-invocation">8.2 Weave: Translate WEB to TeX</a></li> - <li><a name="toc-Pooltype_003a-Display-WEB-pool-files" href="#pooltype-invocation">8.3 Pooltype: Display WEB pool files</a></li> + <li><a id="toc-Tangle_003a-Translate-WEB-to-Pascal" href="#tangle-invocation">8.1 Tangle: Translate WEB to Pascal</a></li> + <li><a id="toc-Weave_003a-Translate-WEB-to-TeX" href="#weave-invocation">8.2 Weave: Translate WEB to TeX</a></li> + <li><a id="toc-Pooltype_003a-Display-WEB-pool-files" href="#pooltype-invocation">8.3 Pooltype: Display WEB pool files</a></li> </ul></li> - <li><a name="toc-DVI-utilities-1" href="#DVI-utilities">9 DVI utilities</a> + <li><a id="toc-DVI-utilities-1" href="#DVI-utilities">9 DVI utilities</a> <ul class="no-bullet"> - <li><a name="toc-DVIcopy_003a-Canonicalize-virtual-font-references" href="#dvicopy-invocation">9.1 DVIcopy: Canonicalize virtual font references</a></li> - <li><a name="toc-DVItype_003a-Plain-text-transliteration-of-DVI-files" href="#dvitype-invocation">9.2 DVItype: Plain text transliteration of DVI files</a> + <li><a id="toc-DVIcopy_003a-Canonicalize-virtual-font-references" href="#dvicopy-invocation">9.1 DVIcopy: Canonicalize virtual font references</a></li> + <li><a id="toc-DVItype_003a-Plain-text-transliteration-of-DVI-files" href="#dvitype-invocation">9.2 DVItype: Plain text transliteration of DVI files</a> <ul class="no-bullet"> - <li><a name="toc-DVItype-output-example" href="#dvitype-output-example">9.2.1 DVItype output example</a></li> + <li><a id="toc-DVItype-output-example" href="#dvitype-output-example">9.2.1 DVItype output example</a></li> </ul></li> </ul></li> - <li><a name="toc-Font-utilities-1" href="#Font-utilities">10 Font utilities</a> + <li><a id="toc-Font-utilities-1" href="#Font-utilities">10 Font utilities</a> <ul class="no-bullet"> - <li><a name="toc-Font-file-formats-1" href="#Font-file-formats">10.1 Font file formats</a></li> - <li><a name="toc-GFtoPK_003a-Generic-to-packed-font-conversion" href="#gftopk-invocation">10.2 GFtoPK: Generic to packed font conversion</a></li> - <li><a name="toc-PKtoGF_003a-Packed-to-generic-font-conversion" href="#pktogf-invocation">10.3 PKtoGF: Packed to generic font conversion</a></li> - <li><a name="toc-PKtype_003a-Plain-text-transliteration-of-packed-fonts" href="#pktype-invocation">10.4 PKtype: Plain text transliteration of packed fonts</a></li> - <li><a name="toc-GFtype_003a-Plain-text-transliteration-of-generic-fonts" href="#gftype-invocation">10.5 GFtype: Plain text transliteration of generic fonts</a></li> - <li><a name="toc-TFtoPL_003a-TeX-font-metric-to-property-list-conversion" href="#tftopl-invocation">10.6 TFtoPL: TeX font metric to property list conversion</a></li> - <li><a name="toc-PLtoTF_003a-Property-list-to-TeX-font-metric-conversion" href="#pltotf-invocation">10.7 PLtoTF: Property list to TeX font metric conversion</a></li> - <li><a name="toc-VFtoVP_003a-Virtual-font-to-virtual-property-lists" href="#vftovp-invocation">10.8 VFtoVP: Virtual font to virtual property lists</a></li> - <li><a name="toc-VPtoVF_003a-Virtual-property-lists-to-virtual-font" href="#vptovf-invocation">10.9 VPtoVF: Virtual property lists to virtual font</a></li> - <li><a name="toc-Font-utilities-available-elsewhere-1" href="#Font-utilities-available-elsewhere">10.10 Font utilities available elsewhere</a></li> + <li><a id="toc-Font-file-formats-1" href="#Font-file-formats">10.1 Font file formats</a></li> + <li><a id="toc-GFtoPK_003a-Generic-to-packed-font-conversion" href="#gftopk-invocation">10.2 GFtoPK: Generic to packed font conversion</a></li> + <li><a id="toc-PKtoGF_003a-Packed-to-generic-font-conversion" href="#pktogf-invocation">10.3 PKtoGF: Packed to generic font conversion</a></li> + <li><a id="toc-PKtype_003a-Plain-text-transliteration-of-packed-fonts" href="#pktype-invocation">10.4 PKtype: Plain text transliteration of packed fonts</a></li> + <li><a id="toc-GFtype_003a-Plain-text-transliteration-of-generic-fonts" href="#gftype-invocation">10.5 GFtype: Plain text transliteration of generic fonts</a></li> + <li><a id="toc-TFtoPL_003a-TeX-font-metric-to-property-list-conversion" href="#tftopl-invocation">10.6 TFtoPL: TeX font metric to property list conversion</a></li> + <li><a id="toc-PLtoTF_003a-Property-list-to-TeX-font-metric-conversion" href="#pltotf-invocation">10.7 PLtoTF: Property list to TeX font metric conversion</a></li> + <li><a id="toc-VFtoVP_003a-Virtual-font-to-virtual-property-lists" href="#vftovp-invocation">10.8 VFtoVP: Virtual font to virtual property lists</a></li> + <li><a id="toc-VPtoVF_003a-Virtual-property-lists-to-virtual-font" href="#vptovf-invocation">10.9 VPtoVF: Virtual property lists to virtual font</a></li> + <li><a id="toc-Font-utilities-available-elsewhere-1" href="#Font-utilities-available-elsewhere">10.10 Font utilities available elsewhere</a></li> </ul></li> - <li><a name="toc-Legalisms-1" href="#Legalisms">Appendix A Legalisms</a></li> - <li><a name="toc-References-1" href="#References">Appendix B References</a></li> - <li><a name="toc-Index-1" href="#Index">Index</a></li> + <li><a id="toc-Legalisms-1" href="#Legalisms">Appendix A Legalisms</a></li> + <li><a id="toc-References-1" href="#References">Appendix B References</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="Web2c"></a> -<h1 class="top">Web2c</h1> +<span id="Web2c"></span><h1 class="top">Web2c</h1> <p>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. </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">A brief introduction. +<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a></td><td> </td><td align="left" valign="top">A brief 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 Web2c. +<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 Web2c. </td></tr> -<tr><td align="left" valign="top">• <a href="#Commonalities" accesskey="3">Commonalities</a>:</td><td> </td><td align="left" valign="top">Option syntax, standard options, memory dumps. +<tr><td align="left" valign="top">• <a href="#Commonalities" accesskey="3">Commonalities</a></td><td> </td><td align="left" valign="top">Option syntax, standard options, memory dumps. </td></tr> -<tr><td align="left" valign="top">• <a href="#TeX" accesskey="4">TeX</a>:</td><td> </td><td align="left" valign="top">Typesetting. +<tr><td align="left" valign="top">• <a href="#TeX" accesskey="4">TeX</a></td><td> </td><td align="left" valign="top">Typesetting. </td></tr> -<tr><td align="left" valign="top">• <a href="#Metafont" accesskey="5">Metafont</a>:</td><td> </td><td align="left" valign="top">Typeface design. +<tr><td align="left" valign="top">• <a href="#Metafont" accesskey="5">Metafont</a></td><td> </td><td align="left" valign="top">Typeface design. </td></tr> -<tr><td align="left" valign="top">• <a href="#MetaPost" accesskey="6">MetaPost</a>:</td><td> </td><td align="left" valign="top">Technical illustrations. +<tr><td align="left" valign="top">• <a href="#MetaPost" accesskey="6">MetaPost</a></td><td> </td><td align="left" valign="top">Technical illustrations. </td></tr> -<tr><td align="left" valign="top">• <a href="#BibTeX" accesskey="7">BibTeX</a>:</td><td> </td><td align="left" valign="top">Reusable bibliographies. +<tr><td align="left" valign="top">• <a href="#BibTeX" accesskey="7">BibTeX</a></td><td> </td><td align="left" valign="top">Reusable bibliographies. </td></tr> -<tr><td align="left" valign="top">• <a href="#WEB" accesskey="8">WEB</a>:</td><td> </td><td align="left" valign="top">Literate programming. +<tr><td align="left" valign="top">• <a href="#WEB" accesskey="8">WEB</a></td><td> </td><td align="left" valign="top">Literate programming. </td></tr> -<tr><td align="left" valign="top">• <a href="#DVI-utilities" accesskey="9">DVI utilities</a>:</td><td> </td><td align="left" valign="top">DVI expansion. +<tr><td align="left" valign="top">• <a href="#DVI-utilities" accesskey="9">DVI utilities</a></td><td> </td><td align="left" valign="top">DVI expansion. </td></tr> -<tr><td align="left" valign="top">• <a href="#Font-utilities">Font utilities</a>:</td><td> </td><td align="left" valign="top">Font format conversion. +<tr><td align="left" valign="top">• <a href="#Font-utilities">Font utilities</a></td><td> </td><td align="left" valign="top">Font format conversion. </td></tr> -<tr><td align="left" valign="top">• <a href="#Legalisms">Legalisms</a>:</td><td> </td><td align="left" valign="top">Blah blah blah. +<tr><td align="left" valign="top">• <a href="#Legalisms">Legalisms</a></td><td> </td><td align="left" valign="top">Blah blah blah. </td></tr> -<tr><td align="left" valign="top">• <a href="#References">References</a>:</td><td> </td><td align="left" valign="top">Books and such. +<tr><td align="left" valign="top">• <a href="#References">References</a></td><td> </td><td align="left" valign="top">Books and such. </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="#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> -<a name="index-introduction"></a> +<span id="index-introduction"></span> -<p>This manual corresponds to version 2018 of Web2c, released in -February 2018. +<p>This manual corresponds to version 2019 of Web2c, released in +February 2019. </p> -<a name="index-Knuth_002c-Donald-E_002e"></a> -<a name="index-TeX_002c-Web2c-implementation-of"></a> -<a name="index-Hobby_002c-John"></a> -<a name="index-Breitenlohner_002c-Peter"></a> +<span id="index-Knuth_002c-Donald-E_002e"></span> +<span id="index-TeX_002c-Web2c-implementation-of"></span> +<span id="index-Hobby_002c-John"></span> +<span id="index-Breitenlohner_002c-Peter"></span> <p><em>Web2c</em> is the name of a TeX implementation, originally for Unix, but now also running under DOS, Amiga, and other operating systems. By <em>TeX implementation</em>, we mean all of the standard programs @@ -252,21 +239,21 @@ itself. Other programs are also included: DVIcopy, written by Peter Breitenlohner, MetaPost and its utilities (derived from Metafont), by John Hobby, etc. </p> -<a name="index-translation-from-WEB-to-C"></a> -<a name="index-strategy_002c-overall"></a> +<span id="index-translation-from-WEB-to-C"></span> +<span id="index-strategy_002c-overall"></span> <p>General strategy: Web2c works, as its name implies, by translating the WEB source in which TeX is written into C source code. Its output is not self-contained, however; it makes extensive use of many macros and functions in a library (the <samp>web2c/lib</samp> directory in the sources). Therefore, it will not work without change on an arbitrary WEB program. </p> -<a name="index-licensing-terms"></a> -<a name="index-freedom-of-Web2c"></a> -<a name="index-ice-cream"></a> -<a name="index-Henry_002c-Patrick"></a> +<span id="index-licensing-terms"></span> +<span id="index-freedom-of-Web2c"></span> +<span id="index-ice-cream"></span> +<span id="index-Henry_002c-Patrick"></span> <p>Availability: All of Web2c is freely available—“free” both in the sense of no cost (free ice cream) and of having the source code to -modify and/or redistribute (free speech). See <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>, for the practical details of how to obtain Web2c. +modify and/or redistribute (free speech). See <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>, for the practical details of how to obtain Web2c. </p> <p>Different parts of the Web2c distribution have different licensing terms, however, reflecting the different circumstances of their @@ -274,20 +261,20 @@ creation; consult each source file for exact details. The main practical implication for redistributors of Web2c is that the executables are covered by the GNU General Public License, and therefore anyone who gets a binary distribution must also get the sources, as explained -by the terms of the GPL (see <a href="http://tug.org/texinfohtml/kpathsea.html#Copying">Copying</a> in <cite>Kpathsea</cite>). The +by the terms of the GPL (see <a href="https://tug.org/texinfohtml/kpathsea.html#Copying">Copying</a> in <cite>Kpathsea</cite>). The GPL covers the Web2c executables, including <code>tex</code>, because the Free Software Foundation sponsored the initial development of the Kpathsea library that Web2c uses. The basic source files from Stanford, however, have their own copyright terms or are in the public domain, and are not covered by the GPL. </p> -<a name="index-history"></a> -<a name="index-Rokicki_002c-Tomas"></a> -<a name="index-Trickey_002c-Howard"></a> -<a name="index-Curtis_002c-Pavel"></a> -<a name="index-Morgan_002c-Tim"></a> -<a name="index-Berry_002c-Karl"></a> -<a name="index-Weber_002c-Olaf"></a> +<span id="index-history"></span> +<span id="index-Rokicki_002c-Tomas"></span> +<span id="index-Trickey_002c-Howard"></span> +<span id="index-Curtis_002c-Pavel"></span> +<span id="index-Morgan_002c-Tim"></span> +<span id="index-Berry_002c-Karl"></span> +<span id="index-Weber_002c-Olaf"></span> <p>History: Tomas Rokicki originated the TeX-to-C system in 1987, working from the first change files for TeX under Unix, which were done primarily by Howard Trickey and Pavel Curtis. Tim Morgan then took @@ -298,10 +285,10 @@ using the shorter name Web2c. In 1997, Olaf Weber took over. Dozens of other people have contributed; their names are listed in the <samp>ChangeLog</samp> files. </p> -<a name="index-acknowledgements"></a> -<a name="index-Martin_002c-Rick"></a> -<a name="index-Morris_002c-Bob"></a> -<a name="index-Stallman_002c-Richard"></a> +<span id="index-acknowledgements"></span> +<span id="index-Martin_002c-Rick"></span> +<span id="index-Morris_002c-Bob"></span> +<span id="index-Stallman_002c-Richard"></span> <p>Other acknowledgements: The University of Massachusetts at Boston (particularly Rick Martin and Bob Morris) provided computers and ftp access to me for many years. Richard Stallman at the Free Software @@ -310,38 +297,36 @@ Foundation employed me while I wrote the original path searching library without which I cannot imagine developing Web2c.) And, of course, TeX would not exist in the first place without Donald E. Knuth. </p> -<a name="index-reading_002c-additional"></a> +<span id="index-reading_002c-additional"></span> <p>Further reading: See <a href="#References">References</a>. </p> <hr> -<a name="Installation"></a> -<div class="header"> +<span id="Installation"></span><div class="header"> <p> Next: <a href="#Commonalities" accesskey="n" rel="next">Commonalities</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"></a> -<a name="index-compilation"></a> -<a name="index-installation"></a> +<span id="index-configuration"></span> +<span id="index-compilation"></span> +<span id="index-installation"></span> <p>(A copy of this chapter is in the distribution file <samp>web2c/INSTALL</samp>.) </p> <p>Installing Web2c is mostly the same as installing any other 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>. (A copy is in the file +see <a href="https://tug.org/texinfohtml/kpathsea.html#Installation">Installation</a> in <cite>Kpathsea</cite>. (A copy is in the file <samp>kpathsea/INSTALL</samp>.) </p> <p>One peculiarity to Web2c is that the source distribution comes in two files: <samp>web.tar.gz</samp> and <samp>web2c.tar.gz</samp>. You must retrieve and unpack them both. (We have two because the former archive contains the very large and seldom-changing original WEB source files.) -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> -<a name="index-mpost_002c-reason-for-name-change"></a> +<span id="index-mpost_002c-reason-for-name-change"></span> <p>Another peculiarity is the MetaPost program. Although it has been installed previously as <code>mp</code>, as of Web2c 7.0 the installed name is now <code>mpost</code>, to avoid conflict with the <code>mp</code> program that does @@ -351,21 +336,21 @@ available under its shorter name as well, you will have to set up a link or some such yourself. And of course individual users can do the same. </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>). See also the Web2c home page, +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>). See also the Web2c home page, <a href="http://www.tug.org/web2c">http://www.tug.org/web2c</a>. </p> <p>Points worth repeating: </p> <ul> -<li> <a name="index-directory-structure"></a> -<a name="index-basic-fonts-and-macros"></a> -<a name="index-fonts_002c-basic"></a> -<a name="index-macros_002c-basic"></a> +<li> <span id="index-directory-structure"></span> +<span id="index-basic-fonts-and-macros"></span> +<span id="index-fonts_002c-basic"></span> +<span id="index-macros_002c-basic"></span> Before starting the standard compilation and installation you must install the basic fonts, macros, and other library files. -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>. -</li><li> If you do not wish to use the standard file locations, see <a href="http://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing +</li><li> If you do not wish to use the standard file locations, see <a href="https://tug.org/texinfohtml/kpathsea.html#Changing-search-paths">Changing search paths</a> in <cite>Kpathsea</cite>. </li><li> Some Web2c features are enabled or disabled at <code>configure</code> time, @@ -374,31 +359,29 @@ as described in the first section below. </li></ul> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#configure-options" accesskey="1">configure options</a>:</td><td> </td><td align="left" valign="top">Especially –with and –enable. +<tr><td align="left" valign="top">• <a href="#configure-options" accesskey="1">configure options</a></td><td> </td><td align="left" valign="top">Especially –with and –enable. </td></tr> -<tr><td align="left" valign="top">• <a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a>:</td><td> </td><td align="left" valign="top">Unusual -D’s. +<tr><td align="left" valign="top">• <a href="#Compile_002dtime-options" accesskey="2">Compile-time options</a></td><td> </td><td align="left" valign="top">Unusual -D’s. </td></tr> -<tr><td align="left" valign="top">• <a href="#Additional-targets" accesskey="3">Additional targets</a>:</td><td> </td><td align="left" valign="top">Breaking down the task. +<tr><td align="left" valign="top">• <a href="#Additional-targets" accesskey="3">Additional targets</a></td><td> </td><td align="left" valign="top">Breaking down the task. </td></tr> -<tr><td align="left" valign="top">• <a href="#Triptrap" accesskey="4">Triptrap</a>:</td><td> </td><td align="left" valign="top">Running the torture tests. +<tr><td align="left" valign="top">• <a href="#Triptrap" accesskey="4">Triptrap</a></td><td> </td><td align="left" valign="top">Running the torture tests. </td></tr> -<tr><td align="left" valign="top">• <a href="#Runtime-options" accesskey="5">Runtime options</a>:</td><td> </td><td align="left" valign="top">Array sizes and the like. +<tr><td align="left" valign="top">• <a href="#Runtime-options" accesskey="5">Runtime options</a></td><td> </td><td align="left" valign="top">Array sizes and the like. </td></tr> </table> <hr> -<a name="configure-options"></a> -<div class="header"> +<span id="configure-options"></span><div class="header"> <p> Next: <a href="#Compile_002dtime-options" accesskey="n" rel="next">Compile-time options</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-options-1"></a> -<h3 class="section">2.1 <code>configure</code> options</h3> +<span id="configure-options-1"></span><h3 class="section">2.1 <code>configure</code> options</h3> -<a name="index-configuration_002c-compile_002dtime"></a> -<a name="index-compile_002dtime-options"></a> -<a name="index-configure-_002d_002dwith_002f_002d_002denable-options"></a> +<span id="index-configuration_002c-compile_002dtime"></span> +<span id="index-compile_002dtime-options"></span> +<span id="index-configure-_002d_002dwith_002f_002d_002denable-options"></span> <p>This section gives pointers to descriptions of the ‘<samp>--with</samp>’ and ‘<samp>--enable</samp>’ <code>configure</code> arguments that Web2c accepts. Some are specific to Web2c, others are generic to all Kpathsea-using programs. @@ -409,7 +392,7 @@ package-specific options come last. </p> <p>For a description of the generic options (which mainly allow you to specify installation directories) and basic <code>configure</code> usage, -see <a href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a> in <cite>Autoconf</cite>, a copy is in the file <samp>kpathsea/CONFIGURE</samp>. +see <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Invoking-configure">Running <code>configure</code> scripts</a> in <cite>Autoconf</cite>, a copy is in the file <samp>kpathsea/CONFIGURE</samp>. </p> <dl compact="compact"> <dt>‘<samp>--disable-dump-share</samp>’</dt> @@ -421,13 +404,13 @@ architectures. See <a href="#Hardware-and-memory-dumps">Hardware and memory dum <dt>‘<samp>--without-maketexpk-default</samp>’</dt> <dt>‘<samp>--without-maketextfm-default</samp>’</dt> <dt>‘<samp>--with-maketextex-default</samp>’</dt> -<dd><p>Enable or disable the dynamic generation programs. See <a href="http://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex +<dd><p>Enable or disable the dynamic generation programs. See <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>. The defaults are the inverse of the options, i.e., everything is enabled except <code>mktextex</code>. </p> </dd> <dt>‘<samp>--enable-shared</samp>’</dt> -<dd><p>Build Kpathsea as a shared library. See <a href="http://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite>Kpathsea</cite>. +<dd><p>Build Kpathsea as a shared library. See <a href="https://tug.org/texinfohtml/kpathsea.html#Shared-library">Shared library</a> in <cite>Kpathsea</cite>. </p> </dd> <dt>‘<samp>--with-editor=<var>cmd</var></samp>’</dt> @@ -454,23 +437,21 @@ enabled. See <a href="#Online-Metafont-graphics">Online Metafont graphics</a>. <dt>‘<samp>--x-includes=<var>dir</var></samp>’</dt> <dt>‘<samp>--x-libraries=<var>dir</var></samp>’</dt> <dd><p>Define the locations of the X11 include files and libraries; by default, -<code>configure</code> does its best to guess). See <a href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite>Autoconf</cite>. A copy is in <samp>kpathsea/CONFIGURE</samp>. +<code>configure</code> does its best to guess). See <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Optional-Features">Optional Features</a> in <cite>Autoconf</cite>. A copy is in <samp>kpathsea/CONFIGURE</samp>. </p></dd> </dl> <hr> -<a name="Compile_002dtime-options"></a> -<div class="header"> +<span id="Compile_002dtime-options"></span><div class="header"> <p> Next: <a href="#Additional-targets" accesskey="n" rel="next">Additional targets</a>, Previous: <a href="#configure-options" accesskey="p" rel="prev">configure options</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="Compile_002dtime-options-1"></a> -<h3 class="section">2.2 Compile-time options</h3> +<span id="Compile_002dtime-options-1"></span><h3 class="section">2.2 Compile-time options</h3> -<a name="index-compile_002dtime-options-1"></a> -<a name="index-_0023define-options"></a> -<a name="index-_002dD-compiler-options"></a> +<span id="index-compile_002dtime-options-1"></span> +<span id="index-_0023define-options"></span> +<span id="index-_002dD-compiler-options"></span> <p>In addition to the <code>configure</code> options listed in the previous section, there are a few things that can be affected at compile-time with C definitions, rather than with <code>configure</code>. Using any of @@ -482,18 +463,18 @@ simplest thing to do is: <pre class="example">make XCFLAGS="<var>ccoptions</var>" </pre></div> <p>You can also set the <code>CFLAGS</code> environment variable before -running <code>configure</code>. See <a href="http://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite>Kpathsea</cite>. +running <code>configure</code>. See <a href="https://tug.org/texinfohtml/kpathsea.html#configure-environment">configure environment</a> in <cite>Kpathsea</cite>. </p> <p>Anyway, here are the possibilities: </p> <dl compact="compact"> <dt>‘<samp>-DFIXPT</samp>’</dt> <dt>‘<samp>-DNO_MF_ASM</samp>’</dt> -<dd><a name="index-FIXPT"></a> -<a name="index-fixed_002dpoint-arithmetic"></a> -<a name="index-floating_002dpoint-arithmetic"></a> -<a name="index-assembly-language-routines"></a> -<a name="index-fraction-routines"></a> +<dd><span id="index-FIXPT"></span> +<span id="index-fixed_002dpoint-arithmetic"></span> +<span id="index-floating_002dpoint-arithmetic"></span> +<span id="index-assembly-language-routines"></span> +<span id="index-fraction-routines"></span> <p>Use the original WEB fixed-point routines for Metafont and MetaPost arithmetic calculations regarding fractions. By default, assembly-language routines are used on x86 hardware with GNU C (unless @@ -502,24 +483,22 @@ otherwise. </p> </dd> <dt>‘<samp>-DIPC_DEBUG</samp>’</dt> -<dd><a name="index-IPC_005fDEBUG"></a> +<dd><span id="index-IPC_005fDEBUG"></span> <p>Report on various interprocess communication activities. See <a href="#IPC-and-TeX">IPC and TeX</a>. </p></dd> </dl> <hr> -<a name="Additional-targets"></a> -<div class="header"> +<span id="Additional-targets"></span><div class="header"> <p> Next: <a href="#Triptrap" accesskey="n" rel="next">Triptrap</a>, Previous: <a href="#Compile_002dtime-options" accesskey="p" rel="prev">Compile-time options</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="Additional-targets-1"></a> -<h3 class="section">2.3 Additional targets</h3> +<span id="Additional-targets-1"></span><h3 class="section">2.3 Additional targets</h3> -<a name="index-additional-Make-targets"></a> -<a name="index-targets_002c-additional-Make"></a> -<a name="index-Make-targets_002c-additional"></a> +<span id="index-additional-Make-targets"></span> +<span id="index-targets_002c-additional-Make"></span> +<span id="index-Make-targets_002c-additional"></span> <p>Web2c has several Make targets besides the standard ones. You can invoke these either in the top level directory of the source distribution (the @@ -528,16 +507,16 @@ one containing <samp>kpathsea/</samp> and <samp>web2c/</samp>), or in the </p> <dl compact="compact"> <dt>‘<samp>c-sources</samp>’</dt> -<dd><a name="index-c_002dsources-Makefile-target"></a> -<a name="index-non_002dUnix-system_002c-compiling-on"></a> +<dd><span id="index-c_002dsources-Makefile-target"></span> +<span id="index-non_002dUnix-system_002c-compiling-on"></span> <p>Make only the C files, translated from the Web sources, presumably because you want to take them to a non-Unix machine. </p> </dd> <dt>‘<samp>formats</samp>’</dt> <dt>‘<samp>install-formats</samp>’</dt> -<dd><a name="index-formats-Make-target"></a> -<a name="index-install_002dformats-Make-target"></a> +<dd><span id="index-formats-Make-target"></span> +<span id="index-install_002dformats-Make-target"></span> <p>Make or install all the memory dumps (see <a href="#Memory-dumps">Memory dumps</a>). By default, the standard plain formats plus <samp>latex.fmt</samp> are made. You can add other formats by redefining the <code>fmts</code>, <code>bases</code>, and @@ -547,23 +526,23 @@ possibilities. </dd> <dt>‘<samp>fmts</samp>’</dt> <dt>‘<samp>install-fmts</samp>’</dt> -<dd><a name="index-fmts-Make-target"></a> -<a name="index-install_002dfmts-Make-target"></a> +<dd><span id="index-fmts-Make-target"></span> +<span id="index-install_002dfmts-Make-target"></span> <p>Make or install the TeX <samp>.fmt</samp> files. See <a href="#Initial-TeX">Initial TeX</a>. </p> </dd> <dt>‘<samp>bases</samp>’</dt> <dt>‘<samp>install-bases</samp>’</dt> -<dd><a name="index-bases-Make-target"></a> -<a name="index-install_002dbases-Make-target"></a> +<dd><span id="index-bases-Make-target"></span> +<span id="index-install_002dbases-Make-target"></span> <p>Make or install the Metafont <samp>.base</samp> files. See <a href="#Initial-Metafont">Initial Metafont</a>. </p> </dd> <dt>‘<samp>mems</samp>’</dt> <dt>‘<samp>install-mems</samp>’</dt> -<dd><a name="index-mems-Make-target"></a> -<a name="index-install_002dmems-Make-target"></a> +<dd><span id="index-mems-Make-target"></span> +<span id="index-install_002dmems-Make-target"></span> <p>Make or install the MetaPost <samp>.mem</samp> files. See <a href="#Initial-MetaPost">Initial MetaPost</a>. </p> </dd> @@ -571,10 +550,10 @@ possibilities. <dt>‘<samp>trip</samp>’</dt> <dt>‘<samp>trap</samp>’</dt> <dt>‘<samp>mptrap</samp>’</dt> -<dd><a name="index-triptrap-Make-target"></a> -<a name="index-trip-Make-target"></a> -<a name="index-trap-Make-target"></a> -<a name="index-mptrap-Make-target"></a> +<dd><span id="index-triptrap-Make-target"></span> +<span id="index-trip-Make-target"></span> +<span id="index-trap-Make-target"></span> +<span id="index-mptrap-Make-target"></span> <p>To run the torture tests for TeX, Metafont, and MetaPost (respectively). See the next section. </p> @@ -583,23 +562,21 @@ possibilities. <hr> -<a name="Triptrap"></a> -<div class="header"> +<span id="Triptrap"></span><div class="header"> <p> Next: <a href="#Runtime-options" accesskey="n" rel="next">Runtime options</a>, Previous: <a href="#Additional-targets" accesskey="p" rel="prev">Additional targets</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="Trip_002c-trap_002c-and-mptrap_003a-Torture-tests"></a> -<h3 class="section">2.4 Trip, trap, and mptrap: Torture tests</h3> - -<a name="index-Gruff_002c-Billy-Goat"></a> -<a name="index-trip-test"></a> -<a name="index-trap-test"></a> -<a name="index-mptrap-test"></a> -<a name="index-torture-tests"></a> - -<a name="index-tripman_002etex"></a> -<a name="index-trapman_002etex"></a> -<a name="index-mptrap_002ereadme"></a> +<span id="Trip_002c-trap_002c-and-mptrap_003a-Torture-tests"></span><h3 class="section">2.4 Trip, trap, and mptrap: Torture tests</h3> + +<span id="index-Gruff_002c-Billy-Goat"></span> +<span id="index-trip-test"></span> +<span id="index-trap-test"></span> +<span id="index-mptrap-test"></span> +<span id="index-torture-tests"></span> + +<span id="index-tripman_002etex"></span> +<span id="index-trapman_002etex"></span> +<span id="index-mptrap_002ereadme"></span> <p>To validate your TeX, Metafont, and MetaPost executables, run ‘<samp>make triptrap</samp>’. This runs the trip, trap, and mptrap “torture tests”. See the files <samp>triptrap/tripman.tex</samp>, @@ -619,7 +596,7 @@ all acceptable) are: <p>Any other differences are trouble. The most common culprit in the past has been compiler bugs, especially when optimizing. -See <a href="http://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite>Kpathsea</cite>. +See <a href="https://tug.org/texinfohtml/kpathsea.html#TeX-or-Metafont-failing">TeX or Metafont failing</a> in <cite>Kpathsea</cite>. </p> <p>The files <samp>trip.diffs</samp>, <samp>mftrap.diffs</samp>, and <samp>mptrap.diffs</samp> in the <samp>triptrap</samp> directory show the standard @@ -639,22 +616,20 @@ file <samp>tests/check.log</samp> if you like. </p> <hr> -<a name="Runtime-options"></a> -<div class="header"> +<span id="Runtime-options"></span><div class="header"> <p> Previous: <a href="#Triptrap" accesskey="p" rel="prev">Triptrap</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="Runtime-options-1"></a> -<h3 class="section">2.5 Runtime options</h3> +<span id="Runtime-options-1"></span><h3 class="section">2.5 Runtime options</h3> -<a name="index-runtime-options"></a> +<span id="index-runtime-options"></span> -<a name="index-configuration-file-values"></a> -<a name="index-array-sizes"></a> +<span id="index-configuration-file-values"></span> +<span id="index-array-sizes"></span> <p>Besides the configure- and compile-time options described in the previous sections, you can control a number of parameters (in particular, array sizes) in the <samp>texmf.cnf</samp> runtime file read by -Kpathsea (see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). +Kpathsea (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). </p> <p>Rather than exhaustively listing them here, please see the last section of the distributed <samp>kpathsea/texmf.cnf</samp>. Some of the more @@ -662,36 +637,36 @@ interesting values: </p> <dl compact="compact"> <dt>‘<samp>main_memory</samp>’ -<a name="index-main_005fmemory"></a> +<span id="index-main_005fmemory"></span> </dt> <dd><p>Total words of memory available, for TeX, Metafont, and MetaPost. Must remake the format file after changing. </p> </dd> <dt>‘<samp>extra_mem_bot</samp>’ -<a name="index-extra_005fmem_005fbot"></a> +<span id="index-extra_005fmem_005fbot"></span> </dt> -<dd><a name="index-boxes_002c-memory-for"></a> -<a name="index-glue_002c-memory-for"></a> -<a name="index-breakpoints_002c-memory-for"></a> -<a name="index-PiCTeX_002c-increasing-memory-for"></a> +<dd><span id="index-boxes_002c-memory-for"></span> +<span id="index-glue_002c-memory-for"></span> +<span id="index-breakpoints_002c-memory-for"></span> +<span id="index-PiCTeX_002c-increasing-memory-for"></span> <p>Extra space for “large” TeX data structures: boxes, glue, breakpoints, et al. If you use PiCTeX, you may well want to set this. </p> </dd> <dt>‘<samp>font_mem_size</samp>’ -<a name="index-font_005fmem_005fsize"></a> +<span id="index-font_005fmem_005fsize"></span> </dt> -<dd><a name="index-TFM-files_002c-memory-for"></a> +<dd><span id="index-TFM-files_002c-memory-for"></span> <p>Words of font info available for TeX; this is approximately the total size of all TFM files read. </p> </dd> <dt>‘<samp>hash_extra</samp>’ -<a name="index-hash_005fextra"></a> +<span id="index-hash_005fextra"></span> </dt> -<dd><a name="index-control-sequence-names_002c-space-for"></a> -<a name="index-hash-table_002c-increasing-size-of"></a> +<dd><span id="index-control-sequence-names_002c-space-for"></span> +<span id="index-hash-table_002c-increasing-size-of"></span> <p>Additional space for the hash table of control sequence names. Approximately 10,000 control sequences can be stored in the main hash table; if you have a large book with numerous cross-references, @@ -700,10 +675,10 @@ this might not be enough, and thus you will want to set <code>hash_extra</code>. </dd> </dl> -<a name="index-array-limit_002c-fixed"></a> -<a name="index-swap-space_002c-as-array-limit"></a> -<a name="index-reallocation-of-arrays"></a> -<a name="index-dynamic-array-allocation"></a> +<span id="index-array-limit_002c-fixed"></span> +<span id="index-swap-space_002c-as-array-limit"></span> +<span id="index-reallocation-of-arrays"></span> +<span id="index-dynamic-array-allocation"></span> <p>Of course, ideally all arrays would be dynamically expanded as necessary, so the only limiting factor would be the amount of swap space available. Unfortunately, implementing this is extremely difficult, as @@ -715,53 +690,49 @@ reallocation of some arrays.) </p> <hr> -<a name="Commonalities"></a> -<div class="header"> +<span id="Commonalities"></span><div class="header"> <p> Next: <a href="#TeX" accesskey="n" rel="next">TeX</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="Commonalities-1"></a> -<h2 class="chapter">3 Commonalities</h2> +<span id="Commonalities-1"></span><h2 class="chapter">3 Commonalities</h2> -<a name="index-commonalities"></a> +<span id="index-commonalities"></span> <p>Many aspects of the TeX system are the same among more than one program, so we describe all those pieces together, here. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Option-conventions" accesskey="1">Option conventions</a>:</td><td> </td><td align="left" valign="top">– or -, = or ‘ ’ for values. +<tr><td align="left" valign="top">• <a href="#Option-conventions" accesskey="1">Option conventions</a></td><td> </td><td align="left" valign="top">– or -, = or ‘ ’ for values. </td></tr> -<tr><td align="left" valign="top">• <a href="#Common-options" accesskey="2">Common options</a>:</td><td> </td><td align="left" valign="top">–help –version –verbose, and TeX/MF/MP options. +<tr><td align="left" valign="top">• <a href="#Common-options" accesskey="2">Common options</a></td><td> </td><td align="left" valign="top">–help –version –verbose, and TeX/MF/MP options. </td></tr> -<tr><td align="left" valign="top">• <a href="#Path-searching" accesskey="3">Path searching</a>:</td><td> </td><td align="left" valign="top">Features of the common path searching library. +<tr><td align="left" valign="top">• <a href="#Path-searching" accesskey="3">Path searching</a></td><td> </td><td align="left" valign="top">Features of the common path searching library. </td></tr> -<tr><td align="left" valign="top">• <a href="#Output-file-location" accesskey="4">Output file location</a>:</td><td> </td><td align="left" valign="top">TEXMFOUTPUT allows output in places other than ‘.’. +<tr><td align="left" valign="top">• <a href="#Output-file-location" accesskey="4">Output file location</a></td><td> </td><td align="left" valign="top">TEXMFOUTPUT allows output in places other than ‘.’. </td></tr> -<tr><td align="left" valign="top">• <a href="#Three-programs" accesskey="5">Three programs</a>:</td><td> </td><td align="left" valign="top">TeX, Metafont, and MetaPost have a lot in common. +<tr><td align="left" valign="top">• <a href="#Three-programs" accesskey="5">Three programs</a></td><td> </td><td align="left" valign="top">TeX, Metafont, and MetaPost have a lot in common. </td></tr> </table> <hr> -<a name="Option-conventions"></a> -<div class="header"> +<span id="Option-conventions"></span><div class="header"> <p> Next: <a href="#Common-options" accesskey="n" rel="next">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a 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-conventions-1"></a> -<h3 class="section">3.1 Option conventions</h3> +<span id="Option-conventions-1"></span><h3 class="section">3.1 Option conventions</h3> -<a name="index-option-conventions"></a> -<a name="index-conventions-for-options_002c"></a> +<span id="index-option-conventions"></span> +<span id="index-conventions-for-options_002c"></span> -<a name="index-getopt_005flong_005fonly"></a> +<span id="index-getopt_005flong_005fonly"></span> <p>To provide a clean and consistent behavior, we chose to have all these programs use the GNU function <code>getopt_long_only</code> to parse command lines. However, we do use in a restricted mode, where all the options have to come before the rest of the arguments. </p> -<a name="index-_002d-starts-option-names"></a> -<a name="index-_002d_002d-starts-option-names"></a> +<span id="index-_002d-starts-option-names"></span> +<span id="index-_002d_002d-starts-option-names"></span> <p>As a result, you can: </p><ul> <li> use ‘<samp>-</samp>’ or ‘<samp>--</samp>’ to start an option name; @@ -771,8 +742,8 @@ have to come before the rest of the arguments. </li><li> separate option names and values with either ‘<samp>=</samp>’ or one or more spaces; -</li><li> <a name="index-_002d-starting-a-filename"></a> -<a name="index-filenames-starting-with-_002d"></a> +</li><li> <span id="index-_002d-starting-a-filename"></span> +<span id="index-filenames-starting-with-_002d"></span> use filenames that would otherwise look like options by putting them after an option ‘<samp>--</samp>’. </li></ul> @@ -794,15 +765,13 @@ option; and specifies the filename <samp>-myfile-</samp>. <hr> -<a name="Common-options"></a> -<div class="header"> +<span id="Common-options"></span><div class="header"> <p> Next: <a href="#Path-searching" accesskey="n" rel="next">Path searching</a>, Previous: <a href="#Option-conventions" accesskey="p" rel="prev">Option conventions</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a 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-options-1"></a> -<h3 class="section">3.2 Common options</h3> +<span id="Common-options-1"></span><h3 class="section">3.2 Common options</h3> -<a name="index-common-options"></a> +<span id="index-common-options"></span> <p>All of these programs accept the standard GNU ‘<samp>--help</samp>’ and ‘<samp>--version</samp>’ options, and several programs accept ‘<samp>--verbose</samp>’. Rather than writing identical descriptions for @@ -810,21 +779,21 @@ every program, they are described here. </p> <dl compact="compact"> <dt>‘<samp>--help</samp>’</dt> -<dd><a name="index-_002d_002dhelp-common-option"></a> -<a name="index-help_002c-online"></a> +<dd><span id="index-_002d_002dhelp-common-option"></span> +<span id="index-help_002c-online"></span> <p>Print a usage message listing basic usage and all available options to standard output, then exit successfully. </p> </dd> <dt>‘<samp>--verbose</samp>’</dt> -<dd><a name="index-_002d_002dverbose-common-option"></a> -<a name="index-verbosity_002c-enabling"></a> +<dd><span id="index-_002d_002dverbose-common-option"></span> +<span id="index-verbosity_002c-enabling"></span> <p>Print progress reports to standard output. </p> </dd> <dt>‘<samp>--version</samp>’</dt> -<dd><a name="index-_002d_002dversion-common-option"></a> -<a name="index-version-number_002c-finding"></a> +<dd><span id="index-_002d_002dversion-common-option"></span> +<span id="index-version-number_002c-finding"></span> <p>Print the version number to standard output, then exit successfully. </p></dd> </dl> @@ -834,12 +803,12 @@ common: </p> <dl compact="compact"> <dt>‘<samp>-file-line-error</samp>’</dt> -<dd><a name="index-_002dfile_002dline_002derror"></a> +<dd><span id="index-_002dfile_002dline_002derror"></span> </dd> <dt>‘<samp>-no-file-line-error</samp>’</dt> -<dd><a name="index-_002dno_002dfile_002dline_002derror"></a> -<a name="index-_002dfile_002dline_002derror_002dstyle"></a> -<a name="index-changing-error-messages-style"></a> +<dd><span id="index-_002dno_002dfile_002dline_002derror"></span> +<span id="index-_002dfile_002dline_002derror_002dstyle"></span> +<span id="index-changing-error-messages-style"></span> <p>Change (or do not change) the way error messages are printed. The alternate style looks like error messages from many compilers and is easier to parse for some editors that invoke TeX. This option used @@ -849,10 +818,10 @@ to be called ‘<samp>-file-line-error-style</samp>’. <dt>‘<samp>-fmt=<var>dumpname</var></samp>’</dt> <dt>‘<samp>-base=<var>dumpname</var></samp>’</dt> <dt>‘<samp>-mem=<var>dumpname</var></samp>’</dt> -<dd><a name="index-_002dfmt_003ddumpname"></a> -<a name="index-_002dbase_003ddumpname"></a> -<a name="index-_002dmem_003ddumpname"></a> -<a name="index-dump-file"></a> +<dd><span id="index-_002dfmt_003ddumpname"></span> +<span id="index-_002dbase_003ddumpname"></span> +<span id="index-_002dmem_003ddumpname"></span> +<span id="index-dump-file"></span> <p>Use <var>dumpname</var> instead of the program name or a ‘<samp>%&</samp>’ line to determine the name of the memory dump file read (‘<samp>fmt</samp>’ for TeX, ‘<samp>base</samp>’ for Metafont, ‘<samp>mem</samp>’ for MetaPost). See <a href="#Memory-dumps">Memory dumps</a>. Also sets the program name to <var>dumpname</var> if no @@ -860,80 +829,80 @@ determine the name of the memory dump file read (‘<samp>fmt</samp>’ </p> </dd> <dt>‘<samp>-halt-on-error</samp>’</dt> -<dd><a name="index-_002dhalt_002don_002derror"></a> -<a name="index-stopping-at-the-first-error"></a> +<dd><span id="index-_002dhalt_002don_002derror"></span> +<span id="index-stopping-at-the-first-error"></span> <p>Stop processing and exit when an error occurs, as opposed to the normal process of trying to recover and continue. </p> </dd> <dt>‘<samp>-ini</samp>’</dt> -<dd><a name="index-_002dini"></a> -<a name="index-program-names_002c-special"></a> -<a name="index-initial-form_002c-enabling"></a> +<dd><span id="index-_002dini"></span> +<span id="index-program-names_002c-special"></span> +<span id="index-initial-form_002c-enabling"></span> <p>Enable the “initial” form of the program (see <a href="#Initial-and-virgin">Initial and virgin</a>). This is implicitly set if the program name is <code>initex</code> resp. <code>inimf</code>. </p> </dd> <dt>‘<samp>-interaction=<var>string</var></samp>’</dt> -<dd><a name="index-_002dinteraction_003dstring"></a> -<a name="index-interaction-mode"></a> +<dd><span id="index-_002dinteraction_003dstring"></span> +<span id="index-interaction-mode"></span> <p>Set the interaction mode from the command line. The <var>string</var> must be one of ‘<samp>batchmode</samp>’, ‘<samp>nonstopmode</samp>’, ‘<samp>scrollmode</samp>’, or ‘<samp>errorstopmode</samp>’. </p> </dd> <dt>‘<samp>-jobname=<var>string</var></samp>’</dt> -<dd><a name="index-_002djobname_003dstring"></a> -<a name="index-job-name"></a> +<dd><span id="index-_002djobname_003dstring"></span> +<span id="index-job-name"></span> <p>Set the job name to <var>string</var>, instead of deriving it from the name of the input file. </p> </dd> <dt>‘<samp>-kpathsea-debug=<var>number</var></samp>’</dt> -<dd><a name="index-_002dkpathsea_002ddebug_003dnumber"></a> -<a name="index-KPATHSEA_005fDEBUG"></a> -<a name="index-debugging-flags_002c-specifying"></a> -<a name="index-path-searching-debugging"></a> +<dd><span id="index-_002dkpathsea_002ddebug_003dnumber"></span> +<span id="index-KPATHSEA_005fDEBUG"></span> +<span id="index-debugging-flags_002c-specifying"></span> +<span id="index-path-searching-debugging"></span> <p>Set path searching debugging flags according to the bits of <var>number</var> -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). You can also specify this in +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Debugging">Debugging</a> in <cite>Kpathsea</cite>). You can also specify this in <code>KPATHSEA_DEBUG</code> environment variable (for all Web2c programs). (The command line value overrides.) The most useful value is ‘<samp>-1</samp>’, to get all available output. </p> </dd> <dt>‘<samp>-output-directory=<var>dirname</var></samp>’</dt> -<dd><a name="index-_002doutput_002ddirectory"></a> -<a name="index-output-directory_002c-specifying"></a> +<dd><span id="index-_002doutput_002ddirectory"></span> +<span id="index-output-directory_002c-specifying"></span> <p>Specify the directory <var>dirname</var> to which output files are written. Also look for input files in <var>dirname</var> first, before looking along the normal search path. See <a href="#Output-file-location">Output file location</a>. </p> </dd> <dt>‘<samp>-parse-first-line</samp>’</dt> -<dd><a name="index-_002dparse_002dfirst_002dline"></a> +<dd><span id="index-_002dparse_002dfirst_002dline"></span> </dd> <dt>‘<samp>-no-parse-first-line</samp>’</dt> -<dd><a name="index-_002dno_002dparse_002dfirst_002dline"></a> -<a name="index-parsing-the-first-line"></a> +<dd><span id="index-_002dno_002dparse_002dfirst_002dline"></span> +<span id="index-parsing-the-first-line"></span> <p>Check or disable checking whether the first line of the main input file starts with ‘<samp>%&</samp>’, and parse it if it does. This line can be used specify the format and/or a TCX file. </p> </dd> <dt>‘<samp>-progname=<var>string</var></samp>’</dt> -<dd><a name="index-_002dprogname_003dstring"></a> -<a name="index-binaries_002c-linking"></a> -<a name="index-linking-binaries"></a> -<a name="index-program-names_002c-special-1"></a> +<dd><span id="index-_002dprogname_003dstring"></span> +<span id="index-binaries_002c-linking"></span> +<span id="index-linking-binaries"></span> +<span id="index-program-names_002c-special-1"></span> <p>Set program (and memory dump) name to <var>string</var>. This may affect the -search paths and other values used (see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). Using this option is equivalent to making a link named +search paths and other values used (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>). Using this option is equivalent to making a link named <var>string</var> to the binary and then invoking the binary under that name. See <a href="#Memory-dumps">Memory dumps</a>. </p> </dd> <dt>‘<samp>-recorder</samp>’</dt> -<dd><a name="index-_002drecorder"></a> -<a name="index-file-recorder"></a> +<dd><span id="index-_002drecorder"></span> +<span id="index-file-recorder"></span> <p>Enable the filename recorder. This makes the program save a list of the opened files into a file with (by default) extension ‘<samp>.fls</samp>’. For Aleph, this option is always on, and the file has extension ‘<samp>.ofl</samp>’. @@ -948,10 +917,10 @@ explicitly set the basename. </p> </dd> <dt>‘<samp>-translate-file=<var>tcxfile</var></samp>’</dt> -<dd><a name="index-_002dtranslate_002dfile_003dtcxfile"></a> -<a name="index-translation-file-for-TeX_002c-specifying"></a> -<a name="index-_002etcx-character-translation-files"></a> -<a name="index-first-line-of-the-main-input-file"></a> +<dd><span id="index-_002dtranslate_002dfile_003dtcxfile"></span> +<span id="index-translation-file-for-TeX_002c-specifying"></span> +<span id="index-_002etcx-character-translation-files"></span> +<span id="index-first-line-of-the-main-input-file"></span> <p>Use <var>tcxfile</var> to define which characters are printable and translations between the internal and external character sets. Moreover, <var>tcxfile</var> can be explicitly declared in the first line of the main @@ -961,9 +930,9 @@ See <a href="#TCX-files">TCX files</a>. </p> </dd> <dt>‘<samp>-8bit</samp>’</dt> -<dd><a name="index-_002d8bit"></a> -<a name="index-8-bit-clean"></a> -<a name="index-8-bit-clean-output_002c-specifying"></a> +<dd><span id="index-_002d8bit"></span> +<span id="index-8-bit-clean"></span> +<span id="index-8-bit-clean-output_002c-specifying"></span> <p>This option specifies that by default all characters should be considered printable. If ‘<samp>-translate-file</samp>’ was given as well, then the TCX file may mark characters as non-printable. @@ -973,29 +942,27 @@ TCX file may mark characters as non-printable. <hr> -<a name="Path-searching"></a> -<div class="header"> +<span id="Path-searching"></span><div class="header"> <p> Next: <a href="#Output-file-location" accesskey="n" rel="next">Output file location</a>, Previous: <a href="#Common-options" accesskey="p" rel="prev">Common options</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a 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> -<h3 class="section">3.3 Path searching</h3> +<span id="Path-searching-1"></span><h3 class="section">3.3 Path searching</h3> -<a name="index-path-searching"></a> +<span id="index-path-searching"></span> -<a name="index-texmf_002ecnf"></a> -<a name="index-configuration-file-reading"></a> +<span id="index-texmf_002ecnf"></span> +<span id="index-configuration-file-reading"></span> <p>All of the Web2c programs, including TeX, which do path searching use the Kpathsea routines to do so. The precise names of the environment and configuration file variables which get searched for particular file formatted are therefore documented in the Kpathsea manual -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). Reading -<samp>texmf.cnf</samp> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>), invoking -<code>mktex…</code> scripts (see <a href="http://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite>Kpathsea</cite>), and so on are all handled by Kpathsea. +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). Reading +<samp>texmf.cnf</samp> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Config-files">Config files</a> in <cite>Kpathsea</cite>), invoking +<code>mktex…</code> scripts (see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-scripts">mktex scripts</a> in <cite>Kpathsea</cite>), and so on are all handled by Kpathsea. </p> -<a name="index-font-aliases"></a> -<a name="index-aliases-for-fonts"></a> -<a name="index-texfonts_002emap"></a> +<span id="index-font-aliases"></span> +<span id="index-aliases-for-fonts"></span> +<span id="index-texfonts_002emap"></span> <p>The programs which read fonts make use of another Kpathsea feature: <samp>texfonts.map</samp>, which allows arbitrary aliases for the actual names of font files; for example, ‘<samp>Times-Roman</samp>’ for ‘<samp>ptmr8r.tfm</samp>’. @@ -1005,17 +972,15 @@ names. </p> <hr> -<a name="Output-file-location"></a> -<div class="header"> +<span id="Output-file-location"></span><div class="header"> <p> Next: <a href="#Three-programs" accesskey="n" rel="next">Three programs</a>, Previous: <a href="#Path-searching" accesskey="p" rel="prev">Path searching</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a 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-file-location-1"></a> -<h3 class="section">3.4 Output file location</h3> +<span id="Output-file-location-1"></span><h3 class="section">3.4 Output file location</h3> -<a name="index-output-file-location"></a> -<a name="index-current-directory_002c-used-for-output"></a> -<a name="index-_002e_002c-used-for-output"></a> +<span id="index-output-file-location"></span> +<span id="index-current-directory_002c-used-for-output"></span> +<span id="index-_002e_002c-used-for-output"></span> <p>All the programs generally follow the usual convention for output files. Namely, they are placed in the directory current when the program is run, regardless of any input file location; or, in a few cases, output @@ -1025,22 +990,22 @@ is to standard output. will be in <samp>./foo.dvi</samp> and <samp>./foo.log</samp>, not <samp>/tmp/foo.dvi</samp> and <samp>/tmp/foo.log</samp>. </p> -<a name="index-_002doutput_002ddirectory-1"></a> -<a name="index-output-directory_002c-specifying-1"></a> -<a name="index-readonly-directory_002c-running-TeX-in"></a> +<span id="index-_002doutput_002ddirectory-1"></span> +<span id="index-output-directory_002c-specifying-1"></span> +<span id="index-readonly-directory_002c-running-TeX-in"></span> <p>You can use the ‘<samp>-output-directory</samp>’ option to cause all output files that would normally be written in the current directory to be written in the specified directory instead. See <a href="#Common-options">Common options</a>. </p> -<a name="index-TEXMFOUTPUT_002c-used-if-_002e-unwritable"></a> -<a name="index-readonly-directory_002c-running-TeX-in-1"></a> +<span id="index-TEXMFOUTPUT_002c-used-if-_002e-unwritable"></span> +<span id="index-readonly-directory_002c-running-TeX-in-1"></span> <p>If the current directory is not writable, and ‘<samp>-output-directory</samp>’ is not specified, the main programs (TeX, Metafont, MetaPost, and BibTeX) make an exception: if the config file or environment variable value <code>TEXMFOUTPUT</code> is set (it is not by default), output files are written to the directory specified. </p> -<a name="index-TEXMFOUTPUT_002c-used-for-reading"></a> +<span id="index-TEXMFOUTPUT_002c-used-for-reading"></span> <p><code>TEXMFOUTPUT</code> is also checked for input files, as TeX often generates files that need to be subsequently read; for input, no suffixes (such as ‘<samp>.tex</samp>’) are added by default and no exhaustive @@ -1049,18 +1014,16 @@ simply checked as given. </p> <hr> -<a name="Three-programs"></a> -<div class="header"> +<span id="Three-programs"></span><div class="header"> <p> Previous: <a href="#Output-file-location" accesskey="p" rel="prev">Output file location</a>, Up: <a href="#Commonalities" accesskey="u" rel="up">Commonalities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX"></a> -<h3 class="section">3.5 Three programs: Metafont, MetaPost, and TeX</h3> +<span id="Three-programs_003a-Metafont_002c-MetaPost_002c-and-TeX"></span><h3 class="section">3.5 Three programs: Metafont, MetaPost, and TeX</h3> -<a name="index-three-programs"></a> -<a name="index-TeX_002c-Metafont_002c-and-MetaPost"></a> -<a name="index-Metafont_002c-MetaPost_002c-and-TeX"></a> -<a name="index-MetaPost_002c-TeX_002c-and-Metafont"></a> +<span id="index-three-programs"></span> +<span id="index-TeX_002c-Metafont_002c-and-MetaPost"></span> +<span id="index-Metafont_002c-MetaPost_002c-and-TeX"></span> +<span id="index-MetaPost_002c-TeX_002c-and-Metafont"></span> <p>TeX, Metafont, and MetaPost have a number of features in common. Besides the ones here, the common command-line options are described in @@ -1069,47 +1032,45 @@ control some array sizes and other features are described in <a href="#Runtime-options">Runtime options</a>. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Initial-and-virgin" accesskey="1">Initial and virgin</a>:</td><td> </td><td align="left" valign="top">Making memory dumps vs. production runs. +<tr><td align="left" valign="top">• <a href="#Initial-and-virgin" accesskey="1">Initial and virgin</a></td><td> </td><td align="left" valign="top">Making memory dumps vs. production runs. </td></tr> -<tr><td align="left" valign="top">• <a href="#Memory-dumps" accesskey="2">Memory dumps</a>:</td><td> </td><td align="left" valign="top">.fmt/.base files for fast startup. +<tr><td align="left" valign="top">• <a href="#Memory-dumps" accesskey="2">Memory dumps</a></td><td> </td><td align="left" valign="top">.fmt/.base files for fast startup. </td></tr> -<tr><td align="left" valign="top">• <a href="#Editor-invocation" accesskey="3">Editor invocation</a>:</td><td> </td><td align="left" valign="top">The ‘e’ response at errors. +<tr><td align="left" valign="top">• <a href="#Editor-invocation" accesskey="3">Editor invocation</a></td><td> </td><td align="left" valign="top">The ‘e’ response at errors. </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005cinput-filenames" accesskey="4">\input filenames</a>:</td><td> </td><td align="left" valign="top">~ and $ expansion in TeX/MF/MP. +<tr><td align="left" valign="top">• <a href="#g_t_005cinput-filenames" accesskey="4">\input filenames</a></td><td> </td><td align="left" valign="top">~ and $ expansion in TeX/MF/MP. </td></tr> </table> <hr> -<a name="Initial-and-virgin"></a> -<div class="header"> +<span id="Initial-and-virgin"></span><div class="header"> <p> Next: <a href="#Memory-dumps" accesskey="n" rel="next">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Initial-and-virgin-1"></a> -<h4 class="subsection">3.5.1 Initial and virgin</h4> +<span id="Initial-and-virgin-1"></span><h4 class="subsection">3.5.1 Initial and virgin</h4> -<a name="index-executables_002c-shared-initial-and-virgin"></a> +<span id="index-executables_002c-shared-initial-and-virgin"></span> <p>The TeX and Metafont programs each have two main variants, called <em>initial</em> and <em>virgin</em>. MetaPost no longer makes this distinction. </p> <p>The initial form is enabled if: </p><ol> -<li> <a name="index-_002dini-1"></a> +<li> <span id="index-_002dini-1"></span> the ‘<samp>-ini</samp>’ option was specified; or </li><li> the program name is <samp>initex</samp> resp. <samp>inimf</samp>; or </li><li> the first line of the main input file is ‘<samp>%&ini</samp>’; </li></ol> <p>otherwise, the virgin form is used. </p> -<a name="index-virgin-programs"></a> -<a name="index-production-use"></a> +<span id="index-virgin-programs"></span> +<span id="index-production-use"></span> <p>The <em>virgin</em> form is the one generally invoked for production use. The first thing it does is read a memory dump (see <a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a>), and then proceeds on with the main job. </p> -<a name="index-initial-programs"></a> -<a name="index-initializations_002c-lengthy"></a> +<span id="index-initial-programs"></span> +<span id="index-initializations_002c-lengthy"></span> <p>The <em>initial</em> form is generally used only to create memory dumps (see the next section). It starts up more slowly than the virgin form, because it must do lengthy initializations that are encapsulated in the @@ -1117,46 +1078,42 @@ memory dump file. </p> <hr> -<a name="Memory-dumps"></a> -<div class="header"> +<span id="Memory-dumps"></span><div class="header"> <p> Next: <a href="#Editor-invocation" accesskey="n" rel="next">Editor invocation</a>, Previous: <a href="#Initial-and-virgin" accesskey="p" rel="prev">Initial and virgin</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Memory-dumps-1"></a> -<h4 class="subsection">3.5.2 Memory dumps</h4> +<span id="Memory-dumps-1"></span><h4 class="subsection">3.5.2 Memory dumps</h4> -<a name="index-memory-dumps"></a> +<span id="index-memory-dumps"></span> -<a name="index-dumping-memory"></a> -<a name="index-macros_002c-predefining-in-memory-dumps"></a> -<a name="index-predefined-macros-and-memory-dumps"></a> +<span id="index-dumping-memory"></span> +<span id="index-macros_002c-predefining-in-memory-dumps"></span> +<span id="index-predefined-macros-and-memory-dumps"></span> <p>In typical use, TeX and Metafont require a large number of macros to be predefined; therefore, they support <em>memory dump</em> files, which can be read much more efficiently than ordinary source code. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Creating-memory-dumps" accesskey="1">Creating memory dumps</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Determining-the-memory-dump-to-use" accesskey="2">Determining the memory dump to use</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#Hardware-and-memory-dumps" accesskey="3">Hardware and memory dumps</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="Creating-memory-dumps"></a> -<div class="header"> +<span id="Creating-memory-dumps"></span><div class="header"> <p> Next: <a href="#Determining-the-memory-dump-to-use" accesskey="n" rel="next">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Creating-memory-dumps-1"></a> -<h4 class="subsubsection">3.5.2.1 Creating memory dumps</h4> +<span id="Creating-memory-dumps-1"></span><h4 class="subsubsection">3.5.2.1 Creating memory dumps</h4> -<a name="index-memory-dumps_002c-creating"></a> -<a name="index-creating-memory-dumps"></a> -<a name="index-writing-memory-dumps"></a> +<span id="index-memory-dumps_002c-creating"></span> +<span id="index-creating-memory-dumps"></span> +<span id="index-writing-memory-dumps"></span> <p>The programs all create memory dumps in slightly idiosyncratic (thought substantially similar) way, so we describe the details in separate @@ -1190,18 +1147,16 @@ difficulties. </p> <hr> -<a name="Determining-the-memory-dump-to-use"></a> -<div class="header"> +<span id="Determining-the-memory-dump-to-use"></span><div class="header"> <p> Next: <a href="#Hardware-and-memory-dumps" accesskey="n" rel="next">Hardware and memory dumps</a>, Previous: <a href="#Creating-memory-dumps" accesskey="p" rel="prev">Creating memory dumps</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Determining-the-memory-dump-to-use-1"></a> -<h4 class="subsubsection">3.5.2.2 Determining the memory dump to use</h4> +<span id="Determining-the-memory-dump-to-use-1"></span><h4 class="subsubsection">3.5.2.2 Determining the memory dump to use</h4> -<a name="index-memory-dump-to-use_002c-determining"></a> -<a name="index-fmt-file_002c-determining"></a> -<a name="index-base-file_002c-determining"></a> -<a name="index-mem-file_002c-determining"></a> +<span id="index-memory-dump-to-use_002c-determining"></span> +<span id="index-fmt-file_002c-determining"></span> +<span id="index-base-file_002c-determining"></span> +<span id="index-mem-file_002c-determining"></span> <p>The virgin form (see <a href="#Initial-and-virgin">Initial and virgin</a>) of each program always reads a memory dump before processing normal source input. All three @@ -1213,15 +1168,15 @@ program uses the remainder of that argument as the memory dump name. For example, running ‘<samp>tex \&super</samp>’ reads <samp>super.fmt</samp>. (The backslash protects the ‘<samp>&</samp>’ against interpretation by the shell.) -</li><li> <a name="index-_002dfmt_003dfmt"></a> -<a name="index-_002dbase_003dbase"></a> +</li><li> <span id="index-_002dfmt_003dfmt"></span> +<span id="index-_002dbase_003dbase"></span> If the ‘<samp>-fmt</samp>’ resp. ‘<samp>-base</samp>’ option is specified, its value is used. -</li><li> <a name="index-_002dprogname_003dstring-1"></a> +</li><li> <span id="index-_002dprogname_003dstring-1"></span> If the ‘<samp>-progname</samp>’ option is specified, its value is used. -</li><li> <a name="index-_0025_0026-magic-number"></a> +</li><li> <span id="index-_0025_0026-magic-number"></span> If the first line of the main input file (which must be specified on the command line, not in response to ‘<samp>**</samp>’) is <code>%&<var>dump</var></code>, and <var>dump</var> is an existing memory dump of the appropriate type, @@ -1235,8 +1190,8 @@ translation file is to be used: <code>%&-translate-file=<var>tcxfile</var></ -translate-file=<var>tcxfile</var></code>. If this is done, the name of the dump must be given first. </p> -</li><li> <a name="index-program-name_002c-determines-memory-dump"></a> -<a name="index-links-to-binaries"></a> +</li><li> <span id="index-program-name_002c-determines-memory-dump"></span> +<span id="index-links-to-binaries"></span> Otherwise, the program uses the program invocation name, most commonly <samp>tex</samp> resp. <samp>mf</samp>. For example, if <samp>latex</samp> is a link to <samp>tex</samp>, and the user runs ‘<samp>latex foo</samp>’, <samp>latex.fmt</samp> @@ -1246,37 +1201,35 @@ will be used. <hr> -<a name="Hardware-and-memory-dumps"></a> -<div class="header"> +<span id="Hardware-and-memory-dumps"></span><div class="header"> <p> Previous: <a href="#Determining-the-memory-dump-to-use" accesskey="p" rel="prev">Determining the memory dump to use</a>, Up: <a href="#Memory-dumps" accesskey="u" rel="up">Memory dumps</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Hardware-and-memory-dumps-1"></a> -<h4 class="subsubsection">3.5.2.3 Hardware and memory dumps</h4> - -<a name="index-hardware-and-memory-dumps"></a> -<a name="index-memory-dumps-and-hardware"></a> -<a name="index-sharing-memory-dumps"></a> -<a name="index-fmt-files_002c-sharing"></a> -<a name="index-base-files_002c-sharing"></a> -<a name="index-mem-files_002c-sharing"></a> - -<a name="index-LittleEndian-machines"></a> -<a name="index-BigEndian-machines"></a> -<a name="index-endian-dependencies"></a> -<a name="index-machine-dependencies"></a> -<a name="index-architecture-dependencies"></a> -<a name="index-dependencies_002c-hardware"></a> -<a name="index-_002d_002ddisable_002ddump_002dshare-configure-option"></a> +<span id="Hardware-and-memory-dumps-1"></span><h4 class="subsubsection">3.5.2.3 Hardware and memory dumps</h4> + +<span id="index-hardware-and-memory-dumps"></span> +<span id="index-memory-dumps-and-hardware"></span> +<span id="index-sharing-memory-dumps"></span> +<span id="index-fmt-files_002c-sharing"></span> +<span id="index-base-files_002c-sharing"></span> +<span id="index-mem-files_002c-sharing"></span> + +<span id="index-LittleEndian-machines"></span> +<span id="index-BigEndian-machines"></span> +<span id="index-endian-dependencies"></span> +<span id="index-machine-dependencies"></span> +<span id="index-architecture-dependencies"></span> +<span id="index-dependencies_002c-hardware"></span> +<span id="index-_002d_002ddisable_002ddump_002dshare-configure-option"></span> <p>By default, memory dump files are generally sharable between architectures of different types; specifically, on machines of different -endianness (see <a href="http://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite>GNU C Library</cite>). (This is a +endianness (see <a href="https://www.gnu.org/software/libc/manual/html_mono/libc.html#Byte-order">Byte order</a> in <cite>GNU C Library</cite>). (This is a feature of the Web2c implementation, and is not true of all TeX implementations.) If you specify ‘<samp>--disable-dump-share</samp>’ to <code>configure</code>, however, memory dumps will be endian-dependent. </p> -<a name="index-byte-swapping"></a> -<a name="index-swapping-bytes"></a> +<span id="index-byte-swapping"></span> +<span id="index-swapping-bytes"></span> <p>The reason to do this is speed. To achieve endian-independence, the reading of memory dumps on LittleEndian architectures, such as PC’s and DEC architectures, is somewhat slowed (all the multibyte values have to @@ -1286,8 +1239,8 @@ outweighs the speed loss. But if you’re installing Web2c for use on LittleEndian machines only, perhaps on a PC being used only by you, you may wish to get maximum speed. </p> -<a name="index-floating_002dpoint-values"></a> -<a name="index-glue-ratio-representations"></a> +<span id="index-floating_002dpoint-values"></span> +<span id="index-glue-ratio-representations"></span> <p>TeXnically, even without ‘<samp>--disable-dump-share</samp>’, sharing of <samp>.fmt</samp> files cannot be guaranteed to work. Floating-point values are always written in native format, and hence will generally not be @@ -1297,15 +1250,15 @@ LaTeX, AMSTeX, …) do not do any glue setting at <samp>.fmt</samp>-creation time. Metafont does not use floating point in any dumped value at all. </p> -<a name="index-date-and-time_002c-in-memory-dumps"></a> -<a name="index-time-and-date_002c-in-memory-dumps"></a> -<a name="index-memory-dumps_002c-contain-date-and-time"></a> +<span id="index-date-and-time_002c-in-memory-dumps"></span> +<span id="index-time-and-date_002c-in-memory-dumps"></span> +<span id="index-memory-dumps_002c-contain-date-and-time"></span> <p>Incidentally, different memory dump files will never compare equal byte-for-byte, because the program always dumps the current date and time. So don’t be alarmed by just a few bytes difference. </p> -<a name="index-Harbison_002c-Samuel-P_002e"></a> -<a name="index-Steele-Jr_002e_002c-Guy-L_002e"></a> +<span id="index-Harbison_002c-Samuel-P_002e"></span> +<span id="index-Steele-Jr_002e_002c-Guy-L_002e"></span> <p>If you don’t know what endianness your machine is, and you’re curious, here is a little C program to tell you. (The <code>configure</code> script contains a similar program.) This is from the book <cite>C: A Reference @@ -1335,26 +1288,24 @@ Jr. (see <a href="#References">References</a>). <hr> -<a name="Editor-invocation"></a> -<div class="header"> +<span id="Editor-invocation"></span><div class="header"> <p> Next: <a href="#g_t_005cinput-filenames" accesskey="n" rel="next">\input filenames</a>, Previous: <a href="#Memory-dumps" accesskey="p" rel="prev">Memory dumps</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Editor-invocation-1"></a> -<h4 class="subsection">3.5.3 Editor invocation</h4> +<span id="Editor-invocation-1"></span><h4 class="subsection">3.5.3 Editor invocation</h4> -<a name="index-editor-invoked-at-error"></a> -<a name="index-errors_002c-editor-invoked-at"></a> -<a name="index-e-response-at-error-prompt"></a> +<span id="index-editor-invoked-at-error"></span> +<span id="index-errors_002c-editor-invoked-at"></span> +<span id="index-e-response-at-error-prompt"></span> <p>TeX, Metafont, and MetaPost all (by default) stop and ask for user intervention at an error. If the input came from a file, and the user responds with <kbd>e</kbd> or <kbd>E</kbd>, the program invokes an editor. </p> -<a name="index-TEXEDIT"></a> -<a name="index-MFEDIT"></a> -<a name="index-MPEDIT"></a> -<a name="index-_002d_002dwith_002deditor_003dcmd"></a> +<span id="index-TEXEDIT"></span> +<span id="index-MFEDIT"></span> +<span id="index-MPEDIT"></span> +<span id="index-_002d_002dwith_002deditor_003dcmd"></span> <p>Specifying ‘<samp>--with-editor=<var>cmd</var></samp>’ to <code>configure</code> sets the default editor command string to <var>cmd</var>. The environment variables/configuration values <code>TEXEDIT</code>, <code>MFEDIT</code>, and @@ -1368,17 +1319,15 @@ and ‘<samp>%s</samp>’ is replaced by the name of the current input f </p> <hr> -<a name="g_t_005cinput-filenames"></a> -<div class="header"> +<span id="g_t_005cinput-filenames"></span><div class="header"> <p> Previous: <a href="#Editor-invocation" accesskey="p" rel="prev">Editor invocation</a>, Up: <a href="#Three-programs" accesskey="u" rel="up">Three programs</a> [<a 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_005cinput-filenames-1"></a> -<h4 class="subsection">3.5.4 <code>\input</code> filenames</h4> +<span id="g_t_005cinput-filenames-1"></span><h4 class="subsection">3.5.4 <code>\input</code> filenames</h4> -<a name="index-input-filenames"></a> -<a name="index-filename-conventions_002c-in-input-files"></a> -<a name="index-_005cinput-filenames"></a> +<span id="index-input-filenames"></span> +<span id="index-filename-conventions_002c-in-input-files"></span> +<span id="index-_005cinput-filenames"></span> <p>TeX, Metafont, and MetaPost source programs can all read other source files with the <code>\input</code> (TeX) and <code>input</code> (MF and MP) @@ -1387,9 +1336,9 @@ primitives: <pre class="example">\input <var>name</var> % in TeX </pre></div> -<a name="index-space_002dterminated-filenames"></a> -<a name="index-whitespace_002dterminated-filenames"></a> -<a name="index-terminator-for-filenames"></a> +<span id="index-space_002dterminated-filenames"></span> +<span id="index-whitespace_002dterminated-filenames"></span> +<span id="index-terminator-for-filenames"></span> <p>The file <var>name</var> can always be terminated with whitespace; for Metafont and MetaPost, the statement terminator ‘<samp>;</samp>’ also works. (LaTeX and other macro packages provide other interfaces to @@ -1420,9 +1369,9 @@ tokenized and expanded the input. So, multiple spaces and tabs may be seen as a single space, active characters such as ‘<samp>~</samp>’ are expanded first, and so on. (See below.) </p> -<a name="index-NUL_002c-not-allowed-in-filenames"></a> -<a name="index-eight_002dbit-characters-in-filenames"></a> -<a name="index-meta-characters-in-filenames"></a> +<span id="index-NUL_002c-not-allowed-in-filenames"></span> +<span id="index-eight_002dbit-characters-in-filenames"></span> +<span id="index-meta-characters-in-filenames"></span> <p>On the other hand, various C library routines and Unix itself use the null byte (character code zero, ASCII NUL) to terminate strings. So filenames in Web2c cannot contain nulls, even though TeX itself does @@ -1430,7 +1379,7 @@ not treat NUL specially. In addition, some older Unix variants do not allow eight-bit characters (codes 128–255) in filenames. </p> -<a name="index-portable-filenames"></a> +<span id="index-portable-filenames"></span> <p>For maximal portability of your document across systems, use only the characters ‘<samp>a</samp>’–‘<samp>z</samp>’, ‘<samp>0</samp>’–‘<samp>9</samp>’, and ‘<samp>.</samp>’, and restrict your filenames to at most eight characters (not including the @@ -1439,8 +1388,8 @@ anything but simple filenames, since directory separators vary among systems; instead, add the necessary directories to the appropriate search path. </p> -<a name="index-_007e-expansion-in-filenames"></a> -<a name="index-_0024-expansion-in-filenames"></a> +<span id="index-_007e-expansion-in-filenames"></span> +<span id="index-_0024-expansion-in-filenames"></span> <p>Finally, the present Web2c implementation does ‘<samp>~</samp>’ and ‘<samp>$</samp>’ expansion on <var>name</var>, unlike Knuth’s original implementation and older versions of Web2c. Thus: @@ -1456,7 +1405,7 @@ numeral, or ‘<samp>_</samp>’. <p>(So another way to get a program to read a filename containing whitespace is to define an environment variable and dereference it.) </p> -<a name="index-_005cstring"></a> +<span id="index-_005cstring"></span> <p>In all the common TeX formats (plain TeX, LaTeX, AMSTeX), the characters ‘<samp>~</samp>’ and ‘<samp>$</samp>’ have special category codes, so to actually use these in a document you have to change their catcodes or @@ -1466,23 +1415,21 @@ is when typing interactively. </p> <hr> -<a name="TeX"></a> -<div class="header"> +<span id="TeX"></span><div class="header"> <p> Next: <a href="#Metafont" accesskey="n" rel="next">Metafont</a>, Previous: <a href="#Commonalities" accesskey="p" rel="prev">Commonalities</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_003a-Typesetting"></a> -<h2 class="chapter">4 TeX: Typesetting</h2> +<span id="TeX_003a-Typesetting"></span><h2 class="chapter">4 TeX: Typesetting</h2> -<a name="index-TeX_002c-description-of"></a> -<a name="index-typesetting"></a> -<a name="index-mathematical-typesetting"></a> +<span id="index-TeX_002c-description-of"></span> +<span id="index-typesetting"></span> +<span id="index-mathematical-typesetting"></span> <p>TeX is a typesetting system: it was especially designed to handle complex mathematics, as well as most ordinary text typesetting. </p> -<a name="index-batch-languages"></a> -<a name="index-word-processor_002c-not"></a> +<span id="index-batch-languages"></span> +<span id="index-word-processor_002c-not"></span> <p>TeX is a batch language, like C or Pascal, and not an interactive “word processor”: you compile a TeX input file into a corresponding device-independent (DVI) file (and then translate the DVI file to the @@ -1493,34 +1440,32 @@ description of the TeX language, see <cite>The TeXbook</cite> otherwise, are available. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tex-invocation" accesskey="1">tex invocation</a>:</td><td> </td><td align="left" valign="top">Invoking TeX. +<tr><td align="left" valign="top">• <a href="#tex-invocation" accesskey="1">tex invocation</a></td><td> </td><td align="left" valign="top">Invoking TeX. </td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-TeX" accesskey="2">Initial TeX</a>:</td><td> </td><td align="left" valign="top">Making format files. +<tr><td align="left" valign="top">• <a href="#Initial-TeX" accesskey="2">Initial TeX</a></td><td> </td><td align="left" valign="top">Making format files. </td></tr> -<tr><td align="left" valign="top">• <a href="#Formats" accesskey="3">Formats</a>:</td><td> </td><td align="left" valign="top">Major TeX macro packages. +<tr><td align="left" valign="top">• <a href="#Formats" accesskey="3">Formats</a></td><td> </td><td align="left" valign="top">Major TeX macro packages. </td></tr> -<tr><td align="left" valign="top">• <a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a>:</td><td> </td><td align="left" valign="top">TeX supports many human languages. +<tr><td align="left" valign="top">• <a href="#Languages-and-hyphenation" accesskey="4">Languages and hyphenation</a></td><td> </td><td align="left" valign="top">TeX supports many human languages. </td></tr> -<tr><td align="left" valign="top">• <a href="#Shell-escapes" accesskey="5">Shell escapes</a>:</td><td> </td><td align="left" valign="top">Running subprograms from TeX. +<tr><td align="left" valign="top">• <a href="#Shell-escapes" accesskey="5">Shell escapes</a></td><td> </td><td align="left" valign="top">Running subprograms from TeX. </td></tr> -<tr><td align="left" valign="top">• <a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a>:</td><td> </td><td align="left" valign="top">DVI output to a socket. +<tr><td align="left" valign="top">• <a href="#IPC-and-TeX" accesskey="6">IPC and TeX</a></td><td> </td><td align="left" valign="top">DVI output to a socket. </td></tr> -<tr><td align="left" valign="top">• <a href="#TeX-extensions" accesskey="7">TeX extensions</a>:</td><td> </td><td align="left" valign="top">Changes to the TeX language. +<tr><td align="left" valign="top">• <a href="#TeX-extensions" accesskey="7">TeX extensions</a></td><td> </td><td align="left" valign="top">Changes to the TeX language. </td></tr> </table> <hr> -<a name="tex-invocation"></a> -<div class="header"> +<span id="tex-invocation"></span><div class="header"> <p> Next: <a href="#Initial-TeX" accesskey="n" rel="next">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a 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-invocation-1"></a> -<h3 class="section">4.1 <code>tex</code> invocation</h3> +<span id="tex-invocation-1"></span><h3 class="section">4.1 <code>tex</code> invocation</h3> -<a name="index-tex"></a> -<a name="index-TeX_002c-invocation"></a> +<span id="index-tex"></span> +<span id="index-TeX_002c-invocation"></span> <p>TeX (usually invoked as <code>tex</code>) formats the given text and commands, and outputs a corresponding device-independent representation @@ -1539,10 +1484,10 @@ tex [<var>option</var>]… \<var>first-line</var> tex [<var>option</var>]… &<var>fmt</var> <var>args</var> </pre></div> -<a name="index-_002etex"></a> -<a name="index-TeX_002c-input-files-found"></a> +<span id="index-_002etex"></span> +<span id="index-TeX_002c-input-files-found"></span> <p>TeX searches the usual places for the main input file <var>texname</var> -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending <var>texname</var> with <samp>.tex</samp> if necessary. To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -1556,7 +1501,7 @@ arguments as a line of regular TeX input. <p>If no arguments or options are specified, TeX prompts for an input file name with ‘<samp>**</samp>’. </p> -<a name="index-texput"></a> +<span id="index-texput"></span> <p>TeX writes the main DVI output to the file <samp><var>basetexname</var>.dvi</samp>, where <var>basetexname</var> is the basename of <var>texname</var>, or ‘<samp>texput</samp>’ if no input file was specified. A DVI @@ -1564,31 +1509,31 @@ file is a device-independent binary representation of your TeX document. The idea is that after running TeX, you translate the DVI file using a separate program to the commands for a particular output device, such as a PostScript printer -(see <a href="http://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>) or an X Window System display +(see <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>) or an X Window System display (see xdvi(1)). </p> -<a name="index-EC-fonts"></a> -<a name="index-mktextfM_002c-disabling"></a> -<a name="index-_005cfont-and-dynamic-generation"></a> +<span id="index-EC-fonts"></span> +<span id="index-mktextfM_002c-disabling"></span> +<span id="index-_005cfont-and-dynamic-generation"></span> <p>TeX also reads TFM files for any fonts you load in your document with the <code>\font</code> primitive. By default, it runs an external program named <samp>mktextfm</samp> to create any nonexistent TFM files. You can -disable this at configure-time or runtime (see <a href="http://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex +disable this at configure-time or runtime (see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is enabled mostly for the sake of the EC fonts, which can be generated at any size. </p> -<a name="index-_005copenout-and-security"></a> -<a name="index-security_002c-and-_005copenout"></a> -<a name="index-output-files_002c-written-by-TeX-programs"></a> -<a name="index-Trojan-horses-and-TeX-programs"></a> -<a name="index-dot-files_002c-written-by-TeX-programs"></a> -<a name="index-security_002c-and-output-files"></a> +<span id="index-_005copenout-and-security"></span> +<span id="index-security_002c-and-_005copenout"></span> +<span id="index-output-files_002c-written-by-TeX-programs"></span> +<span id="index-Trojan-horses-and-TeX-programs"></span> +<span id="index-dot-files_002c-written-by-TeX-programs"></span> +<span id="index-security_002c-and-output-files"></span> <p>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>. (MetaPost has a <code>write</code> primitive with similar implications). To alleviate this and similar problems the functions <code>kpathsea_out_name_ok</code> and -<code>kpathsea_in_name_ok</code> from the Kpathse library (see <a href="http://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling +<code>kpathsea_in_name_ok</code> from the Kpathse library (see <a href="https://tug.org/texinfohtml/kpathsea.html#Calling-sequence">Calling sequence</a> in <cite>Kpathsea</cite>) are used to determine if a given filename is acceptable to be opened for output or input, depending on the setting of the configuration variables <code>openout_any</code> and <code>openin_any</code>: @@ -1624,9 +1569,9 @@ See <a href="#Common-options">Common options</a>. </p> </dd> <dt>‘<samp>-enc</samp>’</dt> -<dd><a name="index-_002denc"></a> -<a name="index-Unicode-input"></a> -<a name="index-UTF_002d8-input"></a> +<dd><span id="index-_002denc"></span> +<span id="index-Unicode-input"></span> +<span id="index-UTF_002d8-input"></span> <p>Enable encTeX extensions, such as <code>\mubyte</code>. This can be used to support Unicode UTF-8 input encoding. See <a href="http://www.olsak.net/enctex.html">http://www.olsak.net/enctex.html</a>. @@ -1634,9 +1579,9 @@ to support Unicode UTF-8 input encoding. See </dd> <dt>‘<samp>-ipc</samp>’</dt> <dt>‘<samp>-ipc-start</samp>’</dt> -<dd><a name="index-_002dipc"></a> -<a name="index-_002dipc_002dstart"></a> -<a name="index-_002d_002denable_002dipc-configure-option"></a> +<dd><span id="index-_002dipc"></span> +<span id="index-_002dipc_002dstart"></span> +<span id="index-_002d_002denable_002dipc-configure-option"></span> <p>With either option, TeX writes its DVI output to a socket as well as to the usual <samp>.dvi</samp> file. With ‘<samp>-ipc-start</samp>’, TeX also opens a server program at the other end to read the output. See <a href="#IPC-and-TeX">IPC and TeX</a>. @@ -1647,27 +1592,27 @@ specified to <code>configure</code> during installation of Web2c. </dd> <dt>‘<samp>-mktex=<var>filetype</var></samp>’</dt> <dt>‘<samp>-no-mktex=<var>filetype</var></samp>’</dt> -<dd><a name="index-_002dmktex_003dfiletype"></a> -<a name="index-_002dno_002dmktex_003dfiletype"></a> +<dd><span id="index-_002dmktex_003dfiletype"></span> +<span id="index-_002dno_002dmktex_003dfiletype"></span> <p>Turn on or off the ‘<samp>mktex</samp>’ script associated with <var>filetype</var>. For TeX proper, <var>filetype</var> can only be ‘<samp>tex</samp>’ and ‘<samp>tfm</samp>’, but for pdfTeX and luaTeX, it can also be ‘<samp>pk</samp>’. </p> </dd> <dt>‘<samp>-mltex</samp>’</dt> -<dd><a name="index-_002dmltex"></a> -<a name="index-MLTeX_002c-enabling"></a> -<a name="index-program-names_002c-special-2"></a> +<dd><span id="index-_002dmltex"></span> +<span id="index-MLTeX_002c-enabling"></span> +<span id="index-program-names_002c-special-2"></span> <p>If we are <code>INITEX</code> (see <a href="#Initial-and-virgin">Initial and virgin</a>), enable MLTeX extensions such as <code>\charsubdef</code>. Implicitly set if the program name is <code>mltex</code>. See <a href="#MLTeX">MLTeX</a>. </p> </dd> <dt>‘<samp>-output-comment=<var>string</var></samp>’</dt> -<dd><a name="index-_002doutput_002dcomment_003dstring"></a> -<a name="index-output_005fcomment-for-DVI-files"></a> -<a name="index-DVI-comment_002c-specifying"></a> -<a name="index-regression-testing"></a> +<dd><span id="index-_002doutput_002dcomment_003dstring"></span> +<span id="index-output_005fcomment-for-DVI-files"></span> +<span id="index-DVI-comment_002c-specifying"></span> +<span id="index-regression-testing"></span> <p>Use <var>string</var> as the DVI file comment. Ordinarily, this comment records the date and time of the TeX run, but if you are doing regression testing, you may not want the DVI file to have this spurious @@ -1676,23 +1621,23 @@ config file value ‘<samp>output_comment</samp>’. </p> </dd> <dt>‘<samp>-shell-escape</samp>’</dt> -<dd><a name="index-_002dshell_002descape"></a> +<dd><span id="index-_002dshell_002descape"></span> </dd> <dt>‘<samp>-no-shell-escape</samp>’</dt> -<dd><a name="index-_002dno_002dshell_002descape"></a> +<dd><span id="index-_002dno_002dshell_002descape"></span> </dd> <dt>‘<samp>-shell-restricted</samp>’</dt> -<dd><a name="index-_002dshell_002drestricted"></a> +<dd><span id="index-_002dshell_002drestricted"></span> <p>Enable, or disable, or enable with restrictions the <code>\write18{<var>shell-command</var>}</code> feature for external executing shell commands. See <a href="#Shell-escapes">Shell escapes</a>. </p> </dd> <dt>‘<samp>-enable-write18</samp>’</dt> -<dd><a name="index-_002denable_002dwrite18"></a> +<dd><span id="index-_002denable_002dwrite18"></span> </dd> <dt>‘<samp>-disable-write18</samp>’</dt> -<dd><a name="index-_002ddisable_002dwrite18"></a> +<dd><span id="index-_002ddisable_002dwrite18"></span> <p>Synonyms for <samp>-shell-escape</samp> and <samp>-no-shell-escape</samp>, for compatibility with MiKTeX. (MiKTeX also accepts both pairs of options.) See <a href="#Shell-escapes">Shell escapes</a>. @@ -1700,7 +1645,7 @@ options.) See <a href="#Shell-escapes">Shell escapes</a>. </dd> <dt>‘<samp>-src-specials</samp>’</dt> <dt>‘<samp>-src-specials=<var>string</var></samp>’</dt> -<dd><a name="index-generating-source-specials"></a> +<dd><span id="index-generating-source-specials"></span> <p>This option makes TeX output specific source information using ‘<samp>\special</samp>’ commands in the DVI file. These ‘<samp>\special</samp>’ track the current file name and line number. @@ -1738,19 +1683,17 @@ hard-coded to always use the ‘<samp>\special</samp>’ primitive. <hr> -<a name="Initial-TeX"></a> -<div class="header"> +<span id="Initial-TeX"></span><div class="header"> <p> Next: <a href="#Formats" accesskey="n" rel="next">Formats</a>, Previous: <a href="#tex-invocation" accesskey="p" rel="prev">tex invocation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Initial-TeX-1"></a> -<h3 class="section">4.2 Initial TeX</h3> +<span id="Initial-TeX-1"></span><h3 class="section">4.2 Initial TeX</h3> -<a name="index-initial-TeX"></a> -<a name="index-TeX_002c-initial"></a> +<span id="index-initial-TeX"></span> +<span id="index-TeX_002c-initial"></span> -<a name="index-_002efmt"></a> -<a name="index-fmt-files"></a> +<span id="index-_002efmt"></span> +<span id="index-fmt-files"></span> <p>The <em>initial</em> form of TeX is invoked by ‘<samp>tex -ini</samp>’. It does lengthy initializations avoided by the “virgin” (<code>vir</code>) form, so as to be capable of dumping ‘<samp>.fmt</samp>’ files (see <a href="#Memory-dumps">Memory dumps</a>). For a detailed comparison of virgin and initial forms, @@ -1758,9 +1701,9 @@ see <a href="#Initial-and-virgin">Initial and virgin</a>. </p> <p>For a list of options and other information, see <a href="#tex-invocation">tex invocation</a>. </p> -<a name="index-plain_002efmt"></a> -<a name="index-tex_002efmt"></a> -<a name="index-format-files"></a> +<span id="index-plain_002efmt"></span> +<span id="index-tex_002efmt"></span> +<span id="index-format-files"></span> <p>Unlike Metafont and MetaPost, many format files are commonly used with TeX. The standard one implementing the features described in the <cite>TeXbook</cite> is ‘<samp>plain.fmt</samp>’, also known as ‘<samp>tex.fmt</samp>’ @@ -1783,17 +1726,15 @@ more details on TeX formats. </p> <hr> -<a name="Formats"></a> -<div class="header"> +<span id="Formats"></span><div class="header"> <p> Next: <a href="#Languages-and-hyphenation" accesskey="n" rel="next">Languages and hyphenation</a>, Previous: <a href="#Initial-TeX" accesskey="p" rel="prev">Initial TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Formats-1"></a> -<h3 class="section">4.3 Formats</h3> +<span id="Formats-1"></span><h3 class="section">4.3 Formats</h3> -<a name="index-formats-for-TeX"></a> -<a name="index-TeX_002c-format-packages-for"></a> -<a name="index-macro-packages_002c-major-TeX"></a> +<span id="index-formats-for-TeX"></span> +<span id="index-TeX_002c-format-packages-for"></span> +<span id="index-macro-packages_002c-major-TeX"></span> <p>TeX <em>formats</em> are large collections of macros, often dumped into a <samp>.fmt</samp> file (see <a href="#Memory-dumps">Memory dumps</a>) by <code>tex -ini</code> @@ -1805,14 +1746,14 @@ only the ‘<samp>plain</samp>’ and ‘<samp>latex</samp>’ f </p> <p>You can get the latest versions of most of these formats from the CTAN archives in subdirectories of <samp><var>CTAN:</var>/macros</samp> (for CTAN info, -see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). The archive +see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). The archive <a href="ftp://ftp.tug.org/tex/lib.tar.gz">ftp://ftp.tug.org/tex/lib.tar.gz</a> (also available from CTAN) contains most of these formats (although perhaps not the absolute latest version), among other things. </p> <dl compact="compact"> <dt><tt>latex</tt></dt> -<dd><a name="index-LaTeX"></a> +<dd><span id="index-LaTeX"></span> <p>The most widely used format. The current release is named ‘LaTeX 2e’; new versions are released approximately every six months, with patches issued as needed. The old release was called ‘LaTeX 2.09’, @@ -1831,9 +1772,9 @@ other interesting features. The ConTeXt home page: </p> </dd> <dt><tt>amstex</tt></dt> -<dd><a name="index-AMSTeX"></a> -<a name="index-American-Mathematical-Society_002c-typesetting-system"></a> -<a name="index-Mathematical-Reviews"></a> +<dd><span id="index-AMSTeX"></span> +<span id="index-American-Mathematical-Society_002c-typesetting-system"></span> +<span id="index-Mathematical-Reviews"></span> <p>The official typesetting system of the American Mathematical Society. Like LaTeX, it encourages generic markup commands. The AMS also provides many LaTeX package for authors who prefer LaTeX. Taken @@ -1843,9 +1784,9 @@ together, they are used to produce nearly all AMS publications, e.g., </p> </dd> <dt><tt>texinfo</tt></dt> -<dd><a name="index-Texinfo"></a> -<a name="index-Info-format"></a> -<a name="index-Free-Software-Foundation-documentation-system"></a> +<dd><span id="index-Texinfo"></span> +<span id="index-Info-format"></span> +<span id="index-Free-Software-Foundation-documentation-system"></span> <p>The documentation system developed and maintained by the Free Software Foundation for their software manuals. It can be automatically converted into plain text, a machine-readable on-line format called @@ -1854,8 +1795,8 @@ converted into plain text, a machine-readable on-line format called </p> </dd> <dt><tt>eplain</tt></dt> -<dd><a name="index-Eplain"></a> -<a name="index-expanded-plain-format"></a> +<dd><span id="index-Eplain"></span> +<span id="index-expanded-plain-format"></span> <p>The “expanded plain” format provides various common features (e.g., symbolic cross-referencing, tables of contents, indexing, citations using BibTeX), for those authors who prefer to handle their own @@ -1864,8 +1805,8 @@ high-level formatting. The Eplain home page: </p> </dd> <dt><tt>slitex</tt></dt> -<dd><a name="index-SliTeX"></a> -<a name="index-slides_002c-producing"></a> +<dd><span id="index-SliTeX"></span> +<span id="index-slides_002c-producing"></span> <p>An obsolete LaTeX 2.09 format for making slides. It is replaced by the ‘<samp>slides</samp>’ document class, along with the ‘<samp>beamer</samp>’, ‘<samp>texpower</samp>’, and other packages. @@ -1875,47 +1816,43 @@ the ‘<samp>slides</samp>’ document class, along with the ‘<sam <hr> -<a name="Languages-and-hyphenation"></a> -<div class="header"> +<span id="Languages-and-hyphenation"></span><div class="header"> <p> Next: <a href="#Shell-escapes" accesskey="n" rel="next">Shell escapes</a>, Previous: <a href="#Formats" accesskey="p" rel="prev">Formats</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Languages-and-hyphenation-1"></a> -<h3 class="section">4.4 Languages and hyphenation</h3> +<span id="Languages-and-hyphenation-1"></span><h3 class="section">4.4 Languages and hyphenation</h3> -<a name="index-language-support-in-TeX"></a> -<a name="index-human-languages_002c-supported-in-TeX"></a> -<a name="index-hyphenation-and-languages"></a> +<span id="index-language-support-in-TeX"></span> +<span id="index-human-languages_002c-supported-in-TeX"></span> +<span id="index-hyphenation-and-languages"></span> <p>TeX supports most natural languages. See also <a href="#TeX-extensions">TeX extensions</a>. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#MLTeX" accesskey="1">MLTeX</a>:</td><td> </td><td align="left" valign="top">Multi-lingual TeX. +<tr><td align="left" valign="top">• <a href="#MLTeX" accesskey="1">MLTeX</a></td><td> </td><td align="left" valign="top">Multi-lingual TeX. </td></tr> -<tr><td align="left" valign="top">• <a href="#TCX-files" accesskey="2">TCX files</a>:</td><td> </td><td align="left" valign="top">Support for different character sets & fonts. +<tr><td align="left" valign="top">• <a href="#TCX-files" accesskey="2">TCX files</a></td><td> </td><td align="left" valign="top">Support for different character sets & fonts. </td></tr> -<tr><td align="left" valign="top">• <a href="#patgen-invocation" accesskey="3">patgen invocation</a>:</td><td> </td><td align="left" valign="top">Creating hyphenation patterns. +<tr><td align="left" valign="top">• <a href="#patgen-invocation" accesskey="3">patgen invocation</a></td><td> </td><td align="left" valign="top">Creating hyphenation patterns. </td></tr> </table> <hr> -<a name="MLTeX"></a> -<div class="header"> +<span id="MLTeX"></span><div class="header"> <p> Next: <a href="#TCX-files" accesskey="n" rel="next">TCX files</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="MLTeX_003a-Multi_002dlingual-TeX"></a> -<h4 class="subsection">4.4.1 MLTeX: Multi-lingual TeX</h4> +<span id="MLTeX_003a-Multi_002dlingual-TeX"></span><h4 class="subsection">4.4.1 MLTeX: Multi-lingual TeX</h4> -<a name="index-mltex"></a> -<a name="index-Multi_002dlingual-TeX"></a> +<span id="index-mltex"></span> +<span id="index-Multi_002dlingual-TeX"></span> -<a name="index-Ferguson_002c-Michael"></a> -<a name="index-Raichle_002c-Bernd"></a> -<a name="index-accents_002c-hyphenating-words-with"></a> -<a name="index-glyph-substitutions"></a> -<a name="index-substitutions-of-font-glyphs"></a> +<span id="index-Ferguson_002c-Michael"></span> +<span id="index-Raichle_002c-Bernd"></span> +<span id="index-accents_002c-hyphenating-words-with"></span> +<span id="index-glyph-substitutions"></span> +<span id="index-substitutions-of-font-glyphs"></span> <p>Multi-lingual TeX (<code>mltex</code>) is an extension of TeX originally written by Michael Ferguson and now updated and maintained by Bernd Raichle. It allows the use of non-existing glyphs in a font by @@ -1940,23 +1877,21 @@ file. Aside from these, MLTeX is completely compatible with standard TeX. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#g_t_005ccharsubdef" accesskey="1">\charsubdef</a>:</td><td> </td><td align="left" valign="top">Character substitution definitions. +<tr><td align="left" valign="top">• <a href="#g_t_005ccharsubdef" accesskey="1">\charsubdef</a></td><td> </td><td align="left" valign="top">Character substitution definitions. </td></tr> -<tr><td align="left" valign="top">• <a href="#g_t_005ctracingcharsubdef" accesskey="2">\tracingcharsubdef</a>:</td><td> </td><td align="left" valign="top">Tracing substitutions. +<tr><td align="left" valign="top">• <a href="#g_t_005ctracingcharsubdef" accesskey="2">\tracingcharsubdef</a></td><td> </td><td align="left" valign="top">Tracing substitutions. </td></tr> </table> <hr> -<a name="g_t_005ccharsubdef"></a> -<div class="header"> +<span id="g_t_005ccharsubdef"></span><div class="header"> <p> Next: <a href="#g_t_005ctracingcharsubdef" accesskey="n" rel="next">\tracingcharsubdef</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX</a> [<a 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_005ccharsubdef_003a-Character-substitutions"></a> -<h4 class="subsubsection">4.4.1.1 <code>\charsubdef</code>: Character substitutions</h4> +<span id="g_t_005ccharsubdef_003a-Character-substitutions"></span><h4 class="subsubsection">4.4.1.1 <code>\charsubdef</code>: Character substitutions</h4> -<a name="index-_005ccharsubdef-and-MLTeX"></a> +<span id="index-_005ccharsubdef-and-MLTeX"></span> <p>The most important primitive MLTeX adds is <code>\charsubdef</code>, used in a way reminiscent of <code>\chardef</code>: @@ -1976,7 +1911,7 @@ primitive, will be mapped to a font glyph or to an <code>\accent</code> glyph construction. </p> <p>For example, if you assume glyph code 138 -<a name="index-e_002dcircumflex"></a> +<span id="index-e_002dcircumflex"></span> (decimal) for an e-circumflex and you are using the Computer Modern fonts, which have the circumflex accent in position 18 and lowercase ‘e’ in the usual ASCII position 101 @@ -1998,7 +1933,7 @@ as a pair of zeros. For example: </p><div class="example"> <pre class="example">\charsubdef '321 = 0 0 % disable N tilde </pre></div> -<a name="index-N-tilde"></a> +<span id="index-N-tilde"></span> <p>(Octal <tt>'321</tt> is the ISO Latin-1 value for the Spanish N tilde.) </p> <p><code>\charsubdef</code> commands should only be given once. Although in @@ -2014,43 +1949,39 @@ accessed often, so changing it is not desirable, nor generally useful.) </p> <hr> -<a name="g_t_005ctracingcharsubdef"></a> -<div class="header"> +<span id="g_t_005ctracingcharsubdef"></span><div class="header"> <p> Previous: <a href="#g_t_005ccharsubdef" accesskey="p" rel="prev">\charsubdef</a>, Up: <a href="#MLTeX" accesskey="u" rel="up">MLTeX</a> [<a 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_005ctracingcharsubdef_003a-Substitution-diagnostics"></a> -<h4 class="subsubsection">4.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</h4> +<span id="g_t_005ctracingcharsubdef_003a-Substitution-diagnostics"></span><h4 class="subsubsection">4.4.1.2 <code>\tracingcharsubdef</code>: Substitution diagnostics</h4> -<a name="index-_005ctracingcharsubdef-and-MLTeX"></a> -<a name="index-redefined-character-substitutions"></a> +<span id="index-_005ctracingcharsubdef-and-MLTeX"></span> +<span id="index-redefined-character-substitutions"></span> <p>To help diagnose problems with ‘<samp>\charsubdef</samp>’, MLTeX provides a new primitive parameter, <code>\tracingcharsubdef</code>. If positive, every use of <code>\charsubdef</code> will be reported. This can help track down when a character is redefined. </p> -<a name="index-_005ctracinglostchars-and-MLTeX"></a> +<span id="index-_005ctracinglostchars-and-MLTeX"></span> <p>In addition, if the TeX parameter <code>\tracinglostchars</code> is 100 or more, the character substitutions actually performed at <code>\shipout</code>-time will be recorded. </p> <hr> -<a name="TCX-files"></a> -<div class="header"> +<span id="TCX-files"></span><div class="header"> <p> Next: <a href="#patgen-invocation" accesskey="n" rel="next">patgen invocation</a>, Previous: <a href="#MLTeX" accesskey="p" rel="prev">MLTeX</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="TCX-files_003a-Character-translations"></a> -<h4 class="subsection">4.4.2 TCX files: Character translations</h4> +<span id="TCX-files_003a-Character-translations"></span><h4 class="subsection">4.4.2 TCX files: Character translations</h4> -<a name="index-TCX-character-translation-files"></a> -<a name="index-_002etcx-character-translation-files-1"></a> -<a name="index-character-translation-files"></a> +<span id="index-TCX-character-translation-files"></span> +<span id="index-_002etcx-character-translation-files-1"></span> +<span id="index-character-translation-files"></span> -<a name="index-international-characters"></a> -<a name="index-8_002dbit-characters"></a> -<a name="index-accented-character"></a> +<span id="index-international-characters"></span> +<span id="index-8_002dbit-characters"></span> +<span id="index-accented-character"></span> <p>TCX (TeX character translation) files help TeX support direct input of 8-bit international characters if fonts containing those characters are being used. Specifically, they map an input (keyboard) @@ -2082,7 +2013,7 @@ construction made out of two separate character glyphs. TCX files involve no new primitives; it is not possible to specify that an input (keyboard) character maps to more than one character. </p> -<a name="index-WEB2C_002c-search-path-for-TCX-files"></a> +<span id="index-WEB2C_002c-search-path-for-TCX-files"></span> <p>Information on specifying TCX files: </p> <ul> @@ -2100,11 +2031,11 @@ with the command-line option ‘<samp>-translate-file=<var>tcxfile</var></sa </li><li> Initial TeX (see <a href="#Initial-TeX">Initial TeX</a>) ignores TCX files. </li></ul> -<a name="index-il1_002dt1_002etcx"></a> -<a name="index-il2_002dt1_002etcx"></a> -<a name="index-empty_002etcx"></a> -<a name="index-Cork-encoding-and-ISO-input"></a> -<a name="index-T1-encoding-and-ISO-input"></a> +<span id="index-il1_002dt1_002etcx"></span> +<span id="index-il2_002dt1_002etcx"></span> +<span id="index-empty_002etcx"></span> +<span id="index-Cork-encoding-and-ISO-input"></span> +<span id="index-T1-encoding-and-ISO-input"></span> <p>The Web2c distribution comes with a number of TCX files. Two important ones are <samp>il1-t1.tcx</samp> and <samp>il2-t1.tcx</samp>, which support ISO Latin 1 and ISO Latin 2, respectively, with Cork-encoded @@ -2125,16 +2056,16 @@ latex --translate-file=empty.tcx somefile8.tex ⇒ terminal etc. output with ^^ notation </pre></div> -<a name="index-syntax-of-TCX-files"></a> +<span id="index-syntax-of-TCX-files"></span> <p>Syntax of TCX files: </p><ol> -<li> <a name="index-blank-lines_002c-in-TCX-files"></a> +<li> <span id="index-blank-lines_002c-in-TCX-files"></span> Line-oriented. Blank lines are ignored. -</li><li> <a name="index-whitespace_002c-in-TCX-files"></a> +</li><li> <span id="index-whitespace_002c-in-TCX-files"></span> Whitespace is ignored except as a separator. -</li><li> <a name="index-comments_002c-in-TCX-files"></a> +</li><li> <span id="index-comments_002c-in-TCX-files"></span> Comments start with ‘<samp>%</samp>’ and continue to the end of the line. </li><li> Otherwise, a line consists of one or two character codes, optionally @@ -2144,10 +2075,10 @@ considered printable. <pre class="example"><var>src</var> [<var>dest</var> [<var>prnt</var>]] </pre></div> -</li><li> <a name="index-character-codes_002c-in-TCX-files"></a> -<a name="index-octal-character-codes_002c-in-TCX-files"></a> -<a name="index-hex-character-codes_002c-in-TCX-files"></a> -<a name="index-decimal-character-codes_002c-in-TCX-files"></a> +</li><li> <span id="index-character-codes_002c-in-TCX-files"></span> +<span id="index-octal-character-codes_002c-in-TCX-files"></span> +<span id="index-hex-character-codes_002c-in-TCX-files"></span> +<span id="index-decimal-character-codes_002c-in-TCX-files"></span> Each character code may be specified in octal with a leading ‘<samp>0</samp>’, hexadecimal with a leading ‘<samp>0x</samp>’, or decimal otherwise. Values must be between 0 and 255, inclusive (decimal). @@ -2159,8 +2090,8 @@ be between 0 and 255, inclusive (decimal). definition that counts. </li></ol> -<a name="index-printable-characters_002c-specifying"></a> -<a name="index-_005e_005e-notation_002c-avoiding"></a> +<span id="index-printable-characters_002c-specifying"></span> +<span id="index-_005e_005e-notation_002c-avoiding"></span> <p>Finally, here’s what happens: when TeX sees an input character with code <var>src</var>, it 1) changes <var>src</var> to <var>dest</var>; and 2) makes the <var>dest</var> code “printable”, i.e., printed as-is in diagnostics and the @@ -2175,12 +2106,12 @@ make the following characters printable: <code>^^I</code> (TAB), <code>^^J</code (line feed), <code>^^M</code> (carriage return), and <code>^^?</code> (delete), since TeX uses them in various ways. </p> -<a name="index-font-character-code_002c-translating"></a> -<a name="index-keyboard-character-code_002c-translating"></a> +<span id="index-font-character-code_002c-translating"></span> +<span id="index-keyboard-character-code_002c-translating"></span> <p>Thus, the idea is to specify the input (keyboard) character code for <var>src</var>, and the output (font) character code for <var>dest</var>. </p> -<a name="index-interaction-between-TCX-files-and-_002d8bit_002e"></a> +<span id="index-interaction-between-TCX-files-and-_002d8bit_002e"></span> <p>By default, only the printable ASCII characters are considered printable by TeX. If you specify the ‘<samp>-8bit</samp>’ option, all characters are considered printable by default. If you specify both the ‘<samp>-8bit</samp>’ @@ -2200,17 +2131,15 @@ the dump is ignored and the data from the file used instead. </p> <hr> -<a name="patgen-invocation"></a> -<div class="header"> +<span id="patgen-invocation"></span><div class="header"> <p> Previous: <a href="#TCX-files" accesskey="p" rel="prev">TCX files</a>, Up: <a href="#Languages-and-hyphenation" accesskey="u" rel="up">Languages and hyphenation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Patgen_003a-Creating-hyphenation-patterns"></a> -<h4 class="subsection">4.4.3 Patgen: Creating hyphenation patterns</h4> +<span id="Patgen_003a-Creating-hyphenation-patterns"></span><h4 class="subsection">4.4.3 Patgen: Creating hyphenation patterns</h4> -<a name="index-patgen"></a> -<a name="index-hyphenation-patterns_002c-creating"></a> -<a name="index-languages_002c-hyphenation-rules-for"></a> +<span id="index-patgen"></span> +<span id="index-hyphenation-patterns_002c-creating"></span> +<span id="index-languages_002c-hyphenation-rules-for"></span> <p>Patgen creates hyphenation patterns from dictionary files for use with TeX. Synopsis: @@ -2232,22 +2161,20 @@ Frank Liang (see <a href="#References">References</a>), and also the <samp>patge </p> <hr> -<a name="Shell-escapes"></a> -<div class="header"> +<span id="Shell-escapes"></span><div class="header"> <p> Next: <a href="#IPC-and-TeX" accesskey="n" rel="next">IPC and TeX</a>, Previous: <a href="#Languages-and-hyphenation" accesskey="p" rel="prev">Languages and hyphenation</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a 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-escapes-1"></a> -<h3 class="section">4.5 Shell escapes</h3> - -<a name="index-shell-commands-in-TeX"></a> -<a name="index-security_002c-and-shell-escapes"></a> -<a name="index-restricted-shell-escapes"></a> -<a name="index-system-command"></a> -<a name="index-shell_005fescape-enabling-in-TeX"></a> -<a name="index-_005cimmediate_005cwrite18"></a> -<a name="index-_005cwrite18-shell-escape-extension"></a> -<a name="index-system-C-library-function"></a> +<span id="Shell-escapes-1"></span><h3 class="section">4.5 Shell escapes</h3> + +<span id="index-shell-commands-in-TeX"></span> +<span id="index-security_002c-and-shell-escapes"></span> +<span id="index-restricted-shell-escapes"></span> +<span id="index-system-command"></span> +<span id="index-shell_005fescape-enabling-in-TeX"></span> +<span id="index-_005cimmediate_005cwrite18"></span> +<span id="index-_005cwrite18-shell-escape-extension"></span> +<span id="index-system-C-library-function"></span> <p>TeX can execute <em>shell escapes</em>, that is, arbitrary shell commands. Although tremendously useful, this also has obvious @@ -2276,14 +2203,14 @@ specified, or if <code>shell_escape</code> is set to anything else. <pre class="example">\write18{echo "hello, world"} </pre></div> -<a name="index-_005coutput-routine_002c-and-_005cwrite"></a> +<span id="index-_005coutput-routine_002c-and-_005cwrite"></span> <p>From TeX’s point of view, this is a normal <code>\write</code> command, and is therefore subject to the usual TeX expansions. Also, the system call either happens during the ‘<samp>\output</samp>’ routine or right away, according to the absence or presence of the <code>\immediate</code> prefix, as usual for <code>\write</code>. </p> -<a name="index-exit-status_002c-of-shell-escape"></a> +<span id="index-exit-status_002c-of-shell-escape"></span> <p>The <var>shell-command</var> string is passed to the command shell (via the C library function <code>system</code>). The output of <var>shell-command</var> is not diverted anywhere, so it will not appear in the log file, or @@ -2303,7 +2230,7 @@ expansions (from, e.g., <tt>`...`</tt>). Mismatched quotation marks in the command string result in a diagnostic message in the log file; no execution is performed. </p> -<a name="index-shell_005fescape_005fcommands"></a> +<span id="index-shell_005fescape_005fcommands"></span> <p>After quotation processing, if the first word (delimited by a space or tab) of the command is in the list specified by the <code>shell_escape_commands</code> configuration value, the command is @@ -2319,11 +2246,11 @@ commands included: <pre class="example">shell_escape_commands = bibtex,dvips,epstopdf,...,tex </pre></div> -<a name="index-pipes_002c-reading-and-writing"></a> -<a name="index-_005copenin_002c-and-pipes"></a> -<a name="index-_005cinput_002c-and-pipes"></a> -<a name="index-_005copenout_002c-and-pipes"></a> -<a name="index-_005cpdfshellescape"></a> +<span id="index-pipes_002c-reading-and-writing"></span> +<span id="index-_005copenin_002c-and-pipes"></span> +<span id="index-_005cinput_002c-and-pipes"></span> +<span id="index-_005copenout_002c-and-pipes"></span> +<span id="index-_005cpdfshellescape"></span> <p>pdfTeX and luaTeX support reading (via <code>\input</code> and <code>\openin</code>) and writing (via <code>\openout</code>) from pipes if the first character is ‘<samp>|</samp>’. The following command is then treated @@ -2332,7 +2259,7 @@ engines, the primitive variable <code>\pdfshellescape</code> is set to 0 if shell escapes are disabled, 1 if they are enabled, and 2 if they are enabled with restrictions. </p> -<a name="index-web-environments_002c-and-security"></a> +<span id="index-web-environments_002c-and-security"></span> <p>The purpose of this feature is to make it possible for TeX documents to perform useful external actions in the common case of an individual user running a known document on his or her own machine. @@ -2341,16 +2268,14 @@ considered untrustworthy, shell escapes should be completely disabled. </p> <hr> -<a name="IPC-and-TeX"></a> -<div class="header"> +<span id="IPC-and-TeX"></span><div class="header"> <p> Next: <a href="#TeX-extensions" accesskey="n" rel="next">TeX extensions</a>, Previous: <a href="#Shell-escapes" accesskey="p" rel="prev">Shell escapes</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="IPC-and-TeX-1"></a> -<h3 class="section">4.6 IPC and TeX</h3> +<span id="IPC-and-TeX-1"></span><h3 class="section">4.6 IPC and TeX</h3> -<a name="index-IPC"></a> -<a name="index-sockets"></a> +<span id="index-IPC"></span> +<span id="index-sockets"></span> <p>(If anyone uses this feature and needs documentation, write <a href="mailto:tex-k@tug.org">tex-k@tug.org</a>.) </p> @@ -2358,7 +2283,7 @@ Next: <a href="#TeX-extensions" accesskey="n" rel="next">TeX extensions</a>, Pre was specified to <code>configure</code> during installation of Web2c (see <a href="#Installation">Installation</a>). </p> -<a name="index-IPC_005fDEBUG-1"></a> +<span id="index-IPC_005fDEBUG-1"></span> <p>If you define <code>IPC_DEBUG</code> before compilation (e.g., with ‘<samp>make XCFLAGS=-DIPC_DEBUG</samp>’), TeX will print messages to standard error about its socket operations. This may be helpful if you are, well, @@ -2366,41 +2291,39 @@ debugging. </p> <hr> -<a name="TeX-extensions"></a> -<div class="header"> +<span id="TeX-extensions"></span><div class="header"> <p> Previous: <a href="#IPC-and-TeX" accesskey="p" rel="prev">IPC and TeX</a>, Up: <a href="#TeX" accesskey="u" rel="up">TeX</a> [<a 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-extensions-1"></a> -<h3 class="section">4.7 TeX extensions</h3> +<span id="TeX-extensions-1"></span><h3 class="section">4.7 TeX extensions</h3> -<a name="index-extensions-to-TeX"></a> -<a name="index-TeX_002c-extensions-to"></a> +<span id="index-extensions-to-TeX"></span> +<span id="index-TeX_002c-extensions-to"></span> <p>The base TeX program has been extended in many ways. Here’s a partial list. </p> <dl compact="compact"> <dt>e-TeX</dt> -<dd><a name="index-e_002dTeX"></a> -<a name="index-primitives_002c-new"></a> +<dd><span id="index-e_002dTeX"></span> +<span id="index-primitives_002c-new"></span> <p>Adds many new primitives, including right-to-left typesetting and more registers. Now frozen. </p> </dd> <dt>Aleph</dt> -<dd><a name="index-Aleph"></a> -<a name="index-Unicode"></a> +<dd><span id="index-Aleph"></span> +<span id="index-Unicode"></span> <p>This adds Unicode support, right-to-left typesetting, and more. Omega was the original program. Aleph is an updated version with a variety of bug fixes, and includes e-TeX. Aleph is not actively maintained. </p> </dd> <dt>pdfTeX</dt> -<dd><a name="index-pdfTeX"></a> -<a name="index-PDF"></a> -<a name="index-micro_002dtypography"></a> -<a name="index-hypertext"></a> +<dd><span id="index-pdfTeX"></span> +<span id="index-PDF"></span> +<span id="index-micro_002dtypography"></span> +<span id="index-hypertext"></span> <p>Can produce PDF as well as DVI files. It also incorporates the e-TeX extensions, new primitives for hypertext and micro-typography, reading/writing from pipes, and much more. Home @@ -2408,16 +2331,16 @@ page: <a href="http://pdftex.org">http://pdftex.org</a>. </p> </dd> <dt>luaTeX</dt> -<dd><a name="index-luaTeX"></a> -<a name="index-Lua"></a> +<dd><span id="index-luaTeX"></span> +<span id="index-Lua"></span> <p>Based on pdfTeX, this also embeds the Lua programming language (<a href="http://lua.org">http://lua.org</a>) and opens up the TeX typesetting engine to control from Lua. Home page: <a href="http://luatex.org">http://luatex.org</a>. </p> </dd> <dt>XeTeX</dt> -<dd><a name="index-XeTeX"></a> -<a name="index-Unicode-1"></a> +<dd><span id="index-XeTeX"></span> +<span id="index-Unicode-1"></span> <p>Combines support for Unicode input and OpenType- and system fonts with the capabilities of pdfTeX. Home page: <a href="http://tug.org/xetex">http://tug.org/xetex</a>. @@ -2427,19 +2350,17 @@ Home page: <a href="http://tug.org/xetex">http://tug.org/xetex</a>. <hr> -<a name="Metafont"></a> -<div class="header"> +<span id="Metafont"></span><div class="header"> <p> Next: <a href="#MetaPost" accesskey="n" rel="next">MetaPost</a>, Previous: <a href="#TeX" accesskey="p" rel="prev">TeX</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="Metafont_003a-Creating-typeface-families"></a> -<h2 class="chapter">5 Metafont: Creating typeface families</h2> +<span id="Metafont_003a-Creating-typeface-families"></span><h2 class="chapter">5 Metafont: Creating typeface families</h2> -<a name="index-Metafont"></a> -<a name="index-typeface-families"></a> -<a name="index-geometric-designs"></a> -<a name="index-shapes"></a> -<a name="index-font-design"></a> +<span id="index-Metafont"></span> +<span id="index-typeface-families"></span> +<span id="index-geometric-designs"></span> +<span id="index-shapes"></span> +<span id="index-font-design"></span> <p>Metafont is a system for producing shapes; it was designed for producing complete typeface families, but it can also produce geometric designs, @@ -2456,32 +2377,30 @@ description of the Metafont language, see <cite>The METAFONTbook</cite> (see <a href="#References">References</a>). </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#mf-invocation" accesskey="1">mf invocation</a>:</td><td> </td><td align="left" valign="top">Invoking Metafont. +<tr><td align="left" valign="top">• <a href="#mf-invocation" accesskey="1">mf invocation</a></td><td> </td><td align="left" valign="top">Invoking Metafont. </td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-Metafont" accesskey="2">Initial Metafont</a>:</td><td> </td><td align="left" valign="top">Making bases. +<tr><td align="left" valign="top">• <a href="#Initial-Metafont" accesskey="2">Initial Metafont</a></td><td> </td><td align="left" valign="top">Making bases. </td></tr> -<tr><td align="left" valign="top">• <a href="#Modes" accesskey="3">Modes</a>:</td><td> </td><td align="left" valign="top">Device definitions for Metafont. +<tr><td align="left" valign="top">• <a href="#Modes" accesskey="3">Modes</a></td><td> </td><td align="left" valign="top">Device definitions for Metafont. </td></tr> -<tr><td align="left" valign="top">• <a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a>:</td><td> </td><td align="left" valign="top">Seeing MF output online. +<tr><td align="left" valign="top">• <a href="#Online-Metafont-graphics" accesskey="4">Online Metafont graphics</a></td><td> </td><td align="left" valign="top">Seeing MF output online. </td></tr> -<tr><td align="left" valign="top">• <a href="#gftodvi-invocation" accesskey="5">gftodvi invocation</a>:</td><td> </td><td align="left" valign="top">Making proofsheets for fonts. +<tr><td align="left" valign="top">• <a href="#gftodvi-invocation" accesskey="5">gftodvi invocation</a></td><td> </td><td align="left" valign="top">Making proofsheets for fonts. </td></tr> -<tr><td align="left" valign="top">• <a href="#mft-invocation" accesskey="6">mft invocation</a>:</td><td> </td><td align="left" valign="top">Prettyprinting Metafont sources. +<tr><td align="left" valign="top">• <a href="#mft-invocation" accesskey="6">mft invocation</a></td><td> </td><td align="left" valign="top">Prettyprinting Metafont sources. </td></tr> </table> <hr> -<a name="mf-invocation"></a> -<div class="header"> +<span id="mf-invocation"></span><div class="header"> <p> Next: <a href="#Initial-Metafont" accesskey="n" rel="next">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="mf-invocation-1"></a> -<h3 class="section">5.1 <code>mf</code> invocation</h3> +<span id="mf-invocation-1"></span><h3 class="section">5.1 <code>mf</code> invocation</h3> -<a name="index-mf"></a> -<a name="index-Metafont-invocation"></a> +<span id="index-mf"></span> +<span id="index-Metafont-invocation"></span> <p>Metafont (usually invoked as <code>mf</code>) reads character definitions specified in the Metafont programming language, and outputs the @@ -2505,25 +2424,25 @@ mf [<var>option</var>]… &<var>base</var> <var>args</var> </pre></div> <p>(The single quotes avoid unwanted interpretation by the shell.) </p> -<a name="index-_002emf"></a> -<a name="index-Metafont-input-files"></a> -<a name="index-EC-fonts-1"></a> -<a name="index-mktexmf_002c-disabling"></a> +<span id="index-_002emf"></span> +<span id="index-Metafont-input-files"></span> +<span id="index-EC-fonts-1"></span> +<span id="index-mktexmf_002c-disabling"></span> <p>Metafont searches the usual places for the main input file <var>mfname</var> -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending <var>mfname</var> with <samp>.mf</samp> if necessary. To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. By default, Metafont runs an external program named <samp>mktexmf</samp> to create any nonexistent Metafont source files you input. You can disable this at configure-time or runtime -(see <a href="http://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is mostly +(see <a href="https://tug.org/texinfohtml/kpathsea.html#mktex-configuration">mktex configuration</a> in <cite>Kpathsea</cite>). This is mostly for the sake of the EC fonts, which can be generated at any size. </p> -<a name="index-_002ennngf-generic-fonts"></a> -<a name="index-mfput"></a> -<a name="index-GF-output"></a> -<a name="index-GF-files_002c-output-by-Metafont"></a> -<a name="index-PK-files_002c-not-output-by-Metafont"></a> +<span id="index-_002ennngf-generic-fonts"></span> +<span id="index-mfput"></span> +<span id="index-GF-output"></span> +<span id="index-GF-files_002c-output-by-Metafont"></span> +<span id="index-PK-files_002c-not-output-by-Metafont"></span> <p>Metafont writes the main GF output to the file <samp><var>basemfname</var>.<var>nnn</var>gf</samp>, where <var>nnn</var> is the font resolution in pixels per inch, and <var>basemfname</var> is the basename of @@ -2533,17 +2452,17 @@ converted immediately to PK files with GFtoPK (see <a href="#gftopk-invocation"> more compact. (Metafont output in GF format rather than PK for only historical reasons.) </p> -<a name="index-_002etfm-output"></a> -<a name="index-TFM-files_002c-output-by-Metafont"></a> +<span id="index-_002etfm-output"></span> +<span id="index-TFM-files_002c-output-by-Metafont"></span> <p>Metafont also usually writes a metric file in TFM format to <samp><var>basemfname</var>.tfm</samp>. A TFM file contains character dimensions, kerns, and ligatures, and spacing parameters. TeX reads only this <tt>.tfm</tt> file, not the GF file. </p> -<a name="index-mode-needed-to-run-Metafont"></a> -<a name="index-proof-mode"></a> -<a name="index-2602gf"></a> -<a name="index-_002e2602gf"></a> +<span id="index-mode-needed-to-run-Metafont"></span> +<span id="index-proof-mode"></span> +<span id="index-2602gf"></span> +<span id="index-_002e2602gf"></span> <p>The <var>mode</var> in the example command above is a name referring to a device definition (see <a href="#Modes">Modes</a>); for example, <code>localfont</code> or <code>ljfour</code>. These device definitions must generally be precompiled @@ -2589,8 +2508,8 @@ See <a href="#Common-options">Common options</a>. </dd> <dt>‘<samp>-mktex=<var>filetype</var></samp>’</dt> <dt>‘<samp>-no-mktex=<var>filetype</var></samp>’</dt> -<dd><a name="index-_002dmktex_003dfiletype-1"></a> -<a name="index-_002dno_002dmktex_003dfiletype-1"></a> +<dd><span id="index-_002dmktex_003dfiletype-1"></span> +<span id="index-_002dno_002dmktex_003dfiletype-1"></span> <p>Turn on or off the ‘<samp>mktex</samp>’ script associated with <var>filetype</var>. The only value that makes sense for <var>filetype</var> is ‘<samp>mf</samp>’. </p></dd> @@ -2598,19 +2517,17 @@ The only value that makes sense for <var>filetype</var> is ‘<samp>mf</samp <hr> -<a name="Initial-Metafont"></a> -<div class="header"> +<span id="Initial-Metafont"></span><div class="header"> <p> Next: <a href="#Modes" accesskey="n" rel="next">Modes</a>, Previous: <a href="#mf-invocation" accesskey="p" rel="prev">mf invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Initial-Metafont-1"></a> -<h3 class="section">5.2 Initial Metafont</h3> +<span id="Initial-Metafont-1"></span><h3 class="section">5.2 Initial Metafont</h3> -<a name="index-initial-Metafont"></a> -<a name="index-Metafont_002c-initial"></a> +<span id="index-initial-Metafont"></span> +<span id="index-Metafont_002c-initial"></span> -<a name="index-_002ebase"></a> -<a name="index-base-files"></a> +<span id="index-_002ebase"></span> +<span id="index-base-files"></span> <p><code>inimf</code> is the “initial” form of Metafont, which does lengthy initializations avoided by the “virgin” (<code>vir</code>) form, so as to be capable of dumping ‘<samp>.base</samp>’ files (see <a href="#Memory-dumps">Memory dumps</a>). For @@ -2618,8 +2535,8 @@ a detailed comparison of virgin and initial forms, see <a href="#Initial-and-vir </p> <p>For a list of options and other information, see <a href="#mf-invocation">mf invocation</a>. </p> -<a name="index-plain_002ebase"></a> -<a name="index-mf_002ebase"></a> +<span id="index-plain_002ebase"></span> +<span id="index-mf_002ebase"></span> <p>The only memory dump file commonly used with Metafont is the default ‘<samp>plain.base</samp>’, also known as ‘<samp>mf.base</samp>’ (again, see <a href="#Memory-dumps">Memory dumps</a>). It is created by default during installation, but you can also do so by hand if necessary (e.g., if a Metafont update is issued): @@ -2634,48 +2551,46 @@ Then install the resulting <samp>plain.base</samp> in ‘<samp>$(basedir)</s <p>For an explanation of the additional <samp>modes.mf</samp> file, see <a href="#Modes">Modes</a>. This file has no counterpart in TeX or MetaPost. </p> -<a name="index-cmmf_002ebase-not-recommended"></a> -<a name="index-cm_002ebase"></a> -<a name="index-cmbase_002emf"></a> -<a name="index-Computer-Modern-macros"></a> -<a name="index-base-files_002c-plain-only"></a> +<span id="index-cmmf_002ebase-not-recommended"></span> +<span id="index-cm_002ebase"></span> +<span id="index-cmbase_002emf"></span> +<span id="index-Computer-Modern-macros"></span> +<span id="index-base-files_002c-plain-only"></span> <p>In the past, it was sometimes useful to create a base file <samp>cmmf.base</samp> (a.k.a. <samp>cm.base</samp>), with the Computer Modern macros also included in the base file. Nowadays, however, the additional time required to read <samp>cmbase.mf</samp> is exceedingly small, usually not enough to be worth the administrative hassle of updating the <samp>cmmf.base</samp> file when you install a new version of <samp>modes.mf</samp>. -<a name="index-type-design_002c-personal"></a> +<span id="index-type-design_002c-personal"></span> People actually working on a typeface may still find it worthwhile to create their own base file, of course. </p> <hr> -<a name="Modes"></a> -<div class="header"> +<span id="Modes"></span><div class="header"> <p> Next: <a href="#Online-Metafont-graphics" accesskey="n" rel="next">Online Metafont graphics</a>, Previous: <a href="#Initial-Metafont" accesskey="p" rel="prev">Initial Metafont</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Modes_003a-Device-definitions-for-Metafont"></a> -<h3 class="section">5.3 Modes: Device definitions for Metafont</h3> +<span id="Modes_003a-Device-definitions-for-Metafont"></span><h3 class="section">5.3 Modes: Device definitions for Metafont</h3> -<a name="index-modes-file-needed-for-Metafont"></a> -<a name="index-base-files_002c-need-mode-definitions"></a> -<a name="index-device-definitions_002c-for-Metafont"></a> -<a name="index-printer-characteristics_002c-for-Metafont"></a> +<span id="index-modes-file-needed-for-Metafont"></span> +<span id="index-base-files_002c-need-mode-definitions"></span> +<span id="index-device-definitions_002c-for-Metafont"></span> +<span id="index-printer-characteristics_002c-for-Metafont"></span> <p>Running Metafont and creating Metafont base files requires information that TeX and MetaPost do not: <em>mode</em> definitions which specify device characteristics, so Metafont can properly rasterize the shapes. </p> -<a name="index-modes_002emf-recommended-modes-file"></a> +<span id="index-modes_002emf-recommended-modes-file"></span> <p>When making a base file, a file containing modes for locally-available devices should be input after <samp>plain.mf</samp>. One commonly used file is <a href="ftp://ftp.tug.org/tex/modes.mf">ftp://ftp.tug.org/tex/modes.mf</a>; it includes all known definitions. </p> -<a name="index-small-Metafont-memory-and-modes"></a> -<a name="index-mode_005fdef"></a> -<a name="index-mode_005fsetup"></a> +<span id="index-small-Metafont-memory-and-modes"></span> +<span id="index-mode_005fdef"></span> +<span id="index-mode_005fsetup"></span> <p>If, however, for some reason you have decreased the memory available in your Metafont, you may need to copy <samp>modes.mf</samp> and remove the definitions irrelevant to you (probably most of them) instead of using @@ -2689,8 +2604,8 @@ comments in that file for how to create the new definition, and please send the definition to <a href="mailto:tex-fonts@math.utah.edu">tex-fonts@math.utah.edu</a> to get it included in the next release of <samp>modes.mf</samp>. </p> -<a name="index-smode-and-dynamic-Metafont-mode-definition"></a> -<a name="index-dynamic-Metafont-mode-definitions-with-smode"></a> +<span id="index-smode-and-dynamic-Metafont-mode-definition"></span> +<span id="index-dynamic-Metafont-mode-definitions-with-smode"></span> <p>Usually, when you run Metafont you must supply the name of a mode that was dumped in the base file. But you can also define the mode characteristics dynamically, by invoking Metafont with an assignment to @@ -2720,24 +2635,22 @@ and <var>o</var>.) </p> <hr> -<a name="Online-Metafont-graphics"></a> -<div class="header"> +<span id="Online-Metafont-graphics"></span><div class="header"> <p> Next: <a href="#gftodvi-invocation" accesskey="n" rel="next">gftodvi invocation</a>, Previous: <a href="#Modes" accesskey="p" rel="prev">Modes</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Online-Metafont-graphics-1"></a> -<h3 class="section">5.4 Online Metafont graphics</h3> +<span id="Online-Metafont-graphics-1"></span><h3 class="section">5.4 Online Metafont graphics</h3> -<a name="index-online-Metafont-graphics"></a> -<a name="index-Metafont-graphics"></a> +<span id="index-online-Metafont-graphics"></span> +<span id="index-Metafont-graphics"></span> <p>The Web2c implementation of Metafont can do online graphics with a number of devices. (See the Metafont manual for more information about how to draw on your screen.) By default, no graphics support is enabled. </p> -<a name="index-MFTERM"></a> -<a name="index-TERM"></a> +<span id="index-MFTERM"></span> +<span id="index-TERM"></span> <p>Metafont examines the <code>MFTERM</code> environment variable or config file value at runtime, or the <code>TERM</code> environment variable if <code>MFTERM</code> is not set, to determine the device support to use. @@ -2749,10 +2662,10 @@ and the corresponding <code>configure</code> option(s) in parentheses. </p> <dl compact="compact"> <dt><code>epsf</code> -<a name="index-epsf"></a> +<span id="index-epsf"></span> </dt> -<dd><a name="index-Herberts_002c-Mathias"></a> -<a name="index-_002d_002denable_002depsfwin"></a> +<dd><span id="index-Herberts_002c-Mathias"></span> +<span id="index-_002d_002denable_002depsfwin"></span> <p>(‘<samp>--enable-epsfwin</samp>’) Pseudo-window server for Encapsulated PostScript (see <samp>web2c/window/epsf.c</samp>). This device produces an EPS file containing the graphics which would be displayed online on @@ -2762,103 +2675,103 @@ filename. Contributed by Mathias Herberts. </p> </dd> <dt><code>hp2627</code> -<a name="index-hp2627"></a> +<span id="index-hp2627"></span> </dt> -<dd><a name="index-_002d_002denable_002dhp2627win"></a> +<dd><span id="index-_002d_002denable_002dhp2627win"></span> <p>(‘<samp>--enable-hp2627win</samp>’) HP2627a color graphics terminals. </p> </dd> <dt><code>mftalk</code> -<a name="index-mftalk"></a> +<span id="index-mftalk"></span> </dt> -<dd><a name="index-_002d_002denable_002dmftalkwin"></a> +<dd><span id="index-_002d_002denable_002dmftalkwin"></span> <p>(‘<samp>--enable-mftalkwin</samp>’) Generic window server (see <samp>web2c/window/mftalk.c</samp>). </p> </dd> <dt><code>next</code> -<a name="index-next"></a> +<span id="index-next"></span> </dt> -<dd><a name="index-DrawingServant"></a> -<a name="index-_002d_002denable_002dnext"></a> +<dd><span id="index-DrawingServant"></span> +<span id="index-_002d_002denable_002dnext"></span> <p>(‘<samp>--enable-next</samp>’) NeXT window system. This requires a separate program, called <code>DrawingServant</code>, available separately. See the <samp>web2c/window/next.c</samp>. </p> </dd> <dt><code>regis</code> -<a name="index-regis"></a> +<span id="index-regis"></span> </dt> -<dd><a name="index-_002d_002denable_002dregiswin"></a> -<a name="index-Regis-graphics-support"></a> +<dd><span id="index-_002d_002denable_002dregiswin"></span> +<span id="index-Regis-graphics-support"></span> <p>(‘<samp>--enable-regiswin</samp>’) Regis terminals. </p> </dd> <dt><code>sun</code> -<a name="index-sun"></a> +<span id="index-sun"></span> </dt> -<dd><a name="index-SunView"></a> -<a name="index-Suntools"></a> -<a name="index-_002d_002denable_002dsuntoolswin"></a> -<a name="index-sun_002dgfx_002ec"></a> +<dd><span id="index-SunView"></span> +<span id="index-Suntools"></span> +<span id="index-_002d_002denable_002dsuntoolswin"></span> +<span id="index-sun_002dgfx_002ec"></span> <p>(‘<samp>--enable-suntoolswin</samp>’) The old Suntools (not any flavor of X) window system. (You can get the even older SunWindows <code>gfx</code> system by using <samp>sun-gfx.c</samp>.) </p> </dd> <dt><code>tek</code> -<a name="index-tek"></a> +<span id="index-tek"></span> </dt> -<dd><a name="index-Tektronix"></a> -<a name="index-_002d_002denable_002dtektronixwin"></a> +<dd><span id="index-Tektronix"></span> +<span id="index-_002d_002denable_002dtektronixwin"></span> <p>(‘<samp>--enable-tektronixwin</samp>’) Tektronix terminals. </p> -<a name="index-Poole_002c-Simon"></a> +<span id="index-Poole_002c-Simon"></span> </dd> <dt><code>uniterm</code> -<a name="index-uniterm"></a> +<span id="index-uniterm"></span> </dt> -<dd><a name="index-Tektronix-4014"></a> -<a name="index-_002d_002denable_002dunitermwin"></a> +<dd><span id="index-Tektronix-4014"></span> +<span id="index-_002d_002denable_002dunitermwin"></span> <p>(‘<samp>--enable-unitermwin</samp>’) Uniterm, Simon Poole’s emulator of a smart Tektronix 4014 terminal. This may work with regular Tektronix terminals as well; it’s faster than the driver ‘<samp>--enable-tektronixwin</samp>’ selects. </p> -<a name="index-NO_005fX11WIN"></a> -<a name="index-Xt"></a> -<a name="index-Xlib"></a> +<span id="index-NO_005fX11WIN"></span> +<span id="index-Xt"></span> +<span id="index-Xlib"></span> </dd> <dt><code>xterm</code> -<a name="index-xterm"></a> +<span id="index-xterm"></span> </dt> -<dd><a name="index-_002d_002dwith_002dx"></a> +<dd><span id="index-_002d_002dwith_002dx"></span> <p>‘<samp>--with-x</samp>’ The X window system (version 11). </p> -<a name="index-_002d_002dwith_002dmf_002dx_002dtoolkit_003dkit"></a> -<a name="index-toolkits_002c-X"></a> -<a name="index-X-toolkits-and-Metafont"></a> -<a name="index-Xt-support"></a> -<a name="index-Xlib-support"></a> +<span id="index-_002d_002dwith_002dmf_002dx_002dtoolkit_003dkit"></span> +<span id="index-toolkits_002c-X"></span> +<span id="index-X-toolkits-and-Metafont"></span> +<span id="index-Xt-support"></span> +<span id="index-Xlib-support"></span> <p>There are two variants of the X11 support, one that works with the Xt toolkit, and another that works directly with Xlib. The Xt support is more efficient and has more functionality, so it is the default. If you must use the Xlib support, use ‘<samp>configure --with-x --with-kf-x-toolkit=no</samp>’. </p> -<a name="index-_002d_002ddisable_002dmf_002dnowin"></a> -<a name="index-non_002dwindows_002dcapable-Metafont"></a> +<span id="index-_002d_002ddisable_002dmf_002dnowin"></span> +<span id="index-non_002dwindows_002dcapable-Metafont"></span> <p>Specify ‘<samp>--disable-mf-nowin</samp>’ in order not to build a separate non-windows-capable Metafont executable <code>mf-nowin</code> (or <code>mf-nowin.exe</code>). </p> -<a name="index-X-resources"></a> -<a name="index-X-class-name-for-Metafont"></a> -<a name="index-class-name-for-Metafont"></a> -<a name="index-geometry-for-Metafont"></a> -<a name="index-Metafont-geometry"></a> -<a name="index-_002eXdefaults"></a> -<a name="index-_002eXresources"></a> -<a name="index-_002dgeometry_002c-supported-with-Xt"></a> +<span id="index-X-resources"></span> +<span id="index-X-class-name-for-Metafont"></span> +<span id="index-class-name-for-Metafont"></span> +<span id="index-geometry-for-Metafont"></span> +<span id="index-Metafont-geometry"></span> +<span id="index-_002eXdefaults"></span> +<span id="index-_002eXresources"></span> +<span id="index-_002dgeometry_002c-supported-with-Xt"></span> <p>You cannot specify any of the usual X options (e.g., ‘<samp>-geometry</samp>’) on the Metafont command line, but you can specify X resources in your <samp>~/.Xdefaults</samp> or <samp>~/.Xresources</samp> file. The class name is @@ -2866,16 +2779,16 @@ on the Metafont command line, but you can specify X resources in your resources are supported. If you’re using the Xlib support, only the <code>geometry</code> resource is supported. </p> -<a name="index-DISPLAY"></a> +<span id="index-DISPLAY"></span> <p>You specify the X display to which Metafont connects in the <code>DISPLAY</code> environment variable, as usual. </p> </dd> </dl> -<a name="index-Metafont-online-support_002c-new-devices"></a> -<a name="index-new-graphics-support-for-Metafont"></a> -<a name="index-texmfmp_002ec"></a> +<span id="index-Metafont-online-support_002c-new-devices"></span> +<span id="index-new-graphics-support-for-Metafont"></span> +<span id="index-texmfmp_002ec"></span> <p>Writing support for a new device is straightforward. Aside from defining the basic drawing routines that Metafont uses (see <samp>mf.web</samp>), you only have to add another entry to the tables on the last page of @@ -2884,18 +2797,16 @@ use MFtalk (see <samp>web2c/window/mftalk.c</samp>). </p> <hr> -<a name="gftodvi-invocation"></a> -<div class="header"> +<span id="gftodvi-invocation"></span><div class="header"> <p> Next: <a href="#mft-invocation" accesskey="n" rel="next">mft invocation</a>, Previous: <a href="#Online-Metafont-graphics" accesskey="p" rel="prev">Online Metafont graphics</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="GFtoDVI_003a-Character-proofs-of-fonts"></a> -<h3 class="section">5.5 GFtoDVI: Character proofs of fonts</h3> +<span id="GFtoDVI_003a-Character-proofs-of-fonts"></span><h3 class="section">5.5 GFtoDVI: Character proofs of fonts</h3> -<a name="index-gftodvi"></a> -<a name="index-character-proofs-of-fonts"></a> -<a name="index-font-proofs"></a> -<a name="index-proof-sheets_002c-of-fonts"></a> +<span id="index-gftodvi"></span> +<span id="index-character-proofs-of-fonts"></span> +<span id="index-font-proofs"></span> +<span id="index-proof-sheets_002c-of-fonts"></span> <p>GFtoDVI makes <em>proof sheets</em> from a GF bitmap file as output by, for example, Metafont (see <a href="#Metafont">Metafont</a>). This is an indispensable aid for @@ -2905,7 +2816,7 @@ font designers or Metafont hackers. Synopsis: <pre class="example">gftodvi [<var>option</var>]… <var>gfname</var>[gf] </pre></div> -<p>The font <var>gfname</var> is searched for in the usual places (see <a href="http://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -2924,20 +2835,20 @@ with labels, titles, and annotations, as specified in Appendix H <p>GFtoDVI uses several fonts besides <var>gfname</var> itself: </p> <ul> -<li> <a name="index-gray-font"></a> +<li> <span id="index-gray-font"></span> <em>gray font</em> (default <samp>gray</samp>): for the pixels that actually make up the character. Simply using black is not right, since then labels, key points, and other information could not be shown. -</li><li> <a name="index-title-font"></a> +</li><li> <span id="index-title-font"></span> <em>title font</em> (default <samp>cmr8</samp>): for the header information at the top of each output page. -</li><li> <a name="index-label-font"></a> +</li><li> <span id="index-label-font"></span> <em>label font</em> (default <samp>cmtt10</samp>): for the labels on key points of the figure. -</li><li> <a name="index-slant-font"></a> +</li><li> <span id="index-slant-font"></span> <em>slant font</em> (no default): for diagonal lines, which are otherwise simulated using horizontal and vertical rules. </li></ul> @@ -2961,9 +2872,9 @@ should produce <samp>rtest.dvi</samp>, which you process as usual. </p> <dl compact="compact"> <dt>‘<samp>-overflow-label-offset=<var>points</var></samp>’</dt> -<dd><a name="index-_002doverflow_002dlabel_002doffset_003dpoints"></a> -<a name="index-overflow-label-offset"></a> -<a name="index-offset-for-overflow-labels"></a> +<dd><span id="index-_002doverflow_002dlabel_002doffset_003dpoints"></span> +<span id="index-overflow-label-offset"></span> +<span id="index-offset-for-overflow-labels"></span> <p>Typeset the so-called overflow labels, if any, <var>points</var> TeX points from the right edge of the character bounding box. The default is a little over two inches (ten million scaled points, to be precise). @@ -2974,20 +2885,18 @@ position is too crowded with other information. <hr> -<a name="mft-invocation"></a> -<div class="header"> +<span id="mft-invocation"></span><div class="header"> <p> Previous: <a href="#gftodvi-invocation" accesskey="p" rel="prev">gftodvi invocation</a>, Up: <a href="#Metafont" accesskey="u" rel="up">Metafont</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="MFT_003a-Prettyprinting-Metafont-source"></a> -<h3 class="section">5.6 MFT: Prettyprinting Metafont source</h3> +<span id="MFT_003a-Prettyprinting-Metafont-source"></span><h3 class="section">5.6 MFT: Prettyprinting Metafont source</h3> -<a name="index-mft"></a> -<a name="index-Metafont-source_002c-prettyprinting"></a> -<a name="index-prettyprinting-Metafont-source"></a> -<a name="index-TeX_002c-creating-from-Metafont"></a> +<span id="index-mft"></span> +<span id="index-Metafont-source_002c-prettyprinting"></span> +<span id="index-prettyprinting-Metafont-source"></span> +<span id="index-TeX_002c-creating-from-Metafont"></span> -<a name="index-mftmac_002etex"></a> +<span id="index-mftmac_002etex"></span> <p>MFT translates a Metafont program into a TeX document suitable for typesetting, with the aid of TeX macros defined in the file <samp>mftmac.tex</samp>. Synopsis: @@ -2996,7 +2905,7 @@ typesetting, with the aid of TeX macros defined in the file <pre class="example">mft [<var>option</var>]… <var>mfname</var>[.mf] </pre></div> -<p>MFT searches the usual places for <var>mfname</var> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file +<p>MFT searches the usual places for <var>mfname</var> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. The output goes to the basename of <var>mfname</var> extended @@ -3010,7 +2919,7 @@ indentation and line breaks. Each line of input is translated independently of the others. </p> <p>Further control is allowed via Metafont comments: -<a name="index-comments_002c-MFT-control"></a> +<span id="index-comments_002c-MFT-control"></span> </p><ul> <li> Metafont comments following a single ‘<samp>%</samp>’ should be valid TeX input. But Metafont material can be included within vertical bars in a @@ -3048,7 +2957,7 @@ of such a line. </li><li> Five or more ‘<samp>%</samp>’ signs should not be used. </li></ul> -<a name="index-Knuth_002c-Donald-E_002e-1"></a> +<span id="index-Knuth_002c-Donald-E_002e-1"></span> <p>(The above description was edited from <samp>mft.web</samp>, written by D.E. Knuth<!-- /@w -->.) </p> @@ -3056,31 +2965,31 @@ D.E. Knuth<!-- /@w -->.) ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-change=<var>chfile</var>[.ch]</samp>’</dt> -<dd><a name="index-_002dchange_003dchfile"></a> -<a name="index-change-files_002c-and-MFT"></a> +<dd><span id="index-_002dchange_003dchfile"></span> +<span id="index-change-files_002c-and-MFT"></span> <p>Apply the change file <var>chfile</var> as with Tangle and Weave (see <a href="#WEB">WEB</a>). </p> </dd> <dt>‘<samp>-style=<var>mftfile</var>[.mft]</samp>’</dt> -<dd><a name="index-_002dstyle_003dmftfile"></a> -<a name="index-style-files"></a> -<a name="index-plain_002emft"></a> +<dd><span id="index-_002dstyle_003dmftfile"></span> +<span id="index-style-files"></span> +<span id="index-plain_002emft"></span> <p>Read <var>mftfile</var> before anything else; a MFT style file typically contains only MFT directives as described above. The default style file is named <samp>plain.mft</samp>, which defines this properly for programs using plain Metafont. The MFT files is searched along the -<code>MFTINPUTS</code> path; see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. +<code>MFTINPUTS</code> path; see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>. </p> -<a name="index-cmbase_002emft"></a> -<a name="index-e_002emft"></a> -<a name="index-Computer-Modern-Typefaces_002c-production-of"></a> +<span id="index-cmbase_002emft"></span> +<span id="index-e_002emft"></span> +<span id="index-Computer-Modern-Typefaces_002c-production-of"></span> <p>Other examples of MFT style files are <samp>cmbase.mft</samp>, which defines formatting rules for the macros defined in <samp>cm.base</samp>, and <samp>e.mft</samp>, which was used in the production of Knuth’s Volume <!-- /@w -->E, <cite>Computer Modern Typefaces</cite>. </p> -<a name="index-MetaPost-source_002c-prettyprinting"></a> +<span id="index-MetaPost-source_002c-prettyprinting"></span> <p>Using an appropriate MFT style file, it is also possible to configure MFT for typesetting MetaPost sources. However, MFT does not search the usual places for MetaPost input files. @@ -3093,17 +3002,15 @@ configure TeX to print these properly. </p> <hr> -<a name="MetaPost"></a> -<div class="header"> +<span id="MetaPost"></span><div class="header"> <p> Next: <a href="#BibTeX" accesskey="n" rel="next">BibTeX</a>, Previous: <a href="#Metafont" accesskey="p" rel="prev">Metafont</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="MetaPost_003a-Creating-technical-illustrations"></a> -<h2 class="chapter">6 MetaPost: Creating technical illustrations</h2> +<span id="MetaPost_003a-Creating-technical-illustrations"></span><h2 class="chapter">6 MetaPost: Creating technical illustrations</h2> -<a name="index-MetaPost"></a> -<a name="index-PostScript-meets-Metafont"></a> -<a name="index-Metafont-meets-PostScript"></a> +<span id="index-MetaPost"></span> +<span id="index-PostScript-meets-Metafont"></span> +<span id="index-Metafont-meets-PostScript"></span> <p>MetaPost is a picture-drawing language similar to Metafont (see <a href="#Metafont">Metafont</a>), but instead of outputting bitmaps in a “font”, it outputs PostScript commands. It’s primarily intended for creating @@ -3114,28 +3021,26 @@ a natural way, using any typesetter (TeX and Troff are both supported) and a number of other subsidiary programs, described below. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#mpost-invocation" accesskey="1">mpost invocation</a>:</td><td> </td><td align="left" valign="top">Invoking MetaPost. +<tr><td align="left" valign="top">• <a href="#mpost-invocation" accesskey="1">mpost invocation</a></td><td> </td><td align="left" valign="top">Invoking MetaPost. </td></tr> -<tr><td align="left" valign="top">• <a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a>:</td><td> </td><td align="left" valign="top">Making mems. +<tr><td align="left" valign="top">• <a href="#Initial-MetaPost" accesskey="2">Initial MetaPost</a></td><td> </td><td align="left" valign="top">Making mems. </td></tr> -<tr><td align="left" valign="top">• <a href="#dvitomp-invocation" accesskey="3">dvitomp invocation</a>:</td><td> </td><td align="left" valign="top">DVI-to-MPX translation. +<tr><td align="left" valign="top">• <a href="#dvitomp-invocation" accesskey="3">dvitomp invocation</a></td><td> </td><td align="left" valign="top">DVI-to-MPX translation. </td></tr> </table> <hr> -<a name="mpost-invocation"></a> -<div class="header"> +<span id="mpost-invocation"></span><div class="header"> <p> Next: <a href="#Initial-MetaPost" accesskey="n" rel="next">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="mpost-invocation-1"></a> -<h3 class="section">6.1 <code>mpost</code> invocation</h3> +<span id="mpost-invocation-1"></span><h3 class="section">6.1 <code>mpost</code> invocation</h3> -<a name="index-mpost"></a> -<a name="index-MetaPost-invocation"></a> +<span id="index-mpost"></span> +<span id="index-MetaPost-invocation"></span> -<a name="index-mpman_002eps"></a> +<span id="index-mpman_002eps"></span> <p>MetaPost (installed as <code>mpost</code>) reads a series of pictures specified in the MetaPost programming language, and outputs corresponding PostScript code. This section merely describes the @@ -3151,7 +3056,7 @@ also: related information). </li></ul> -<a name="index-mpgraph_002eps"></a> +<span id="index-mpgraph_002eps"></span> <p>Also, a standard MetaPost package for drawing graphs is documented in AT&T technical report CSTR-164, available as the file <samp>mpgraph.ps</samp>, generally stored alongside <samp>mpman.ps</samp>. @@ -3166,20 +3071,20 @@ mpost [<var>option</var>]… \<var>first-line</var> mpost [<var>option</var>]… &<var>mem</var> <var>args</var> </pre></div> -<a name="index-_002emp"></a> -<a name="index-MetaPost-input-files"></a> +<span id="index-_002emp"></span> +<span id="index-MetaPost-input-files"></span> <p>MetaPost searches the usual places for the main input file <var>mpname</var> -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>), extending <var>mpname</var> with <samp>.mp</samp> if necessary. To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. </p> -<a name="index-beginfig"></a> -<a name="index-_002ennn-PostScript-figures"></a> -<a name="index-_002etfm-output-1"></a> -<a name="index-mpout"></a> -<a name="index-TFM-files_002c-output-by-MetaPost"></a> -<a name="index-PostScript-output"></a> +<span id="index-beginfig"></span> +<span id="index-_002ennn-PostScript-figures"></span> +<span id="index-_002etfm-output-1"></span> +<span id="index-mpout"></span> +<span id="index-TFM-files_002c-output-by-MetaPost"></span> +<span id="index-PostScript-output"></span> <p>MetaPost writes its PostScript output to a series of files <samp><var>basempname</var>.<var>nnn</var></samp> (or perhaps <samp><var>basempname</var>.ps</samp>, very occasionally @@ -3194,10 +3099,10 @@ with any other PostScript figures. For example, with this TeX command: </p><div class="example"> <pre class="example">\special{psfile="<var>filename</var>"} </pre></div> -<p>or by using <samp>epsf.tex</samp> (see <a href="http://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite>Dvips</cite>). +<p>or by using <samp>epsf.tex</samp> (see <a href="https://tug.org/texinfohtml/dvips.html#EPSF-macros">EPSF macros</a> in <cite>Dvips</cite>). </p> -<a name="index-btex-for-MetaPost-labels"></a> -<a name="index-etex-for-MetaPost-labels"></a> +<span id="index-btex-for-MetaPost-labels"></span> +<span id="index-etex-for-MetaPost-labels"></span> <p>The MetaPost construct </p><div class="example"> <pre class="example">btex … <var>tex-input</var> … etex @@ -3222,21 +3127,21 @@ package (unfortunately absent from many Troff implementations), or an equivalent such as the ‘<samp>-m pspic</samp>’ macros from GNU groff described in grops(1). </p> -<a name="index-PostScript-fonts_002c-and-Troff"></a> -<a name="index-Troff_002c-and-MetaPost"></a> -<a name="index-Computer-Modern-fonts_002c-and-Troff"></a> +<span id="index-PostScript-fonts_002c-and-Troff"></span> +<span id="index-Troff_002c-and-MetaPost"></span> +<span id="index-Computer-Modern-fonts_002c-and-Troff"></span> <p>Naturally, you must use fonts that are supported by the typesetter; specifically, you’ll probably want to use standard PostScript fonts with Troff. And only the TeX system understands Computer Modern or other Metafont fonts; you can also use PostScript fonts with TeX, of course. </p> -<a name="index-mproof_002etex"></a> -<a name="index-downloading-of-fonts-for-MetaPost-labels"></a> -<a name="index-font-downloading-for-MetaPost-labels"></a> +<span id="index-mproof_002etex"></span> +<span id="index-downloading-of-fonts-for-MetaPost-labels"></span> +<span id="index-font-downloading-for-MetaPost-labels"></span> <p>MetaPost-generated PostScript figures which do use Computer Modern fonts for labels cannot be directly previewed or printed. Instead, you must include them in a TeX document and run the resulting DVI file through -Dvips to arrange for the downloading of the required fonts (see <a href="http://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts +Dvips to arrange for the downloading of the required fonts (see <a href="https://tug.org/texinfohtml/dvips.html#Fonts-in-figures">Fonts in figures</a> in <cite>Dvips</cite>). To help with this, the MetaPost distribution provides a small TeX file <samp>mproof.tex</samp> which is typically called as: @@ -3245,16 +3150,16 @@ typically called as: </pre></div> <p>The resulting file <samp>mproof.ps</samp> can then be printed or previewed. </p> -<a name="index-prologues_002c-and-EPSF-output"></a> -<a name="index-psfonts_002emap_002c-read-by-MetaPost"></a> +<span id="index-prologues_002c-and-EPSF-output"></span> +<span id="index-psfonts_002emap_002c-read-by-MetaPost"></span> <p>To generate EPSF files, set the internal MetaPost variable <code>prologues</code> positive. To make the output files self-contained, use only standard PostScript fonts. MetaPost reads the same <samp>psfonts.map</samp> file as Dvips, to determine PostScript fonts that -need to be downloaded (see <a href="http://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite>Dvips</cite>). +need to be downloaded (see <a href="https://tug.org/texinfohtml/dvips.html#psfonts_002emap">psfonts.map</a> in <cite>Dvips</cite>). </p> -<a name="index-PDF_002c-and-_002emps-files"></a> -<a name="index-_002emps-files-and-PDF"></a> +<span id="index-PDF_002c-and-_002emps-files"></span> +<span id="index-_002emps-files-and-PDF"></span> <p>It is posible for pdfTeX to read MetaPost output directly; this is in contrast to general EPSF files, which have to be converted for use with PDF output. The easiest way is to name the MetaPost output files @@ -3262,7 +3167,7 @@ with the <code>.mps</code> extension. Then the LaTeX <code>\includegraphics</code> command, for example, will be able to read them, even when outputting PDF. </p> -<a name="index-security_002c-and-write"></a> +<span id="index-security_002c-and-write"></span> <p>MetaPost can write output files, via the <code>write</code> primitive; this opens a security hole. See <a href="#tex-invocation">tex invocation</a>. </p> @@ -3288,14 +3193,14 @@ See <a href="#Common-options">Common options</a>. </dd> <dt>‘<samp>-T</samp>’</dt> <dt>‘<samp>-troff</samp>’</dt> -<dd><a name="index-_002dT"></a> -<a name="index-_002dtroff"></a> -<a name="index-prologues"></a> +<dd><span id="index-_002dT"></span> +<span id="index-_002dtroff"></span> +<span id="index-prologues"></span> <p>Set the <code>prologues</code> internal variable to <code>1</code>. </p> </dd> <dt>‘<samp>-tex=<var>texprogram</var></samp>’</dt> -<dd><a name="index-_002dtex_003dtexprogram"></a> +<dd><span id="index-_002dtex_003dtexprogram"></span> <p>When this option is given, the program <var>texprogram</var> is used to typeset the labels. </p> @@ -3304,16 +3209,14 @@ typeset the labels. <hr> -<a name="Initial-MetaPost"></a> -<div class="header"> +<span id="Initial-MetaPost"></span><div class="header"> <p> Next: <a href="#dvitomp-invocation" accesskey="n" rel="next">dvitomp invocation</a>, Previous: <a href="#mpost-invocation" accesskey="p" rel="prev">mpost invocation</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Initial-MetaPost-1"></a> -<h3 class="section">6.2 Initial MetaPost</h3> +<span id="Initial-MetaPost-1"></span><h3 class="section">6.2 Initial MetaPost</h3> -<a name="index-initial-MetaPost"></a> -<a name="index-MetaPost_002c-initial"></a> +<span id="index-initial-MetaPost"></span> +<span id="index-MetaPost_002c-initial"></span> <p>As of MetaPost 1.504 (TeX Live 2011), MetaPost no longer dumps <samp>.mem</samp> files (see <a href="#Memory-dumps">Memory dumps</a>) and does not distinguish @@ -3323,10 +3226,10 @@ virgin and initial forms (see <a href="#Initial-and-virgin">Initial and virgin</ </p> <p>For a list of options and other information, see <a href="#mpost-invocation">mpost invocation</a>. </p> -<a name="index-Metafont_002c-compatibility-in-MetaPost"></a> -<a name="index-plain-Metafont_002c-compatibility-in-MetaPost"></a> -<a name="index-MetaPost-and-plain-Metafont-compatibility"></a> -<a name="index-mfplain"></a> +<span id="index-Metafont_002c-compatibility-in-MetaPost"></span> +<span id="index-plain-Metafont_002c-compatibility-in-MetaPost"></span> +<span id="index-MetaPost-and-plain-Metafont-compatibility"></span> +<span id="index-mfplain"></span> <p>MetaPost provides a format with all the features of plain Metafont, called <samp>mfplain</samp>. You can use that in the same way; just run <code>mfplain</code> instead of <code>mpost</code>. This lets you directly @@ -3336,17 +3239,15 @@ Metafont in proof mode and GFtoDVI (see <a href="#gftodvi-invocation">gftodvi in </p> <hr> -<a name="dvitomp-invocation"></a> -<div class="header"> +<span id="dvitomp-invocation"></span><div class="header"> <p> Previous: <a href="#Initial-MetaPost" accesskey="p" rel="prev">Initial MetaPost</a>, Up: <a href="#MetaPost" accesskey="u" rel="up">MetaPost</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="DVItoMP_003a-DVI-to-MPX-conversion"></a> -<h3 class="section">6.3 DVItoMP: DVI to MPX conversion</h3> +<span id="DVItoMP_003a-DVI-to-MPX-conversion"></span><h3 class="section">6.3 DVItoMP: DVI to MPX conversion</h3> -<a name="index-dvitomp"></a> -<a name="index-DVI-files_002c-converting-to-MPX"></a> -<a name="index-MPX-files_002c-converting-from-DVI-files"></a> +<span id="index-dvitomp"></span> +<span id="index-DVI-files_002c-converting-to-MPX"></span> +<span id="index-MPX-files_002c-converting-from-DVI-files"></span> <p>DVItoMP converts DVI files into low-level MetaPost commands in a so-called MPX file. Synopsis: @@ -3359,7 +3260,7 @@ so-called MPX file. Synopsis: <var>dvifile</var> extended with <samp>.mpx</samp>, e.g., ‘<samp>dvitomp /wherever/foo.dvi</samp>’ creates <samp>./foo.mpx</samp>. </p> -<a name="index-color_002c-in-DVItoMP"></a> +<span id="index-color_002c-in-DVItoMP"></span> <p>DVItoMP supports Dvips-style color specials, such as ‘<samp>color push <var>name</var></samp>’ and ‘<samp>color pop</samp>’, outputting them as <code>withcolor</code> MetaPost commands. @@ -3368,42 +3269,38 @@ MetaPost commands. </p> <hr> -<a name="BibTeX"></a> -<div class="header"> +<span id="BibTeX"></span><div class="header"> <p> Next: <a href="#WEB" accesskey="n" rel="next">WEB</a>, Previous: <a href="#MetaPost" accesskey="p" rel="prev">MetaPost</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="BibTeX_003a-Bibliographies"></a> -<h2 class="chapter">7 BibTeX: Bibliographies</h2> +<span id="BibTeX_003a-Bibliographies"></span><h2 class="chapter">7 BibTeX: Bibliographies</h2> -<a name="index-bibliographies_002c-creating"></a> -<a name="index-BibTeX"></a> +<span id="index-bibliographies_002c-creating"></span> +<span id="index-BibTeX"></span> <p>BibTeX automates much of the job of typesetting bibliographies, and makes bibliography entries reusable in many different contexts. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#bibtex-invocation" accesskey="1">bibtex invocation</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#bibtex-invocation" accesskey="1">bibtex invocation</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a>:</td><td> </td><td align="left" valign="top">The standard and semi-standard styles. +<tr><td align="left" valign="top">• <a href="#Basic-BibTeX-style-files" accesskey="2">Basic BibTeX style files</a></td><td> </td><td align="left" valign="top">The standard and semi-standard styles. </td></tr> </table> <hr> -<a name="bibtex-invocation"></a> -<div class="header"> +<span id="bibtex-invocation"></span><div class="header"> <p> Next: <a href="#Basic-BibTeX-style-files" accesskey="n" rel="next">Basic BibTeX style files</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="BibTeX-invocation"></a> -<h3 class="section">7.1 BibTeX invocation</h3> +<span id="BibTeX-invocation"></span><h3 class="section">7.1 BibTeX invocation</h3> -<a name="index-bibtex"></a> +<span id="index-bibtex"></span> -<a name="index-_002ebbl-bibliography-files"></a> -<a name="index-_002eaux-cross_002dreference-files"></a> -<a name="index-_002ebib-bibliography-databases"></a> +<span id="index-_002ebbl-bibliography-files"></span> +<span id="index-_002eaux-cross_002dreference-files"></span> +<span id="index-_002ebib-bibliography-databases"></span> <p>BibTeX creates a printable bibliography (<samp>.bbl</samp>) file from references in a <samp>.aux</samp> file, generally written by TeX or LaTeX. The <samp>.bbl</samp> file is then incorporated on a subsequent @@ -3415,23 +3312,23 @@ of the <samp>.bbl</samp> file. Synopsis: <pre class="example">bibtex [<var>option</var>]… <var>auxfile</var>[.aux] </pre></div> -<a name="index-_002eblg-BibTeX-log-file"></a> -<a name="index-log-file_002c-BibTeX"></a> +<span id="index-_002eblg-BibTeX-log-file"></span> +<span id="index-log-file_002c-BibTeX"></span> <p>The output goes to the basename of <var>auxfile</var> extended with <samp>.bbl</samp>; for example, ‘<samp>bibtex /wherever/foo.aux</samp>’ creates <samp>./foo.bbl</samp>. BibTeX also writes a log file to the basename of <var>auxfile</var> extended with ‘<samp>.blg</samp>’. </p> -<a name="index-_005cbibliography"></a> -<a name="index-_005cbibliographystyle"></a> -<a name="index-TEXBIB_002c-search-path-for-bib-files"></a> -<a name="index-BIBINPUTS_002c-search-path-for-bib-files"></a> -<a name="index-BSTINPUTS_002c-search-path-for-bst-files"></a> +<span id="index-_005cbibliography"></span> +<span id="index-_005cbibliographystyle"></span> +<span id="index-TEXBIB_002c-search-path-for-bib-files"></span> +<span id="index-BIBINPUTS_002c-search-path-for-bib-files"></span> +<span id="index-BSTINPUTS_002c-search-path-for-bst-files"></span> <p>The names of the <samp>.bib</samp> and <samp>.bst</samp> files are specified in the <samp>.aux</samp> file as well, via the <samp>\bibliography</samp> and <samp>\bibliographystyle</samp> (La)TeX macros. BibTeX searches for <samp>.bib</samp> files using the <code>BIBINPUTS</code> and <code>TEXBIB</code> paths, -and for <samp>.bst</samp> files using <code>BSTINPUTS</code> (see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file +and for <samp>.bst</samp> files using <code>BSTINPUTS</code> (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). It does no path searching for <samp>.aux</samp> files. </p> @@ -3439,16 +3336,16 @@ formats</a> in <cite>Kpathsea</cite>). It does no path searching for ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-terse</samp>’</dt> -<dd><a name="index-_002dterse"></a> -<a name="index-terse-output"></a> -<a name="index-verbose-BibTeX-output_002c-suppressing"></a> +<dd><span id="index-_002dterse"></span> +<span id="index-terse-output"></span> +<span id="index-verbose-BibTeX-output_002c-suppressing"></span> <p>Suppress the program banner and progress reports normally output. </p> </dd> <dt>‘<samp>-min-crossrefs=<var>n</var></samp>’</dt> -<dd><a name="index-_002dmin_002dcrossrefs_003dn"></a> -<a name="index-cross_002dreferenced-bibliography-items"></a> -<a name="index-bibliography-items_002c-cross_002dreferenced"></a> +<dd><span id="index-_002dmin_002dcrossrefs_003dn"></span> +<span id="index-cross_002dreferenced-bibliography-items"></span> +<span id="index-bibliography-items_002c-cross_002dreferenced"></span> <p>If at least <var>n</var> (2 by default) bibliography entries refer to another entry <var>e</var> via their <code>crossref</code> field, include <var>e</var> in the <tt>.bbl</tt> file, even if it was not explicitly referenced in the <tt>.aux</tt> @@ -3468,31 +3365,31 @@ for <var>e</var> to the <tt>.aux</tt>, and nothing will remove it. <p>See also: </p><dl compact="compact"> <dt><samp>btxdoc.tex</samp></dt> -<dd><a name="index-btxdoc_002etex"></a> +<dd><span id="index-btxdoc_002etex"></span> <p>Basic LaTeXable documentation for general BibTeX users. </p> </dd> <dt><samp>btxhak.tex</samp></dt> -<dd><a name="index-btxhak_002etex"></a> -<a name="index-style-design_002c-for-BibTeX"></a> +<dd><span id="index-btxhak_002etex"></span> +<span id="index-style-design_002c-for-BibTeX"></span> <p>LaTeXable documentation for style designers. </p> </dd> <dt><samp>btxdoc.bib</samp></dt> -<dd><a name="index-btxdoc_002ebib"></a> +<dd><span id="index-btxdoc_002ebib"></span> <p>BibTeX database file for the two above documents. </p> </dd> <dt><samp>xampl.bib</samp></dt> -<dd><a name="index-xampl_002ebib"></a> +<dd><span id="index-xampl_002ebib"></span> <p>Example database file with all the standard entry types. </p> </dd> <dt><samp><a href="ftp://ftp.math.utah.edu/pub/tex/bib/">ftp://ftp.math.utah.edu/pub/tex/bib/</a></samp></dt> -<dd><a name="index-ftp_002emath_002eutah_002eedu"></a> -<a name="index-BibTeX-collection"></a> -<a name="index-TUGboat-bibliography"></a> -<a name="index-TeX_002c-bibliographies-for"></a> +<dd><span id="index-ftp_002emath_002eutah_002eedu"></span> +<span id="index-BibTeX-collection"></span> +<span id="index-TUGboat-bibliography"></span> +<span id="index-TeX_002c-bibliographies-for"></span> <p>A very large <samp>.bib</samp> and <samp>.bst</samp> collection, including references for all the standard TeX books and a complete bibliography for TUGboat. @@ -3501,46 +3398,44 @@ for TUGboat. <hr> -<a name="Basic-BibTeX-style-files"></a> -<div class="header"> +<span id="Basic-BibTeX-style-files"></span><div class="header"> <p> Previous: <a href="#bibtex-invocation" accesskey="p" rel="prev">bibtex invocation</a>, Up: <a href="#BibTeX" accesskey="u" rel="up">BibTeX</a> [<a 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-BibTeX-style-files-1"></a> -<h3 class="section">7.2 Basic BibTeX style files</h3> +<span id="Basic-BibTeX-style-files-1"></span><h3 class="section">7.2 Basic BibTeX style files</h3> -<a name="index-basic-BibTeX-style-files"></a> -<a name="index-BibTeX-style-files"></a> +<span id="index-basic-BibTeX-style-files"></span> +<span id="index-BibTeX-style-files"></span> <p>Here are descriptions of the four standard and four semi-standard basic BibTeX styles. <samp><var>CTAN:</var>/biblio/bibtex</samp> contains these and -many more (for CTAN info, see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). +many more (for CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). </p> <dl compact="compact"> <dt><code>plain</code></dt> -<dd><a name="index-plain_002ebst"></a> +<dd><span id="index-plain_002ebst"></span> <p>Sorts entries alphabetically, with numeric labels. Generally formatted according to van Leunen’s <cite>A Handbook for Scholars</cite>. The other style files listed here are based on <code>plain</code>. </p> </dd> <dt><code>abbrv</code></dt> -<dd><a name="index-abbrv_002ebst"></a> +<dd><span id="index-abbrv_002ebst"></span> <p>First names, month names, and journal names are abbreviated. </p> </dd> <dt><code>acm</code></dt> -<dd><a name="index-acm_002ebst"></a> +<dd><span id="index-acm_002ebst"></span> <p>Names are printed in small caps. </p> </dd> <dt><code>alpha</code></dt> -<dd><a name="index-alpha_002ebst"></a> +<dd><span id="index-alpha_002ebst"></span> <p>Alphanumeric labels, e.g., ‘<samp>Knu66</samp>’. </p> </dd> <dt><code>apalike</code></dt> -<dd><a name="index-apalike_002ebst"></a> +<dd><span id="index-apalike_002ebst"></span> <p>No labels at all; instead, the year appears in parentheses after the author. Use this in conjunction with <samp>apalike.tex</samp> (plain TeX) or <samp>apalike.sty</samp> (LaTeX), which also changes the citations in the @@ -3548,19 +3443,19 @@ text to be ‘<samp>(<var>author</var>, <var>year</var>)</samp>’. </p> </dd> <dt><code>ieeetr</code></dt> -<dd><a name="index-ieeetr_002ebst"></a> +<dd><span id="index-ieeetr_002ebst"></span> <p>Numeric labels, entries in citation order, <small>IEEE</small> abbreviations, article titles in quotes. </p> </dd> <dt><code>siam</code></dt> -<dd><a name="index-siam_002ebst"></a> +<dd><span id="index-siam_002ebst"></span> <p>Numeric labels, alphabetic order, <cite>Math. Reviews</cite> abbreviations, names in small caps. </p> </dd> <dt><code>unsrt</code></dt> -<dd><a name="index-unsrt_002ebst"></a> +<dd><span id="index-unsrt_002ebst"></span> <p>Lists entries in citation order, i.e., unsorted. </p> </dd> @@ -3572,16 +3467,14 @@ abbreviations, names in small caps. <hr> -<a name="WEB"></a> -<div class="header"> +<span id="WEB"></span><div class="header"> <p> Next: <a href="#DVI-utilities" accesskey="n" rel="next">DVI utilities</a>, Previous: <a href="#BibTeX" accesskey="p" rel="prev">BibTeX</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="WEB_003a-Literate-programming"></a> -<h2 class="chapter">8 WEB: Literate programming</h2> +<span id="WEB_003a-Literate-programming"></span><h2 class="chapter">8 WEB: Literate programming</h2> -<a name="index-WEB"></a> -<a name="index-literate-programming"></a> +<span id="index-WEB"></span> +<span id="index-literate-programming"></span> <p><em>WEB</em> languages allow you to write a single source file that can produce both a compilable program and a well-formatted document @@ -3590,13 +3483,13 @@ Writing in this kind of dual-purpose language is called <em>literate programming</em>. (The Usenet newsgroup <samp>comp.programming.literate</samp> is devoted to this subject.) </p> -<a name="index-webman_002etex"></a> -<a name="index-Spiderweb"></a> -<a name="index-Cweb"></a> -<a name="index-CWEB"></a> -<a name="index-Awk_002c-WEB-for"></a> -<a name="index-Ada_002c-WEB-for"></a> -<a name="index-Troff_002c-WEB-for"></a> +<span id="index-webman_002etex"></span> +<span id="index-Spiderweb"></span> +<span id="index-Cweb"></span> +<span id="index-CWEB"></span> +<span id="index-Awk_002c-WEB-for"></span> +<span id="index-Ada_002c-WEB-for"></span> +<span id="index-Troff_002c-WEB-for"></span> <p>WEB-like languages have been implemented with many pairs of base languages: Cweb provides C and Troff (see <a href="#References">References</a>); CWEB provides C and TeX (<samp><var>CTAN:</var>/web/c_cpp/cweb</samp>); Spiderweb provides C, @@ -3611,27 +3504,25 @@ which is included in the <a href="ftp://ftp.tug.org/tex/lib.tar.gz">ftp://ftp.tu (and available in many other places, of course). </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#tangle-invocation" accesskey="1">tangle invocation</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#tangle-invocation" accesskey="1">tangle invocation</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#weave-invocation" accesskey="2">weave invocation</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#weave-invocation" accesskey="2">weave invocation</a></td><td> </td><td align="left" valign="top"> </td></tr> -<tr><td align="left" valign="top">• <a href="#pooltype-invocation" accesskey="3">pooltype invocation</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#pooltype-invocation" accesskey="3">pooltype invocation</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="tangle-invocation"></a> -<div class="header"> +<span id="tangle-invocation"></span><div class="header"> <p> Next: <a href="#weave-invocation" accesskey="n" rel="next">weave invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Tangle_003a-Translate-WEB-to-Pascal"></a> -<h3 class="section">8.1 Tangle: Translate WEB to Pascal</h3> +<span id="Tangle_003a-Translate-WEB-to-Pascal"></span><h3 class="section">8.1 Tangle: Translate WEB to Pascal</h3> -<a name="index-tangle"></a> -<a name="index-Pascal_002c-creating-from-WEB"></a> -<a name="index-WEB-programs_002c-compiling"></a> +<span id="index-tangle"></span> +<span id="index-Pascal_002c-creating-from-WEB"></span> +<span id="index-WEB-programs_002c-compiling"></span> <p>Tangle creates a compilable Pascal program from a WEB source file (see <a href="#WEB">WEB</a>). Synopsis: @@ -3640,14 +3531,14 @@ Next: <a href="#weave-invocation" accesskey="n" rel="next">weave invocation</a>, <pre class="example">tangle [<var>option</var>]… <var>webfile</var>[.web] [<var>changefile</var>[.ch]] </pre></div> -<a name="index-change-files_002c-and-Tangle"></a> +<span id="index-change-files_002c-and-Tangle"></span> <p>The Pascal output is written to the basename of <var>webfile</var> extended with ‘<samp>.p</samp>’; for example, ‘<samp>tangle /wherever/foo.web</samp>’ creates <samp>./foo.p</samp>. Tangle applies <var>changefile</var> to <var>webfile</var> before writing the output; by default, there is no change file. </p> -<a name="index-pool-file_002c-writing"></a> -<a name="index-string-pool_002c-writing"></a> +<span id="index-pool-file_002c-writing"></span> +<span id="index-string-pool_002c-writing"></span> <p>If the program makes use of the WEB string facility, Tangle writes the string pool to the basename of <var>webfile</var> extended with ‘<samp>.pool</samp>’. </p> @@ -3660,8 +3551,8 @@ semicolons when this can be done conveniently. </p> <dl compact="compact"> <dt>‘<samp>-length=<var>number</var></samp>’</dt> -<dd><a name="index-_002dlength_003dnumber"></a> -<a name="index-identifier-length"></a> +<dd><span id="index-_002dlength_003dnumber"></span> +<span id="index-identifier-length"></span> <p>The number of characters that are considered significant in an identifier. Whether underline characters are counted depends on the ‘<samp>-underline</samp>’ option. The default value is 32, the original tangle @@ -3671,10 +3562,10 @@ used 7, but this proved too restrictive for use by Web2c. <dt>‘<samp>-lowercase</samp>’</dt> <dt>‘<samp>-mixedcase</samp>’</dt> <dt>‘<samp>-uppercase</samp>’</dt> -<dd><a name="index-_002dlowercase"></a> -<a name="index-_002dmixedcase"></a> -<a name="index-_002duppercase"></a> -<a name="index-identifier-case"></a> +<dd><span id="index-_002dlowercase"></span> +<span id="index-_002dmixedcase"></span> +<span id="index-_002duppercase"></span> +<span id="index-identifier-case"></span> <p>These options specify the case of identifiers in the output of tangle. If ‘<samp>-uppercase</samp>’ (‘<samp>-lowercase</samp>’) is specified, tangle will convert all identfiers to uppercase (lowercase). The default is @@ -3682,17 +3573,17 @@ convert all identfiers to uppercase (lowercase). The default is </p> </dd> <dt>‘<samp>-underline</samp>’</dt> -<dd><a name="index-_002dunderline"></a> -<a name="index-identifiers-with-underlines"></a> +<dd><span id="index-_002dunderline"></span> +<span id="index-identifiers-with-underlines"></span> <p>When this option is given, tangle does not strip underline characters from identifiers. </p> </dd> <dt>‘<samp>-loose</samp>’</dt> <dt>‘<samp>-strict</samp>’</dt> -<dd><a name="index-_002dloose"></a> -<a name="index-_002dstrict"></a> -<a name="index-identifier-collisions"></a> +<dd><span id="index-_002dloose"></span> +<span id="index-_002dstrict"></span> +<span id="index-identifier-collisions"></span> <p>These options specify how strict tangle must be when checking identifiers for equality. The default is ‘<samp>-loose</samp>’, which means that tangle will follow the rules set by the case-smashing and underline @@ -3704,18 +3595,16 @@ whether they collide. </dl> <hr> -<a name="weave-invocation"></a> -<div class="header"> +<span id="weave-invocation"></span><div class="header"> <p> Next: <a href="#pooltype-invocation" accesskey="n" rel="next">pooltype invocation</a>, Previous: <a href="#tangle-invocation" accesskey="p" rel="prev">tangle invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Weave_003a-Translate-WEB-to-TeX"></a> -<h3 class="section">8.2 Weave: Translate WEB to TeX</h3> +<span id="Weave_003a-Translate-WEB-to-TeX"></span><h3 class="section">8.2 Weave: Translate WEB to TeX</h3> -<a name="index-weave"></a> -<a name="index-TeX_002c-creating-from-WEB"></a> -<a name="index-WEB-programs_002c-typesetting"></a> -<a name="index-prettyprinting-WEB-programs"></a> +<span id="index-weave"></span> +<span id="index-TeX_002c-creating-from-WEB"></span> +<span id="index-WEB-programs_002c-typesetting"></span> +<span id="index-prettyprinting-WEB-programs"></span> <p>Weave creates a TeX document from a WEB source file (see <a href="#WEB">WEB</a>), assuming various macros defined in <samp>webmac.tex</samp>. It takes care of @@ -3727,7 +3616,7 @@ cross-reference information. Synopsis: <pre class="example">weave [<var>option</var>]… <var>webfile</var>[.web] [<var>changefile</var>[.ch]] </pre></div> -<a name="index-change-files_002c-and-Weave"></a> +<span id="index-change-files_002c-and-Weave"></span> <p>The output is to the basename of <var>webfile</var> extended with ‘<samp>.tex</samp>’; for example, ‘<samp>weave /wherever/foo.web</samp>’ creates <samp>./foo.tex</samp>. Weave applies <var>changefile</var> to <var>webfile</var> @@ -3737,10 +3626,10 @@ before writing the output; by default, there is no change file. ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-x</samp>’</dt> -<dd><a name="index-_002dx"></a> -<a name="index-cross_002dreferences_002c-omitting"></a> -<a name="index-CONTENTS_002etex"></a> -<a name="index-webmac_002etex"></a> +<dd><span id="index-_002dx"></span> +<span id="index-cross_002dreferences_002c-omitting"></span> +<span id="index-CONTENTS_002etex"></span> +<span id="index-webmac_002etex"></span> <p>Omit the cross-reference information: the index, the list of WEB module names, and the table of contents (an empty <samp>CONTENTS.tex</samp> file will still be written when the Weave output file is processed by TeX using @@ -3755,18 +3644,16 @@ first change in the change file). </p> <hr> -<a name="pooltype-invocation"></a> -<div class="header"> +<span id="pooltype-invocation"></span><div class="header"> <p> Previous: <a href="#weave-invocation" accesskey="p" rel="prev">weave invocation</a>, Up: <a href="#WEB" accesskey="u" rel="up">WEB</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Pooltype_003a-Display-WEB-pool-files"></a> -<h3 class="section">8.3 Pooltype: Display WEB pool files</h3> +<span id="Pooltype_003a-Display-WEB-pool-files"></span><h3 class="section">8.3 Pooltype: Display WEB pool files</h3> -<a name="index-pooltype"></a> -<a name="index-type-programs_002c-pool"></a> -<a name="index-string-numbers_002c-displaying"></a> -<a name="index-WEB-pool-files_002c-displaying"></a> +<span id="index-pooltype"></span> +<span id="index-type-programs_002c-pool"></span> +<span id="index-string-numbers_002c-displaying"></span> +<span id="index-WEB-pool-files_002c-displaying"></span> <p>Pooltype shows the so-called <em>string number</em> of each string in a WEB pool file (see <a href="#WEB">WEB</a>), as output by Tangle (see <a href="#tangle-invocation">tangle invocation</a>), including the first 256 strings corresponding to the @@ -3794,8 +3681,8 @@ output. (23617 characters in all.) </pre></div> -<a name="index-representation-of-strings"></a> -<a name="index-string-representation"></a> +<span id="index-representation-of-strings"></span> +<span id="index-string-representation"></span> <p>In Metafont and MetaPost, the first 256 characters are actually represented as single bytes (i.e., themselves), not in the ‘<samp>^^</samp>’ notation. Consider Pooltype as showing the results after conversion for @@ -3803,26 +3690,24 @@ output. </p> <hr> -<a name="DVI-utilities"></a> -<div class="header"> +<span id="DVI-utilities"></span><div class="header"> <p> Next: <a href="#Font-utilities" accesskey="n" rel="next">Font utilities</a>, Previous: <a href="#WEB" accesskey="p" rel="prev">WEB</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="DVI-utilities-1"></a> -<h2 class="chapter">9 DVI utilities</h2> +<span id="DVI-utilities-1"></span><h2 class="chapter">9 DVI utilities</h2> -<a name="index-DVI-utilities"></a> +<span id="index-DVI-utilities"></span> <p>TeX outputs a file in <em>DVI</em> (DeVice Independent) format as a compact representation of the original document. DVI files can be translated to meet the requirements of a real physical device, such as -PostScript printers (see <a href="http://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>), PCL +PostScript printers (see <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>), PCL printers (see dvilj(1)), and X displays (see xdvi(1)). In fact, DVI translators are available for virtually all common devices: see -<samp><var>CTAN:</var>/dviware</samp> (for CTAN info, see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). +<samp><var>CTAN:</var>/dviware</samp> (for CTAN info, see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). </p> -<a name="index-dvitype_002eweb"></a> -<a name="index-DVI-format-definition"></a> +<span id="index-dvitype_002eweb"></span> +<span id="index-DVI-format-definition"></span> <p>For the precise definition of the DVI file format, see (for example) the source file <samp>web2c/dvitype.web</samp>. </p> @@ -3830,26 +3715,24 @@ source file <samp>web2c/dvitype.web</samp>. drivers; they perform generic utility functions. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#dvicopy-invocation" accesskey="1">dvicopy invocation</a>:</td><td> </td><td align="left" valign="top">Expand virtual fonts. +<tr><td align="left" valign="top">• <a href="#dvicopy-invocation" accesskey="1">dvicopy invocation</a></td><td> </td><td align="left" valign="top">Expand virtual fonts. </td></tr> -<tr><td align="left" valign="top">• <a href="#dvitype-invocation" accesskey="2">dvitype invocation</a>:</td><td> </td><td align="left" valign="top">DVI to human-readable text. +<tr><td align="left" valign="top">• <a href="#dvitype-invocation" accesskey="2">dvitype invocation</a></td><td> </td><td align="left" valign="top">DVI to human-readable text. </td></tr> </table> <hr> -<a name="dvicopy-invocation"></a> -<div class="header"> +<span id="dvicopy-invocation"></span><div class="header"> <p> Next: <a href="#dvitype-invocation" accesskey="n" rel="next">dvitype invocation</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="DVIcopy_003a-Canonicalize-virtual-font-references"></a> -<h3 class="section">9.1 DVIcopy: Canonicalize virtual font references</h3> +<span id="DVIcopy_003a-Canonicalize-virtual-font-references"></span><h3 class="section">9.1 DVIcopy: Canonicalize virtual font references</h3> -<a name="index-dvicopy"></a> -<a name="index-virtual-fonts_002c-expanding"></a> +<span id="index-dvicopy"></span> +<span id="index-virtual-fonts_002c-expanding"></span> <p>DVIcopy reads a DVI file, expands any references to virtual fonts -(see <a href="http://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) to base fonts, and writes the +(see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) to base fonts, and writes the resulting DVI file. Thus you can use virtual fonts even if your DVI processor does not support them, by passing the documents through DVIcopy first. Synopsis: @@ -3865,24 +3748,24 @@ standard output if <var>outdvi</var> is not specified. ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-magnification=<var>integer</var></samp>’</dt> -<dd><a name="index-_002dmagnification_003dinteger"></a> -<a name="index-magnification"></a> -<a name="index-_005cmag"></a> +<dd><span id="index-_002dmagnification_003dinteger"></span> +<span id="index-magnification"></span> +<span id="index-_005cmag"></span> <p>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000 specifies no magnification. This is equivalent to setting TeX’s <code>\mag</code> parameter. </p> </dd> <dt>‘<samp>-max-pages=<var>n</var></samp>’</dt> -<dd><a name="index-_002dmax_002dpages_003dn"></a> +<dd><span id="index-_002dmax_002dpages_003dn"></span> <p>Process <var>n</var> pages; default is one million. </p> </dd> <dt>‘<samp>-page-start=<var>page-spec</var></samp>’</dt> -<dd><a name="index-_002dpage_002dstart_003dpage_002dspec"></a> -<a name="index-starting-page"></a> -<a name="index-page_002c-starting"></a> -<a name="index-_005ccountn"></a> +<dd><span id="index-_002dpage_002dstart_003dpage_002dspec"></span> +<span id="index-starting-page"></span> +<span id="index-page_002c-starting"></span> +<span id="index-_005ccountn"></span> <p>Start at the first page matching <var>page-spec</var>, which is one or more (signed) integers separated by periods, corresponding to TeX’s <code>\count0…9</code> parameters at <code>\shipout</code> time; ‘<samp>*</samp>’ @@ -3892,20 +3775,18 @@ matches anything. Examples: ‘<samp>3</samp>’, ‘<samp>1.*.-4</ <hr> -<a name="dvitype-invocation"></a> -<div class="header"> +<span id="dvitype-invocation"></span><div class="header"> <p> Previous: <a href="#dvicopy-invocation" accesskey="p" rel="prev">dvicopy invocation</a>, Up: <a href="#DVI-utilities" accesskey="u" rel="up">DVI utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="DVItype_003a-Plain-text-transliteration-of-DVI-files"></a> -<h3 class="section">9.2 DVItype: Plain text transliteration of DVI files</h3> +<span id="DVItype_003a-Plain-text-transliteration-of-DVI-files"></span><h3 class="section">9.2 DVItype: Plain text transliteration of DVI files</h3> -<a name="index-dvitype-DVI-validation"></a> -<a name="index-conversion_002c-DVI-to-plain-text"></a> -<a name="index-plain-text_002c-converting-DVI-to"></a> -<a name="index-human_002dreadable-text_002c-converting-DVI-to"></a> -<a name="index-type-programs_002c-DVI"></a> -<a name="index-validation_002c-of-DVI-files"></a> +<span id="index-dvitype-DVI-validation"></span> +<span id="index-conversion_002c-DVI-to-plain-text"></span> +<span id="index-plain-text_002c-converting-DVI-to"></span> +<span id="index-human_002dreadable-text_002c-converting-DVI-to"></span> +<span id="index-type-programs_002c-DVI"></span> +<span id="index-validation_002c-of-DVI-files"></span> <p>DVItype translates a DeVice Independent (DVI) file (as output by TeX, for example) to a plain text file that humans can read. It also serves @@ -3918,7 +3799,7 @@ correct. Synopsis: <p>DVItype does not read any bitmap files, but it does read TFM files for fonts referenced in <var>dvifile</var>. The usual places are searched -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. </p> @@ -3928,27 +3809,27 @@ relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-dpi=<var>real</var></samp>’</dt> -<dd><a name="index-_002ddpi_003dreal"></a> +<dd><span id="index-_002ddpi_003dreal"></span> <p>Do pixel movement calculations at <var>real</var> pixels per inch; default 300.0. </p> </dd> <dt>‘<samp>-magnification=<var>integer</var></samp>’</dt> -<dd><a name="index-_002dmagnification_003dinteger-1"></a> -<a name="index-magnification-1"></a> -<a name="index-_005cmag-1"></a> +<dd><span id="index-_002dmagnification_003dinteger-1"></span> +<span id="index-magnification-1"></span> +<span id="index-_005cmag-1"></span> <p>Override existing magnification in <var>indvi</var> with <var>integer</var>; 1000 specifies no magnification. This is equivalent to setting TeX’s <code>\mag</code> parameter. </p> </dd> <dt>‘<samp>-max-pages=<var>n</var></samp>’</dt> -<dd><a name="index-_002dmax_002dpages_003dn-1"></a> +<dd><span id="index-_002dmax_002dpages_003dn-1"></span> <p>Process <var>n</var> pages; default is one million. </p> </dd> <dt>‘<samp>-output-level=<var>n</var></samp>’</dt> -<dd><a name="index-_002doutput_002dlevel_003dn"></a> +<dd><span id="index-_002doutput_002dlevel_003dn"></span> <p>Verbosity level of output, from 0 to 4 (default 4): </p><ul> <li> 0: Global document information only. @@ -3961,10 +3842,10 @@ in the file, reading the DVI postamble first. </dd> <dt>‘<samp>-page-start=<var>page-spec</var></samp>’</dt> -<dd><a name="index-_002dpage_002dstart_003dpage_002dspec-1"></a> -<a name="index-starting-page-1"></a> -<a name="index-page_002c-starting-1"></a> -<a name="index-_005ccountn-1"></a> +<dd><span id="index-_002dpage_002dstart_003dpage_002dspec-1"></span> +<span id="index-starting-page-1"></span> +<span id="index-page_002c-starting-1"></span> +<span id="index-_005ccountn-1"></span> <p>Start at the first page matching <var>page-spec</var>, which is one or more (signed) integers separated by periods, corresponding to TeX’s <code>\count0…9</code> parameters at <code>\shipout</code> time; ‘<samp>*</samp>’ @@ -3972,10 +3853,10 @@ matches anything. Examples: ‘<samp>1</samp>’, ‘<samp>5.*.-9</ </p> </dd> <dt>‘<samp>-show-opcodes</samp>’</dt> -<dd><a name="index-_002dshow_002dopcodes"></a> -<a name="index-opcodes_002c-showing-DVI"></a> -<a name="index-DVI-opcodes_002c-showing"></a> -<a name="index-debugging-DVI-utilities"></a> +<dd><span id="index-_002dshow_002dopcodes"></span> +<span id="index-opcodes_002c-showing-DVI"></span> +<span id="index-DVI-opcodes_002c-showing"></span> +<span id="index-debugging-DVI-utilities"></span> <p>Show numeric opcode values (in decimal) for DVI commands, in braces after the command name. This can help in debugging DVI utilities. We use decimal because in the DVI format documentation (in @@ -3984,21 +3865,19 @@ use decimal because in the DVI format documentation (in </dl> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#dvitype-output-example" accesskey="1">dvitype output example</a>:</td><td> </td><td align="left" valign="top"> +<tr><td align="left" valign="top">• <a href="#dvitype-output-example" accesskey="1">dvitype output example</a></td><td> </td><td align="left" valign="top"> </td></tr> </table> <hr> -<a name="dvitype-output-example"></a> -<div class="header"> +<span id="dvitype-output-example"></span><div class="header"> <p> Up: <a href="#dvitype-invocation" accesskey="u" rel="up">dvitype invocation</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="DVItype-output-example"></a> -<h4 class="subsection">9.2.1 DVItype output example</h4> +<span id="DVItype-output-example"></span><h4 class="subsection">9.2.1 DVItype output example</h4> -<a name="index-dvitype-output-example"></a> +<span id="index-dvitype-output-example"></span> <p>As an example of the output from DVItype (see section above), here is its (abridged) translation of the <samp>story.dvi</samp> resulting from running the example in <cite>The TeXbook</cite>, with @@ -4079,66 +3958,62 @@ STORY]</samp>’ and the ‘<samp>[ 1]</samp>’. <hr> -<a name="Font-utilities"></a> -<div class="header"> +<span id="Font-utilities"></span><div class="header"> <p> Next: <a href="#Legalisms" accesskey="n" rel="next">Legalisms</a>, Previous: <a href="#DVI-utilities" accesskey="p" rel="prev">DVI utilities</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="Font-utilities-1"></a> -<h2 class="chapter">10 Font utilities</h2> +<span id="Font-utilities-1"></span><h2 class="chapter">10 Font utilities</h2> -<a name="index-font-utilities"></a> +<span id="index-font-utilities"></span> <p>The Web2c programs described here convert between various TeX-related font formats; the first section below briefly describes the formats. GFtoPK is the only one that is routinely used, as Metafont outputs GF format, but it’s most efficient for device drivers to use PK. </p> -<a name="index-pktype_002eweb"></a> -<a name="index-gftype_002eweb"></a> -<a name="index-PK-format-definition"></a> -<a name="index-GF-format-definition"></a> +<span id="index-pktype_002eweb"></span> +<span id="index-gftype_002eweb"></span> +<span id="index-PK-format-definition"></span> +<span id="index-GF-format-definition"></span> <p>The precise definitions of the PK, GF, TFM, PL, VF, and VPL formats mentioned below are in the source files that read them; <samp>pktype.web</samp>, <samp>gftype.web</samp>, <samp>tftopl.web</samp>, etc. </p> <table class="menu" border="0" cellspacing="0"> -<tr><td align="left" valign="top">• <a href="#Font-file-formats" accesskey="1">Font file formats</a>:</td><td> </td><td align="left" valign="top">Explanations of GF, PK, TFM, VF, ... +<tr><td align="left" valign="top">• <a href="#Font-file-formats" accesskey="1">Font file formats</a></td><td> </td><td align="left" valign="top">Explanations of GF, PK, TFM, VF, ... </td></tr> -<tr><td align="left" valign="top">• <a href="#gftopk-invocation" accesskey="2">gftopk invocation</a>:</td><td> </td><td align="left" valign="top">GF -> PK (compact) +<tr><td align="left" valign="top">• <a href="#gftopk-invocation" accesskey="2">gftopk invocation</a></td><td> </td><td align="left" valign="top">GF -> PK (compact) </td></tr> -<tr><td align="left" valign="top">• <a href="#pktogf-invocation" accesskey="3">pktogf invocation</a>:</td><td> </td><td align="left" valign="top">PK -> GF (expand). +<tr><td align="left" valign="top">• <a href="#pktogf-invocation" accesskey="3">pktogf invocation</a></td><td> </td><td align="left" valign="top">PK -> GF (expand). </td></tr> -<tr><td align="left" valign="top">• <a href="#pktype-invocation" accesskey="4">pktype invocation</a>:</td><td> </td><td align="left" valign="top">PK -> human-readable text. +<tr><td align="left" valign="top">• <a href="#pktype-invocation" accesskey="4">pktype invocation</a></td><td> </td><td align="left" valign="top">PK -> human-readable text. </td></tr> -<tr><td align="left" valign="top">• <a href="#gftype-invocation" accesskey="5">gftype invocation</a>:</td><td> </td><td align="left" valign="top">GF -> human-readable text. +<tr><td align="left" valign="top">• <a href="#gftype-invocation" accesskey="5">gftype invocation</a></td><td> </td><td align="left" valign="top">GF -> human-readable text. </td></tr> -<tr><td align="left" valign="top">• <a href="#tftopl-invocation" accesskey="6">tftopl invocation</a>:</td><td> </td><td align="left" valign="top">TFM -> PL (for editing TFM). +<tr><td align="left" valign="top">• <a href="#tftopl-invocation" accesskey="6">tftopl invocation</a></td><td> </td><td align="left" valign="top">TFM -> PL (for editing TFM). </td></tr> -<tr><td align="left" valign="top">• <a href="#pltotf-invocation" accesskey="7">pltotf invocation</a>:</td><td> </td><td align="left" valign="top">PL -> TFM (make editing results usable). +<tr><td align="left" valign="top">• <a href="#pltotf-invocation" accesskey="7">pltotf invocation</a></td><td> </td><td align="left" valign="top">PL -> TFM (make editing results usable). </td></tr> -<tr><td align="left" valign="top">• <a href="#vftovp-invocation" accesskey="8">vftovp invocation</a>:</td><td> </td><td align="left" valign="top">VF -> VPL (tftopl for virtual fonts). +<tr><td align="left" valign="top">• <a href="#vftovp-invocation" accesskey="8">vftovp invocation</a></td><td> </td><td align="left" valign="top">VF -> VPL (tftopl for virtual fonts). </td></tr> -<tr><td align="left" valign="top">• <a href="#vptovf-invocation" accesskey="9">vptovf invocation</a>:</td><td> </td><td align="left" valign="top">VPL -> VF (pltotf for virtual fonts). +<tr><td align="left" valign="top">• <a href="#vptovf-invocation" accesskey="9">vptovf invocation</a></td><td> </td><td align="left" valign="top">VPL -> VF (pltotf for virtual fonts). </td></tr> -<tr><td align="left" valign="top">• <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a>:</td><td> </td><td align="left" valign="top">Type 1, BDF, editors, etc. +<tr><td align="left" valign="top">• <a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td><td> </td><td align="left" valign="top">Type 1, BDF, editors, etc. </td></tr> </table> <hr> -<a name="Font-file-formats"></a> -<div class="header"> +<span id="Font-file-formats"></span><div class="header"> <p> Next: <a href="#gftopk-invocation" accesskey="n" rel="next">gftopk invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a 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-file-formats-1"></a> -<h3 class="section">10.1 Font file formats</h3> +<span id="Font-file-formats-1"></span><h3 class="section">10.1 Font file formats</h3> -<a name="index-font-file-formats"></a> -<a name="index-file-formats-for-fonts"></a> +<span id="index-font-file-formats"></span> +<span id="index-file-formats-for-fonts"></span> -<p>(For another perspective on this, see <a href="http://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite>Dvips</cite>). +<p>(For another perspective on this, see <a href="https://tug.org/texinfohtml/dvips.html#Font-concepts">Font concepts</a> in <cite>Dvips</cite>). </p> <p>Font files come in several varieties, with suffixes like: </p><div class="example"> @@ -4146,7 +4021,7 @@ Next: <a href="#gftopk-invocation" accesskey="n" rel="next">gftopk invocation</a </pre></div> <p>Each represents a file format. </p> -<a name="index-TFM-files_002c-explained"></a> +<span id="index-TFM-files_002c-explained"></span> <p>A TFM (TeX font metric) file is a compact binary file that contains information about each character in a font, about combinations of characters within that font, and about the font as a whole. The font @@ -4156,10 +4031,10 @@ described below, TFM font files contain no information about the shapes of characters. They describe rectangular areas and combinations thereof, but not what will eventually be printed in those areas. </p> -<a name="index-scaling-of-fonts"></a> -<a name="index-optical-font-scaling"></a> -<a name="index-geometric-font-scaling"></a> -<a name="index-PostScript_002c-and-font-scaling"></a> +<span id="index-scaling-of-fonts"></span> +<span id="index-optical-font-scaling"></span> +<span id="index-geometric-font-scaling"></span> +<span id="index-PostScript_002c-and-font-scaling"></span> <p>Since TeX does scaling calculations, one TFM file serves for all magnifications of a given typeface. On the other hand, the best printed results are obtained when magnified (or reduced fonts) are not produced @@ -4168,7 +4043,7 @@ with each size a separate design (as done with Computer Modern and the EC fonts, for example); then a separate TFM file is needed for each size. </p> -<a name="index-DVI-files_002c-explained"></a> +<span id="index-DVI-files_002c-explained"></span> <p>At any rate, TeX produces a DVI (DeVice Independent) file from your source document. In order to print DVI files on real devices, you need font files defining digitized character shapes and other data. Then @@ -4180,9 +4055,9 @@ font was produced, and the ‘<samp>pk</samp>’ or ‘<samp>gf</sam indicates the font format. Outline fonts in PostScript Type 1 format have suffixes such as ‘<samp>.pfa</samp>’ or ‘<samp>.pfb</samp>’. </p> -<a name="index-PXL-files_002c-explained"></a> -<a name="index-PK-files_002c-explained"></a> -<a name="index-GF-files_002c-explained"></a> +<span id="index-PXL-files_002c-explained"></span> +<span id="index-PK-files_002c-explained"></span> +<span id="index-GF-files_002c-explained"></span> <p>Fonts in pk (packed) format are in the tightly packed raster format that is pretty much the standard today. They take up less space than fonts in the gf (generic font) format that Metafont generates, and far less @@ -4190,7 +4065,7 @@ space than fonts in pxl format. Fonts in pxl format take up gross amounts of disk space and permit only 128 characters. They are obsolete. </p> -<a name="index-PL-files_002c-explained"></a> +<span id="index-PL-files_002c-explained"></span> <p>Font files with the ‘<samp>.pl</samp>’ (property list) suffix are the plain text (human-readable) analog of the binary ‘<samp>.tfm</samp>’ files. The TFtoPL and PLtoTF programs convert between the two formats @@ -4201,33 +4076,31 @@ These are the files used by Metafont to generate rastered fonts for specific typefaces at specific magnifications for the specific resolution and type of mapping used by your device. </p> -<a name="index-virtual_002dfonts_002eknuth"></a> -<a name="index-virtualfonts_002etxt"></a> +<span id="index-virtual_002dfonts_002eknuth"></span> +<span id="index-virtualfonts_002etxt"></span> <p>The suffix ‘<samp>.vf</samp>’ identifies “virtual font” files, for which ‘<samp>.vpl</samp>’ is the human-readable analog. See See <a href="#vftovp-invocation">vftovp invocation</a>, and <a href="#vptovf-invocation">vptovf invocation</a>. For further discussion of virtual fonts, see <samp><var>CTAN:</var>/doc/virtual-fonts.knuth</samp>, -<samp><var>CTAN:</var>/help/virtualfonts.txt</samp>, and <a href="http://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>. +<samp><var>CTAN:</var>/help/virtualfonts.txt</samp>, and <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>. </p> -<a name="index-MacKay_002c-Pierre"></a> -<a name="index-Tachikawa_002c-Elizabeth"></a> +<span id="index-MacKay_002c-Pierre"></span> +<span id="index-Tachikawa_002c-Elizabeth"></span> <p>(This section is based on documentation in the original Unix TeX distribution by Pierre MacKay and Elizabeth Tachikawa.) </p> <hr> -<a name="gftopk-invocation"></a> -<div class="header"> +<span id="gftopk-invocation"></span><div class="header"> <p> Next: <a href="#pktogf-invocation" accesskey="n" rel="next">pktogf invocation</a>, Previous: <a href="#Font-file-formats" accesskey="p" rel="prev">Font file formats</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="GFtoPK_003a-Generic-to-packed-font-conversion"></a> -<h3 class="section">10.2 GFtoPK: Generic to packed font conversion</h3> +<span id="GFtoPK_003a-Generic-to-packed-font-conversion"></span><h3 class="section">10.2 GFtoPK: Generic to packed font conversion</h3> -<a name="index-gftopk"></a> -<a name="index-conversion_002c-GF-to-PK"></a> -<a name="index-PK_002c-converting-GF-to"></a> -<a name="index-GF_002c-converting-to-PK"></a> +<span id="index-gftopk"></span> +<span id="index-conversion_002c-GF-to-PK"></span> +<span id="index-PK_002c-converting-GF-to"></span> +<span id="index-GF_002c-converting-to-PK"></span> <p>GFtoPK converts a generic font (GF) file output by, for example, Metafont (see <a href="#mf-invocation">mf invocation</a>) to a packed font (PK) file. PK files @@ -4240,7 +4113,7 @@ Synopsis: <pre class="example">gftopk [<var>option</var>]… <var>gfname</var>.<var>dpi</var>[gf] [<var>pkfile</var>] </pre></div> -<p>The font <var>gfname</var> is searched for in the usual places (see <a href="http://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4258,18 +4131,16 @@ of ‘<samp><var>gfname</var>.<var>dpi</var>pk</samp>’, e.g., ‘< </p> <hr> -<a name="pktogf-invocation"></a> -<div class="header"> +<span id="pktogf-invocation"></span><div class="header"> <p> Next: <a href="#pktype-invocation" accesskey="n" rel="next">pktype invocation</a>, Previous: <a href="#gftopk-invocation" accesskey="p" rel="prev">gftopk invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="PKtoGF_003a-Packed-to-generic-font-conversion"></a> -<h3 class="section">10.3 PKtoGF: Packed to generic font conversion</h3> +<span id="PKtoGF_003a-Packed-to-generic-font-conversion"></span><h3 class="section">10.3 PKtoGF: Packed to generic font conversion</h3> -<a name="index-pktogf"></a> -<a name="index-conversion_002c-PK-to-GF"></a> -<a name="index-GF_002c-converting-PK-to"></a> -<a name="index-PK_002c-converting-to-GF"></a> +<span id="index-pktogf"></span> +<span id="index-conversion_002c-PK-to-GF"></span> +<span id="index-GF_002c-converting-PK-to"></span> +<span id="index-PK_002c-converting-to-GF"></span> <p>PKtoGF converts a packed font (PK) file to a generic font (GF) file. Since PK format is much more compact than GF format, the most likely @@ -4281,7 +4152,7 @@ programs do not support PK format. Synopsis: <pre class="example">pktogf [<var>option</var>]… <var>pkname</var>.<var>dpi</var>[pk] [<var>gffile</var>] </pre></div> -<p>The font <var>pkname</var> is searched for in the usual places (see <a href="http://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>pkname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4299,20 +4170,18 @@ of ‘<samp><var>pkname</var>.<var>dpi</var>gf</samp>’, e.g., ‘< </p> <hr> -<a name="pktype-invocation"></a> -<div class="header"> +<span id="pktype-invocation"></span><div class="header"> <p> Next: <a href="#gftype-invocation" accesskey="n" rel="next">gftype invocation</a>, Previous: <a href="#pktogf-invocation" accesskey="p" rel="prev">pktogf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="PKtype_003a-Plain-text-transliteration-of-packed-fonts"></a> -<h3 class="section">10.4 PKtype: Plain text transliteration of packed fonts</h3> +<span id="PKtype_003a-Plain-text-transliteration-of-packed-fonts"></span><h3 class="section">10.4 PKtype: Plain text transliteration of packed fonts</h3> -<a name="index-pktype-PK-validation"></a> -<a name="index-conversion_002c-PK-to-plain-text"></a> -<a name="index-plain-text_002c-converting-PK-to"></a> -<a name="index-human_002dreadable-text_002c-converting-PK-to"></a> -<a name="index-type-programs_002c-PK"></a> -<a name="index-validation_002c-of-PK-files"></a> +<span id="index-pktype-PK-validation"></span> +<span id="index-conversion_002c-PK-to-plain-text"></span> +<span id="index-plain-text_002c-converting-PK-to"></span> +<span id="index-human_002dreadable-text_002c-converting-PK-to"></span> +<span id="index-type-programs_002c-PK"></span> +<span id="index-validation_002c-of-PK-files"></span> <p>PKtype translates a packed font (PK) bitmap file (as output by GFtoPK, for example) to a plain text file that humans can read. It also serves @@ -4323,7 +4192,7 @@ correct. Synopsis: <pre class="example">pktype <var>pkname</var>.<var>dpi</var>[pk] </pre></div> -<p>The font <var>pkname</var> is searched for in the usual places (see <a href="http://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>pkname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4341,8 +4210,8 @@ letter ‘K’ in ‘<samp>cmr10</samp>’, as rendered at 600dp ‘<samp>ljfour</samp>’ from <a href="modes.mf">modes.mf</a> (available from <samp>ftp://ftp.tug.org/tex/modes.mf</samp>). </p> -<div class="smallexample"> -<pre class="smallexample">955: Flag byte = 184 Character = 75 Packet length = 174 +<div class="example"> +<pre class="example">955: Flag byte = 184 Character = 75 Packet length = 174 Dynamic packing variable = 11 TFM width = 815562 dx = 4259840 Height = 57 Width = 57 X-offset = -3 Y-offset = 56 @@ -4355,62 +4224,62 @@ letter ‘K’ in ‘<samp>cmr10</samp>’, as rendered at 600dp </p> <dl compact="compact"> <dt>‘<samp>955</samp>’</dt> -<dd><a name="index-byte-position"></a> +<dd><span id="index-byte-position"></span> <p>The byte position in the file where this character starts. </p> </dd> <dt>‘<samp>Flag byte</samp>’</dt> <dt>‘<samp>Dynamic packing variable</samp>’</dt> -<dd><a name="index-flag-byte"></a> -<a name="index-dynamic-packing-variable"></a> +<dd><span id="index-flag-byte"></span> +<span id="index-dynamic-packing-variable"></span> <p>Related to the packing for this character; see the source code. </p> </dd> <dt>‘<samp>Character</samp>’</dt> -<dd><a name="index-character-codes_002c-in-PKtype-output"></a> +<dd><span id="index-character-codes_002c-in-PKtype-output"></span> <p>The character code, in decimal. </p> </dd> <dt>‘<samp>Packet length</samp>’</dt> -<dd><a name="index-packet-length"></a> +<dd><span id="index-packet-length"></span> <p>The total length of this character definition, in bytes. </p> </dd> <dt>‘<samp>TFM width</samp>’</dt> -<dd><a name="index-TFM-width-of-characters"></a> -<a name="index-device_002dindependent-width"></a> -<a name="index-width_002c-device_002dindependent"></a> +<dd><span id="index-TFM-width-of-characters"></span> +<span id="index-device_002dindependent-width"></span> +<span id="index-width_002c-device_002dindependent"></span> <p>The device-independent (TFM) width of this character. It is 2^24 times the ratio of the true width to the font’s design size. </p> </dd> <dt>‘<samp>dx</samp>’</dt> -<dd><a name="index-horizontal-escapement"></a> -<a name="index-escapement_002c-horizontal"></a> -<a name="index-scaled-pixels"></a> -<a name="index-dx-horizontal-escapement"></a> +<dd><span id="index-horizontal-escapement"></span> +<span id="index-escapement_002c-horizontal"></span> +<span id="index-scaled-pixels"></span> +<span id="index-dx-horizontal-escapement"></span> <p>The device-dependent width, in <em>scaled pixels</em>, i.e., units of horizontal pixels times 2^16. </p> </dd> <dt>‘<samp>Height</samp>’</dt> <dt>‘<samp>Width</samp>’</dt> -<dd><a name="index-height_002c-in-pixels"></a> -<a name="index-pixel-height"></a> -<a name="index-pixel-width"></a> -<a name="index-width_002c-in-pixels"></a> +<dd><span id="index-height_002c-in-pixels"></span> +<span id="index-pixel-height"></span> +<span id="index-pixel-width"></span> +<span id="index-width_002c-in-pixels"></span> <p>The bitmap height and width, in pixels. </p> </dd> <dt>‘<samp>X-offset</samp>’</dt> <dt>‘<samp>Y-offset</samp>’</dt> -<dd><a name="index-x-offset"></a> -<a name="index-y-offset"></a> -<a name="index-origin"></a> -<a name="index-reference-pixel"></a> -<a name="index-side-bearings"></a> -<a name="index-left-side-bearing"></a> -<a name="index-right-side-bearing"></a> +<dd><span id="index-x-offset"></span> +<span id="index-y-offset"></span> +<span id="index-origin"></span> +<span id="index-reference-pixel"></span> +<span id="index-side-bearings"></span> +<span id="index-left-side-bearing"></span> +<span id="index-right-side-bearing"></span> <p>Horizontal and vertical offset from the upper left pixel to the reference (origin) pixel for this character, in pixels (right and down are positive). The <em>reference pixel</em> is the pixel that occupies the @@ -4421,8 +4290,8 @@ escapement minus the bitmap width plus the x-offset. </p> </dd> <dt>‘<samp>[2]23(16)…</samp>’</dt> -<dd><a name="index-run-length-encoded-bitmaps"></a> -<a name="index-repeated-rows"></a> +<dd><span id="index-run-length-encoded-bitmaps"></span> +<span id="index-repeated-rows"></span> <p>Finally, run lengths of black pixels alternate with parenthesized run lengths of white pixels, and brackets indicate a repeated row. </p></dd> @@ -4430,20 +4299,18 @@ lengths of white pixels, and brackets indicate a repeated row. <hr> -<a name="gftype-invocation"></a> -<div class="header"> +<span id="gftype-invocation"></span><div class="header"> <p> Next: <a href="#tftopl-invocation" accesskey="n" rel="next">tftopl invocation</a>, Previous: <a href="#pktype-invocation" accesskey="p" rel="prev">pktype invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="GFtype_003a-Plain-text-transliteration-of-generic-fonts"></a> -<h3 class="section">10.5 GFtype: Plain text transliteration of generic fonts</h3> +<span id="GFtype_003a-Plain-text-transliteration-of-generic-fonts"></span><h3 class="section">10.5 GFtype: Plain text transliteration of generic fonts</h3> -<a name="index-gftype-GF-validation"></a> -<a name="index-conversion_002c-GF-to-plain-text"></a> -<a name="index-plain-text_002c-converting-GF-to"></a> -<a name="index-human_002dreadable-text_002c-converting-GF-to"></a> -<a name="index-type-programs_002c-GF"></a> -<a name="index-validation_002c-of-GF-files"></a> +<span id="index-gftype-GF-validation"></span> +<span id="index-conversion_002c-GF-to-plain-text"></span> +<span id="index-plain-text_002c-converting-GF-to"></span> +<span id="index-human_002dreadable-text_002c-converting-GF-to"></span> +<span id="index-type-programs_002c-GF"></span> +<span id="index-validation_002c-of-GF-files"></span> <p>GFtype translates a generic font (GF) bitmap file (as output by Metafont, for example) to a plain text file that humans can read. It @@ -4454,7 +4321,7 @@ it’s correct. Synopsis: <pre class="example">gftype [<var>option</var>]… <var>gfname</var>.<var>dpi</var>[gf] </pre></div> -<p>The font <var>gfname</var> is searched for in the usual places (see <a href="http://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph +<p>The font <var>gfname</var> is searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Glyph-lookup">Glyph lookup</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. @@ -4468,12 +4335,12 @@ not an extension; no ‘<samp>.</samp>’ precedes it: for instance, <sa ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-images</samp>’</dt> -<dd><a name="index-_002dimages"></a> +<dd><span id="index-_002dimages"></span> <p>Show the characters’ bitmaps using asterisks and spaces. </p> </dd> <dt>‘<samp>-mnemonics</samp>’</dt> -<dd><a name="index-_002dmnemonics"></a> +<dd><span id="index-_002dmnemonics"></span> <p>Translate all commands in the GF file. </p></dd> </dl> @@ -4527,19 +4394,19 @@ main definition: <dt>‘<samp>2033</samp>’</dt> <dt>‘<samp>2043</samp>’</dt> <dt>‘<samp>…</samp>’</dt> -<dd><a name="index-byte-position-1"></a> +<dd><span id="index-byte-position-1"></span> <p>The byte position in the file where each GF command starts. </p> </dd> <dt>‘<samp>beginning of char 75</samp>’</dt> -<dd><a name="index-character-codes_002c-in-GFtype-output"></a> +<dd><span id="index-character-codes_002c-in-GFtype-output"></span> <p>The character code, in decimal. </p> </dd> <dt>‘<samp>3<=m<=60 0<=n<=56</samp>’</dt> -<dd><a name="index-left-side-bearing-1"></a> -<a name="index-right-side-bearing-1"></a> -<a name="index-side-bearings-1"></a> +<dd><span id="index-left-side-bearing-1"></span> +<span id="index-right-side-bearing-1"></span> +<span id="index-side-bearings-1"></span> <p>The character’s bitmap lies between 3 and 60 (inclusive) horizontally, and between 0 and 56 (inclusive) vertically. (<em>m</em> is a column position and <em>n</em> is a row position.) Thus, 3 is the left side @@ -4548,18 +4415,18 @@ below) minus the maximum <em>m</em>. </p> </dd> <dt>‘<samp>(initially n=56) paint (0)24(12)20</samp>’</dt> -<dd><a name="index-run-length-encoded-bitmaps-1"></a> +<dd><span id="index-run-length-encoded-bitmaps-1"></span> <p>The first row of pixels: 0 white pixels, 24 black pixels, 12 white pixels, etc. </p> </dd> <dt>‘<samp>newrow 0 (n=55) paint 24(12)20</samp>’</dt> -<dd><a name="index-newrow-GF-command"></a> +<dd><span id="index-newrow-GF-command"></span> <p>The second row of pixels, with zero leading white pixels on the row. </p> </dd> <dt>‘<samp>eoc</samp>’</dt> -<dd><a name="index-eoc-GF-command"></a> +<dd><span id="index-eoc-GF-command"></span> <p>The end of the main character definition. </p> </dd> @@ -4575,13 +4442,13 @@ pixels, etc. </p> <dl compact="compact"> <dt>‘<samp>dx</samp>’</dt> -<dd><a name="index-horizontal-escapement-1"></a> -<a name="index-escapement_002c-horizontal-1"></a> -<a name="index-vertical-escapement"></a> -<a name="index-escapement_002c-vertical"></a> -<a name="index-scaled-pixels-1"></a> -<a name="index-dx-horizontal-escapement-1"></a> -<a name="index-dy-vertical-escapement"></a> +<dd><span id="index-horizontal-escapement-1"></span> +<span id="index-escapement_002c-horizontal-1"></span> +<span id="index-vertical-escapement"></span> +<span id="index-escapement_002c-vertical"></span> +<span id="index-scaled-pixels-1"></span> +<span id="index-dx-horizontal-escapement-1"></span> +<span id="index-dy-vertical-escapement"></span> <p>The device-dependent width, in <em>scaled pixels</em>, i.e., units of horizontal pixels times 2^16. The ‘<samp>(65)</samp>’ is simply the same number rounded. If the vertical escapement is nonzero, it would appear here as @@ -4589,9 +4456,9 @@ a ‘<samp>dy</samp>’ value. </p> </dd> <dt>‘<samp>width</samp>’</dt> -<dd><a name="index-TFM-width-of-characters-1"></a> -<a name="index-device_002dindependent-width-1"></a> -<a name="index-width_002c-device_002dindependent-1"></a> +<dd><span id="index-TFM-width-of-characters-1"></span> +<span id="index-device_002dindependent-width-1"></span> +<span id="index-width_002c-device_002dindependent-1"></span> <p>The device-independent (TFM) width of this character. It is 2^24 times the ratio of the true width to the font’s design size. The ‘<samp>64.57289</samp>’ is the same number converted to pixels. @@ -4605,22 +4472,20 @@ times the ratio of the true width to the font’s design size. The <hr> -<a name="tftopl-invocation"></a> -<div class="header"> +<span id="tftopl-invocation"></span><div class="header"> <p> Next: <a href="#pltotf-invocation" accesskey="n" rel="next">pltotf invocation</a>, Previous: <a href="#gftype-invocation" accesskey="p" rel="prev">gftype invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="TFtoPL_003a-TeX-font-metric-to-property-list-conversion"></a> -<h3 class="section">10.6 TFtoPL: TeX font metric to property list conversion</h3> +<span id="TFtoPL_003a-TeX-font-metric-to-property-list-conversion"></span><h3 class="section">10.6 TFtoPL: TeX font metric to property list conversion</h3> -<a name="index-tftopl"></a> -<a name="index-conversion_002c-TFM-to-property-list"></a> -<a name="index-validation_002c-of-TFM-files"></a> -<a name="index-property-list_002c-converting-TFM-to"></a> -<a name="index-human_002dreadable-text_002c-converting-TFM-to"></a> -<a name="index-plain-text_002c-converting-TFM-to"></a> +<span id="index-tftopl"></span> +<span id="index-conversion_002c-TFM-to-property-list"></span> +<span id="index-validation_002c-of-TFM-files"></span> +<span id="index-property-list_002c-converting-TFM-to"></span> +<span id="index-human_002dreadable-text_002c-converting-TFM-to"></span> +<span id="index-plain-text_002c-converting-TFM-to"></span> -<p>TFtoPL translates a TeX font metric (TFM, see <a href="http://tug.org/texinfohtml/dvips.html#Metric-files">Metric +<p>TFtoPL translates a TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by Metafont, for example) to <em>property list format</em> (a list of parenthesized items describing the font) that humans can edit or read. This program is mostly used by @@ -4632,7 +4497,7 @@ Synopsis: </pre></div> <p>The font <var>tfmname</var> (extended with ‘<samp>.tfm</samp>’ if necessary) is -searched for in the usual places (see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the +searched for in the usual places (see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. </p> @@ -4645,7 +4510,7 @@ program TFtoPL (see the next section). ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-charcode-format=<var>type</var></samp>’</dt> -<dd><a name="index-_002dcharcode_002dformat_003dtype"></a> +<dd><span id="index-_002dcharcode_002dformat_003dtype"></span> <p>Output character codes in the PL file according to <var>type</var>: either ‘<samp>octal</samp>’ or ‘<samp>ascii</samp>’. Default is ‘<samp>ascii</samp>’ for letters and digits, octal for all other characters. Exception: if the font’s coding @@ -4664,7 +4529,7 @@ confusing. </p></dd> </dl> -<a name="index-property-list-format"></a> +<span id="index-property-list-format"></span> <p>As an example of the output, here is the (abridged) property list translation of <samp>cmr10.tfm</samp>: </p> @@ -4720,25 +4585,25 @@ translation of <samp>cmr10.tfm</samp>: <em>properties</em>, nested where necessary. </p> <ul> -<li> <a name="index-FAMILY-property"></a> -<a name="index-FACE-property"></a> -<a name="index-headerbyte-information"></a> +<li> <span id="index-FAMILY-property"></span> +<span id="index-FACE-property"></span> +<span id="index-headerbyte-information"></span> The first few items (<code>FAMILY</code>, <code>FACE</code>, and so on) are the so-called <em>headerbyte</em> information from Metafont, giving general information about the font. -</li><li> <a name="index-FAMILY-property-1"></a> -<a name="index-_005cfontdimen"></a> +</li><li> <span id="index-FAMILY-property-1"></span> +<span id="index-_005cfontdimen"></span> The <code>FONTDIMEN</code> property defines the TeX <code>\fontdimen</code> values. -</li><li> <a name="index-LIGTABLE-property"></a> -<a name="index-LABEL-property"></a> -<a name="index-LIG-property"></a> -<a name="index-KRN-property"></a> -<a name="index-ligature-table_002c-in-TFM-files"></a> -<a name="index-kerning-table_002c-in-TFM-files"></a> -<a name="index-design_002dsize-units"></a> +</li><li> <span id="index-LIGTABLE-property"></span> +<span id="index-LABEL-property"></span> +<span id="index-LIG-property"></span> +<span id="index-KRN-property"></span> +<span id="index-ligature-table_002c-in-TFM-files"></span> +<span id="index-kerning-table_002c-in-TFM-files"></span> +<span id="index-design_002dsize-units"></span> The <code>LIGTABLE</code> property defines the ligature and kerning table. <code>LIG</code> properties define ligatures: in the example above, an ‘<samp>f</samp>’ (in the ‘<samp>LABEL</samp>’) followed by an ‘<samp>i</samp>’ is a ligature, @@ -4751,11 +4616,11 @@ apostrophe), TeX inserts a small amount of space between them: three-quarters of a printer’s point by default in this case, or .001 inches). -</li><li> <a name="index-CHARACTER-property"></a> -<a name="index-CHARWD-property"></a> -<a name="index-CHARHT-property"></a> -<a name="index-CHARDP-property"></a> -<a name="index-CHARIC-property"></a> +</li><li> <span id="index-CHARACTER-property"></span> +<span id="index-CHARWD-property"></span> +<span id="index-CHARHT-property"></span> +<span id="index-CHARDP-property"></span> +<span id="index-CHARIC-property"></span> The <code>CHARACTER</code> property defines the dimensions of a character: its width, height, depth, and italic correction, also in design-size units, as explained in the previous item. For our example ‘f’, the depth is @@ -4766,21 +4631,19 @@ ligatures for this character as a comment. <hr> -<a name="pltotf-invocation"></a> -<div class="header"> +<span id="pltotf-invocation"></span><div class="header"> <p> Next: <a href="#vftovp-invocation" accesskey="n" rel="next">vftovp invocation</a>, Previous: <a href="#tftopl-invocation" accesskey="p" rel="prev">tftopl invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="PLtoTF_003a-Property-list-to-TeX-font-metric-conversion"></a> -<h3 class="section">10.7 PLtoTF: Property list to TeX font metric conversion</h3> +<span id="PLtoTF_003a-Property-list-to-TeX-font-metric-conversion"></span><h3 class="section">10.7 PLtoTF: Property list to TeX font metric conversion</h3> -<a name="index-pltotf"></a> -<a name="index-conversion_002c-property-list-to-TFM"></a> -<a name="index-TFM-files_002c-converting-property-lists-to"></a> -<a name="index-machine_002dreadable_002c-converting-property-lists-to"></a> +<span id="index-pltotf"></span> +<span id="index-conversion_002c-property-list-to-TFM"></span> +<span id="index-TFM-files_002c-converting-property-lists-to"></span> +<span id="index-machine_002dreadable_002c-converting-property-lists-to"></span> <p>PLtoTF translates a property list file (as output by TFtoPL, for -example) to TeX font metric (TFM, see <a href="http://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) +example) to TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) format. It’s much easier for both programs and humans to create the (plain text) property list files and let PLtoTF take care of creating the binary TFM equivalent than to output TFM files directly. Synopsis: @@ -4802,24 +4665,22 @@ output by default is undesirable.) </p> <hr> -<a name="vftovp-invocation"></a> -<div class="header"> +<span id="vftovp-invocation"></span><div class="header"> <p> Next: <a href="#vptovf-invocation" accesskey="n" rel="next">vptovf invocation</a>, Previous: <a href="#pltotf-invocation" accesskey="p" rel="prev">pltotf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="VFtoVP_003a-Virtual-font-to-virtual-property-lists"></a> -<h3 class="section">10.8 VFtoVP: Virtual font to virtual property lists</h3> +<span id="VFtoVP_003a-Virtual-font-to-virtual-property-lists"></span><h3 class="section">10.8 VFtoVP: Virtual font to virtual property lists</h3> -<a name="index-vftovp"></a> -<a name="index-conversion_002c-VF-to-VPL"></a> -<a name="index-validation_002c-of-VF-files"></a> -<a name="index-property-list_002c-converting-VF-to-virtual"></a> -<a name="index-human_002dreadable-text_002c-converting-VF-to"></a> -<a name="index-plain-text_002c-converting-VF-to"></a> +<span id="index-vftovp"></span> +<span id="index-conversion_002c-VF-to-VPL"></span> +<span id="index-validation_002c-of-VF-files"></span> +<span id="index-property-list_002c-converting-VF-to-virtual"></span> +<span id="index-human_002dreadable-text_002c-converting-VF-to"></span> +<span id="index-plain-text_002c-converting-VF-to"></span> -<p>VFtoVP translates a virtual font metric (VF, see <a href="http://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual +<p>VFtoVP translates a virtual font metric (VF, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) file and its accompanying TeX font metric (TFM, -see <a href="http://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by VPtoVF, for +see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) file (as output by VPtoVF, for example) to <em>virtual property list format</em> (a list of parenthesized items describing the virtual font) that humans can edit or read. This program is mostly used by people debugging virtual font utilities. @@ -4831,7 +4692,7 @@ Synopsis: <p>The fonts <var>vfname</var> and <var>tfmname</var> (extended with ‘<samp>.vf</samp>’ and ‘<samp>.tfm</samp>’ if necessary) are searched for in the usual places -(see <a href="http://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the +(see <a href="https://tug.org/texinfohtml/kpathsea.html#Supported-file-formats">Supported file formats</a> in <cite>Kpathsea</cite>). To see all the relevant paths, set the environment variable <code>KPATHSEA_DEBUG</code> to ‘<samp>-1</samp>’ before running the program. If <var>tfmname</var> is not specified, <var>vfname</var> (without a trailing ‘<samp>.vf</samp>’) is used. @@ -4845,7 +4706,7 @@ companion program VFtoVP (see the next section). ‘<samp>-verbose</samp>’, ‘<samp>-help</samp>’ and ‘<samp>-version</samp>’ (see <a href="#Common-options">Common options</a>): </p><dl compact="compact"> <dt>‘<samp>-charcode-format=<var>type</var></samp>’</dt> -<dd><a name="index-_002dcharcode_002dformat_003dtype-1"></a> +<dd><span id="index-_002dcharcode_002dformat_003dtype-1"></span> <p>Output character codes in the PL file according to <var>type</var>: either ‘<samp>octal</samp>’ or ‘<samp>ascii</samp>’. Default is ‘<samp>ascii</samp>’ for letters and digits, octal for all other characters. Exception: if the font’s coding @@ -4866,22 +4727,20 @@ confusing. <hr> -<a name="vptovf-invocation"></a> -<div class="header"> +<span id="vptovf-invocation"></span><div class="header"> <p> Next: <a href="#Font-utilities-available-elsewhere" accesskey="n" rel="next">Font utilities available elsewhere</a>, Previous: <a href="#vftovp-invocation" accesskey="p" rel="prev">vftovp invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="VPtoVF_003a-Virtual-property-lists-to-virtual-font"></a> -<h3 class="section">10.9 VPtoVF: Virtual property lists to virtual font</h3> +<span id="VPtoVF_003a-Virtual-property-lists-to-virtual-font"></span><h3 class="section">10.9 VPtoVF: Virtual property lists to virtual font</h3> -<a name="index-vptovf"></a> -<a name="index-conversion_002c-property-list-to-VF"></a> -<a name="index-VF-files_002c-converting-property-lists-to"></a> -<a name="index-machine_002dreadable_002c-converting-property-lists-to-1"></a> +<span id="index-vptovf"></span> +<span id="index-conversion_002c-property-list-to-VF"></span> +<span id="index-VF-files_002c-converting-property-lists-to"></span> +<span id="index-machine_002dreadable_002c-converting-property-lists-to-1"></span> <p>VPtoVF translates a virtual property list file (as output by VFtoVP, for -example) to virtual font (VF, see <a href="http://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) and -TeX font metric (TFM, see <a href="http://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) files. +example) to virtual font (VF, see <a href="https://tug.org/texinfohtml/dvips.html#Virtual-fonts">Virtual fonts</a> in <cite>Dvips</cite>) and +TeX font metric (TFM, see <a href="https://tug.org/texinfohtml/dvips.html#Metric-files">Metric files</a> in <cite>Dvips</cite>) files. It’s much easier for both programs and humans to create the (plain text) property list files and let VPtoVF take care of creating the binary VF and TFM equivalents than to output them directly. Synopsis: @@ -4901,47 +4760,45 @@ specified, the VF output is written to the basename of </p> <hr> -<a name="Font-utilities-available-elsewhere"></a> -<div class="header"> +<span id="Font-utilities-available-elsewhere"></span><div class="header"> <p> Previous: <a href="#vptovf-invocation" accesskey="p" rel="prev">vptovf invocation</a>, Up: <a href="#Font-utilities" accesskey="u" rel="up">Font utilities</a> [<a 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-utilities-available-elsewhere-1"></a> -<h3 class="section">10.10 Font utilities available elsewhere</h3> +<span id="Font-utilities-available-elsewhere-1"></span><h3 class="section">10.10 Font utilities available elsewhere</h3> -<a name="index-font-utilities_002c-non_002dWeb2c"></a> +<span id="index-font-utilities_002c-non_002dWeb2c"></span> <p>The Web2c complement of font utilities merely implements a few basic conversions. Many other more sophisticated font utilities exist; most are in <samp><var>CTAN:</var>/fonts/utilities</samp> (for CTAN info, -see <a href="http://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). Here are some of the most +see <a href="https://tug.org/texinfohtml/kpathsea.html#unixtex_002eftp">unixtex.ftp</a> in <cite>Kpathsea</cite>). Here are some of the most commonly-requested items: </p> <ul> -<li> <a name="index-AFM-to-TFM-conversion"></a> -<a name="index-afm2tfm"></a> -<a name="index-afmtopl"></a> -AFM (Adobe font metric) to TFM conversion: see <a href="http://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite>Dvips</cite>, and <samp><var>CTAN:</var>/fonts/utilities/afmtopl</samp>. +<li> <span id="index-AFM-to-TFM-conversion"></span> +<span id="index-afm2tfm"></span> +<span id="index-afmtopl"></span> +AFM (Adobe font metric) to TFM conversion: see <a href="https://tug.org/texinfohtml/dvips.html#Invoking-afm2tfm">Invoking afm2tfm</a> in <cite>Dvips</cite>, and <samp><var>CTAN:</var>/fonts/utilities/afmtopl</samp>. -</li><li> <a name="index-X-bitmap-fonts"></a> -<a name="index-BDF-and-GF-conversion"></a> +</li><li> <span id="index-X-bitmap-fonts"></span> +<span id="index-BDF-and-GF-conversion"></span> BDF (the X bitmap format) conversion: <a href="ftp://ftp.tug.org/tex/bdf.tar.gz">ftp://ftp.tug.org/tex/bdf.tar.gz</a>. -</li><li> <a name="index-metatype1"></a> -<a name="index-Latin-Modern"></a> +</li><li> <span id="index-metatype1"></span> +<span id="index-Latin-Modern"></span> Creating fonts using MetaPost: MetaType1. <a href="ftp://bop.eps.gda.pl/pub/metatype1">ftp://bop.eps.gda.pl/pub/metatype1</a>. This is used to create the excellent Latin Modern font family (<samp><var>CTAN:</var>/fonts/lm</samp>), which extends Computer Modern to a vast repertoire of scripts. -</li><li> <a name="index-editing-of-bitmap-fonts"></a> -<a name="index-xbfe_002c-bitmap-font-editor"></a> -<a name="index-xfed_002c-bitmap-font-editor"></a> -<a name="index-xfedor_002c-bitmap-font-editor"></a> -<a name="index-gftopxl"></a> -<a name="index-chtopx"></a> -<a name="index-pxtoch"></a> +</li><li> <span id="index-editing-of-bitmap-fonts"></span> +<span id="index-xbfe_002c-bitmap-font-editor"></span> +<span id="index-xfed_002c-bitmap-font-editor"></span> +<span id="index-xfedor_002c-bitmap-font-editor"></span> +<span id="index-gftopxl"></span> +<span id="index-chtopx"></span> +<span id="index-pxtoch"></span> Editing of bitmap fonts: Xbfe from the GNU font utilities mentioned below; the X BDF-editing programs available from <a href="ftp://ftp.x.org/R5contrib/xfed.tar.Z">ftp://ftp.x.org/R5contrib/xfed.tar.Z</a> and @@ -4950,36 +4807,36 @@ fonts have only 128 characters, you can use the old <code>gftopxl</code>, <code>pxtoch</code>, and <code>chtopx</code> programs from <a href="ftp://ftp.tug.org/tex/web">ftp://ftp.tug.org/tex/web</a>. -</li><li> <a name="index-fontforge"></a> -<a name="index-pfaedit"></a> +</li><li> <span id="index-fontforge"></span> +<span id="index-pfaedit"></span> Editing of outline fonts: FontForge, <a href="fontforge.sourceforge.net">fontforge.sourceforge.net</a>. This is a very elaborate program with support for many outline formats (Type 1, OpenType, TrueType, …), and many advanced font editing features. -</li><li> <a name="index-PK-bitmaps-from-PostScript"></a> -<a name="index-PostScript-to-PK-bitmaps"></a> -<a name="index-gsftopk"></a> -<a name="index-ps2pk"></a> +</li><li> <span id="index-PK-bitmaps-from-PostScript"></span> +<span id="index-PostScript-to-PK-bitmaps"></span> +<span id="index-gsftopk"></span> +<span id="index-ps2pk"></span> PK bitmaps from PostScript outline fonts: gsftopk from the ‘<samp>xdvi</samp>’ distribution. Alternatively, <code>ps2pk</code>, from <samp><var>CTAN:</var>/fonts/utilities/ps2pk</samp>. -</li><li> <a name="index-Type-1-conversion"></a> -<a name="index-PFA-and-PFB-conversion"></a> -<a name="index-PostScript-Type-1-font-conversion"></a> +</li><li> <span id="index-Type-1-conversion"></span> +<span id="index-PFA-and-PFB-conversion"></span> +<span id="index-PostScript-Type-1-font-conversion"></span> PostScript Type 1 font format conversion (i.e., between PFA and PFB formats): <a href="http://www.lcdf.org/type">http://www.lcdf.org/type</a>. -</li><li> <a name="index-scanned-images-of-fonts"></a> -<a name="index-typeface-specimen-sheets"></a> -<a name="index-fontutils"></a> +</li><li> <span id="index-scanned-images-of-fonts"></span> +<span id="index-typeface-specimen-sheets"></span> +<span id="index-fontutils"></span> Scanned image conversion: the (aging) GNU font utilities convert type specimen images to Metafont, PostScript, etc.: <a href="http://www.gnu.org/software/fontutils/">http://www.gnu.org/software/fontutils/</a>. -</li><li> <a name="index-autotrace"></a> -<a name="index-potrace"></a> +</li><li> <span id="index-autotrace"></span> +<span id="index-potrace"></span> Tracing bitmaps to fitted outlines: Autotrace (<a href="http://autotrace.sourceforge.net">http://autotrace.sourceforge.net</a>), Potrace (<a href="http://potrace.sourceforge.net">http://potrace.sourceforge.net</a>). For Metafont fonts, either of @@ -4987,24 +4844,22 @@ the two programs <code>mftrace</code> (<a href="http://www.xs4all.nl/~hanwen/mftrace">http://www.xs4all.nl/~hanwen/mftrace</a>) or <code>textrace</code> (<a href="http://textrace.sourceforge.net">http://textrace.sourceforge.net</a>) make the job easier. -</li><li> <a name="index-virtual-font-creation"></a> -<a name="index-fontinst_002c-for-creating-virtual-fonts"></a> +</li><li> <span id="index-virtual-font-creation"></span> +<span id="index-fontinst_002c-for-creating-virtual-fonts"></span> Virtual font creation: <samp><var>CTAN:</var>/fonts/utilities/fontinst</samp>. </li></ul> <hr> -<a name="Legalisms"></a> -<div class="header"> +<span id="Legalisms"></span><div class="header"> <p> Next: <a href="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Font-utilities" accesskey="p" rel="prev">Font utilities</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="Legalisms-1"></a> -<h2 class="appendix">Appendix A Legalisms</h2> +<span id="Legalisms-1"></span><h2 class="appendix">Appendix A Legalisms</h2> -<a name="index-legalisms"></a> -<a name="index-copyright-notices"></a> -<a name="index-permissions_002c-legal"></a> +<span id="index-legalisms"></span> +<span id="index-copyright-notices"></span> +<span id="index-permissions_002c-legal"></span> <p>In general, each file has its own copyright notice stating the copying permissions for that file. Following is a summary. @@ -5020,7 +4875,7 @@ be modified only through a <samp>.ch</samp> file. under X-like terms; the precise notice is included below. </p> <p>Finally, the Kpathsea library is covered by the GNU Lesser General -Public License (see <a href="http://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite>Kpathsea</cite>). Therefore, +Public License (see <a href="https://tug.org/texinfohtml/kpathsea.html#Introduction">Introduction</a> in <cite>Kpathsea</cite>). Therefore, the <em>binaries</em> resulting from a standard Web2c compilation are also covered by the LGPL; so if you (re)distribute the binaries, you must also (offer to) distribute the complete source that went into those @@ -5050,21 +4905,19 @@ software. <hr> -<a name="References"></a> -<div class="header"> +<span id="References"></span><div class="header"> <p> Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Legalisms" accesskey="p" rel="prev">Legalisms</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="References-1"></a> -<h2 class="appendix">Appendix B References</h2> +<span id="References-1"></span><h2 class="appendix">Appendix B References</h2> -<a name="index-references"></a> -<a name="index-bibliography"></a> +<span id="index-references"></span> +<span id="index-bibliography"></span> <ol> -<li> Kpathsea: See <a href="http://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite>Kpathsea</cite>. +<li> Kpathsea: See <a href="https://tug.org/texinfohtml/kpathsea.html#Top">Introduction</a> in <cite>Kpathsea</cite>. -</li><li> Dvips and Afm2tfm: See <a href="http://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>. +</li><li> Dvips and Afm2tfm: See <a href="https://tug.org/texinfohtml/dvips.html#Top">Introduction</a> in <cite>Dvips</cite>. </li><li> The TeX Users Group: <a href="http://www.tug.org">http://www.tug.org</a>. For an introduction to the TeX system, see <a href="http://tug.org/begin.html">http://tug.org/begin.html</a>. @@ -5215,13 +5068,11 @@ American Mathematical Society, Providence, RI, USA, 2nd revised edition, 1990. <hr> -<a name="Index"></a> -<div class="header"> +<span id="Index"></span><div class="header"> <p> Previous: <a href="#References" accesskey="p" rel="prev">References</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> @@ -5296,16 +5147,16 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <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-_0023define-options">‘<samp>#define</samp>’ options</a>:</td><td> </td><td valign="top"><a href="#Compile_002dtime-options">Compile-time options</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-in-filenames"><code>$ <span class="roman">expansion in filenames</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</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_0026-magic-number"><code>%& <span class="roman">magic number</span></code></a>:</td><td> </td><td valign="top"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</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-_002d-starting-a-filename"><code>- <span class="roman">starting a filename</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-conventions">Option conventions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d-starts-option-names"><code>- <span class="roman">starts option names</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-conventions">Option conventions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002d-starts-option-names"><code>-- <span class="roman">starts option names</span></code></a>:</td><td> </td><td valign="top"><a href="#Option-conventions">Option conventions</a></td></tr> @@ -5395,7 +5246,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_002duppercase"><code>-uppercase</code></a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dx"><code>-x</code></a>:</td><td> </td><td valign="top"><a href="#weave-invocation">weave invocation</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-_002e_002c-used-for-output"><code>.<span class="roman">, used for output</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-file-location">Output file location</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="#mf-invocation">mf invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002eaux-cross_002dreference-files"><code>.aux <span class="roman">cross-reference files</span></code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> @@ -5417,15 +5268,15 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_002eXdefaults"><code>.Xdefaults</code></a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002eXresources"><code>.Xresources</code></a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</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="#mf-invocation">mf invocation</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-bit-clean">8 bit clean</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-8-bit-clean-output_002c-specifying"><code>8 bit clean output, specifying</code></a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-8_002dbit-characters">8-bit characters</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX 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-_005cbibliography"><code>\bibliography</code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cbibliographystyle"><code>\bibliographystyle</code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005ccharsubdef-and-MLTeX"><code>\charsubdef <span class="roman">and MLTeX</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr> @@ -5448,13 +5299,13 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-_005ctracinglostchars-and-MLTeX"><code>\tracinglostchars <span class="roman">and MLTeX</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ctracingcharsubdef">\tracingcharsubdef</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_005cwrite18-shell-escape-extension"><code>\write18 <span class="roman">shell escape extension</span></code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</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-_005e_005e-notation_002c-avoiding"><code>^^ <span class="roman">notation, avoiding</span></code></a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</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-_007e-expansion-in-filenames"><code>~ <span class="roman">expansion in filenames</span></code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</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-abbrv_002ebst"><code>abbrv.bst</code></a>:</td><td> </td><td valign="top"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-accented-character">accented character</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-accents_002c-hyphenating-words-with">accents, hyphenating words with</a>:</td><td> </td><td valign="top"><a href="#MLTeX">MLTeX</a></td></tr> @@ -5478,7 +5329,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-autotrace"><code>autotrace</code></a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Awk_002c-WEB-for">Awk, WEB for</a>:</td><td> </td><td valign="top"><a href="#WEB">WEB</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-base-file_002c-determining">base file, determining</a>:</td><td> </td><td valign="top"><a href="#Determining-the-memory-dump-to-use">Determining the memory dump to use</a></td></tr> <tr><td></td><td valign="top"><a href="#index-base-files">base files</a>:</td><td> </td><td valign="top"><a href="#Initial-Metafont">Initial Metafont</a></td></tr> <tr><td></td><td valign="top"><a href="#index-base-files_002c-need-mode-definitions">base files, need mode definitions</a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr> @@ -5514,7 +5365,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-byte-position-1">byte position</a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-byte-swapping">byte swapping</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</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_002dsources-Makefile-target"><code>c-sources <span class="roman">Makefile target</span></code></a>:</td><td> </td><td valign="top"><a href="#Additional-targets">Additional targets</a></td></tr> <tr><td></td><td valign="top"><a href="#index-change-files_002c-and-MFT">change files, and MFT</a>:</td><td> </td><td valign="top"><a href="#mft-invocation">mft invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-change-files_002c-and-Tangle">change files, and Tangle</a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> @@ -5574,7 +5425,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-Cweb">Cweb</a>:</td><td> </td><td valign="top"><a href="#WEB">WEB</a></td></tr> <tr><td></td><td valign="top"><a href="#index-CWEB">CWEB</a>:</td><td> </td><td valign="top"><a href="#WEB">WEB</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-date-and-time_002c-in-memory-dumps">date and time, in memory dumps</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-debugging-DVI-utilities">debugging DVI utilities</a>:</td><td> </td><td valign="top"><a href="#dvitype-invocation">dvitype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-debugging-flags_002c-specifying">debugging flags, specifying</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> @@ -5609,7 +5460,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-dynamic-Metafont-mode-definitions-with-smode">dynamic Metafont mode definitions with <code>smode</code></a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-dynamic-packing-variable">dynamic packing variable</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</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-response-at-error-prompt"><code>e <span class="roman">response at error prompt</span></code></a>:</td><td> </td><td valign="top"><a href="#Editor-invocation">Editor invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-e_002dcircumflex">e-circumflex</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr> <tr><td></td><td valign="top"><a href="#index-e_002dTeX">e-TeX</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> @@ -5635,7 +5486,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-extensions-to-TeX">extensions to TeX</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-extra_005fmem_005fbot"><code>extra_mem_bot</code></a>:</td><td> </td><td valign="top"><a href="#Runtime-options">Runtime options</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-FACE-property"><code>FACE <span class="roman">property</span></code></a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-FAMILY-property"><code>FAMILY <span class="roman">property</span></code></a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-FAMILY-property-1"><code>FAMILY <span class="roman">property</span></code></a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</a></td></tr> @@ -5675,7 +5526,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-freedom-of-Web2c">freedom of Web2c</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ftp_002emath_002eutah_002eedu"><code>ftp.math.utah.edu</code></a>:</td><td> </td><td valign="top"><a href="#bibtex-invocation">bibtex invocation</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-generating-source-specials">generating source specials</a>:</td><td> </td><td valign="top"><a href="#tex-invocation">tex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-geometric-designs">geometric designs</a>:</td><td> </td><td valign="top"><a href="#Metafont">Metafont</a></td></tr> <tr><td></td><td valign="top"><a href="#index-geometric-font-scaling">geometric font scaling</a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> @@ -5699,7 +5550,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-Gruff_002c-Billy-Goat">Gruff, Billy Goat</a>:</td><td> </td><td valign="top"><a href="#Triptrap">Triptrap</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="#Font-utilities-available-elsewhere">Font utilities available elsewhere</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-Harbison_002c-Samuel-P_002e">Harbison, Samuel P.</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hardware-and-memory-dumps">hardware and memory dumps</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hash-table_002c-increasing-size-of">hash table, increasing size of</a>:</td><td> </td><td valign="top"><a href="#Runtime-options">Runtime options</a></td></tr> @@ -5725,7 +5576,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-hyphenation-and-languages">hyphenation and languages</a>:</td><td> </td><td valign="top"><a href="#Languages-and-hyphenation">Languages and hyphenation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-hyphenation-patterns_002c-creating">hyphenation patterns, creating</a>:</td><td> </td><td valign="top"><a href="#patgen-invocation">patgen invocation</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-ice-cream">ice cream</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-identifier-case">identifier case</a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-identifier-collisions">identifier collisions</a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> @@ -5755,10 +5606,10 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-IPC_005fDEBUG"><code>IPC_DEBUG</code></a>:</td><td> </td><td valign="top"><a href="#Compile_002dtime-options">Compile-time options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-IPC_005fDEBUG-1"><code>IPC_DEBUG</code></a>:</td><td> </td><td valign="top"><a href="#IPC-and-TeX">IPC and TeX</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-job-name">job name</a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</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-kerning-table_002c-in-TFM-files">kerning table, in TFM files</a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-keyboard-character-code_002c-translating">keyboard character code, translating</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</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="#Introduction">Introduction</a></td></tr> @@ -5766,7 +5617,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-KPATHSEA_005fDEBUG"><code>KPATHSEA_DEBUG</code></a>:</td><td> </td><td valign="top"><a href="#Common-options">Common options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-KRN-property"><code>KRN <span class="roman">property</span></code></a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</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-label-font">label font</a>:</td><td> </td><td valign="top"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-LABEL-property"><code>LABEL <span class="roman">property</span></code></a>:</td><td> </td><td valign="top"><a href="#tftopl-invocation">tftopl invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-language-support-in-TeX">language support in TeX</a>:</td><td> </td><td valign="top"><a href="#Languages-and-hyphenation">Languages and hyphenation</a></td></tr> @@ -5788,7 +5639,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-Lua">Lua</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-luaTeX">luaTeX</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</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-machine-dependencies">machine dependencies</a>:</td><td> </td><td valign="top"><a href="#Hardware-and-memory-dumps">Hardware and memory dumps</a></td></tr> <tr><td></td><td valign="top"><a href="#index-machine_002dreadable_002c-converting-property-lists-to">machine-readable, converting property lists to</a>:</td><td> </td><td valign="top"><a href="#pltotf-invocation">pltotf invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-machine_002dreadable_002c-converting-property-lists-to-1">machine-readable, converting property lists to</a>:</td><td> </td><td valign="top"><a href="#vptovf-invocation">vptovf invocation</a></td></tr> @@ -5865,7 +5716,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-MPX-files_002c-converting-from-DVI-files">MPX files, converting from DVI files</a>:</td><td> </td><td valign="top"><a href="#dvitomp-invocation">dvitomp invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Multi_002dlingual-TeX">Multi-lingual TeX</a>:</td><td> </td><td valign="top"><a href="#MLTeX">MLTeX</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-tilde">N tilde</a>:</td><td> </td><td valign="top"><a href="#g_t_005ccharsubdef">\charsubdef</a></td></tr> <tr><td></td><td valign="top"><a href="#index-new-graphics-support-for-Metafont">new graphics support for Metafont</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-newrow-GF-command"><code>newrow <span class="roman">GF command</span></code></a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> @@ -5875,7 +5726,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-NO_005fX11WIN"><code>NO_X11WIN</code></a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-NUL_002c-not-allowed-in-filenames">NUL, not allowed in filenames</a>:</td><td> </td><td valign="top"><a href="#g_t_005cinput-filenames">\input filenames</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-octal-character-codes_002c-in-TCX-files">octal character codes, in TCX files</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-offset-for-overflow-labels">offset for overflow labels</a>:</td><td> </td><td valign="top"><a href="#gftodvi-invocation">gftodvi invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-online-Metafont-graphics">online Metafont graphics</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> @@ -5890,7 +5741,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-output_005fcomment-for-DVI-files"><code>output_comment <span class="roman">for DVI files</span></code></a>:</td><td> </td><td valign="top"><a href="#tex-invocation">tex invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-overflow-label-offset">overflow label offset</a>:</td><td> </td><td valign="top"><a href="#gftodvi-invocation">gftodvi invocation</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-packet-length">packet length</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page_002c-starting">page, starting</a>:</td><td> </td><td valign="top"><a href="#dvicopy-invocation">dvicopy invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-page_002c-starting-1">page, starting</a>:</td><td> </td><td valign="top"><a href="#dvitype-invocation">dvitype invocation</a></td></tr> @@ -5964,7 +5815,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-PXL-files_002c-explained">PXL files, explained</a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-pxtoch"><code>pxtoch</code></a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</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-Raichle_002c-Bernd">Raichle, Bernd</a>:</td><td> </td><td valign="top"><a href="#MLTeX">MLTeX</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reading_002c-additional">reading, additional</a>:</td><td> </td><td valign="top"><a href="#Introduction">Introduction</a></td></tr> <tr><td></td><td valign="top"><a href="#index-readonly-directory_002c-running-TeX-in">readonly directory, running TeX in</a>:</td><td> </td><td valign="top"><a href="#Output-file-location">Output file location</a></td></tr> @@ -5986,7 +5837,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-run-length-encoded-bitmaps-1">run length encoded bitmaps</a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-runtime-options">runtime options</a>:</td><td> </td><td valign="top"><a href="#Runtime-options">Runtime options</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-scaled-pixels">scaled pixels</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-scaled-pixels-1">scaled pixels</a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-scaling-of-fonts">scaling of fonts</a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> @@ -6033,7 +5884,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-system-C-library-function"><code>system <span class="roman">C library function</span></code></a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> <tr><td></td><td valign="top"><a href="#index-system-command">system command</a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</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-T1-encoding-and-ISO-input">T1 encoding and ISO input</a>:</td><td> </td><td valign="top"><a href="#TCX-files">TCX files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Tachikawa_002c-Elizabeth">Tachikawa, Elizabeth</a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tangle"><code>tangle</code></a>:</td><td> </td><td valign="top"><a href="#tangle-invocation">tangle invocation</a></td></tr> @@ -6104,7 +5955,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-typeface-specimen-sheets">typeface specimen sheets</a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr> <tr><td></td><td valign="top"><a href="#index-typesetting">typesetting</a>:</td><td> </td><td valign="top"><a href="#TeX">TeX</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-Unicode">Unicode</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Unicode-1">Unicode</a>:</td><td> </td><td valign="top"><a href="#TeX-extensions">TeX extensions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-Unicode-input">Unicode input</a>:</td><td> </td><td valign="top"><a href="#tex-invocation">tex invocation</a></td></tr> @@ -6112,7 +5963,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-unsrt_002ebst"><code>unsrt.bst</code></a>:</td><td> </td><td valign="top"><a href="#Basic-BibTeX-style-files">Basic BibTeX style files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-UTF_002d8-input">UTF-8 input</a>:</td><td> </td><td valign="top"><a href="#tex-invocation">tex invocation</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-validation_002c-of-DVI-files">validation, of DVI files</a>:</td><td> </td><td valign="top"><a href="#dvitype-invocation">dvitype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-validation_002c-of-GF-files">validation, of GF files</a>:</td><td> </td><td valign="top"><a href="#gftype-invocation">gftype invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-validation_002c-of-PK-files">validation, of PK files</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr> @@ -6131,7 +5982,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-virtualfonts_002etxt"><code>virtualfonts.txt</code></a>:</td><td> </td><td valign="top"><a href="#Font-file-formats">Font file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-vptovf"><code>vptovf</code></a>:</td><td> </td><td valign="top"><a href="#vptovf-invocation">vptovf invocation</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-weave"><code>weave</code></a>:</td><td> </td><td valign="top"><a href="#weave-invocation">weave invocation</a></td></tr> <tr><td></td><td valign="top"><a href="#index-WEB">WEB</a>:</td><td> </td><td valign="top"><a href="#WEB">WEB</a></td></tr> <tr><td></td><td valign="top"><a href="#index-web-environments_002c-and-security">web environments, and security</a>:</td><td> </td><td valign="top"><a href="#Shell-escapes">Shell escapes</a></td></tr> @@ -6150,7 +6001,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-word-processor_002c-not">word processor, not</a>:</td><td> </td><td valign="top"><a href="#TeX">TeX</a></td></tr> <tr><td></td><td valign="top"><a href="#index-writing-memory-dumps">writing memory dumps</a>:</td><td> </td><td valign="top"><a href="#Creating-memory-dumps">Creating memory dumps</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-bitmap-fonts">X bitmap fonts</a>:</td><td> </td><td valign="top"><a href="#Font-utilities-available-elsewhere">Font utilities available elsewhere</a></td></tr> <tr><td></td><td valign="top"><a href="#index-X-class-name-for-Metafont">X class name for Metafont</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-x-offset">x offset</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr> @@ -6167,7 +6018,7 @@ Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a <tr><td></td><td valign="top"><a href="#index-Xt-support">Xt support</a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</a></td></tr> <tr><td></td><td valign="top"><a href="#index-xterm"><code>xterm</code></a>:</td><td> </td><td valign="top"><a href="#Online-Metafont-graphics">Online Metafont graphics</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-offset">y offset</a>:</td><td> </td><td valign="top"><a href="#pktype-invocation">pktype invocation</a></td></tr> <tr><td colspan="4"> <hr></td></tr> </table> diff --git a/Master/texmf-dist/doc/web2c/web2c.pdf b/Master/texmf-dist/doc/web2c/web2c.pdf Binary files differindex 44bcec0f34e..68065edac44 100644 --- a/Master/texmf-dist/doc/web2c/web2c.pdf +++ b/Master/texmf-dist/doc/web2c/web2c.pdf diff --git a/Master/tlpkg/doc/releng.txt b/Master/tlpkg/doc/releng.txt index 62e0d5ff31e..e148439c8ea 100644 --- a/Master/tlpkg/doc/releng.txt +++ b/Master/tlpkg/doc/releng.txt @@ -179,18 +179,23 @@ M. As work proceeds, update the doc: Consider updates of core man pages in Build/source/texk/web2c/man. Remake updmap,fmtutil man pages with help2man: make -C Build/source/Work/texk/texlive/tl_scripts xupdmap.1 xfmtutil.1 - They must be moved from /tmp into Master by hand: + x1=`(unset CDPATH; cd Master/texmf-dist/doc/man/man1; pwd)` + They must be moved from /tmp into Master by hand mv /tmp/xupdmap.1 $x1/updmap.1 mv /tmp/xfmtutil.1 $x1/fmtutil.1 - Also update ~www/texlive/doc/*.html (groff -mandoc -Thtml fmtutil.1): - mv /tmp/xupdmap.1.html $lw/doc/updmap.html - mv /tmp/xfmtutil.1.html $lw/doc/fmtutil.html + Also update ~www/texlive/doc/*.html: + groff -mandoc -Thtml $x1/updmap.1 >$lw/doc/updmap.html + groff -mandoc -Thtml $x1/fmtutil.1 >$lw/doc/fmtutil.html + Man pages from Build to Master (after doing a build): + tl-update-man # consider removals from output, if any binaries are gone + # check /tmp/so.rules against man1/Makefile, update if needed. + cd $x1/.. + make # remakes pdfs + # files to add: + svn status . | sed -n 's/^\?//p' + svn add `!!` Texinfo manuals from Build to Master: tl-update-txi - Man pages from Build to Master (after doing a build): - tl-update-man - # then run make in texmf-dist/doc/man - # and check /tmp/so.rules against man1/Makefile Don't forget commit in texmf-dist/doc. N. Really test during pretest (really! don't leave it for Knuth to do!): |