summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive/tlbuild
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-03-04 16:00:29 +0000
committerKarl Berry <karl@freefriends.org>2022-03-04 16:00:29 +0000
commit5027858830867ff20c7eca53eed6f8b798c5ad9c (patch)
tree842f07fed6d88920a1bcdc035157bb20e17e7904 /Master/texmf-dist/doc/texlive/tlbuild
parentf23f3a09677e44ad094dcf2aa3ac0c3dc3893238 (diff)
2022 doc (+sync) update
git-svn-id: svn://tug.org/texlive/trunk@62387 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/texlive/tlbuild')
-rw-r--r--Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html2579
-rw-r--r--Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdfbin519572 -> 541914 bytes
2 files changed, 1368 insertions, 1211 deletions
diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
index 0b09fb47b17..e25893ed60a 100644
--- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
+++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
@@ -1,8 +1,11 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
+<!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ -->
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This file documents the TeX Live build system and more.
-Copyright (C) 2016-2021 Karl Berry.
+Copyright (C) 2016-2022 Karl Berry.
Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner.
@@ -20,27 +23,27 @@ Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the TeX Users Group. -->
-<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>Building TeX Live (2021)</title>
+<title>Building TeX Live (2022)</title>
-<meta name="description" content="Building TeX Live (2021)">
-<meta name="keywords" content="Building TeX Live (2021)">
+<meta name="description" content="Building TeX Live (2022)">
+<meta name="keywords" content="Building TeX Live (2022)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
<link href="#Top" rel="start" title="Top">
<link href="#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="http://tug.org/texinfohtml" rel="up" title="(dir)">
+<link href="#Introduction" rel="next" title="Introduction">
<style type="text/css">
<!--
+a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em}
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
-div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
@@ -49,6 +52,7 @@ pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
+span:hover a.copiable-anchor {visibility: visible}
ul.no-bullet {list-style: none}
-->
</style>
@@ -57,7 +61,7 @@ ul.no-bullet {list-style: none}
</head>
<body lang="en">
-<h1 class="settitle" align="center">Building TeX Live (2021)</h1>
+<h1 class="settitle" align="center">Building TeX Live (2022)</h1>
@@ -67,27 +71,18 @@ ul.no-bullet {list-style: none}
-<span id="SEC_Overview"></span>
-<h2 class="shortcontents-heading">Short Table of Contents</h2>
-<div class="shortcontents">
-<ul class="no-bullet">
-<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" rel="index">Index</a></li>
-</ul>
+<div class="top" id="Top">
+<div class="header">
+<p>
+Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
+<span id="Building-TeX-Live-_00282022_0029"></span><h1 class="top">Building TeX Live (2022)</h1>
+
+<p>For an overview of this manual, see <a href="#Introduction">Introduction</a>.
+</p>
-<span id="SEC_Contents"></span>
+<div class="Contents_element" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
@@ -99,15 +94,14 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Building-1" href="#Building">4 Building</a>
<ul class="no-bullet">
<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>
+ <li><a id="toc-Build-in-parallel-1" href="#Build-in-parallel">4.2 Build in parallel</a></li>
+ <li><a id="toc-Build-distribution-1" href="#Build-distribution">4.3 Build distribution</a></li>
+ <li><a id="toc-Build-one-package-1" href="#Build-one-package">4.4 Build one package</a></li>
+ <li><a id="toc-Build-one-engine-1" href="#Build-one-engine">4.5 Build one engine</a></li>
+ <li><a id="toc-Cross-compilation-1" href="#Cross-compilation">4.6 Cross compilation</a>
<ul class="no-bullet">
- <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>
+ <li><a id="toc-Cross-configuring-1" href="#Cross-configuring">4.6.1 Cross configuring</a></li>
+ <li><a id="toc-Cross-problems-1" href="#Cross-problems">4.6.2 Cross problems</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Installing-1" href="#Installing">5 Installing</a>
@@ -146,8 +140,9 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX&nbsp;Live</a>
<ul class="no-bullet">
<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>
+ <li><a id="toc-Adding-a-new-engine-1" href="#Adding-a-new-engine">6.6.2 Adding a new engine</a></li>
+ <li><a id="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.3 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.4 Adding a new TeX-specific library module</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Configure-options-1" href="#Configure-options">7 Configure options</a>
@@ -285,55 +280,39 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
</ul>
</div>
-
-
-<span id="Top"></span><div class="header">
-<p>
-Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Building-TeX-Live-_00282021_0029"></span><h1 class="top">Building TeX Live (2021)</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">&bull; <a href="#Introduction" accesskey="1">Introduction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">About this manual.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Overview-of-build-system" accesskey="2">Overview of build system</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The TeX&nbsp;Live build system.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Prerequisites" accesskey="3">Prerequisites</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Requirements for building TeX&nbsp;Live.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Building" accesskey="4">Building</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The overall build process.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Installing" accesskey="5">Installing</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How and where installation happens (or not).
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Layout-and-infrastructure" accesskey="6">Layout and infrastructure</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Autoconf macros, etc., in detail.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options" accesskey="7">Configure options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">List of all configure options.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Coding-conventions" accesskey="8">Coding conventions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Conventions to follow.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Continuous-integration" accesskey="9">Continuous integration</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Automated build testing.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl">install-tl</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The TeX&nbsp;Live installer.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr">tlmgr</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The native TeX&nbsp;Live package manager.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Index" rel="index">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
-</td></tr>
-</table>
-
+<div class="Overview_element" id="SEC_Overview">
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
+<div class="shortcontents">
+<ul class="no-bullet">
+<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" rel="index">Index</a></li>
+</ul>
+</div>
+</div>
<hr>
-<span id="Introduction"></span><div class="header">
+<div class="chapter" id="Introduction">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Building TeX Live (2022)</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
<span id="index-introduction"></span>
-<p>This manual (dated February 2021) corresponds to the TeX&nbsp;Live
-2021 release.
+<p>This manual (dated February 2022) corresponds to the TeX&nbsp;Live
+2022 release.
</p>
<p>This manual is aimed at system installers and programmers, and focuses
on how to configure, build, and develop the TeX&nbsp;Live (TL) sources. It is
@@ -361,8 +340,8 @@ are distributed with TeX&nbsp;Live: <a href="https://tug.org/texlive/build.html"
</li><li> The TeX&nbsp;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="https://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>,
-<cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.):
+</li><li> Other TeX-related Texinfo manuals (see <cite><a data-manual="web2c" href="https://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>,
+<cite><a data-manual="kpathsea" 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 &lsquo;<samp>TeX</samp>&rsquo; category in
the GNU Info system.
@@ -379,11 +358,12 @@ to do so. The same text is available online (linked from
with &lsquo;<samp>--help</samp>&rsquo; (or look at the end of the source).
</p>
-
<hr>
-<span id="Overview-of-build-system"></span><div class="header">
+</div>
+<div class="chapter" id="Overview-of-build-system">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Overview-of-build-system-1"></span><h2 class="chapter">2 Overview of build system</h2>
@@ -405,20 +385,20 @@ all <code>configure</code> options.
<p>The main components of the TL build system are:
</p>
<dl compact="compact">
-<dt><samp>libs/<var>lib</var></samp></dt>
+<dt><span><samp>libs/<var>lib</var></samp></span></dt>
<dd><p>Generic libraries.
</p>
</dd>
-<dt><samp>texk/<var>lib</var></samp></dt>
+<dt><span><samp>texk/<var>lib</var></samp></span></dt>
<dd><p>TeX-specific libraries in subdirectories, notably
<var>lib</var>=<code>kpathsea</code>. (The other one is <samp>texk/ptexenc</samp>.)
</p>
</dd>
-<dt><samp>texk/<var>prog</var></samp></dt>
+<dt><span><samp>texk/<var>prog</var></samp></span></dt>
<dd><p>TeX-specific programs (that use Kpathsea).
</p>
</dd>
-<dt><samp>utils/<var>prog</var></samp></dt>
+<dt><span><samp>utils/<var>prog</var></samp></span></dt>
<dd><p>Other programs (that don&rsquo;t use Kpathsea).
</p>
</dd>
@@ -446,11 +426,12 @@ distributed source tree and document any modifications of that source.
integrating new modules into the TL build system. (Despite all
efforts, neither task is easy.)
</p>
-
<hr>
-<span id="Prerequisites"></span><div class="header">
+</div>
+<div class="chapter" id="Prerequisites">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Prerequisites-1"></span><h2 class="chapter">3 Prerequisites</h2>
@@ -459,51 +440,64 @@ Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a hr
<span id="index-compilers_002c-C-and-C_002b_002b11"></span>
<p>Overall, building the TeX&nbsp;Live programs, when using all libraries from
-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.
+the TL source tree, requires C and C++11 compilers, GNU <code>make</code>,
+and Python.
</p>
+<ul>
+<li> If <code>make</code> from your <code>PATH</code> is not GNU <code>make</code>, you can
+set the <code>MAKE</code> environment variable to whatever is necessary.
+
<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) 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
-library ICU; the program <code>dvisvgm</code> also requires C++11. It is
-possible to build everything else with older compilers, but you have
-to remove the C++11-dependent sources. See <a href="#Build-one-package">Build one package</a>.
-</p>
+<span id="index-FreeType_002c-requires-gmake"></span>
+<span id="index-_0024_0040-target-in-normal-make-rules"></span>
+<p>GNU <code>make</code> is required only because of third-party libraries,
+notably FreeType. Automake/Autoconf output in general, and the
+TL-maintained directories, work with any reasonable
+<code>make</code>.<a id="DOCF1" href="#FOOT1"><sup>1</sup></a>
+</p>
+</li><li> <span id="index-C_002b_002b11_002c-required"></span>
+<span id="index-dvisvgm_002c-requires-C_002b_002b11"></span>
+<span id="index-HarfBuzz_002c-requires-C_002b_002b11"></span>
+<span id="index-ICU_002c-requires-C_002b_002b11"></span>
+A C++11 compiler is similarly required because of the third-party
+libraries ICU and HarfBuzz (at least); the program <code>dvisvgm</code> also
+requires C++11. It is possible to build what remains with older
+compilers, but you have to remove the C++11-dependent sources.
+See <a href="#Build-one-package">Build one package</a>.
+
+</li><li> <span id="index-Python_002c-required-by-ICU"></span>
+Python is required by ICU tests. (If you know how to disable these
+tests and thus eliminate the requirement, please write.)
+
+</li></ul>
+
<p>A few programs in the tree have additional requirements:
</p>
<dl compact="compact">
-<dt><samp>web2c</samp></dt>
-<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>.
+<dt id='index-perl_002c-required-by-web2c_002c-etc_002e'><span><samp>web2c</samp><a href='#index-perl_002c-required-by-web2c_002c-etc_002e' class='copiable-anchor'> &para;</a></span></dt>
+<dd><p>requires <code>perl</code> for some tests run by <code>make check</code>.
+Incidentally, the TeX Live installer (<code>install-tl</code>) and
+manager (<code>tlmgr</code>) are also written in Perl, but this does not
+matter for compiling the sources.
</p>
</dd>
-<dt><samp>xdvik</samp></dt>
-<dt><samp>xpdfopen</samp></dt>
-<dd><span id="index-X11-development_002c-required-by-X-clients"></span>
-<p>require X11 headers and libraries, typically in &ldquo;development&rdquo; packages
+<dt id='index-X11-development_002c-required-by-X-clients'><span><samp>xdvik</samp><a href='#index-X11-development_002c-required-by-X-clients' class='copiable-anchor'> &para;</a></span></dt>
+<dt><span><samp>xpdfopen</samp></span></dt>
+<dd><p>require X11 headers and libraries, typically in devel(opment) packages
that are not installed by default.
</p>
</dd>
-<dt><samp>xetex</samp></dt>
-<dd><span id="index-fontconfig-library_002c-required-by-xetex"></span>
-<span id="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></span>
+<dt id='index-fontconfig-library_002c-required-by-xetex'><span><samp>xetex</samp><a href='#index-fontconfig-library_002c-required-by-xetex' class='copiable-anchor'> &para;</a></span></dt>
+<dd><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>
+MacOS only, the <code>ApplicationServices</code> and <code>Cocoa</code>
frameworks.
</p>
</dd>
-<dt><samp>xindy</samp></dt>
-<dd><span id="index-clisp_002c-required-by-xindy"></span>
-<span id="index-libsigsegv_002c-required-by-xindy"></span>
+<dt id='index-clisp_002c-required-by-xindy'><span><samp>xindy</samp><a href='#index-clisp_002c-required-by-xindy' class='copiable-anchor'> &para;</a></span></dt>
+<dd><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>, <code>pdflatex</code>.
@@ -536,14 +530,15 @@ packaging of them. See <a href="#Build-system-tools">Build system tools</a>, fo
<p>If you haven&rsquo;t modified any source files, and infrastructure tools
such as <code>autoconf</code> or <code>makeinfo</code> are still being run, check
your timestamps&mdash;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.
+<code>yes</code> in your Subversion configuration (see <a href="#Build-system-tools">Build system tools</a>). No infrastructure tools are needed to do a normal build
+(barring bugs).
</p>
-
<hr>
-<span id="Building"></span><div class="header">
+</div>
+<div class="chapter" id="Building">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Building-1"></span><h2 class="chapter">4 Building</h2>
@@ -569,28 +564,20 @@ straightforward shell script.
<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">&bull; <a href="#Build-iteration" accesskey="1">Build iteration</a></td><td>&nbsp;&nbsp;</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">&bull; <a href="#Build-problems" accesskey="2">Build problems</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If the build fails.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Build-in-parallel" accesskey="3">Build in parallel</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Simultaneous <code>make</code> processes.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Build-distribution" accesskey="4">Build distribution</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making a distribution tarball.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Build-one-package" accesskey="5">Build one package</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Example of working on just one program.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Build-one-engine" accesskey="6">Build one engine</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Example of building just one TeX engine.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Cross-compilation" accesskey="7">Cross compilation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Building on host X for target Y.
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Build-iteration" accesskey="1">Build iteration</a></li>
+<li><a href="#Build-in-parallel" accesskey="2">Build in parallel</a></li>
+<li><a href="#Build-distribution" accesskey="3">Build distribution</a></li>
+<li><a href="#Build-one-package" accesskey="4">Build one package</a></li>
+<li><a href="#Build-one-engine" accesskey="5">Build one engine</a></li>
+<li><a href="#Cross-compilation" accesskey="6">Cross compilation</a></li>
+</ul>
<hr>
-<span id="Build-iteration"></span><div class="header">
+<div class="section" id="Build-iteration">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Build-in-parallel" accesskey="n" rel="next">Build in parallel</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Build-iteration-1"></span><h3 class="section">4.1 Build iteration</h3>
@@ -621,31 +608,14 @@ etc.
all the library and program modules, and finds (should find) nothing
to be done.
</p>
-
<hr>
-<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Build-problems-1"></span><h3 class="section">4.2 Build problems</h3>
-
-<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&rsquo;t try to run there, and finally rerun the top
-level <code>make</code> (or <samp>./Build</samp> <code>--no-clean</code>).
-</p>
-
-<hr>
-<span id="Build-in-parallel"></span><div class="header">
+<div class="section" id="Build-in-parallel">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Build-distribution" accesskey="n" rel="next">Build distribution</a>, Previous: <a href="#Build-iteration" accesskey="p" rel="prev">Build iteration</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Build-in-parallel-1"></span><h3 class="section">4.3 Build in parallel</h3>
+<span id="Build-in-parallel-1"></span><h3 class="section">4.2 Build in parallel</h3>
<span id="index-building-in-parallel"></span>
<span id="index-parallel-build"></span>
@@ -656,7 +626,7 @@ Next: <a href="#Build-distribution" accesskey="n" rel="next">Build distribution<
<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>,
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>&gt;1</em> or even
+parallel builds (<code>make -j <var>n</var></code> with <em class='math'><var>n</var>&gt;1</em> or even
<code>make -j</code>) that can considerably speed up the TL build.
</p>
<span id="index-cache-file_002c-for-configure"></span>
@@ -665,13 +635,14 @@ parallel builds (<code>make -j <var>n</var></code> with <em><var>n</var>&gt;1</e
using a configure cache file, i.e., specifying the <code>configure</code>
option <code>-C</code> (recommended).
</p>
-
<hr>
-<span id="Build-distribution"></span><div class="header">
+</div>
+<div class="section" id="Build-distribution">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Build-distribution-1"></span><h3 class="section">4.4 Build distribution</h3>
+<span id="Build-distribution-1"></span><h3 class="section">4.3 Build distribution</h3>
<span id="index-building-a-distribution"></span>
<span id="index-distribution-tarball_002c-making"></span>
@@ -688,13 +659,14 @@ system, since all the support files are lacking; see <a href="#Installing">Insta
We do not actually distribute any such tarball, and have no plans to
do so.
</p>
-
<hr>
-<span id="Build-one-package"></span><div class="header">
+</div>
+<div class="section" id="Build-one-package">
+<div class="header">
<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Build-one-package-1"></span><h3 class="section">4.5 Build one package</h3>
+<span id="Build-one-package-1"></span><h3 class="section">4.4 Build one package</h3>
<span id="index-build-one-package"></span>
<span id="index-one-package_002c-building"></span>
@@ -709,8 +681,8 @@ dependencies and can be invoked to build an individual program or
library, first building any required libraries.
</p>
<p>Here is an example from start to finish for working on
-<code>dvipdfm-x</code>. (Unfortunately, this does not suffice for building
-the TeX engines; see the next section.)
+<code>dvipdfm-x</code>. Unfortunately, this does not suffice for building
+the TeX engines; see the next section.
</p>
<div class="example">
<pre class="example">mkdir mydir &amp;&amp; cd mydir # new working directory
@@ -729,11 +701,21 @@ mkdir Work &amp;&amp; cd Work
# Do the make:
make &gt;&amp;outm || echo fail
-# Test:
+# Run the tests:
cd texk/dvipdfm-x
make check
+
+# Run the new binary in the buil tree, finding support files
+# in a separate tree for a TeX Live release YYYY
+# (Bourne shell syntax):
+TEXMFROOT=/usr/local/texlive/YYYY \
+TEXMFCNF=$TEXMFROOT/texmf-dist/web2c \
+./xdvipdfmx ...
</pre></div>
+<span id="index-TEXMFROOT-for-running-standalone"></span>
+<span id="index-TEXMFCNF-for-running-standalone"></span>
+
<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
@@ -752,8 +734,10 @@ 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>
+<span id="Reducing-source-download-size"></span><h4 class="subsubheading">Reducing source download size</h4>
+
<span id="index-size-of-source-tree"></span>
-<p>Finally, the above retrieves the entire TL source tree (several
+<p>The above retrieves the entire TL source tree (several
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
@@ -765,40 +749,62 @@ 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>
+<span id="GCC-used-by-default"></span><h4 class="subsubheading">GCC used by default</h4>
+
+<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>
+<span id="Removing-C_002b11-dependency"></span><h4 class="subsubheading">Removing C+11 dependency</h4>
+
<span id="index-C_002b_002b11_002c-removing-dependent-sources"></span>
-<p>Some libraries and programs require C++11. If you want to build with
-an older compiler lacking such support, you need to (re)move those
-source directories; specifying <code>--disable</code> for them does not
-suffice, unfortunately. Specifically, before running <code>configure</code>:
+<p>Some libraries and programs require C++11; one such is XeTeX. If you
+want to build with an older compiler lacking such support, you need to
+(re)move those source directories; unfortunately, specifying
+<code>--disable</code> for them does not suffice. It&rsquo;s also necessary to
+specify <code>--disable-xetex</code> explicitly. Specifically, before
+running <code>configure --disable-xetex ...</code>:
</p>
<div class="example">
-<pre class="example">rm -rf libs/icu libs/graphite2 texk/dvisvgm
+<pre class="example">rm -rf libs/icu libs/graphite2 texk/dvisvgm texk/web2c/xetexdir
</pre></div>
<span id="index-_002d_002denable_002dmissing-to-ignore-dependencies"></span>
<p>Also, even with <code>--disable-all-pkgs</code>, dependencies are (currently)
-checked. For instance, if a (non-MacOSX) system does not have
+checked. One notable case: if a (non-MacOS) system does not have
<code>fontconfig</code>, XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>),
and <code>configure</code> will terminate even with <code>--disable-xetex</code>.
To proceed without such dependencies, specify <code>--enable-missing</code>
-also. (Patches to improve this would be most welcome.)
+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>As of 2022, HarfBuzz also requires C++11. Therefore even more would
+have to be disabled and removed, notably including <code>luahbtex</code>,
+the standard engine used for LuaLaTeX. Removing that would not
+be acceptable for builds intended for distribution; but perhaps for
+testing the above information could still be useful.
+</p>
+<span id="index-removing-build-directories"></span>
+<span id="index-configure-problems_002c-work-around-by-removing"></span>
+<p>In general, the TL <code>configure</code> will run in all directories.
+Therefore a general workaround for build problems is to remove failing
+directories from the tree, and also specify the relevant
+<code>--disable-...</code> option(s).
+</p>
+<p>Patches to improve all this would be most welcome.
</p>
-
<hr>
-<span id="Build-one-engine"></span><div class="header">
+</div>
+<div class="section" id="Build-one-engine">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Build-one-engine-1"></span><h3 class="section">4.6 Build one engine</h3>
+<span id="Build-one-engine-1"></span><h3 class="section">4.5 Build one engine</h3>
<span id="index-build-one-engine"></span>
<span id="index-one-engine_002c-building"></span>
@@ -816,7 +822,8 @@ original TeX:
<div class="example">
<pre class="example">cd Work # top build directory
../configure --without-x --disable-shared --disable-all-pkgs \
- --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g
+ --enable-tex --disable-synctex --disable-xetex \
+ --enable-missing -C CFLAGS=-g CXXFLAGS=-g
make
cd texk/web2c # cd engine build directory
make tex # must specify target
@@ -824,9 +831,12 @@ make tex # must specify target
<p>The first <code>make</code> run will configure everything, and even build
the libraries, even though the packages are disabled.
-The source tree can be cut down to just what is needed for the given
+</p>
+<p>The source tree can be cut down to just what is needed for the given
engine (the separate pdfTeX and LuaTeX source repositories do
-this, for example), but see caveats in previous section.
+this, for example), but see caveats in previous section. When the
+<code>--disable-xetex</code> and <code>--enable-missing</code> options are needed
+is also explained in the previous section.
</p>
<p>If you want to debug an X-related program or shared library setup, or
other variants, change the <code>configure</code> options
@@ -835,15 +845,44 @@ accordingly. Either <code>../Build</code> or <code>../configure</code> can be ru
<p>Then it is necessary to again specify the target engine (<code>tex</code>,
in the above) in the <code>make</code>.
</p>
-<p>All this is somewhat unfortunate. We hope to improve the situation in
-the future. Patches are welcome.
+<p>All these complications are rather unfortunate. Patches are welcome.
+</p>
+<span id="Testing-one-engine"></span><h4 class="subsubheading">Testing one engine</h4>
+
+<p>To run only the tests for a given engine, say <code>hitex</code>:
+</p>
+<div class="example">
+<pre class="example">make -C $ww check SUBDIRS=. TESTS='$(hitex_tests)'
+</pre></div>
+
+<p>where <code>$ww</code> is the web2c build directory, that is,
+<samp>ww=/wherever/Build/source/Work/texk/web2c</samp>.
+</p>
+<p>It&rsquo;s also possible to run individual tests the same way, using the test
+name exactly as specified in the <samp>.am</samp> file:
+</p>
+<div class="example">
+<pre class="example">make -C $ww check SUBDIRS=. TESTS=hitexdir/tests/hello.test
+</pre></div>
+
+<span id="index-_002d_002dno_002dprint_002ddirectory-GNU-make-option"></span>
+<p>If you get tired of looking at the &lsquo;<samp>Entering</samp>&rsquo;/&lsquo;<samp>Leaving
+directory</samp>&rsquo; lines, you can add the (GNU) make option
+<code>--no-print-dir</code>.
+</p>
+<p>You may find it useful to put lengthy incantations like this into a
+trivial shell script with a short name (say, <code>hitst</code>). Then you
+just run <code>hitst</code> and edit the file when necessary to change
+things around.
</p>
<hr>
-<span id="Cross-compilation"></span><div class="header">
+</div>
+<div class="section" id="Cross-compilation">
+<div class="header">
<p>
Previous: <a href="#Build-one-engine" accesskey="p" rel="prev">Build one engine</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Cross-compilation-1"></span><h3 class="section">4.7 Cross compilation</h3>
+<span id="Cross-compilation-1"></span><h3 class="section">4.6 Cross compilation</h3>
<span id="index-cross-compilation"></span>
<p>In a cross compilation a <em>build</em> system is used to create
@@ -860,10 +899,10 @@ 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="https://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
+(see <a data-manual="autoconf" 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:
+MacOS system one could use:
</p>
<div class="example">
<pre class="example">TL_BUILD_ENV=&quot;CC='clang -arch i386' \
@@ -872,19 +911,18 @@ MacOSX system one could use:
./Build --build=i386-apple-darwin
</pre></div>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Cross-configuring" accesskey="1">Cross configuring</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Configuring for cross compilation.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Cross-problems" accesskey="2">Cross problems</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Cross compilation problems.
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Cross-configuring" accesskey="1">Cross configuring</a></li>
+<li><a href="#Cross-problems" accesskey="2">Cross problems</a></li>
+</ul>
<hr>
-<span id="Cross-configuring"></span><div class="header">
+<div class="subsection" id="Cross-configuring">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Cross-configuring-1"></span><h4 class="subsection">4.7.1 Cross configuring</h4>
+<span id="Cross-configuring-1"></span><h4 class="subsection">4.6.1 Cross configuring</h4>
<span id="index-cross-compilation-configuring"></span>
<span id="index-configuring_002c-for-cross-compilation"></span>
@@ -949,11 +987,13 @@ BUILDLDFLAGS=&hellip;
</pre></div>
<hr>
-<span id="Cross-problems"></span><div class="header">
+</div>
+<div class="subsection" id="Cross-problems">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Cross-problems-1"></span><h4 class="subsection">4.7.2 Cross problems</h4>
+<span id="Cross-problems-1"></span><h4 class="subsection">4.6.2 Cross problems</h4>
<span id="index-cross-compilation-problems"></span>
@@ -1000,11 +1040,14 @@ and <samp>tie</samp>.
<p>Building <code>xindy</code> requires running the host system <code>clisp</code>
binary, thus cross compilation is painful, but possible.
</p>
-
<hr>
-<span id="Installing"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="chapter" id="Installing">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Installing-1"></span><h2 class="chapter">5 Installing</h2>
@@ -1028,18 +1071,15 @@ is the TeX&nbsp;Live (plain text) database in
<code>install-tl</code>. More information is under <samp>Master/tlpkg</samp> and
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">&bull; <a href="#Installation-directories" accesskey="1">Installation directories</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The prefix, <code>bindir</code>, etc., directories.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Linked-scripts" accesskey="2">Linked scripts</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Scripts not maintained in the sources.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Distro-builds" accesskey="3">Distro builds</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Configuring and building for OS distributions.
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Installation-directories" accesskey="1">Installation directories</a></li>
+<li><a href="#Linked-scripts" accesskey="2">Linked scripts</a></li>
+<li><a href="#Distro-builds" accesskey="3">Distro builds</a></li>
+</ul>
<hr>
-<span id="Installation-directories"></span><div class="header">
+<div class="section" id="Installation-directories">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1097,9 +1137,10 @@ 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>
-<span id="Linked-scripts"></span><div class="header">
+</div>
+<div class="section" id="Linked-scripts">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1142,9 +1183,10 @@ want to add more. (See <a href="https://tug.org/texlive/build.html">https://tug
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>
-<span id="Distro-builds"></span><div class="header">
+</div>
+<div class="section" id="Distro-builds">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1175,43 +1217,43 @@ completely different.
find most relevant:
</p>
<dl compact="compact">
-<dt><code>--disable-native-texlive-build</code></dt>
+<dt><span><code>--disable-native-texlive-build</code></span></dt>
<dd><p>This must be specified to avoid interference from the many tweaks we
do for the native TL build.
</p>
</dd>
-<dt><code>--with-banner-add=/<var>SomeDistro</var></code></dt>
+<dt><span><code>--with-banner-add=/<var>SomeDistro</var></code></span></dt>
<dd><p>This isn&rsquo;t technically required, but is strongly recommended, so your
build and your distro can be distinguished from others.
</p>
</dd>
-<dt><code>--enable-shared</code></dt>
+<dt><span><code>--enable-shared</code></span></dt>
<dd><p>Build shared versions of the TeX-specific libraries (uses
<code>libtool</code>).
</p>
</dd>
-<dt><code>--disable-static</code></dt>
+<dt><span><code>--disable-static</code></span></dt>
<dd><p>Do not build the static versions of the TeX-specific libraries.
</p>
</dd>
-<dt><code>--with-system-<var>lib</var></code></dt>
+<dt><span><code>--with-system-<var>lib</var></code></span></dt>
<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>
-<dt><code>--with-<var>lib</var>-includes=<var>dir</var></code></dt>
-<dt><code>--with-<var>lib</var>-libdir=<var>dir</var></code></dt>
+<dt><span><code>--with-<var>lib</var>-includes=<var>dir</var></code></span></dt>
+<dt><span><code>--with-<var>lib</var>-libdir=<var>dir</var></code></span></dt>
<dd><p>If needed, allows you to specify where the headers/code are for the
given library <var>lib</var>.
</p>
</dd>
-<dt><code>--prefix=/usr</code></dt>
-<dt><code>--prefix=/opt/TeXLive</code></dt>
+<dt><span><code>--prefix=/usr</code></span></dt>
+<dt><span><code>--prefix=/opt/TeXLive</code></span></dt>
<dd><p>Or whatever your convention is. The default is <samp>/usr/local</samp> and
you shouldn&rsquo;t install there for a distro.
</p>
</dd>
-<dt><code>--libdir=\${exec_prefix}/lib64</code></dt>
+<dt><span><code>--libdir=\${exec_prefix}/lib64</code></span></dt>
<dd><p>May be needed for 64-bit bi-architecture (GNU/Linux) systems.
</p>
</dd>
@@ -1227,11 +1269,13 @@ has written a detailed article on adapting TL for distros:
article needs updating in the future, perhaps we will merge it into
this document.)
</p>
-
<hr>
-<span id="Layout-and-infrastructure"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Layout-and-infrastructure">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Layout-and-infrastructure-1"></span><h2 class="chapter">6 Layout and infrastructure</h2>
@@ -1244,24 +1288,18 @@ distributed by TL, as well as <code>configure</code> scripts and <code>make</cod
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">&bull; <a href="#Build-system-tools" accesskey="1">Build system tools</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Modifying infrastructure files.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Top_002dlevel-directories" accesskey="2">Top-level directories</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">libs texk utils; am auxdir build-aux m4; doc extra.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Autoconf-macros" accesskey="3">Autoconf macros</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">TL-specific Autoconf macros.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Library-modules" accesskey="4">Library modules</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Handling libraries, with examples.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Program-modules" accesskey="5">Program modules</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Handling programs, with examples.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Extending-TeX-Live" accesskey="6">Extending TeX&nbsp;Live</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Adding a new module.
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Build-system-tools" accesskey="1">Build system tools</a></li>
+<li><a href="#Top_002dlevel-directories" accesskey="2">Top-level directories</a></li>
+<li><a href="#Autoconf-macros" accesskey="3">Autoconf macros</a></li>
+<li><a href="#Library-modules" accesskey="4">Library modules</a></li>
+<li><a href="#Program-modules" accesskey="5">Program modules</a></li>
+<li><a href="#Extending-TeX-Live" accesskey="6">Extending TeX&nbsp;Live</a></li>
+</ul>
<hr>
-<span id="Build-system-tools"></span><div class="header">
+<div class="section" id="Build-system-tools">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1288,12 +1326,12 @@ may be.
<p>Currently the versions we use are:
</p>
<div class="display">
-<pre class="display">autoconf (GNU Autoconf) 2.69
-automake (GNU automake) 1.16.2
-bison (GNU Bison) 3.7.4
+<pre class="display">autoconf (GNU Autoconf) 2.71
+automake (GNU automake) 1.16.5
+bison (GNU Bison) 3.8.2
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
-m4 (GNU M4) 1.4.18
+m4 (GNU M4) 1.4.19
makeinfo (GNU texinfo) 6.7
</pre></div>
@@ -1328,9 +1366,10 @@ to <code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp>
<samp>config.h.in</samp> (or <samp>c-auto.in</samp>), and finally all
<samp>Makefile.in</samp> files.
</p>
-
<hr>
-<span id="Top_002dlevel-directories"></span><div class="header">
+</div>
+<div class="section" id="Top_002dlevel-directories">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1387,9 +1426,10 @@ These names (and everything else about <samp>Build</samp>&rsquo;s operation) can
be changed by setting environment variables before running it; see the
script source.
</p>
-
<hr>
-<span id="Autoconf-macros"></span><div class="header">
+</div>
+<div class="section" id="Autoconf-macros">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1405,23 +1445,18 @@ modules&mdash;many more are defined in the sources; see the top-level
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">&bull; <a href="#General-setup-macros" accesskey="1">Setup</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Macros-for-programs" accesskey="2">Programs</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Macros-for-compilers" accesskey="3">Compilers</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Macros-for-libraries" accesskey="4">Libraries</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Macros-for-library-and-header-flags" accesskey="5">Flags</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Macros-for-Windows" accesskey="6">Windows</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#General-setup-macros" accesskey="1">General setup macros</a></li>
+<li><a href="#Macros-for-programs" accesskey="2">Macros for programs</a></li>
+<li><a href="#Macros-for-compilers" accesskey="3">Macros for compilers</a></li>
+<li><a href="#Macros-for-libraries" accesskey="4">Macros for libraries</a></li>
+<li><a href="#Macros-for-library-and-header-flags" accesskey="5">Macros for library and header flags</a></li>
+<li><a href="#Macros-for-Windows" accesskey="6">Macros for Windows</a></li>
+</ul>
<hr>
-<span id="General-setup-macros"></span><div class="header">
+<div class="subsection" id="General-setup-macros">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1432,23 +1467,24 @@ Next: <a href="#Macros-for-programs" accesskey="n" rel="next">Macros for program
<span id="index-macros_002c-general-setup"></span>
<p>The TL sources use two general setup macros:
</p>
-<dl>
-<dt id="index-KPSE_005fBASIC">Macro: <strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
+<dl class="def">
+<dt id="index-KPSE_005fBASIC"><span class="category">Macro: </span><span><strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em><a href='#index-KPSE_005fBASIC' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Initialize the basic TL infrastructure for module <var>name</var>:<br>&nbsp;&nbsp;&nbsp;<code>AM_INIT_AUTOMAKE([foreign <var>more-options</var>])</code><br>&nbsp;&nbsp;&nbsp;<code>AM_MAINTAINER_MODE</code><br>&nbsp;&nbsp;&nbsp;<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 id="index-KPSE_005fCOMMON">Macro: <strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCOMMON"><span class="category">Macro: </span><span><strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em><a href='#index-KPSE_005fCOMMON' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Like <code>KPSE_BASIC</code> but add:<br>&nbsp;&nbsp;&nbsp;<code>LT_PREREQ([2.2.6])</code><br>&nbsp;&nbsp;&nbsp;<code>LT_INIT([win32-dll])</code><br>&nbsp;&nbsp;&nbsp;<code>AC_SYS_LARGEFILE</code><br>&nbsp;&nbsp;&nbsp;<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>
-<span id="Macros-for-programs"></span><div class="header">
+</div>
+<div class="subsection" id="Macros-for-programs">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1457,8 +1493,8 @@ Next: <a href="#Macros-for-compilers" accesskey="n" rel="next">Macros for compil
<span id="index-macros_002c-for-programs"></span>
<p>Macros for program checks:
</p>
-<dl>
-<dt id="index-KPSE_005fCHECK_005fLATEX">Macro: <strong>KPSE_CHECK_LATEX</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCHECK_005fLATEX"><span class="category">Macro: </span><span><strong>KPSE_CHECK_LATEX</strong><a href='#index-KPSE_005fCHECK_005fLATEX' class='copiable-anchor'> &para;</a></span></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
@@ -1466,25 +1502,26 @@ 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 id="index-KPSE_005fCHECK_005fPDFLATEX">Macro: <strong>KPSE_CHECK_PDFLATEX</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCHECK_005fPDFLATEX"><span class="category">Macro: </span><span><strong>KPSE_CHECK_PDFLATEX</strong><a href='#index-KPSE_005fCHECK_005fPDFLATEX' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Check for <code>pdflatex</code> in <code>PATH</code> and set <code>PDFLATEX</code>.
</p></dd></dl>
-<dl>
-<dt id="index-KPSE_005fCHECK_005fPERL">Macro: <strong>KPSE_CHECK_PERL</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCHECK_005fPERL"><span class="category">Macro: </span><span><strong>KPSE_CHECK_PERL</strong><a href='#index-KPSE_005fCHECK_005fPERL' class='copiable-anchor'> &para;</a></span></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 id="index-KPSE_005fPROG_005fLEX">Macro: <strong>KPSE_PROG_LEX</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fPROG_005fLEX"><span class="category">Macro: </span><span><strong>KPSE_PROG_LEX</strong><a href='#index-KPSE_005fPROG_005fLEX' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Call <code>AC_PROG_LEX</code> and add the flag <code>-l</code> for <code>flex</code>.
</p></dd></dl>
-
<hr>
-<span id="Macros-for-compilers"></span><div class="header">
+</div>
+<div class="subsection" id="Macros-for-compilers">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1494,8 +1531,8 @@ Next: <a href="#Macros-for-libraries" accesskey="n" rel="next">Macros for librar
<p>Macros for compiler-related checks:
</p>
-<dl>
-<dt id="index-KPSE_005fCOMPILER_005fWARNINGS">Macro: <strong>KPSE_COMPILER_WARNINGS</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCOMPILER_005fWARNINGS"><span class="category">Macro: </span><span><strong>KPSE_COMPILER_WARNINGS</strong><a href='#index-KPSE_005fCOMPILER_005fWARNINGS' class='copiable-anchor'> &para;</a></span></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
@@ -1508,8 +1545,8 @@ warning options, but could be extended to others if necessary.
&hellip; variables.
</p></dd></dl>
-<dl>
-<dt id="index-KPSE_005fCOMPILER_005fVISIBILITY">Macro: <strong>KPSE_COMPILER_VISIBILITY</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCOMPILER_005fVISIBILITY"><span class="category">Macro: </span><span><strong>KPSE_COMPILER_VISIBILITY</strong><a href='#index-KPSE_005fCOMPILER_005fVISIBILITY' class='copiable-anchor'> &para;</a></span></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 present this only tests for
@@ -1521,8 +1558,8 @@ extended if necessary.
or <code>kpse_cv_visibility_cxxflags</code> variable.
</p></dd></dl>
-<dl>
-<dt id="index-KPSE_005fCXX_005fHACK">Macro: <strong>KPSE_CXX_HACK</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCXX_005fHACK"><span class="category">Macro: </span><span><strong>KPSE_CXX_HACK</strong><a href='#index-KPSE_005fCXX_005fHACK' class='copiable-anchor'> &para;</a></span></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>
@@ -1536,9 +1573,10 @@ binary.
<p>This macro caches its result in the <code>kpse_cv_cxx_hack</code> variable.
</p></dd></dl>
-
<hr>
-<span id="Macros-for-libraries"></span><div class="header">
+</div>
+<div class="subsection" id="Macros-for-libraries">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1547,16 +1585,17 @@ Next: <a href="#Macros-for-library-and-header-flags" accesskey="n" rel="next">Ma
<span id="index-macros_002c-for-libraries"></span>
<p>One macro for a library check:
</p>
-<dl>
-<dt id="index-KPSE_005fLARGEFILE">Macro: <strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em></dt>
+<dl class="def">
+<dt id="index-KPSE_005fLARGEFILE"><span class="category">Macro: </span><span><strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em><a href='#index-KPSE_005fLARGEFILE' class='copiable-anchor'> &para;</a></span></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>.
</p></dd></dl>
-
<hr>
-<span id="Macros-for-library-and-header-flags"></span><div class="header">
+</div>
+<div class="subsection" id="Macros-for-library-and-header-flags">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1570,8 +1609,8 @@ 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 id="index-KPSE_005fLIBPNG_005fFLAGS">Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fLIBPNG_005fFLAGS"><span class="category">Macro: </span><span><strong>KPSE_LIBPNG_FLAGS</strong><a href='#index-KPSE_005fLIBPNG_005fFLAGS' class='copiable-anchor'> &para;</a></span></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&nbsp;Live tree):
@@ -1584,14 +1623,14 @@ an installed version or from the TeX&nbsp;Live tree):
</table>
</dd></dl>
-<dl>
-<dt id="index-KPSE_005fADD_005fFLAGS">Macro: <strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em></dt>
+<dl class="def">
+<dt id="index-KPSE_005fADD_005fFLAGS"><span class="category">Macro: </span><span><strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em><a href='#index-KPSE_005fADD_005fFLAGS' class='copiable-anchor'> &para;</a></span></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 id="index-KPSE_005fRESTORE_005fFLAGS">Macro: <strong>KPSE_RESTORE_FLAGS</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fRESTORE_005fFLAGS"><span class="category">Macro: </span><span><strong>KPSE_RESTORE_FLAGS</strong><a href='#index-KPSE_005fRESTORE_005fFLAGS' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Restore <code>CPPFLAGS</code> and <code>LIBS</code> to their original values.
</p></dd></dl>
@@ -1626,9 +1665,10 @@ KPSE_ADD_FLAGS([libpng])
KPSE_RESTORE_FLAGS # <span class="roman">restore <code>CPPFLAGS</code> and <code>LIBS</code></span>
</pre></div>
-
<hr>
-<span id="Macros-for-Windows"></span><div class="header">
+</div>
+<div class="subsection" id="Macros-for-Windows">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1639,8 +1679,8 @@ Previous: <a href="#Macros-for-library-and-header-flags" accesskey="p" rel="prev
<p>Windows differs in several aspects from Unix-like systems, many of
them due to the lack of symbolic links.
</p>
-<dl>
-<dt id="index-KPSE_005fCHECK_005fWIN32">Macro: <strong>KPSE_CHECK_WIN32</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCHECK_005fWIN32"><span class="category">Macro: </span><span><strong>KPSE_CHECK_WIN32</strong><a href='#index-KPSE_005fCHECK_005fWIN32' class='copiable-anchor'> &para;</a></span></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
@@ -1648,24 +1688,24 @@ 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 id="index-KPSE_005fCOND_005fWIN32">Macro: <strong>KPSE_COND_WIN32</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCOND_005fWIN32"><span class="category">Macro: </span><span><strong>KPSE_COND_WIN32</strong><a href='#index-KPSE_005fCOND_005fWIN32' class='copiable-anchor'> &para;</a></span></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 id="index-KPSE_005fCOND_005fMINGW32">Macro: <strong>KPSE_COND_MINGW32</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCOND_005fMINGW32"><span class="category">Macro: </span><span><strong>KPSE_COND_MINGW32</strong><a href='#index-KPSE_005fCOND_005fMINGW32' class='copiable-anchor'> &para;</a></span></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 id="index-KPSE_005fCOND_005fWIN32_005fWRAP">Macro: <strong>KPSE_COND_WIN32_WRAP</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fCOND_005fWIN32_005fWRAP"><span class="category">Macro: </span><span><strong>KPSE_COND_WIN32_WRAP</strong><a href='#index-KPSE_005fCOND_005fWIN32_005fWRAP' class='copiable-anchor'> &para;</a></span></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
@@ -1675,8 +1715,8 @@ is used on Windows instead of symlinks for the &ldquo;linked scripts&rdquo;
(see <a href="#Linked-scripts">Linked scripts</a>).
</p></dd></dl>
-<dl>
-<dt id="index-KPSE_005fWIN32_005fCALL">Macro: <strong>KPSE_WIN32_CALL</strong></dt>
+<dl class="def">
+<dt id="index-KPSE_005fWIN32_005fCALL"><span class="category">Macro: </span><span><strong>KPSE_WIN32_CALL</strong><a href='#index-KPSE_005fWIN32_005fCALL' class='copiable-anchor'> &para;</a></span></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
@@ -1686,9 +1726,11 @@ as <code><var>bar</var>.exe</code> is used on Windows instead of a symlink
<code><var>bar</var>-&gt;<var>foo</var></code> for Unix-like systems.
</p></dd></dl>
-
<hr>
-<span id="Library-modules"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Library-modules">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1700,21 +1742,18 @@ Next: <a href="#Program-modules" accesskey="n" rel="next">Program modules</a>, P
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">&bull; <a href="#png-library" accesskey="1"><code>png</code> library</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>libs/libpng</samp>
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#zlib-library" accesskey="2"><code>zlib</code> library</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>libs/zlib</samp>
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#freetype-library" accesskey="3"><code>freetype</code> library</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>libs/freetype2</samp>
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#kpathsea-library" accesskey="4"><code>kpathsea</code> library</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>texk/kpathsea</samp>
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#png-library" accesskey="1">The <code>png</code> library in <samp>libs/libpng</samp></a></li>
+<li><a href="#zlib-library" accesskey="2">The <code>zlib</code> library in <samp>libs/zlib</samp></a></li>
+<li><a href="#freetype-library" accesskey="3">The <code>freetype</code> library in <samp>libs/freetype2</samp></a></li>
+<li><a href="#kpathsea-library" accesskey="4">The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a></li>
+</ul>
<hr>
-<span id="png-library"></span><div class="header">
+<div class="subsection" id="png-library">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#zlib-library" accesskey="n" rel="next">The <code>zlib</code> library in <samp>libs/zlib</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-png-library-in-libs_002flibpng"></span><h4 class="subsection">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></h4>
@@ -1786,11 +1825,12 @@ for the <code>make</code> rules to rebuild the library.
<code>--with-system-libpng</code>, which then uses <code>pkg-config</code> to
determine the flags required for the system library.
</p>
-
<hr>
-<span id="zlib-library"></span><div class="header">
+</div>
+<div class="subsection" id="zlib-library">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#freetype-library" accesskey="n" rel="next">The <code>freetype</code> library in <samp>libs/freetype2</samp></a>, Previous: <a href="#png-library" accesskey="p" rel="prev">The <code>png</code> library in <samp>libs/libpng</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-zlib-library-in-libs_002fzlib"></span><h4 class="subsection">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></h4>
@@ -1804,11 +1844,12 @@ without the dependency on any other library. The file
<code>--with-zlib-libdir</code> to specify non-standard locations of the
<code>zlib</code> headers and/or library.
</p>
-
<hr>
-<span id="freetype-library"></span><div class="header">
+</div>
+<div class="subsection" id="freetype-library">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#kpathsea-library" accesskey="n" rel="next">The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a>, Previous: <a href="#zlib-library" accesskey="p" rel="prev">The <code>zlib</code> library in <samp>libs/zlib</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-freetype-library-in-libs_002ffreetype2"></span><h4 class="subsection">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></h4>
@@ -1827,18 +1868,19 @@ other words, this actually uses the build system provided by upstream
<p>The flags required for the system library are obtained through
<code>freetype-config</code>.
</p>
-
<hr>
-<span id="kpathsea-library"></span><div class="header">
+</div>
+<div class="subsection" id="kpathsea-library">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#freetype-library" accesskey="p" rel="prev">The <code>freetype</code> library in <samp>libs/freetype2</samp></a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-kpathsea-library-in-texk_002fkpathsea"></span><h4 class="subsection">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></h4>
<span id="index-kpathsea-library"></span>
<p>This is one of the TeX-specific libraries that are maintained as
-part of TeX&nbsp;Live (see <cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea
+part of TeX&nbsp;Live (see <cite><a data-manual="kpathsea" 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
@@ -1866,9 +1908,11 @@ however, the command line options <code>-mktex=tfm</code> or
<code>-no-mktex=tfm</code> for the TeX-like engines override this
default.
</p>
-
<hr>
-<span id="Program-modules"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Program-modules">
+<div class="header">
<p>
Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX&nbsp;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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -1879,22 +1923,18 @@ Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX&nbsp;
<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">&bull; <a href="#t1utils-package" accesskey="1"><code>t1utils</code> package</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>utils/t1utils</samp>
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#xindy-package" accesskey="2"><code>xindy</code> package</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>utils/xindy</samp>
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#xdvik-package" accesskey="3"><code>xdvik</code> package</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>texk/xdvik</samp>
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#asymptote" accesskey="4"><code>asymptote</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><samp>utils/asymptote</samp>
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#t1utils-package" accesskey="1">The <code>t1utils</code> package in <samp>utils/t1utils</samp></a></li>
+<li><a href="#xindy-package" accesskey="2">The <code>xindy</code> package in <samp>utils/xindy</samp></a></li>
+<li><a href="#xdvik-package" accesskey="3">The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li>
+<li><a href="#asymptote" accesskey="4">The subdirectory <samp>utils/asymptote</samp></a></li>
+</ul>
<hr>
-<span id="t1utils-package"></span><div class="header">
+<div class="subsection" id="t1utils-package">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#xindy-package" accesskey="n" rel="next">The <code>xindy</code> package in <samp>utils/xindy</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-t1utils-package-in-utils_002ft1utils"></span><h4 class="subsection">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></h4>
@@ -1912,11 +1952,12 @@ fragment <samp>ac/withenable.ac</samp> contains
<p>specifying the module name without any dependencies, and
supplies the configure option <code>--disable-t1utils</code>.
</p>
-
<hr>
-<span id="xindy-package"></span><div class="header">
+</div>
+<div class="subsection" id="xindy-package">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#xdvik-package" accesskey="n" rel="next">The <code>xdvik</code> package in <samp>texk/xdvik</samp></a>, Previous: <a href="#t1utils-package" accesskey="p" rel="prev">The <code>t1utils</code> package in <samp>utils/t1utils</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-xindy-package-in-utils_002fxindy"></span><h4 class="subsection">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></h4>
@@ -1928,7 +1969,7 @@ modifications documented in <samp>TLpatches/*</samp>, and a wrapper
<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>VPATH</code> build, can handle all targets, and does not refer to
<code>${top_srcdir}</code> or <code>${top_builddir}</code>. The fragment
<code>xindy/ac/withenable.ac</code> contains
</p>
@@ -1947,11 +1988,12 @@ too painful to enable by default).
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>
-<span id="xdvik-package"></span><div class="header">
+</div>
+<div class="subsection" id="xdvik-package">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#asymptote" accesskey="n" rel="next">The subdirectory <samp>utils/asymptote</samp></a>, Previous: <a href="#xindy-package" accesskey="p" rel="prev">The <code>xindy</code> package in <samp>utils/xindy</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-xdvik-package-in-texk_002fxdvik"></span><h4 class="subsection">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></h4>
@@ -1982,11 +2024,12 @@ auxiliary program <samp>squeeze/squeeze</samp> has to run on the
<samp>configure.ac</samp> and supplies the configure option
<code>--with-xdvi-x-toolkit</code> also seen at the top level.
</p>
-
<hr>
-<span id="asymptote"></span><div class="header">
+</div>
+<div class="subsection" id="asymptote">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#xdvik-package" accesskey="p" rel="prev">The <code>xdvik</code> package in <samp>texk/xdvik</samp></a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="The-subdirectory-utils_002fasymptote"></span><h4 class="subsection">6.5.4 The subdirectory <samp>utils/asymptote</samp></h4>
@@ -2000,9 +2043,11 @@ 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. See <a href="https://tug.org/build.html#asymptote">https://tug.org/build.html#asymptote</a>.
</p>
-
<hr>
-<span id="Extending-TeX-Live"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Extending-TeX-Live">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2022,20 +2067,18 @@ 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">&bull; <a href="#Adding-a-new-program-module" accesskey="1">Adding a new program module</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Adding-a-new-generic-library-module" accesskey="2">Adding a new generic library module</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="3">Adding a new TeX-specific library module</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Adding-a-new-program-module" accesskey="1">Adding a new program module</a></li>
+<li><a href="#Adding-a-new-engine" accesskey="2">Adding a new engine</a></li>
+<li><a href="#Adding-a-new-generic-library-module" accesskey="3">Adding a new generic library module</a></li>
+<li><a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="4">Adding a new TeX-specific library module</a></li>
+</ul>
<hr>
-<span id="Adding-a-new-program-module"></span><div class="header">
+<div class="subsection" id="Adding-a-new-program-module">
+<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&nbsp;Live</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Adding-a-new-engine" accesskey="n" rel="next">Adding a new engine</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX&nbsp;Live</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Adding-a-new-program-module-1"></span><h4 class="subsection">6.6.1 Adding a new program module</h4>
@@ -2092,18 +2135,12 @@ source files in <code>...-src</code>.
TL source directory (<samp>texk/newprog</samp> or <samp>utils/newprog</samp>):
</p>
<dl compact="compact">
-<dt><samp>ac/withenable.ac</samp>
-<span id="index-ac_002fwithenable_002eac"></span>
-</dt>
+<dt id='index-ac_002fwithenable_002eac'><span><samp>ac/withenable.ac</samp><a href='#index-ac_002fwithenable_002eac' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>The <code>KPSE_ENABLE_PROG</code> call just explained.
</p>
</dd>
-<dt><samp>configure.ac</samp>
-<span id="index-configure_002eac"></span>
-</dt>
-<dt><samp>Makefile.am</samp>
-<span id="index-Makefile_002eam"></span>
-</dt>
+<dt id='index-configure_002eac'><span><samp>configure.ac</samp><a href='#index-configure_002eac' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-Makefile_002eam'><span><samp>Makefile.am</samp><a href='#index-Makefile_002eam' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>By merging the contents of the original <samp>configure.ac</samp> (if
provided) and a comparable program already in TL. In the above
example, one line that will be needed in <samp>configure.ac</samp> (can be
@@ -2125,24 +2162,18 @@ investigate how something is done. Most of the TL-specific macros are
defined in <samp>Build/source/m4/*</samp>.
</p>
</dd>
-<dt><samp>TLpatches/TL-Changes</samp>
-<span id="index-TLpatches_002fTL_002dChanges"></span>
-</dt>
+<dt id='index-TLpatches_002fTL_002dChanges'><span><samp>TLpatches/TL-Changes</samp><a href='#index-TLpatches_002fTL_002dChanges' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>First actions taken after getting the original source tree; typically
removal of derived or unused common files.
</p>
</dd>
-<dt><samp>TLpatches/patch-...</samp>
-<span id="index-TLpatches_002fpatch_002d_002e_002e_002e"></span>
-</dt>
+<dt id='index-TLpatches_002fpatch_002d_002e_002e_002e'><span><samp>TLpatches/patch-...</samp><a href='#index-TLpatches_002fpatch_002d_002e_002e_002e' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>If any changes are needed to the original sources, record the patches
here so they can be applied next time. Also, send them upstream so
that we don&rsquo;t have to maintain them forever.
</p>
</dd>
-<dt><samp>ChangeLog</samp>
-<span id="index-ChangeLog"></span>
-</dt>
+<dt id='index-ChangeLog'><span><samp>ChangeLog</samp><a href='#index-ChangeLog' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Record all TL-specific changes, now and in the future.
</p>
</dd>
@@ -2179,21 +2210,61 @@ builds from scratch.
<p>After final success, don&rsquo;t forget to commit. (Or email the TL
maintainers with the patch.)
</p>
+<hr>
+</div>
+<div class="subsection" id="Adding-a-new-engine">
+<div class="header">
+<p>
+Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic 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&nbsp;Live</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Adding-a-new-engine-1"></span><h4 class="subsection">6.6.2 Adding a new engine</h4>
+
+<span id="index-adding-a-new-engine"></span>
<span id="index-engine_002c-adding-new"></span>
-<p>Caveat: adding a new TeX engine is not completely different, but
-it&rsquo;s not all that similar, either. In that case, the work is done
-inside a new subdirectory of <samp>texk/web2c/</samp>. Many things are
-common to all the engines, other things need to be copied and possibly
-modified for each one, yet others are unique to each. No general
-recipe is possible.
-</p>
+<p>Adding a new TeX engine is not completely different from adding a
+program, but it&rsquo;s not all that similar, either. In this case, the main
+work is done by creating a new subdirectory of <samp>texk/web2c/</samp> for
+the engine. The subdirectory is conventionally named ending in
+<samp>dir</samp>, like <samp>pdftexdir</samp> and <samp>xetexdir</samp>, to avoid
+clashes with executable names.
+</p>
+<p>The source files for the new engine should be put in this
+<samp><var>newengine</var>dir</samp> subdirectory. Also, a file
+<samp><var>newengine</var>dir/am/<var>newengine</var>.am</samp> (e.g.,
+<samp>pdftexdir/am/pdftex.am</samp> is needed with the Makefile fragment
+needed to build it.
+</p>
+<p>The overall <samp>web2c/Makefile.am</samp> needs to have an <samp>include</samp>
+statement added to insert that <samp><var>newengine</var>.am</samp> file.
+</p>
+<p>In <samp>web2c/ac/web2c.ac</samp>, a line needs to be added in the
+definition of the <code>kpse_tex_progs</code> variable to include it in the
+build. That line specifies whether the new engine is built by default,
+and the additional libraries requires.
+</p>
+<p>For examples of building engines in CWEB, you can check the existing
+<samp>hitexdir</samp> and <samp>mplibdir</samp> directories; these are somewhat
+simpler than LuaTeX. Of course, every engine will have its own
+unique features and requirements, so existing examples will only take
+you so far.
+</p>
+<p>Web2c is built as one &ldquo;package&rdquo;, with each subdirectory&rsquo;s <samp>.am</samp>
+fragment inserted with an Automake <code>include</code>. This means that,
+for instance, <code>$(srcdir)</code> is <samp>.../web2c</samp>, not
+<samp>.../webdir/enginedir</samp>. It is a difficult setup to come to terms
+with, but the alternative is to recurse into each engine subdirectory,
+and that would be far worse (see <a data-manual="automake" href="https://www.gnu.org/software/automake/manual/automake.html#Directories">Directories</a> in <cite>GNU
+Automake</cite>).
+</p>
<hr>
-<span id="Adding-a-new-generic-library-module"></span><div class="header">
+</div>
+<div class="subsection" id="Adding-a-new-generic-library-module">
+<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&nbsp;Live</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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-engine" accesskey="p" rel="prev">Adding a new engine</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX&nbsp;Live</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Adding-a-new-generic-library-module-1"></span><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.3 Adding a new generic library module</h4>
<span id="index-adding-a-new-generic-library"></span>
<span id="index-generic-library-module_002c-adding"></span>
@@ -2246,13 +2317,14 @@ 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>&nbsp;&nbsp;&nbsp;<code>AC_REQUIRE([KPSE_<var>LIB</var>_SYSTEM_FLAGS])</code>
</p>
-
<hr>
-<span id="Adding-a-new-TeX_002dspecific-library-module"></span><div class="header">
+</div>
+<div class="subsection" id="Adding-a-new-TeX_002dspecific-library-module">
+<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&nbsp;Live</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Adding-a-new-TeX_002dspecific-library-module-1"></span><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.4 Adding a new TeX-specific library module</h4>
<span id="index-adding-a-new-TeX_002dspecific-library"></span>
<span id="index-TeX_002dspecific-library-module_002c-adding"></span>
@@ -2273,11 +2345,14 @@ The library name <code><var>lib</var></code> is added to the M4 macro
The fragment <code>ac/withenable.ac</code> must use <code>KPSE_WITH_TEXLIB</code>.
</li></ul>
-
<hr>
-<span id="Configure-options"></span><div class="header">
+</div>
+</div>
+</div>
+<div class="chapter" id="Configure-options">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Configure-options-1"></span><h2 class="chapter">7 Configure options</h2>
@@ -2306,20 +2381,16 @@ actual <code>configure</code> script; invoking <code>configure</code> via
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">&bull; <a href="#Global-configure-options" accesskey="1">Global configure options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Program_002dspecific-configure-options" accesskey="2">Program-specific configure options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Library_002dspecific-configure-options" accesskey="3">Library-specific configure options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Variables-for-configure" accesskey="4">Variables for configure</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Global-configure-options" accesskey="1">Global configure options</a></li>
+<li><a href="#Program_002dspecific-configure-options" accesskey="2">Program-specific configure options</a></li>
+<li><a href="#Library_002dspecific-configure-options" accesskey="3">Library-specific configure options</a></li>
+<li><a href="#Variables-for-configure" accesskey="4">Variables for configure</a></li>
+</ul>
<hr>
-<span id="Global-configure-options"></span><div class="header">
+<div class="section" id="Global-configure-options">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2329,38 +2400,26 @@ Next: <a href="#Program_002dspecific-configure-options" accesskey="n" rel="next"
<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">&bull; <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="1"><code>--disable-native-texlive-build</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="2"><code>--prefix</code> <code>--bindir</code> &hellip;</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="3"><code>--disable-largefile</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002ddisable_002dmissing" accesskey="4"><code>--disable-missing</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="5"><code>--enable-compiler-warnings=</code><var>level</var></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="6"><code>--enable-cxx-runtime-hack</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="7"><code>--enable-maintainer-mode</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="8"><code>--enable-multiplatform</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002denable_002dshared" accesskey="9"><code>--enable-shared</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002dwithout_002dx"><code>--without-x</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="1"><code>--disable-native-texlive-build</code></a></li>
+<li><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="2"><code>--prefix</code>, <code>--bindir</code>, &hellip;</a></li>
+<li><a href="#g_t_002d_002ddisable_002dlargefile" accesskey="3"><code>--disable-largefile</code></a></li>
+<li><a href="#g_t_002d_002ddisable_002dmissing" accesskey="4"><code>--disable-missing</code></a></li>
+<li><a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="5"><code>--enable-compiler-warnings=</code><var>level</var></a></li>
+<li><a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="6"><code>--enable-cxx-runtime-hack</code></a></li>
+<li><a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="7"><code>--enable-maintainer-mode</code></a></li>
+<li><a href="#g_t_002d_002denable_002dmultiplatform" accesskey="8"><code>--enable-multiplatform</code></a></li>
+<li><a href="#g_t_002d_002denable_002dshared" accesskey="9"><code>--enable-shared</code></a></li>
+<li><a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></li>
+<li><a href="#g_t_002d_002dwithout_002dln_002ds"><code>--without-ln-s</code></a></li>
+<li><a href="#g_t_002d_002dwithout_002dx"><code>--without-x</code></a></li>
+</ul>
<hr>
-<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"></span><div class="header">
+<div class="subsection" id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">
+<div class="header">
<p>
-Next: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="n" rel="next"><code>--prefix</code> <code>--bindir</code> &hellip;</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="n" rel="next"><code>--prefix</code>, <code>--bindir</code>, &hellip;</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild-1"></span><h4 class="subsection">7.1.1 <code>--disable-native-texlive-build</code></h4>
@@ -2383,9 +2442,10 @@ that can also be built independently from the TL tree (such as
use this option to enable TL-specific adaptations, such as
installation paths.
</p>
-
<hr>
-<span id="g_t_002d_002dprefix-_002d_002dbindir-_2026"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002dprefix-_002d_002dbindir-_2026">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2398,13 +2458,14 @@ directories as usual. For the complete list, see <a href="#Installation-directo
</p>
<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="https://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 data-manual="automake" 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>
-<span id="g_t_002d_002ddisable_002dlargefile"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002ddisable_002dlargefile">
+<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> &hellip;</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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>, &hellip;</a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_002d_002ddisable_002dlargefile-1"></span><h4 class="subsection">7.1.3 <code>--disable-largefile</code></h4>
@@ -2413,7 +2474,7 @@ Next: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="n" rel="next"><code
<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>&lt;2</em>GB, due
+size of <code>DVI</code> and <code>GF</code> files must always be <em class='math'>&lt;2</em>GB, due
to the file format specifications.
</p>
<span id="index-size-of-PDF-and-PS-files"></span>
@@ -2422,9 +2483,10 @@ to the file format specifications.
<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>.
</p>
-
<hr>
-<span id="g_t_002d_002ddisable_002dmissing"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002ddisable_002dmissing">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2435,9 +2497,10 @@ Next: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accessk
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>
-<span id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2452,9 +2515,10 @@ 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>
-<span id="g_t_002d_002denable_002dcxx_002druntime_002dhack"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002denable_002dcxx_002druntime_002dhack">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2464,9 +2528,10 @@ Next: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="n" rel="
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>
-<span id="g_t_002d_002denable_002dmaintainer_002dmode"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002denable_002dmaintainer_002dmode">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2476,11 +2541,12 @@ Next: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="n" rel="next">
<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="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>.
+rebuilds infrastructure files as needed. See <a data-manual="automake" 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>
-<span id="g_t_002d_002denable_002dmultiplatform"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002denable_002dmultiplatform">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2499,9 +2565,10 @@ implied for <code>exec_prefix</code>. In any case, the values for
<code>bindir</code> and <code>libdir</code> are automatically propagated to all
subdirectories.
</p>
-
<hr>
-<span id="g_t_002d_002denable_002dshared"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002denable_002dshared">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2512,9 +2579,10 @@ Next: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="n" rel="nex
<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>
-<span id="g_t_002d_002denable_002dsilent_002drules"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002denable_002dsilent_002drules">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2528,9 +2596,10 @@ 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>
-<span id="g_t_002d_002dwithout_002dln_002ds"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002dwithout_002dln_002ds">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2541,9 +2610,10 @@ Next: <a href="#g_t_002d_002dwithout_002dx" accesskey="n" rel="next"><code>--wit
binaries for a Unix-like system. However, <code>make install</code> will
not create anything useful, and might fail.
</p>
-
<hr>
-<span id="g_t_002d_002dwithout_002dx"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002dwithout_002dx">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2552,9 +2622,11 @@ Previous: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="p" rel="prev">
<span id="index-_002d_002dwithout_002dx"></span>
<p>Disable all programs using the X Window System.
</p>
-
<hr>
-<span id="Program_002dspecific-configure-options"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Program_002dspecific-configure-options">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2564,30 +2636,21 @@ Next: <a href="#Library_002dspecific-configure-options" accesskey="n" rel="next"
<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">&bull; <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>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="2"><code>--disable-all-pkgs</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-texk_002fweb2c" accesskey="3">Configure options for <samp>texk/web2c</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="4">Configure options for <samp>texk/bibtex-x</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="5">Configure options for <samp>texk/dvipdfm-x</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="6">Configure options for <samp>texk/dvisvgm</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-texk_002ftexlive" accesskey="7">Configure options for <samp>texk/texlive</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-texk_002fxdvik" accesskey="8">Configure options for <samp>texk/xdvik</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-utils_002fxindy" accesskey="9">Configure options for <samp>utils/xindy</samp></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><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></li>
+<li><a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="2"><code>--disable-all-pkgs</code></a></li>
+<li><a href="#Configure-options-for-texk_002fweb2c" accesskey="3">Configure options for <samp>texk/web2c</samp></a></li>
+<li><a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="4">Configure options for <samp>texk/bibtex-x</samp></a></li>
+<li><a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="5">Configure options for <samp>texk/dvipdfm-x</samp></a></li>
+<li><a href="#Configure-options-for-texk_002fdvisvgm" accesskey="6">Configure options for <samp>texk/dvisvgm</samp></a></li>
+<li><a href="#Configure-options-for-texk_002ftexlive" accesskey="7">Configure options for <samp>texk/texlive</samp></a></li>
+<li><a href="#Configure-options-for-texk_002fxdvik" accesskey="8">Configure options for <samp>texk/xdvik</samp></a></li>
+<li><a href="#Configure-options-for-utils_002fxindy" accesskey="9">Configure options for <samp>utils/xindy</samp></a></li>
+</ul>
<hr>
-<span id="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"></span><div class="header">
+<div class="subsection" id="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2597,11 +2660,12 @@ Next: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="n" rel="next">
<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>
-<span id="g_t_002d_002ddisable_002dall_002dpkgs"></span><div class="header">
+</div>
+<div class="subsection" id="g_t_002d_002ddisable_002dall_002dpkgs">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_002d_002ddisable_002dall_002dpkgs-1"></span><h4 class="subsection">7.2.2 <code>--disable-all-pkgs</code></h4>
@@ -2617,9 +2681,10 @@ interested in, and its dependencies, are built. See <a href="#Build-one-package
explicitly disabled or specify <code>disable</code> in their
<samp>ac/withenable.ac</samp> fragment.
</p>
-
<hr>
-<span id="Configure-options-for-texk_002fweb2c"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-texk_002fweb2c">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2718,9 +2783,10 @@ support; ignored for a native TeX&nbsp;Live build. Defaults are defined in
<p><code>--disable-synctex</code>
<br>Do not build the <code>SyncTeX</code> library and tool.
</p>
-
<hr>
-<span id="Configure-options-for-texk_002fbibtex_002dx"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-texk_002fbibtex_002dx">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2740,9 +2806,10 @@ module <code>bibtex-x</code> (extended BibTeX).
<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>
-<span id="Configure-options-for-texk_002fdvipdfm_002dx"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-texk_002fdvipdfm_002dx">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2768,9 +2835,10 @@ program or make the <samp>dvipdfm</samp> symlink.
<p><code>--disable-xdvipdfmx</code><br>Do not build the <samp>xdvipdfmx</samp>
program.
</p>
-
<hr>
-<span id="Configure-options-for-texk_002fdvisvgm"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-texk_002fdvisvgm">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2796,9 +2864,10 @@ incompatibilities, e.g., on CentOS 5.
<code>--with-libgs-libdir=<var>dir</var></code><br>Specify non-standard locations
of the Ghostscript headers and library.
</p>
-
<hr>
-<span id="Configure-options-for-texk_002ftexlive"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-texk_002ftexlive">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2810,9 +2879,10 @@ Next: <a href="#Configure-options-for-texk_002fxdvik" accesskey="n" rel="next">C
scripts&rdquo; (see <a href="#Linked-scripts">Linked scripts</a>), except for the TL scripts required
to run <code>texlinks</code>.
</p>
-
<hr>
-<span id="Configure-options-for-texk_002fxdvik"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-texk_002fxdvik">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2839,9 +2909,10 @@ neXtaw</code>. The default is <code>motif</code> if available, else <code>xaw</
<p><code>--enable-xi2-scrolling</code><br>Use XInput 2.1 &ldquo;smooth scrolling&rdquo;
if available (default: yes, except for a native TL build).
</p>
-
<hr>
-<span id="Configure-options-for-utils_002fxindy"></span><div class="header">
+</div>
+<div class="subsection" id="Configure-options-for-utils_002fxindy">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2870,9 +2941,11 @@ 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>
-<span id="Library_002dspecific-configure-options"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Library_002dspecific-configure-options">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2900,13 +2973,13 @@ the required flags.
<p>The top-level <samp>configure</samp> script performs a consistency check for all
required system libraries and bails out if tests fail.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-kpathsea" accesskey="1">Configure options for <code>kpathsea</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#Configure-options-for-kpathsea" accesskey="1">Configure options for <code>kpathsea</code></a></li>
+</ul>
<hr>
-<span id="Configure-options-for-kpathsea"></span><div class="header">
+<div class="subsection" id="Configure-options-for-kpathsea">
+<div class="header">
<p>
Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Library-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2918,35 +2991,38 @@ Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Lib
<code>--disable-<var>cmd</var>-default</code><br>Determine the compile time default
for whether or not to run <var>cmd</var>, which is one of:
</p><dl compact="compact">
-<dt><code>mkocp</code></dt>
+<dt><span><code>mkocp</code></span></dt>
<dd><p>(Omega compiled translation process file)
</p></dd>
-<dt><code>mkofm</code></dt>
+<dt><span><code>mkofm</code></span></dt>
<dd><p>(Omega font metrics file)
</p></dd>
-<dt><code>mktexfmt</code></dt>
+<dt><span><code>mktexfmt</code></span></dt>
<dd><p>(format/base dump file)
</p></dd>
-<dt><code>mktexmf</code></dt>
+<dt><span><code>mktexmf</code></span></dt>
<dd><p>(Metafont source)
</p></dd>
-<dt><code>mktexpk</code></dt>
+<dt><span><code>mktexpk</code></span></dt>
<dd><p>(PK bitmap font)
</p></dd>
-<dt><code>mktextex</code></dt>
+<dt><span><code>mktextex</code></span></dt>
<dd><p>(TeX source)
</p></dd>
-<dt><code>mktextfm</code></dt>
+<dt><span><code>mktextfm</code></span></dt>
<dd><p>(TFM file)
</p></dd>
</dl>
<p>to generate the specified type of file dynamically.
The default can be overridden by the user in any case
-(see <a href="#kpathsea-library"><code>kpathsea</code> library</a>).
+(see <a href="#kpathsea-library">The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a>).
</p>
<hr>
-<span id="Variables-for-configure"></span><div class="header">
+</div>
+</div>
+<div class="section" id="Variables-for-configure">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -2961,37 +3037,23 @@ defined in the environment, but that might not work for cross
compilations.
</p>
<dl compact="compact">
-<dt><code>CC</code>
-<span id="index-CC"></span>
-</dt>
-<dt><code>CXX</code>
-<span id="index-CXX"></span>
-</dt>
-<dt><code>CPPFLAGS</code>
-<span id="index-CPPFLAGS"></span>
-</dt>
+<dt id='index-CC'><span><code>CC</code><a href='#index-CC' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-CXX'><span><code>CXX</code><a href='#index-CXX' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-CPPFLAGS'><span><code>CPPFLAGS</code><a href='#index-CPPFLAGS' class='copiable-anchor'> &para;</a></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="https://www.gnu.org/software/autoconf/manual/autoconf.html#Preset-Output-Variables">Preset Output Variables</a> in <cite>GNU Autoconf</cite>.
+See <a data-manual="autoconf" 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>
-<span id="index-CLISP-1"></span>
-</dt>
+<dt id='index-CLISP-1'><span><code>CLISP</code><a href='#index-CLISP-1' class='copiable-anchor'> &para;</a></span></dt>
<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>
-<span id="index-FT2_005fCONFIG"></span>
-</dt>
-<dt><code>ICU_CONFIG</code>
-<span id="index-ICU_005fCONFIG"></span>
-</dt>
-<dt><code>PKG_CONFIG</code>
-<span id="index-PKG_005fCONFIG"></span>
-</dt>
+<dt id='index-FT2_005fCONFIG'><span><code>FT2_CONFIG</code><a href='#index-FT2_005fCONFIG' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-ICU_005fCONFIG'><span><code>ICU_CONFIG</code><a href='#index-ICU_005fCONFIG' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-PKG_005fCONFIG'><span><code>PKG_CONFIG</code><a href='#index-PKG_005fCONFIG' class='copiable-anchor'> &para;</a></span></dt>
<dd><span id="index-freetype_002dconfig-1"></span>
<span id="index-icu_002dconfig"></span>
<span id="index-libfreetype"></span>
@@ -3002,45 +3064,35 @@ flags required for system versions of <samp>libfreetype</samp>, the ICU
libraries, and other libraries, respectively.
</p>
</dd>
-<dt><code>KPSEWHICH</code>
-<span id="index-KPSEWHICH"></span>
-</dt>
+<dt id='index-KPSEWHICH'><span><code>KPSEWHICH</code><a href='#index-KPSEWHICH' class='copiable-anchor'> &para;</a></span></dt>
<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>
-<span id="index-MAKE"></span>
-</dt>
-<dt><code>SED</code>
-<span id="index-SED"></span>
-</dt>
+<dt id='index-MAKE'><span><code>MAKE</code><a href='#index-MAKE' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-SED'><span><code>SED</code><a href='#index-SED' class='copiable-anchor'> &para;</a></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>
-<span id="index-PERL"></span>
-</dt>
-<dt><code>LATEX</code>
-<span id="index-LATEX"></span>
-</dt>
-<dt><code>PDFLATEX</code>
-<span id="index-PDFLATEX"></span>
-</dt>
+<dt id='index-PERL'><span><code>PERL</code><a href='#index-PERL' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-LATEX'><span><code>LATEX</code><a href='#index-LATEX' class='copiable-anchor'> &para;</a></span></dt>
+<dt id='index-PDFLATEX'><span><code>PDFLATEX</code><a href='#index-PDFLATEX' class='copiable-anchor'> &para;</a></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.
</p>
</dd>
</dl>
-
<hr>
-<span id="Coding-conventions"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Coding-conventions">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Coding-conventions-1"></span><h2 class="chapter">8 Coding conventions</h2>
@@ -3056,16 +3108,14 @@ functions or variables and the use of <code>const</code>. These rules
should be applied to the code maintained in the TeX&nbsp;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">&bull; <a href="#Declarations-and-definitions" accesskey="1">Declarations and definitions</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Const" accesskey="2">Const</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Declarations-and-definitions" accesskey="1">Declarations and definitions</a></li>
+<li><a href="#Const" accesskey="2">Const</a></li>
+</ul>
<hr>
-<span id="Declarations-and-definitions"></span><div class="header">
+<div class="section" id="Declarations-and-definitions">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3134,7 +3184,9 @@ either declared <code>static</code> if used in only one file or declared
file.
</p>
<hr>
-<span id="Const"></span><div class="header">
+</div>
+<div class="section" id="Const">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3184,11 +3236,13 @@ them. Therefore such casts should be avoided whenever possible and
otherwise must be carefully analyzed to make sure that they cannot
cause the modification of quantities supposed to be constant.
</p>
-
<hr>
-<span id="Continuous-integration"></span><div class="header">
+</div>
+</div>
+<div class="chapter" id="Continuous-integration">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Continuous-integration-1"></span><h2 class="chapter">9 Continuous integration</h2>
@@ -3202,20 +3256,16 @@ git-svn mirror of the sources that is pushed to Github
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">&bull; <a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Releases-on-Github" accesskey="4">Releases on Github</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
+<ul class="section-toc">
+<li><a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a></li>
+<li><a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a></li>
+<li><a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a></li>
+<li><a href="#Releases-on-Github" accesskey="4">Releases on Github</a></li>
+</ul>
<hr>
-<span id="Transfer-from-Subversion-to-Github"></span><div class="header">
+<div class="section" id="Transfer-from-Subversion-to-Github">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3271,7 +3321,9 @@ Subversion, back to <code>master</code> on <code>texlive.info</code>, and from
there to Github.
</p>
<hr>
-<span id="Automatic-update-of-the-Git-mirror"></span><div class="header">
+</div>
+<div class="section" id="Automatic-update-of-the-Git-mirror">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3285,7 +3337,9 @@ the <code>master</code> branch with them, and the second pushes changes (if
any) to Github.
</p>
<hr>
-<span id="CI-testing-on-Travis_002dCI"></span><div class="header">
+</div>
+<div class="section" id="CI-testing-on-Travis_002dCI">
+<div class="header">
<p>
Next: <a href="#Releases-on-Github" accesskey="n" rel="next">Releases on Github</a>, 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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3304,7 +3358,9 @@ Travis-CI.
automatically checkout the last pushed commit and try building it.
</p>
<hr>
-<span id="Releases-on-Github"></span><div class="header">
+</div>
+<div class="section" id="Releases-on-Github">
+<div class="header">
<p>
Previous: <a href="#CI-testing-on-Travis_002dCI" accesskey="p" rel="prev">CI testing on Travis-CI</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
@@ -3324,44 +3380,42 @@ Releases can also be made manually from that web page (see
<code>tl-update-bindir</code> for hints).
</p>
<hr>
-<span id="install_002dtl"></span><div class="header">
+</div>
+</div>
+<div class="appendix" id="install_002dtl">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#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">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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">&bull; <a href="#install_002dtl-NAME" accesskey="1">install-tl NAME</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-SYNOPSIS" accesskey="2">install-tl SYNOPSIS</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-DESCRIPTION" accesskey="3">install-tl DESCRIPTION</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-REFERENCES" accesskey="4">install-tl REFERENCES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-OPTIONS" accesskey="5">install-tl OPTIONS</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-PROFILES" accesskey="6">install-tl PROFILES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">install-tl ENVIRONMENT VARIABLES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">install-tl AUTHORS AND COPYRIGHT</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#install_002dtl-NAME" accesskey="1">NAME</a></li>
+<li><a href="#install_002dtl-SYNOPSIS" accesskey="2">SYNOPSIS</a></li>
+<li><a href="#install_002dtl-DESCRIPTION" accesskey="3">DESCRIPTION</a></li>
+<li><a href="#install_002dtl-REFERENCES" accesskey="4">REFERENCES</a></li>
+<li><a href="#install_002dtl-OPTIONS" accesskey="5">OPTIONS</a></li>
+<li><a href="#install_002dtl-PROFILES" accesskey="6">PROFILES</a></li>
+<li><a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">ENVIRONMENT VARIABLES</a></li>
+<li><a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">AUTHORS AND COPYRIGHT</a></li>
+</ul>
<hr>
-<span id="install_002dtl-NAME"></span><div class="header">
+<div class="appendixsec" id="install_002dtl-NAME">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-SYNOPSIS" accesskey="n" rel="next">SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="NAME"></span><h3 class="appendixsec">A.1 NAME</h3>
<p>install-tl - TeX Live cross-platform installer
</p>
<hr>
-<span id="install_002dtl-SYNOPSIS"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-SYNOPSIS">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">DESCRIPTION</a>, Previous: <a href="#install_002dtl-NAME" accesskey="p" rel="prev">NAME</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="SYNOPSIS"></span><h3 class="appendixsec">A.2 SYNOPSIS</h3>
@@ -3369,12 +3423,12 @@ Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl
</p>
<p>install-tl-windows.bat [<em>option</em>]...
</p>
-<p>install-tl-advanced.bat [<em>option</em>]...
-</p>
<hr>
-<span id="install_002dtl-DESCRIPTION"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-DESCRIPTION">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">REFERENCES</a>, Previous: <a href="#install_002dtl-SYNOPSIS" accesskey="p" rel="prev">SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DESCRIPTION"></span><h3 class="appendixsec">A.3 DESCRIPTION</h3>
@@ -3398,9 +3452,11 @@ initial installation is complete.
highly recommended.
</p>
<hr>
-<span id="install_002dtl-REFERENCES"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-REFERENCES">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">OPTIONS</a>, Previous: <a href="#install_002dtl-DESCRIPTION" accesskey="p" rel="prev">DESCRIPTION</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="REFERENCES"></span><h3 class="appendixsec">A.4 REFERENCES</h3>
@@ -3415,9 +3471,11 @@ Internet at <a href="https://tug.org/texlive/doc/install-tl.html">https://tug.or
<a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>.
</p>
<hr>
-<span id="install_002dtl-OPTIONS"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-OPTIONS">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-PROFILES" accesskey="n" rel="next">PROFILES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="OPTIONS"></span><h3 class="appendixsec">A.5 OPTIONS</h3>
@@ -3426,7 +3484,7 @@ leading <code>-</code> or <code>--</code>. An argument value can be separated f
option by either a space or <code>=</code>.
</p>
<dl compact="compact">
-<dt><strong>-gui</strong> [[=]<em>module</em>]</dt>
+<dt><span><strong>-gui</strong> [[=]<em>module</em>]</span></dt>
<dd><span id="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></span>
<p>If no <em>module</em> is given, starts the Tcl/Tk (see below) GUI installer.
</p>
@@ -3434,13 +3492,13 @@ option by either a space or <code>=</code>.
following modules are supported:
</p>
<dl compact="compact">
-<dt><code>text</code></dt>
+<dt><span><code>text</code></span></dt>
<dd><span id="install_002dtl-text"></span>
<p>The text mode user interface (default on Unix systems, including Macs).
Same as the <code>-no-gui</code> option.
</p>
</dd>
-<dt><code>tcl</code> (or &quot;perltk&quot; or &quot;wizard&quot; or &quot;expert&quot; or nothing)</dt>
+<dt><span><code>tcl</code> (or &quot;perltk&quot; or &quot;wizard&quot; or &quot;expert&quot; or nothing)</span></dt>
<dd><span id="install_002dtl-tcl-_0028or-_0022perltk_0022-or-_0022wizard_0022-or-_0022expert_0022-or-nothing_0029"></span>
<p>The Tcl/Tk user interface (default on Windows). It starts
with a small number of configuration options, roughly equivalent
@@ -3457,12 +3515,12 @@ on GNU/Linux, or can be easily installed through a distro package
manager. For Windows, TeX Live provides a Tcl/Tk runtime.
</p>
</dd>
-<dt><strong>-no-gui</strong></dt>
+<dt><span><strong>-no-gui</strong></span></dt>
<dd><span id="install_002dtl-_002dno_002dgui"></span>
<p>Use the text mode installer (default except on Windows and Macs).
</p>
</dd>
-<dt><strong>-lang</strong> <em>llcode</em></dt>
+<dt><span><strong>-lang</strong> <em>llcode</em></span></dt>
<dd><span id="install_002dtl-_002dlang-llcode"></span>
<p>By default, the Tcl GUI uses the language detection built into
Tcl/Tk. If that fails you can select a different language by
@@ -3475,7 +3533,7 @@ Ukrainian (uk), Vietnamese (vi), simplified Chinese (zh_CN), and
traditional Chinese (zh_TW).
</p>
</dd>
-<dt><strong>-repository</strong> <em>url|path</em></dt>
+<dt><span><strong>-repository</strong> <em>url|path</em></span></dt>
<dd><span id="install_002dtl-_002drepository-url_007cpath"></span>
<p>Specify the package repository to be used as the source of the
installation. In short, this can be a directory name or a url using
@@ -3483,7 +3541,7 @@ http(s), ftp, or scp. The documentation for <code>tlmgr</code> has the details
(<a href="https://tug.org/texlive/doc/tlmgr.html#OPTIONS">https://tug.org/texlive/doc/tlmgr.html#OPTIONS</a>).
</p>
<p>For installation, the default is to pick a mirror automatically, using
-<a href="http://mirror.ctan.org/systems/texlive/tlnet">http://mirror.ctan.org/systems/texlive/tlnet</a>; the chosen mirror is
+<a href="https://mirror.ctan.org/systems/texlive/tlnet">https://mirror.ctan.org/systems/texlive/tlnet</a>; the chosen mirror is
used for the entire download. You can use the special argument <code>ctan</code>
as an abbreviation for this. (See <a href="https://ctan.org">https://ctan.org</a> for more about CTAN
and its mirrors.)
@@ -3494,7 +3552,7 @@ the full scheme containing all packages, the list of available schemes
will be adjusted accordingly.
</p>
</dd>
-<dt><strong>-select-repository</strong></dt>
+<dt><span><strong>-select-repository</strong></span></dt>
<dd><span id="install_002dtl-_002dselect_002drepository"></span>
<p>This option allows you to choose a particular mirror from the current
list of active CTAN mirrors. This option is supported in the <code>text</code>
@@ -3504,7 +3562,7 @@ command line. It&rsquo;s useful when the (default) automatic redirection does
not choose a good host for you.
</p>
</dd>
-<dt><strong>-all-options</strong></dt>
+<dt><span><strong>-all-options</strong></span></dt>
<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).
@@ -3512,7 +3570,7 @@ Giving this command line option allows configuring such &quot;foreign&quot;
settings.
</p>
</dd>
-<dt><strong>-custom-bin</strong> <em>path</em></dt>
+<dt><span><strong>-custom-bin</strong> <em>path</em></span></dt>
<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
@@ -3529,7 +3587,13 @@ actions. To install multiple custom binary sets, manually rename
building TeX Live, see <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a>.
</p>
</dd>
-<dt><strong>-debug-translation</strong></dt>
+<dt><span><strong>-debug-fakenet</strong></span></dt>
+<dd><span id="install_002dtl-_002ddebug_002dfakenet"></span>
+<p>Pretend we&rsquo;re doing a network install, for the sole purpose of testing
+broken downloads via moving package files aside in a tlnet mirror.
+</p>
+</dd>
+<dt><span><strong>-debug-translation</strong></span></dt>
<dd><span id="install_002dtl-_002ddebug_002dtranslation"></span>
<p>In the former Perl/Tk GUI modes, this option reported any missing,
or more likely untranslated, messages to standard error. Not yet
@@ -3537,14 +3601,14 @@ implemented for the Tcl interface. Helpful for translators to see
what remains to be done.
</p>
</dd>
-<dt><strong>-force-platform</strong> <em>platform</em></dt>
+<dt><span><strong>-force-platform</strong> <em>platform</em></span></dt>
<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>&ndash;help</strong>, <strong>-?</strong></dt>
+<dt><span><strong>-help</strong>, <strong>&ndash;help</strong>, <strong>-?</strong></span></dt>
<dd><span id="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></span>
<p>Display this help and exit. (This help is also on the web at
<a href="https://tug.org/texlive/doc/install-tl.html">https://tug.org/texlive/doc/install-tl.html</a>). Sometimes the <code>perldoc</code>
@@ -3554,7 +3618,7 @@ detected, but you can set the <code>NOPERLDOC</code> environment variable and
<code>perldoc</code> will not be used.
</p>
</dd>
-<dt><strong>-in-place</strong></dt>
+<dt><span><strong>-in-place</strong></span></dt>
<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
@@ -3565,14 +3629,14 @@ is to redo it from time to time. This option is not available via the
installer interfaces. USE AT YOUR OWN RISK.
</p>
</dd>
-<dt><strong>-init-from-profile</strong> <em>profile_file</em></dt>
+<dt><span><strong>-init-from-profile</strong> <em>profile_file</em></span></dt>
<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 a
normal interactive session. Environment variables are not ignored.
</p>
</dd>
-<dt><strong>-logfile</strong> <em>file</em></dt>
+<dt><span><strong>-logfile</strong> <em>file</em></span></dt>
<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.
@@ -3583,16 +3647,16 @@ for example, <code>/usr/local/texlive/YYYY/install-tl.log</code> for the <em>YYY
release.
</p>
</dd>
-<dt><strong>-no-cls</strong></dt>
+<dt><span><strong>-no-cls</strong></span></dt>
<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>-no-persistent-downloads</strong></dt>
+<dt><span><strong>-no-persistent-downloads</strong></span></dt>
<dd><span id="install_002dtl-_002dno_002dpersistent_002ddownloads"></span>
</dd>
-<dt><strong>-persistent-downloads</strong></dt>
+<dt><span><strong>-persistent-downloads</strong></span></dt>
<dd><span id="install_002dtl-_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
@@ -3605,7 +3669,7 @@ fall back to using <code>wget</code> if this is not possible. To disable usage
LWP and persistent connections, use <code>-no-persistent-downloads</code>.
</p>
</dd>
-<dt><strong>-no-verify-downloads</strong></dt>
+<dt><span><strong>-no-verify-downloads</strong></span></dt>
<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
@@ -3614,37 +3678,37 @@ section of the <code>tlmgr</code> documentation, e.g.,
<a href="https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION">https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION</a>
</p>
</dd>
-<dt><strong>-non-admin</strong></dt>
+<dt><span><strong>-non-admin</strong></span></dt>
<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>-portable</strong></dt>
+<dt><span><strong>-portable</strong></span></dt>
<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>
+<dt><span><strong>-print-platform</strong></span></dt>
<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>
+<dt><span><strong>-profile</strong> <em>profile_file</em></span></dt>
<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. Environment variables are
ignored. See <a href="#install_002dtl-PROFILES">PROFILES</a> below.
</p>
</dd>
-<dt><strong>-q</strong></dt>
+<dt><span><strong>-q</strong></span></dt>
<dd><span id="install_002dtl-_002dq"></span>
<p>Omit normal informational messages.
</p>
</dd>
-<dt><strong>-scheme</strong> <em>scheme</em></dt>
+<dt><span><strong>-scheme</strong> <em>scheme</em></span></dt>
<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
@@ -3655,13 +3719,13 @@ depends on what your package repository provides; see the interactive
menu list.
</p>
</dd>
-<dt><strong>-v</strong></dt>
+<dt><span><strong>-v</strong></span></dt>
<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>&ndash;version</strong></dt>
+<dt><span><strong>-version</strong>, <strong>&ndash;version</strong></span></dt>
<dd><span id="install_002dtl-_002dversion_002c-_002d_002dversion"></span>
<p>Output version information and exit. If <code>-v</code> is also given, the
versions of the TeX Live modules used are also reported.
@@ -3670,9 +3734,11 @@ versions of the TeX Live modules used are also reported.
</dl>
<hr>
-<span id="install_002dtl-PROFILES"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-PROFILES">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="PROFILES"></span><h3 class="appendixsec">A.6 PROFILES</h3>
@@ -3747,28 +3813,28 @@ that could cause problems later.
<p><strong>installer options</strong> (prefix <code>instopt_</code>)
</p>
<dl compact="compact">
-<dt><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</dt>
+<dt><span><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</span></dt>
<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>
+<dt><span><code>instopt_adjustrepo</code> (default 1)</span></dt>
<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>
+<dt><span><code>instopt_letter</code> (default 0)</span></dt>
<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>
+<dt><span><code>instopt_portable</code> (default 0)</span></dt>
<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>
+<dt><span><code>instopt_write18_restricted</code> (default 1)</span></dt>
<dd><span id="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></span>
<p>Enable <code>\write18</code> for a restricted set of programs.
</p>
@@ -3815,9 +3881,11 @@ written, the names above are always used.
installation manual, linked from <a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>.
</p>
<hr>
-<span id="install_002dtl-ENVIRONMENT-VARIABLES"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-ENVIRONMENT-VARIABLES">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-PROFILES" accesskey="p" rel="prev">PROFILES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="ENVIRONMENT-VARIABLES"></span><h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3>
@@ -3826,80 +3894,79 @@ following environment variables. They are not of interest for normal
user installations.
</p>
<dl compact="compact">
-<dt><code>TEXLIVE_DOWNLOADER</code></dt>
+<dt><span><code>TEXLIVE_DOWNLOADER</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fDOWNLOADER"></span>
</dd>
-<dt><code>TL_DOWNLOAD_PROGRAM</code></dt>
+<dt><span><code>TL_DOWNLOAD_PROGRAM</code></span></dt>
<dd><span id="install_002dtl-TL_005fDOWNLOAD_005fPROGRAM"></span>
</dd>
-<dt><code>TL_DOWNLOAD_ARGS</code></dt>
+<dt><span><code>TL_DOWNLOAD_ARGS</code></span></dt>
<dd><span id="install_002dtl-TL_005fDOWNLOAD_005fARGS"></span>
<p>These override the normal choice of a download program; see the <code>tlmgr</code>
documentation, e.g.,
<a href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>.
</p>
</dd>
-<dt><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></span></dt>
<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>
+<dt><span><code>TEXLIVE_INSTALL_NO_CONTEXT_CACHE</code></span></dt>
<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_RESUME</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_NO_RESUME</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fRESUME"></span>
<p>Omit check for installing on top of a previous installation and then
asking about importing previous settings.
</p>
</dd>
-<dt><code>TEXLIVE_INSTALL_NO_WELCOME</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_NO_WELCOME</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></span>
<p>Omit printing the welcome message after successful installation, e.g.,
when testing.
</p>
</dd>
-<dt><code>TEXLIVE_INSTALL_PAPER</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_PAPER</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fPAPER"></span>
<p>Set the default paper size for all relevant programs; must be either
<code>letter</code> or <code>a4</code>. The default is <code>a4</code>.
</p>
</dd>
-<dt><code>TEXLIVE_INSTALL_PREFIX</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_PREFIX</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></span>
</dd>
-<dt><code>TEXLIVE_INSTALL_TEXDIR</code></dt>
-<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></span>
-</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></span>
</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFVAR</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_TEXMFVAR</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></span>
</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFHOME</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_TEXMFHOME</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></span>
</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFLOCAL</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_TEXMFLOCAL</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFLOCAL"></span>
</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFSYSCONFIG</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_TEXMFSYSCONFIG</code></span></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSCONFIG"></span>
</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></dt>
+<dt><span><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></span></dt>
<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.,
-<code>/usr/local/texlive/2016</code>. All the defaults can be seen by running the
+<p>Specify the respective directories. <code>TEXLIVE_INSTALL_PREFIX</code> defaults
+to <code>/usr/local/texlive</code>. All the defaults can be seen by running the
installer interactively and then typing <code>D</code> for the directory menu.
</p>
+<p>To override the so-called <code>TEXDIR</code>, which defaults to the release
+directory within that prefix, e.g., <code>/usr/local/texlive/2020</code>, use a
+profile file (q.v.).
+</p>
</dd>
-<dt><code>NOPERLDOC</code></dt>
+<dt><span><code>NOPERLDOC</code></span></dt>
<dd><span id="install_002dtl-NOPERLDOC"></span>
<p>Don&rsquo;t try to run the <code>--help</code> message through <code>perldoc</code>.
</p>
@@ -3907,9 +3974,11 @@ installer interactively and then typing <code>D</code> for the directory menu.
</dl>
<hr>
-<span id="install_002dtl-AUTHORS-AND-COPYRIGHT"></span><div class="header">
+</div>
+<div class="appendixsec" id="install_002dtl-AUTHORS-AND-COPYRIGHT">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">ENVIRONMENT VARIABLES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="AUTHORS-AND-COPYRIGHT"></span><h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3>
@@ -3917,68 +3986,62 @@ Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="pre
distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
-<p>$Id: install-tl 57970 2021-02-27 14:17:34Z siepo $
+<p>$Id: install-tl 62146 2022-02-22 22:48:10Z karl $
</p>
<hr>
-<span id="tlmgr"></span><div class="header">
+</div>
+</div>
+<div class="appendix" id="tlmgr">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#install_002dtl" accesskey="p" rel="prev">install-tl</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="tlmgr-1"></span><h2 class="appendix">Appendix B tlmgr</h2>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-NAME" accesskey="1">tlmgr NAME</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-SYNOPSIS" accesskey="2">tlmgr SYNOPSIS</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-DESCRIPTION" accesskey="3">tlmgr DESCRIPTION</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-EXAMPLES" accesskey="4">tlmgr EXAMPLES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-OPTIONS" accesskey="5">tlmgr OPTIONS</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-ACTIONS" accesskey="6">tlmgr ACTIONS</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">tlmgr CONFIGURATION FILE FOR TLMGR</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">tlmgr CRYPTOGRAPHIC VERIFICATION</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-USER-MODE" accesskey="9">tlmgr USER MODE</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-MULTIPLE-REPOSITORIES">tlmgr MULTIPLE REPOSITORIES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-GUI-FOR-TLMGR">tlmgr GUI FOR TLMGR</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">tlmgr MACHINE-READABLE OUTPUT</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-ENVIRONMENT-VARIABLES">tlmgr ENVIRONMENT VARIABLES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-AUTHORS-AND-COPYRIGHT">tlmgr AUTHORS AND COPYRIGHT</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-NAME" accesskey="1">NAME</a></li>
+<li><a href="#tlmgr-SYNOPSIS" accesskey="2">SYNOPSIS</a></li>
+<li><a href="#tlmgr-DESCRIPTION" accesskey="3">DESCRIPTION</a></li>
+<li><a href="#tlmgr-EXAMPLES" accesskey="4">EXAMPLES</a></li>
+<li><a href="#tlmgr-OPTIONS" accesskey="5">OPTIONS</a></li>
+<li><a href="#tlmgr-ACTIONS" accesskey="6">ACTIONS</a></li>
+<li><a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">CONFIGURATION FILE FOR TLMGR</a></li>
+<li><a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">CRYPTOGRAPHIC VERIFICATION</a></li>
+<li><a href="#tlmgr-USER-MODE" accesskey="9">USER MODE</a></li>
+<li><a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a></li>
+<li><a href="#tlmgr-GUI-FOR-TLMGR">GUI FOR TLMGR</a></li>
+<li><a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">MACHINE-READABLE OUTPUT</a></li>
+<li><a href="#tlmgr-ENVIRONMENT-VARIABLES">ENVIRONMENT VARIABLES</a></li>
+<li><a href="#tlmgr-AUTHORS-AND-COPYRIGHT">AUTHORS AND COPYRIGHT</a></li>
+</ul>
<hr>
-<span id="tlmgr-NAME"></span><div class="header">
+<div class="appendixsec" id="tlmgr-NAME">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-SYNOPSIS" accesskey="n" rel="next">SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="NAME-1"></span><h3 class="appendixsec">B.1 NAME</h3>
<p>tlmgr - the native TeX Live Manager
</p>
<hr>
-<span id="tlmgr-SYNOPSIS"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-SYNOPSIS">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-DESCRIPTION" accesskey="n" rel="next">DESCRIPTION</a>, Previous: <a href="#tlmgr-NAME" accesskey="p" rel="prev">NAME</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
-<span id="tlmgr-DESCRIPTION"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-DESCRIPTION">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-EXAMPLES" accesskey="n" rel="next">EXAMPLES</a>, Previous: <a href="#tlmgr-SYNOPSIS" accesskey="p" rel="prev">SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="DESCRIPTION-1"></span><h3 class="appendixsec">B.3 DESCRIPTION</h3>
@@ -4002,9 +4065,11 @@ A TeX Live installation can be customized and managed at any level.
available.
</p>
<hr>
-<span id="tlmgr-EXAMPLES"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-EXAMPLES">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">OPTIONS</a>, Previous: <a href="#tlmgr-DESCRIPTION" accesskey="p" rel="prev">DESCRIPTION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="EXAMPLES"></span><h3 class="appendixsec">B.4 EXAMPLES</h3>
@@ -4012,11 +4077,11 @@ Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">tlmgr OPTIONS</a>, Previ
with <code>tlmgr</code>:
</p>
<dl compact="compact">
-<dt><code>tlmgr option repository ctan</code></dt>
+<dt><span><code>tlmgr option repository ctan</code></span></dt>
<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><span id="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span>
+<dt><span><code>tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet</code></span></dt>
+<dd><span id="tlmgr-tlmgr-option-repository-https_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
@@ -4029,18 +4094,18 @@ problems; the list of all CTAN mirrors with the status of each is at
<a href="https://ctan.org/mirrors/mirmon">https://ctan.org/mirrors/mirmon</a>.
</p>
</dd>
-<dt><code>tlmgr update --list</code></dt>
+<dt><span><code>tlmgr update --list</code></span></dt>
<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>
+<dt><span><code>tlmgr update --all</code></span></dt>
<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>
+<dt><span><code>tlmgr info</code> <em>what</em></span></dt>
<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.
@@ -4052,9 +4117,11 @@ status and description, of searches for <em>what</em> in all packages.
following voluminous information.
</p>
<hr>
-<span id="tlmgr-OPTIONS"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-OPTIONS">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-ACTIONS" accesskey="n" rel="next">ACTIONS</a>, Previous: <a href="#tlmgr-EXAMPLES" accesskey="p" rel="prev">EXAMPLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="OPTIONS-1"></span><h3 class="appendixsec">B.5 OPTIONS</h3>
@@ -4066,7 +4133,7 @@ non-option argument will be the main action. In all cases,
between an option name and its value.
</p>
<dl compact="compact">
-<dt><strong>&ndash;repository</strong> <em>url|path</em></dt>
+<dt><span><strong>&ndash;repository</strong> <em>url|path</em></span></dt>
<dd><span id="tlmgr-_002d_002drepository-url_007cpath"></span>
<p>Specify the package repository from which packages should be installed
or updated, either a local directory or network location, as below. This
@@ -4097,26 +4164,26 @@ are accepted as aliases for this option.
<p>Locations can be specified as any of the following:
</p>
<dl compact="compact">
-<dt><code>/some/local/dir</code></dt>
+<dt><span><code>/some/local/dir</code></span></dt>
<dd><span id="tlmgr-_002fsome_002flocal_002fdir"></span>
</dd>
-<dt><code>file:/some/local/dir</code></dt>
+<dt><span><code>file:/some/local/dir</code></span></dt>
<dd><span id="tlmgr-file_003a_002fsome_002flocal_002fdir"></span>
<p>Equivalent ways of specifying a local directory.
</p>
</dd>
-<dt><code>ctan</code></dt>
+<dt><span><code>ctan</code></span></dt>
<dd><span id="tlmgr-ctan"></span>
</dd>
-<dt><code>http://mirror.ctan.org/systems/texlive/tlnet</code></dt>
-<dd><span id="tlmgr-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span>
+<dt><span><code>https://mirror.ctan.org/systems/texlive/tlnet</code></span></dt>
+<dd><span id="tlmgr-https_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span>
<p>Pick a CTAN mirror automatically, trying for one that is both nearby and
up-to-date. The chosen mirror is used for the entire download. The bare
<code>ctan</code> is merely an alias for the full url. (See <a href="https://ctan.org">https://ctan.org</a> for
more about CTAN and its mirrors.)
</p>
</dd>
-<dt><code>http://server/path/to/tlnet</code></dt>
+<dt><span><code>http://server/path/to/tlnet</code></span></dt>
<dd><span id="tlmgr-http_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span>
<p>Standard HTTP. If the (default) LWP method is used, persistent
connections are supported. TL can also use <code>curl</code> or <code>wget</code> to do the
@@ -4125,7 +4192,7 @@ downloads, or an arbitrary user-specified program, as described in the
(<a href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>).
</p>
</dd>
-<dt><code>https://server/path/to/tlnet</code></dt>
+<dt><span><code>https://server/path/to/tlnet</code></span></dt>
<dd><span id="tlmgr-https_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span>
<p>Again, if the (default) LWP method is used, this supports persistent
connections. Unfortunately, some versions of <code>wget</code> and <code>curl</code> do not
@@ -4135,19 +4202,19 @@ certificate roots. The simplest workaround for this problem is to use
http or ftp.
</p>
</dd>
-<dt><code>ftp://server/path/to/tlnet</code></dt>
+<dt><span><code>ftp://server/path/to/tlnet</code></span></dt>
<dd><span id="tlmgr-ftp_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span>
<p>If the (default) LWP method is used, persistent connections are
supported.
</p>
</dd>
-<dt><code>user@machine:/path/to/tlnet</code></dt>
+<dt><span><code>user@machine:/path/to/tlnet</code></span></dt>
<dd><span id="tlmgr-user_0040machine_003a_002fpath_002fto_002ftlnet"></span>
</dd>
-<dt><code>scp://user@machine/path/to/tlnet</code></dt>
+<dt><span><code>scp://user@machine/path/to/tlnet</code></span></dt>
<dd><span id="tlmgr-scp_003a_002f_002fuser_0040machine_002fpath_002fto_002ftlnet"></span>
</dd>
-<dt><code>ssh://user@machine/path/to/tlnet</code></dt>
+<dt><span><code>ssh://user@machine/path/to/tlnet</code></span></dt>
<dd><span id="tlmgr-ssh_003a_002f_002fuser_0040machine_002fpath_002fto_002ftlnet"></span>
<p>These forms are equivalent; they all use <code>scp</code> to transfer files. Using
<code>ssh-agent</code> is recommended. (Info:
@@ -4161,7 +4228,7 @@ supported.
trailing <code>/tlpkg</code> and/or <code>/archive</code> components are ignored.
</p>
</dd>
-<dt><strong>&ndash;gui</strong> [<em>action</em>]</dt>
+<dt><span><strong>&ndash;gui</strong> [<em>action</em>]</span></dt>
<dd><span id="tlmgr-_002d_002dgui-_005baction_005d"></span>
<p>Two notable GUI front-ends for <code>tlmgr</code>, <code>tlshell</code> and <code>tlcockpit</code>,
are started up as separate programs; see their own documentation.
@@ -4181,7 +4248,7 @@ TeX Live&rsquo;s Perl distribution for Windows. You may find <code>tlshell</code
<code>tlcockpit</code> easier to work with.
</p>
</dd>
-<dt><strong>&ndash;gui-lang</strong> <em>llcode</em></dt>
+<dt><span><strong>&ndash;gui-lang</strong> <em>llcode</em></span></dt>
<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
@@ -4194,7 +4261,7 @@ Japanese&nbsp;(ja)<!-- /@w -->, Dutch&nbsp;(nl)<!-- /@w -->, Polish&nbsp;(pl)<!-
<p>tlshell shares its message catalog with tlmgr.
</p>
</dd>
-<dt><strong>&ndash;command-logfile</strong> <em>file</em></dt>
+<dt><span><strong>&ndash;command-logfile</strong> <em>file</em></span></dt>
<dd><span id="tlmgr-_002d_002dcommand_002dlogfile-file"></span>
<p><code>tlmgr</code> logs the output of all programs invoked (mktexlr, mtxrun, fmtutil,
updmap) to a separate log file, by default
@@ -4202,28 +4269,28 @@ updmap) to a separate log file, by default
different file for the log.
</p>
</dd>
-<dt><strong>&ndash;debug-translation</strong></dt>
+<dt><span><strong>&ndash;debug-translation</strong></span></dt>
<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>&ndash;machine-readable</strong></dt>
+<dt><span><strong>&ndash;machine-readable</strong></span></dt>
<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>&ndash;no-execute-actions</strong></dt>
+<dt><span><strong>&ndash;no-execute-actions</strong></span></dt>
<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>&ndash;package-logfile</strong> <em>file</em></dt>
+<dt><span><strong>&ndash;package-logfile</strong> <em>file</em></span></dt>
<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
@@ -4231,16 +4298,16 @@ updates, failed restores) to a separate log file, by default
different file for the log.
</p>
</dd>
-<dt><strong>&ndash;pause</strong></dt>
+<dt><span><strong>&ndash;pause</strong></span></dt>
<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>&ndash;persistent-downloads</strong></dt>
+<dt><span><strong>&ndash;persistent-downloads</strong></span></dt>
<dd><span id="tlmgr-_002d_002dpersistent_002ddownloads"></span>
</dd>
-<dt><strong>&ndash;no-persistent-downloads</strong></dt>
+<dt><span><strong>&ndash;no-persistent-downloads</strong></span></dt>
<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
@@ -4252,24 +4319,24 @@ download for each package.
disable these persistent connections, use <code>--no-persistent-downloads</code>.
</p>
</dd>
-<dt><strong>&ndash;pin-file</strong></dt>
+<dt><span><strong>&ndash;pin-file</strong></span></dt>
<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>&ndash;usermode</strong></dt>
+<dt><span><strong>&ndash;usermode</strong></span></dt>
<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>&ndash;usertree</strong> <em>dir</em></dt>
+<dt><span><strong>&ndash;usertree</strong> <em>dir</em></span></dt>
<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>&ndash;verify-repo=[none|main|all]</strong></dt>
+<dt><span><strong>&ndash;verify-repo=[none|main|all]</strong></span></dt>
<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
@@ -4291,79 +4358,52 @@ 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>
-<span id="tlmgr-ACTIONS"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-ACTIONS">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="ACTIONS"></span><h3 class="appendixsec">B.6 ACTIONS</h3>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-help" accesskey="1">tlmgr help</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-version" accesskey="2">tlmgr version</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-backup" accesskey="3">tlmgr backup</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-candidates-pkg" accesskey="4">tlmgr candidates <em>pkg</em></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-conf" accesskey="6">tlmgr conf</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <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>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-generate" accesskey="8">tlmgr generate</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-gui" accesskey="9">tlmgr gui</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-info">tlmgr info</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-init_002dusertree">tlmgr init-usertree</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr install [<em>option</em>...] <em>pkg</em>...</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-key">tlmgr key</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-list">tlmgr list</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-option">tlmgr option</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-paper">tlmgr paper</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-path">tlmgr path</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-pinning">tlmgr pinning</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-platform">tlmgr platform</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-postaction">tlmgr postaction</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-print_002dplatform">tlmgr print-platform</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-print_002dplatform_002dinfo">tlmgr print-platform-info</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-repository">tlmgr repository</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-restore">tlmgr restore</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search">tlmgr search</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-shell">tlmgr shell</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-show">tlmgr show</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-uninstall">tlmgr uninstall</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <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>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-help" accesskey="1">help</a></li>
+<li><a href="#tlmgr-version" accesskey="2">version</a></li>
+<li><a href="#tlmgr-backup" accesskey="3">backup</a></li>
+<li><a href="#tlmgr-candidates-pkg" accesskey="4">candidates <em>pkg</em></a></li>
+<li><a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="5">check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a></li>
+<li><a href="#tlmgr-conf" accesskey="6">conf</a></li>
+<li><a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="7">dump-tlpdb [<em>option</em>...] [&ndash;json]</a></li>
+<li><a href="#tlmgr-generate" accesskey="8">generate</a></li>
+<li><a href="#tlmgr-gui" accesskey="9">gui</a></li>
+<li><a href="#tlmgr-info">info</a></li>
+<li><a href="#tlmgr-init_002dusertree">init-usertree</a></li>
+<li><a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install [<em>option</em>...] <em>pkg</em>...</a></li>
+<li><a href="#tlmgr-key">key</a></li>
+<li><a href="#tlmgr-list">list</a></li>
+<li><a href="#tlmgr-option">option</a></li>
+<li><a href="#tlmgr-paper">paper</a></li>
+<li><a href="#tlmgr-path">path</a></li>
+<li><a href="#tlmgr-pinning">pinning</a></li>
+<li><a href="#tlmgr-platform">platform</a></li>
+<li><a href="#tlmgr-postaction">postaction</a></li>
+<li><a href="#tlmgr-print_002dplatform">print-platform</a></li>
+<li><a href="#tlmgr-print_002dplatform_002dinfo">print-platform-info</a></li>
+<li><a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">remove [<em>option</em>...] <em>pkg</em>...</a></li>
+<li><a href="#tlmgr-repository">repository</a></li>
+<li><a href="#tlmgr-restore">restore</a></li>
+<li><a href="#tlmgr-search">search</a></li>
+<li><a href="#tlmgr-shell">shell</a></li>
+<li><a href="#tlmgr-show">show</a></li>
+<li><a href="#tlmgr-uninstall">uninstall</a></li>
+<li><a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">update [<em>option</em>...] [<em>pkg</em>...]</a></li>
+</ul>
<hr>
-<span id="tlmgr-help"></span><div class="header">
+<div class="appendixsubsec" id="tlmgr-help">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-version" accesskey="n" rel="next">version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="help"></span><h4 class="appendixsubsec">B.6.1 help</h4>
@@ -4375,9 +4415,11 @@ always be detected, but you can set the <code>NOPERLDOC</code> environment
variable and <code>perldoc</code> will not be used.
</p>
<hr>
-<span id="tlmgr-version"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-version">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-backup" accesskey="n" rel="next">backup</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="version"></span><h4 class="appendixsubsec">B.6.2 version</h4>
@@ -4386,17 +4428,19 @@ Next: <a href="#tlmgr-backup" accesskey="n" rel="next">tlmgr backup</a>, Previou
<p>If <code>-v</code> has been given the revisions of the used modules are reported, too.
</p>
<hr>
-<span id="tlmgr-backup"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-backup">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">candidates <em>pkg</em></a>, Previous: <a href="#tlmgr-version" accesskey="p" rel="prev">version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="backup"></span><h4 class="appendixsubsec">B.6.3 backup</h4>
<dl compact="compact">
-<dt><strong>backup [<em>option</em>...] &ndash;all</strong></dt>
+<dt><span><strong>backup [<em>option</em>...] &ndash;all</strong></span></dt>
<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>
+<dt><span><strong>backup [<em>option</em>...] <em>pkg</em>...</strong></span></dt>
<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
@@ -4417,21 +4461,21 @@ the <code>option</code> action.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
+<dt><span><strong>&ndash;backupdir</strong> <em>directory</em></span></dt>
<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>&ndash;all</strong></dt>
+<dt><span><strong>&ndash;all</strong></span></dt>
<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>&ndash;clean</strong>[=<em>N</em>]</dt>
+<dt><span><strong>&ndash;clean</strong>[=<em>N</em>]</span></dt>
<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
@@ -4439,7 +4483,7 @@ explained above. The optional integer argument <em>N</em> overrides the
of packages together with this option, as desired.
</p>
</dd>
-<dt><strong>&ndash;dry-run</strong></dt>
+<dt><span><strong>&ndash;dry-run</strong></span></dt>
<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.
@@ -4451,9 +4495,11 @@ performed are written to the terminal.
</dl>
<hr>
-<span id="tlmgr-candidates-pkg"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-candidates-pkg">
+<div class="header">
<p>
-Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="n" rel="next">check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="candidates-pkg"></span><h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
@@ -4461,9 +4507,11 @@ Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexe
See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below.
</p>
<hr>
-<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-conf" accesskey="n" rel="next">conf</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"></span><h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</h4>
@@ -4472,7 +4520,7 @@ If no problems are found, there will be no output. (To get a view of
what is being done, run <code>tlmgr -v check</code>.)
</p>
<dl compact="compact">
-<dt><strong>depends</strong></dt>
+<dt><span><strong>depends</strong></span></dt>
<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
@@ -4482,41 +4530,41 @@ contained in any collection.
instead since former versions for <code>tlmgr</code> called it that way.
</p>
</dd>
-<dt><strong>executes</strong></dt>
+<dt><span><strong>executes</strong></span></dt>
<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>files</strong></dt>
+<dt><span><strong>files</strong></span></dt>
<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>runfiles</strong></dt>
+<dt><span><strong>runfiles</strong></span></dt>
<dd><span id="tlmgr-runfiles"></span>
<p>List those filenames that are occurring more than one time in the
runfiles sections, except for known duplicates.
</p>
</dd>
-<dt><strong>texmfdbs</strong></dt>
+<dt><span><strong>texmfdbs</strong></span></dt>
<dd><span id="tlmgr-texmfdbs"></span>
<p>Checks related to the <code>ls-R</code> files. If you have defined new trees, or
changed the <code>TEXMF</code> or <code>TEXMFDBS</code> variables, it can&rsquo;t hurt to run
this. It checks that:
</p>
<dl compact="compact">
-<dt>- all items in <code>TEXMFDBS</code> have the <code>!!</code> prefix.</dt>
+<dt><span>- all items in <code>TEXMFDBS</code> have the <code>!!</code> prefix.</span></dt>
<dd><span id="tlmgr-_002d-all-items-in-TEXMFDBS-have-the-_0021_0021-prefix_002e"></span>
</dd>
-<dt>- all items in <code>TEXMFBDS</code> have an <code>ls-R</code> file (if they exist at all).</dt>
+<dt><span>- all items in <code>TEXMFBDS</code> have an <code>ls-R</code> file (if they exist at all).</span></dt>
<dd><span id="tlmgr-_002d-all-items-in-TEXMFBDS-have-an-ls_002dR-file-_0028if-they-exist-at-all_0029_002e"></span>
</dd>
-<dt>- all items in <code>TEXMF</code> with <code>!!</code> are listed in <code>TEXMFDBS</code>.</dt>
+<dt><span>- all items in <code>TEXMF</code> with <code>!!</code> are listed in <code>TEXMFDBS</code>.</span></dt>
<dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-_0021_0021-are-listed-in-TEXMFDBS_002e"></span>
</dd>
-<dt>- all items in <code>TEXMF</code> with an <code>ls-R</code> file are listed in <code>TEXMFDBS</code>.</dt>
+<dt><span>- all items in <code>TEXMF</code> with an <code>ls-R</code> file are listed in <code>TEXMFDBS</code>.</span></dt>
<dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-an-ls_002dR-file-are-listed-in-TEXMFDBS_002e"></span>
</dd>
</dl>
@@ -4527,7 +4575,7 @@ this. It checks that:
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;use-svn</strong></dt>
+<dt><span><strong>&ndash;use-svn</strong></span></dt>
<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. (This is run nightly.)
@@ -4536,17 +4584,19 @@ checking the TL development repository. (This is run nightly.)
</dl>
<hr>
-<span id="tlmgr-conf"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-conf">
+<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-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">dump-tlpdb [<em>option</em>...] [&ndash;json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="p" rel="prev">check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="conf"></span><h4 class="appendixsubsec">B.6.6 conf</h4>
<dl compact="compact">
-<dt><strong>conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</strong></dt>
+<dt><span><strong>conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</strong></span></dt>
<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 [&ndash;conffile <em>file</em>] [show|add|remove] [<em>value</em>]</strong></dt>
+<dt><span><strong>conf auxtrees [&ndash;conffile <em>file</em>] [show|add|remove] [<em>value</em>]</strong></span></dt>
<dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cremove_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
@@ -4600,9 +4650,11 @@ breakage is possible.
</dl>
<hr>
-<span id="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-generate" accesskey="n" rel="next">generate</a>, Previous: <a href="#tlmgr-conf" accesskey="p" rel="prev">conf</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</h4>
@@ -4613,17 +4665,17 @@ output is analogous to the <code>--machine-readable</code> output; see
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;local</strong></dt>
+<dt><span><strong>&ndash;local</strong></span></dt>
<dd><span id="tlmgr-_002d_002dlocal"></span>
<p>Dump the local TLPDB.
</p>
</dd>
-<dt><strong>&ndash;remote</strong></dt>
+<dt><span><strong>&ndash;remote</strong></span></dt>
<dd><span id="tlmgr-_002d_002dremote"></span>
<p>Dump the remote TLPDB.
</p>
</dd>
-<dt><strong>&ndash;json</strong></dt>
+<dt><span><strong>&ndash;json</strong></span></dt>
<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>,
@@ -4645,23 +4697,25 @@ location, in this format:
<p>Line endings may be either LF or CRLF depending on the current platform.
</p>
<hr>
-<span id="tlmgr-generate"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-generate">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-gui" accesskey="n" rel="next">gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="p" rel="prev">dump-tlpdb [<em>option</em>...] [&ndash;json]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="generate"></span><h4 class="appendixsubsec">B.6.8 generate</h4>
<dl compact="compact">
-<dt><strong>generate [<em>option</em>...] language</strong></dt>
+<dt><span><strong>generate [<em>option</em>...] language</strong></span></dt>
<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></span>
</dd>
-<dt><strong>generate [<em>option</em>...] language.dat</strong></dt>
+<dt><span><strong>generate [<em>option</em>...] language.dat</strong></span></dt>
<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></span>
</dd>
-<dt><strong>generate [<em>option</em>...] language.def</strong></dt>
+<dt><span><strong>generate [<em>option</em>...] language.def</strong></span></dt>
<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>
+<dt><span><strong>generate [<em>option</em>...] language.dat.lua</strong></span></dt>
<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></span>
</dd>
</dl>
@@ -4726,7 +4780,7 @@ extension recreates only that given language file.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;dest</strong> <em>output_file</em></dt>
+<dt><span><strong>&ndash;dest</strong> <em>output_file</em></span></dt>
<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
@@ -4738,13 +4792,13 @@ overwriting; if you want a specific name for each output file, we
recommend invoking <code>tlmgr</code> twice.)
</p>
</dd>
-<dt><strong>&ndash;localcfg</strong> <em>local_conf_file</em></dt>
+<dt><span><strong>&ndash;localcfg</strong> <em>local_conf_file</em></span></dt>
<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>&ndash;rebuild-sys</strong></dt>
+<dt><span><strong>&ndash;rebuild-sys</strong></span></dt>
<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:
@@ -4768,29 +4822,33 @@ succession before invoking these programs.
tex/generic/config/language.dat.lua (and language-local.dat.lua)
</pre>
<hr>
-<span id="tlmgr-gui"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-gui">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-info" accesskey="n" rel="next">info</a>, Previous: <a href="#tlmgr-generate" accesskey="p" rel="prev">generate</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="gui"></span><h4 class="appendixsubsec">B.6.9 gui</h4>
<p>Start the graphical user interface. See <strong>GUI</strong> below.
</p>
<hr>
-<span id="tlmgr-info"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-info">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-init_002dusertree" accesskey="n" rel="next">init-usertree</a>, Previous: <a href="#tlmgr-gui" accesskey="p" rel="prev">gui</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="info"></span><h4 class="appendixsubsec">B.6.10 info</h4>
<dl compact="compact">
-<dt><strong>info [<em>option</em>...] <em>pkg</em>...</strong></dt>
+<dt><span><strong>info [<em>option</em>...] <em>pkg</em>...</strong></span></dt>
<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>
+<dt><span><strong>info [<em>option</em>...] collections</strong></span></dt>
<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></span>
</dd>
-<dt><strong>info [<em>option</em>...] schemes</strong></dt>
+<dt><span><strong>info [<em>option</em>...] schemes</strong></span></dt>
<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>.
@@ -4825,7 +4883,7 @@ but are still supported for backward compatibility.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;list</strong></dt>
+<dt><span><strong>&ndash;list</strong></span></dt>
<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.
@@ -4833,13 +4891,13 @@ When given with schemes and collections, <code>--list</code> outputs their
dependencies in a similar way.
</p>
</dd>
-<dt><strong>&ndash;only-installed</strong></dt>
+<dt><span><strong>&ndash;only-installed</strong></span></dt>
<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>&ndash;only-remote</strong></dt>
+<dt><span><strong>&ndash;only-remote</strong></span></dt>
<dd><span id="tlmgr-_002d_002donly_002dremote"></span>
<p>Only list packages from the remote repository. Useful when checking what
is available in a remote repository using
@@ -4847,10 +4905,10 @@ is available in a remote repository using
<code>--only-installed</code> and <code>--only-remote</code> cannot both be specified.
</p>
</dd>
-<dt><strong>&ndash;data <code>item1,item2,...</code></strong></dt>
+<dt><span><strong>&ndash;data <code>item1,item2,...</code></strong></span></dt>
<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>,
+<p>If the option <code>--data</code> is given, its argument must be a comma or colon
+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>, <code>cat-version</code>, <code>cat-date</code>, <code>cat-license</code>,
plus various <code>cat-contact-*</code> fields (see below).
@@ -4873,7 +4931,7 @@ may be empty or a url value. A brief description is on the CTAN upload
page for new packages: <a href="https://ctan.org/upload">https://ctan.org/upload</a>.
</p>
</dd>
-<dt><strong>&ndash;json</strong></dt>
+<dt><span><strong>&ndash;json</strong></span></dt>
<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
@@ -4888,9 +4946,11 @@ with additional information. For details see
</dl>
<hr>
-<span id="tlmgr-init_002dusertree"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-init_002dusertree">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">install [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info" accesskey="p" rel="prev">info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="init_002dusertree"></span><h4 class="appendixsubsec">B.6.11 init-usertree</h4>
@@ -4899,9 +4959,11 @@ 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>
-<span id="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-key" accesskey="n" rel="next">key</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
@@ -4913,33 +4975,33 @@ action for how to get the latest version of a package.
dependent. Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;dry-run</strong></dt>
+<dt><span><strong>&ndash;dry-run</strong></span></dt>
<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>&ndash;file</strong></dt>
+<dt><span><strong>&ndash;file</strong></span></dt>
<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>&ndash;force</strong></dt>
+<dt><span><strong>&ndash;force</strong></span></dt>
<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>&ndash;no-depends</strong></dt>
+<dt><span><strong>&ndash;no-depends</strong></span></dt>
<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>&ndash;no-depends-at-all</strong></dt>
+<dt><span><strong>&ndash;no-depends-at-all</strong></span></dt>
<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
@@ -4949,7 +5011,7 @@ implies <code>--no-depends</code>. Don&rsquo;t use it unless you are sure of wh
are doing.
</p>
</dd>
-<dt><strong>&ndash;reinstall</strong></dt>
+<dt><span><strong>&ndash;reinstall</strong></span></dt>
<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
@@ -4959,10 +5021,10 @@ useful to recover from accidental removal of files in the hierarchy.
(i.e., not those of category Scheme or Collection).
</p>
</dd>
-<dt><strong>&ndash;with-doc</strong></dt>
+<dt><span><strong>&ndash;with-doc</strong></span></dt>
<dd><span id="tlmgr-_002d_002dwith_002ddoc"></span>
</dd>
-<dt><strong>&ndash;with-src</strong></dt>
+<dt><span><strong>&ndash;with-src</strong></span></dt>
<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
@@ -4981,20 +5043,22 @@ directories; you need to run <code>tlmgr path add</code> (<a href="#tlmgr-path">
you are using this feature and want new symlinks added.
</p>
<hr>
-<span id="tlmgr-key"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-key">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-list" accesskey="n" rel="next">list</a>, Previous: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">install [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="key"></span><h4 class="appendixsubsec">B.6.13 key</h4>
<dl compact="compact">
-<dt><strong>key list</strong></dt>
+<dt><span><strong>key list</strong></span></dt>
<dd><span id="tlmgr-key-list"></span>
</dd>
-<dt><strong>key add <em>file</em></strong></dt>
+<dt><span><strong>key add <em>file</em></strong></span></dt>
<dd><span id="tlmgr-key-add-file"></span>
</dd>
-<dt><strong>key remove <em>keyid</em></strong></dt>
+<dt><span><strong>key remove <em>keyid</em></strong></span></dt>
<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
@@ -5014,29 +5078,33 @@ from the local keyring.
</dl>
<hr>
-<span id="tlmgr-list"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-list">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-option" accesskey="n" rel="next">option</a>, Previous: <a href="#tlmgr-key" accesskey="p" rel="prev">key</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="list"></span><h4 class="appendixsubsec">B.6.14 list</h4>
<p>Synonym for <a href="#tlmgr-info">info</a>.
</p>
<hr>
-<span id="tlmgr-option"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-option">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-paper" accesskey="n" rel="next">paper</a>, Previous: <a href="#tlmgr-list" accesskey="p" rel="prev">list</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="option"></span><h4 class="appendixsubsec">B.6.15 option</h4>
<dl compact="compact">
-<dt><strong>option [&ndash;json] [show]</strong></dt>
+<dt><span><strong>option [&ndash;json] [show]</strong></span></dt>
<dd><span id="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></span>
</dd>
-<dt><strong>option [&ndash;json] showall|help</strong></dt>
+<dt><span><strong>option [&ndash;json] showall|help</strong></span></dt>
<dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall_007chelp"></span>
</dd>
-<dt><strong>option <em>key</em> [<em>value</em>]</strong></dt>
+<dt><span><strong>option <em>key</em> [<em>value</em>]</strong></span></dt>
<dd><span id="tlmgr-option-key-_005bvalue_005d"></span>
</dd>
</dl>
@@ -5079,7 +5147,7 @@ the definitive list):
get further updates from the Internet, after originally installing from
DVD. To do this, you can run
</p>
-<pre class="verbatim"> tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet
+<pre class="verbatim"> tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet
</pre>
<p>The <code>install-tl</code> documentation has more information about the possible
values for <code>repository</code>. (For backward compatibility, <code>location</code> can
@@ -5137,20 +5205,22 @@ 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>
-<span id="tlmgr-paper"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-paper">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-path" accesskey="n" rel="next">path</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="paper"></span><h4 class="appendixsubsec">B.6.16 paper</h4>
<dl compact="compact">
-<dt><strong>paper [a4|letter]</strong></dt>
+<dt><span><strong>paper [a4|letter]</strong></span></dt>
<dd><span id="tlmgr-paper-_005ba4_007cletter_005d"></span>
</dd>
-<dt><strong>&lt;[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|&ndash;list]</strong>&gt;</dt>
+<dt><span><strong>&lt;[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|&ndash;list]</strong>&gt;</span></dt>
<dd><span id="tlmgr-_003c_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d_003e"></span>
</dd>
-<dt><strong>paper &ndash;json</strong></dt>
+<dt><span><strong>paper &ndash;json</strong></span></dt>
<dd><span id="tlmgr-paper-_002d_002djson"></span>
</dd>
</dl>
@@ -5184,17 +5254,19 @@ some programs, notably <code>dvips</code>. <code>tlmgr</code> does not support
settings.
</p>
<hr>
-<span id="tlmgr-path"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-path">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">pinning</a>, Previous: <a href="#tlmgr-paper" accesskey="p" rel="prev">paper</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="path"></span><h4 class="appendixsubsec">B.6.17 path</h4>
<dl compact="compact">
-<dt><strong>path [&ndash;w32mode=user|admin] add</strong></dt>
+<dt><span><strong>path [&ndash;w32mode=user|admin] add</strong></span></dt>
<dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></span>
</dd>
-<dt><strong>path [&ndash;w32mode=user|admin] remove</strong></dt>
+<dt><span><strong>path [&ndash;w32mode=user|admin] remove</strong></span></dt>
<dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></span>
<p>On Unix, adds or removes symlinks for executables, man pages, and info
pages in the system directories specified by the respective options (see
@@ -5227,33 +5299,35 @@ is issued that the caller does not have enough privileges.
</dl>
<hr>
-<span id="tlmgr-pinning"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-pinning">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-platform" accesskey="n" rel="next">platform</a>, Previous: <a href="#tlmgr-path" accesskey="p" rel="prev">path</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
+<dt><span><code>pinning show</code></span></dt>
<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>
+<dt><span><code>pinning add</code> <em>repo</em> <em>pkgglob</em>...</span></dt>
<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>
+<dt><span><code>pinning remove</code> <em>repo</em> <em>pkgglob</em>...</span></dt>
<dd><span id="tlmgr-pinning-remove-repo-pkgglob_002e_002e_002e"></span>
<p>Any packages recorded in the pinning file matching the &lt;pkgglob&gt;s for
the given repository <em>repo</em> are removed.
</p>
</dd>
-<dt><code>pinning remove <em>repo</em> --all</code></dt>
+<dt><span><code>pinning remove <em>repo</em> --all</code></span></dt>
<dd><span id="tlmgr-pinning-remove-repo-_002d_002dall"></span>
<p>Remove all pinning data for repository <em>repo</em>.
</p>
@@ -5261,20 +5335,22 @@ the given repository <em>repo</em> are removed.
</dl>
<hr>
-<span id="tlmgr-platform"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-platform">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-postaction" accesskey="n" rel="next">postaction</a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="platform"></span><h4 class="appendixsubsec">B.6.19 platform</h4>
<dl compact="compact">
-<dt><strong>platform list|add|remove <em>platform</em>...</strong></dt>
+<dt><span><strong>platform list|add|remove <em>platform</em>...</strong></span></dt>
<dd><span id="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></span>
</dd>
-<dt><strong>platform set <em>platform</em></strong></dt>
+<dt><span><strong>platform set <em>platform</em></strong></span></dt>
<dd><span id="tlmgr-platform-set-platform"></span>
</dd>
-<dt><strong>platform set auto</strong></dt>
+<dt><span><strong>platform set auto</strong></span></dt>
<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
@@ -5300,7 +5376,7 @@ platform instead of auto detection.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;dry-run</strong></dt>
+<dt><span><strong>&ndash;dry-run</strong></span></dt>
<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.
@@ -5312,17 +5388,19 @@ written to the terminal.
</dl>
<hr>
-<span id="tlmgr-postaction"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-postaction">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-print_002dplatform" accesskey="n" rel="next">print-platform</a>, Previous: <a href="#tlmgr-platform" accesskey="p" rel="prev">platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
+<dt><span><strong>postaction [<em>option</em>...] install [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></span></dt>
<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>
+<dt><span><strong>postaction [<em>option</em>...] remove [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></span></dt>
<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
@@ -5332,7 +5410,7 @@ line, or for all if <code>--all</code> is given.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;w32mode=[user|admin]</strong></dt>
+<dt><span><strong>&ndash;w32mode=[user|admin]</strong></span></dt>
<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
@@ -5341,7 +5419,7 @@ parts of the registry for the file associations. If you do not have
enough permissions, using <code>--w32mode=admin</code> will not succeed.
</p>
</dd>
-<dt><strong>&ndash;fileassocmode=[1|2]</strong></dt>
+<dt><span><strong>&ndash;fileassocmode=[1|2]</strong></span></dt>
<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
@@ -5349,7 +5427,7 @@ set to 1 (the default), only new associations are added; if it is set to
<code>option fileassocs</code>.)
</p>
</dd>
-<dt><strong>&ndash;all</strong></dt>
+<dt><span><strong>&ndash;all</strong></span></dt>
<dd><span id="tlmgr-_002d_002dall-1"></span>
<p>Carry out the postactions for all packages
</p>
@@ -5360,9 +5438,11 @@ set to 1 (the default), only new associations are added; if it is set to
</dl>
<hr>
-<span id="tlmgr-print_002dplatform"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-print_002dplatform">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">print-platform-info</a>, Previous: <a href="#tlmgr-postaction" accesskey="p" rel="prev">postaction</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="print_002dplatform"></span><h4 class="appendixsubsec">B.6.21 print-platform</h4>
@@ -5371,9 +5451,11 @@ Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">tlmg
<code>--print-arch</code> is a synonym.
</p>
<hr>
-<span id="tlmgr-print_002dplatform_002dinfo"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-print_002dplatform_002dinfo">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">remove [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="print_002dplatform_002dinfo"></span><h4 class="appendixsubsec">B.6.22 print-platform-info</h4>
@@ -5381,9 +5463,11 @@ Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"
original output from guess.
</p>
<hr>
-<span id="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-repository" accesskey="n" rel="next">repository</a>, Previous: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="p" rel="prev">print-platform-info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
@@ -5393,35 +5477,35 @@ collection dependencies of that collection. However, when removing a
package, dependencies are never removed. Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;all</strong></dt>
+<dt><span><strong>&ndash;all</strong></span></dt>
<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>&ndash;backup</strong></dt>
+<dt><span><strong>&ndash;backup</strong></span></dt>
<dd><span id="tlmgr-_002d_002dbackup"></span>
</dd>
-<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
+<dt><span><strong>&ndash;backupdir</strong> <em>directory</em></span></dt>
<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
+<p>These options behave just as with the <a data-manual="update" 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.
</p>
<p>The <a href="#tlmgr-restore">restore</a> action explains how to restore from a backup.
</p>
</dd>
-<dt><strong>&ndash;no-depends</strong></dt>
+<dt><span><strong>&ndash;no-depends</strong></span></dt>
<dd><span id="tlmgr-_002d_002dno_002ddepends-1"></span>
<p>Do not remove dependent packages.
</p>
</dd>
-<dt><strong>&ndash;no-depends-at-all</strong></dt>
+<dt><span><strong>&ndash;no-depends-at-all</strong></span></dt>
<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>&ndash;force</strong></dt>
+<dt><span><strong>&ndash;force</strong></span></dt>
<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
@@ -5433,7 +5517,7 @@ updated, and will be mentioned as <code>forcibly removed</code> in the output of
<code>tlmgr update --list</code>.
</p>
</dd>
-<dt><strong>&ndash;dry-run</strong></dt>
+<dt><span><strong>&ndash;dry-run</strong></span></dt>
<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.
@@ -5441,36 +5525,39 @@ written to the terminal.
</dd>
</dl>
-<p>This action does not automatically remove symlinks to executables from
-system directories; you need to run <code>tlmgr path remove</code> (<a href="#tlmgr-path">path</a>)
-yourself if you are using this feature and want stale symlinks removed.
+<p>Except with <code>--all</code>, this <code>remove</code> action does not automatically
+remove symlinks to executables from system directories; you need to run
+<code>tlmgr path remove</code> (<a href="#tlmgr-path">path</a>) yourself if you remove an individual
+package with a symlink in a system directory.
</p>
<hr>
-<span id="tlmgr-repository"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-repository">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-restore" accesskey="n" rel="next">restore</a>, Previous: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">remove [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="repository"></span><h4 class="appendixsubsec">B.6.24 repository</h4>
<dl compact="compact">
-<dt><strong>repository list</strong></dt>
+<dt><span><strong>repository list</strong></span></dt>
<dd><span id="tlmgr-repository-list"></span>
</dd>
-<dt><strong>repository list <em>path|url|tag</em></strong></dt>
+<dt><span><strong>repository list <em>path|url|tag</em></strong></span></dt>
<dd><span id="tlmgr-repository-list-path_007curl_007ctag"></span>
</dd>
-<dt><strong>repository add <em>path</em> [<em>tag</em>]</strong></dt>
+<dt><span><strong>repository add <em>path</em> [<em>tag</em>]</strong></span></dt>
<dd><span id="tlmgr-repository-add-path-_005btag_005d"></span>
</dd>
-<dt><strong>repository remove <em>path|tag</em></strong></dt>
+<dt><span><strong>repository remove <em>path|tag</em></strong></span></dt>
<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>
+<dt><span><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></span></dt>
<dd><span id="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></span>
</dd>
-<dt><strong>repository status</strong></dt>
+<dt><span><strong>repository status</strong></span></dt>
<dd><span id="tlmgr-repository-status"></span>
-<p>This action manages the list of repositories. See <a href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
+<p>This action manages the list of repositories. See <a data-manual="MULTIPLE_REPOSITORIES" href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
</p>
<p>The first form, <code>repository list</code>, lists all configured repositories
and the respective tags if set. If a path, url, or tag is given after
@@ -5492,7 +5579,7 @@ loaded repositories with the format of one repository per line
with fields separated by a single space:
</p>
<dl compact="compact">
-<dt>The tag (which can be the same as the url);</dt>
+<dt><span>The tag (which can be the same as the url);</span></dt>
<dd><span id="tlmgr-The-tag-_0028which-can-be-the-same-as-the-url_0029_003b"></span>
<p>= the url;
</p>
@@ -5515,17 +5602,19 @@ otherwise, all operations will fail!
</dl>
<hr>
-<span id="tlmgr-restore"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-restore">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-search" accesskey="n" rel="next">search</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
+<dt><span><strong>restore [<em>option</em>...] <em>pkg</em> [<em>rev</em>]</strong></span></dt>
<dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></span>
</dd>
-<dt><strong>restore [<em>option</em>...] &ndash;all</strong></dt>
+<dt><span><strong>restore [<em>option</em>...] &ndash;all</strong></span></dt>
<dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></span>
<p>Restore a package from a previously-made backup.
</p>
@@ -5545,31 +5634,31 @@ specified, try to restore the package from the specified backup.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;all</strong></dt>
+<dt><span><strong>&ndash;all</strong></span></dt>
<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>&ndash;backupdir</strong> <em>directory</em></dt>
+<dt><span><strong>&ndash;backupdir</strong> <em>directory</em></span></dt>
<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>&ndash;dry-run</strong></dt>
+<dt><span><strong>&ndash;dry-run</strong></span></dt>
<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>&ndash;force</strong></dt>
+<dt><span><strong>&ndash;force</strong></span></dt>
<dd><span id="tlmgr-_002d_002dforce-2"></span>
<p>Don&rsquo;t ask questions.
</p>
</dd>
-<dt><strong>&ndash;json</strong></dt>
+<dt><span><strong>&ndash;json</strong></span></dt>
<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>).
@@ -5583,20 +5672,22 @@ If both <code>--json</code> and <code>--data</code> are given, <code>--json</cod
</dl>
<hr>
-<span id="tlmgr-search"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-search">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-shell" accesskey="n" rel="next">shell</a>, Previous: <a href="#tlmgr-restore" accesskey="p" rel="prev">restore</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="search"></span><h4 class="appendixsubsec">B.6.26 search</h4>
<dl compact="compact">
-<dt><strong>search [<em>option</em>...] <em>what</em></strong></dt>
+<dt><span><strong>search [<em>option</em>...] <em>what</em></strong></span></dt>
<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-what"></span>
</dd>
-<dt><strong>search [<em>option</em>...] &ndash;file <em>what</em></strong></dt>
+<dt><span><strong>search [<em>option</em>...] &ndash;file <em>what</em></strong></span></dt>
<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></span>
</dd>
-<dt><strong>search [<em>option</em>...] &ndash;all <em>what</em></strong></dt>
+<dt><span><strong>search [<em>option</em>...] &ndash;all <em>what</em></strong></span></dt>
<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
@@ -5605,23 +5696,23 @@ as a (Perl) regular expression.
<p>Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;file</strong></dt>
+<dt><span><strong>&ndash;file</strong></span></dt>
<dd><span id="tlmgr-_002d_002dfile-1"></span>
<p>List all filenames containing <em>what</em>.
</p>
</dd>
-<dt><strong>&ndash;all</strong></dt>
+<dt><span><strong>&ndash;all</strong></span></dt>
<dd><span id="tlmgr-_002d_002dall-4"></span>
<p>Search everything: package names, descriptions and filenames.
</p>
</dd>
-<dt><strong>&ndash;global</strong></dt>
+<dt><span><strong>&ndash;global</strong></span></dt>
<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>&ndash;word</strong></dt>
+<dt><span><strong>&ndash;word</strong></span></dt>
<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
@@ -5635,9 +5726,11 @@ filenames) to match only full words. For example, searching for
</dl>
<hr>
-<span id="tlmgr-shell"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-shell">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-show" accesskey="n" rel="next">show</a>, Previous: <a href="#tlmgr-search" accesskey="p" rel="prev">search</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="shell"></span><h4 class="appendixsubsec">B.6.27 shell</h4>
@@ -5655,43 +5748,43 @@ the session.
<p>Besides these actions, a few commands are specific to shell mode:
</p>
<dl compact="compact">
-<dt>protocol</dt>
+<dt><span>protocol</span></dt>
<dd><span id="tlmgr-protocol"></span>
<p>Print <code>protocol <em>n</em></code>, the current protocol version.
</p>
</dd>
-<dt>help</dt>
+<dt><span>help</span></dt>
<dd><span id="tlmgr-help-1"></span>
<p>Print pointers to this documentation.
</p>
</dd>
-<dt>version</dt>
+<dt><span>version</span></dt>
<dd><span id="tlmgr-version-1"></span>
<p>Print tlmgr version information.
</p>
</dd>
-<dt>quit, end, bye, byebye, EOF</dt>
+<dt><span>quit, end, bye, byebye, EOF</span></dt>
<dd><span id="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></span>
<p>Exit.
</p>
</dd>
-<dt>restart</dt>
+<dt><span>restart</span></dt>
<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>
+<dt><span>load [local|remote]</span></dt>
<dd><span id="tlmgr-load-_005blocal_007cremote_005d"></span>
<p>Explicitly load the local or remote, respectively, TLPDB.
</p>
</dd>
-<dt>save</dt>
+<dt><span>save</span></dt>
<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>
+<dt><span>get [<em>var</em>] =item set [<em>var</em> [<em>val</em>]]</span></dt>
<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>,
@@ -5708,27 +5801,33 @@ current default prompt.
</dl>
<hr>
-<span id="tlmgr-show"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-show">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-uninstall" accesskey="n" rel="next">uninstall</a>, Previous: <a href="#tlmgr-shell" accesskey="p" rel="prev">shell</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="show"></span><h4 class="appendixsubsec">B.6.28 show</h4>
<p>Synonym for <a href="#tlmgr-info">info</a>.
</p>
<hr>
-<span id="tlmgr-uninstall"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-uninstall">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" accesskey="n" rel="next">update [<em>option</em>...] [<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-show" accesskey="p" rel="prev">show</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
-<span id="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-uninstall" accesskey="p" rel="prev">uninstall</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
@@ -5737,7 +5836,7 @@ at the installation source. Either <code>--all</code> or at least one <em>pkg</
must be specified. Options:
</p>
<dl compact="compact">
-<dt><strong>&ndash;all</strong></dt>
+<dt><span><strong>&ndash;all</strong></span></dt>
<dd><span id="tlmgr-_002d_002dall-5"></span>
<p>Update all installed packages except for <code>tlmgr</code> itself. If updates to
<code>tlmgr</code> itself are present, this gives an error, unless also the option
@@ -5777,7 +5876,7 @@ record the repository from which packages come from.)
due to a slow link), see the <code>--exclude</code> option below.
</p>
</dd>
-<dt><strong>&ndash;self</strong></dt>
+<dt><span><strong>&ndash;self</strong></span></dt>
<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
@@ -5796,13 +5895,13 @@ updates.
# ... this last at your own risk, not recommended!
</pre>
</dd>
-<dt><strong>&ndash;dry-run</strong></dt>
+<dt><span><strong>&ndash;dry-run</strong></span></dt>
<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>&ndash;list</strong> [<em>pkg</em>]</dt>
+<dt><span><strong>&ndash;list</strong> [<em>pkg</em>]</span></dt>
<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.
@@ -5817,7 +5916,7 @@ If neither <code>--all</code> nor <code>--self</code> is given, but specific pac
given, those packages are checked for updates.
</p>
</dd>
-<dt><strong>&ndash;exclude</strong> <em>pkg</em></dt>
+<dt><span><strong>&ndash;exclude</strong> <em>pkg</em></span></dt>
<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.
@@ -5839,7 +5938,7 @@ supported in these circumstances.
the key <code>update-exclude</code>.
</p>
</dd>
-<dt><strong>&ndash;no-auto-remove</strong> [<em>pkg</em>...]</dt>
+<dt><span><strong>&ndash;no-auto-remove</strong> [<em>pkg</em>...]</span></dt>
<dd><span id="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></span>
<p>By default, <code>tlmgr</code> tries to remove packages in an existing collection
which have disappeared on the server, as described above under <code>--all</code>.
@@ -5849,7 +5948,7 @@ inconsistent TeX installation, since packages are not infrequently
renamed or replaced by their authors. Therefore this is not recommended.
</p>
</dd>
-<dt><strong>&ndash;no-auto-install</strong> [<em>pkg</em>...]</dt>
+<dt><span><strong>&ndash;no-auto-install</strong> [<em>pkg</em>...]</span></dt>
<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
@@ -5872,7 +5971,7 @@ server, then
option is not recommended.
</p>
</dd>
-<dt><strong>&ndash;reinstall-forcibly-removed</strong></dt>
+<dt><span><strong>&ndash;reinstall-forcibly-removed</strong></span></dt>
<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
@@ -5886,10 +5985,10 @@ installation with the server&rsquo;s idea of what is available:
<pre class="verbatim"> tlmgr update --reinstall-forcibly-removed --all
</pre>
</dd>
-<dt><strong>&ndash;backup</strong></dt>
+<dt><span><strong>&ndash;backup</strong></span></dt>
<dd><span id="tlmgr-_002d_002dbackup-1"></span>
</dd>
-<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
+<dt><span><strong>&ndash;backupdir</strong> <em>directory</em></span></dt>
<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, backing up packages as currently installed. If
@@ -5912,19 +6011,19 @@ incompatibility.
<p>The <a href="#tlmgr-restore">restore</a> action explains how to restore from a backup.
</p>
</dd>
-<dt><strong>&ndash;no-depends</strong></dt>
+<dt><span><strong>&ndash;no-depends</strong></span></dt>
<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>&ndash;no-depends-at-all</strong></dt>
+<dt><span><strong>&ndash;no-depends-at-all</strong></span></dt>
<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>&ndash;force</strong></dt>
+<dt><span><strong>&ndash;force</strong></span></dt>
<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.
@@ -5950,9 +6049,12 @@ directories; you need to run <code>tlmgr</code> <a href="#tlmgr-path">path</a> y
this feature and want new symlinks added.
</p>
<hr>
-<span id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></span><div class="header">
+</div>
+</div>
+<div class="appendixsec" id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">CRYPTOGRAPHIC VERIFICATION</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="CONFIGURATION-FILE-FOR-TLMGR"></span><h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3>
@@ -5977,67 +6079,63 @@ ignored. All other lines must look like:
<p>The allowed keys are:
</p>
<dl compact="compact">
-<dt><code>auto-remove</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><span id="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
+<dt><span><code>auto-remove =</code> 0 or 1 (default 1), same as command-line option.</span></dt>
+<dd><span id="tlmgr-auto_002dremove-_003d-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><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>
+<dt><span><code>gui-expertmode =</code> 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.</span></dt>
+<dd><span id="tlmgr-gui_002dexpertmode-_003d-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><span id="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></span>
+<dt><span><code>gui-lang =</code> <em>llcode</em>, with a language code value as with the command-line option.</span></dt>
+<dd><span id="tlmgr-gui_002dlang-_003d-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><span id="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></span>
+<dt><span><code>no-checksums =</code> 0 or 1 (default 0, see below).</span></dt>
+<dd><span id="tlmgr-no_002dchecksums-_003d-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><span id="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
+<dt><span><code>persistent-downloads =</code> 0 or 1 (default 1), same as command-line option.</span></dt>
+<dd><span id="tlmgr-persistent_002ddownloads-_003d-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><span id="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></span>
+<dt><span><code>require-verification =</code> 0 or 1 (default 0), same as command-line option.</span></dt>
+<dd><span id="tlmgr-require_002dverification-_003d-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
-<dt><code>tkfontscale</code>, value any float. Controls the scaling of fonts in the Tk based frontends.</dt>
-<dd><span id="tlmgr-tkfontscale_002c-value-any-float_002e-Controls-the-scaling-of-fonts-in-the-Tk-based-frontends_002e"></span>
+<dt><span><code>tkfontscale =</code> <em>floating-point number</em> (default 1.0); scaling factor for fonts in the Tk-based frontends.</span></dt>
+<dd><span id="tlmgr-tkfontscale-_003d-floating_002dpoint-number-_0028default-1_002e0_0029_003b-scaling-factor-for-fonts-in-the-Tk_002dbased-frontends_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><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>
+<dt><span><code>update-exclude =</code> <em>comma-separated list of packages</em> (no spaces allowed). Same as the command line option <code>--exclude</code> for the <code>update</code> action.</span></dt>
+<dd><span id="tlmgr-update_002dexclude-_003d-comma_002dseparated-list-of-packages-_0028no-spaces-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-update-action_002e"></span>
</dd>
-<dt><code>verify-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><span id="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
+<dt><span><code>verify-downloads =</code> 0 or 1 (default 1), same as command-line option.</span></dt>
+<dd><span id="tlmgr-verify_002ddownloads-_003d-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
</dl>
<p>The system-wide config file can contain one additional key:
</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><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&rsquo;t
-make sense to set this.
-</p>
+<dt><span><code>allowed-actions =</code> <em>action1</em>[,<em>action2</em>,...] The value is a comma-separated list (no spaces) 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>). This allows distributors to include <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&rsquo;t make sense to set this.</span></dt>
+<dd><span id="tlmgr-allowed_002dactions-_003d-action1_005b_002caction2_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-_0028no-spaces_0029-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e-This-allows-distributors-to-include-tlmgr-in-their-packaging_002c-but-allow-only-a-restricted-set-of-actions-that-do-not-interfere-with-their-distro-package-manager_002e-For-native-TeX-Live-installations_002c-it-doesn_0027t-make-sense-to-set-this_002e"></span>
</dd>
</dl>
-<p>The <code>no-checksums</code> key needs more explanation. By default, package
-checksums computed and stored on the server (in the TLPDB) are compared
-to checksums computed locally after downloading. <code>no-checksums</code>
-disables this process.
-</p>
-<p>The checksum algorithm is SHA-512. Your system must have one of (looked
-for in this order) the Perl <code>Digest::SHA</code> module, the <code>openssl</code>
-program (<a href="https://openssl.org">https://openssl.org</a>), the <code>sha512sum</code> program (from GNU
-Coreutils, <a href="https://www.gnu.org/software/coreutils">https://www.gnu.org/software/coreutils</a>), or finally the
-<code>shasum</code> program (just to support old Macs). If none of these are
-available, a warning is issued and <code>tlmgr</code> proceeds without checking
-checksums. (Incidentally, other SHA implementations, such as the pure
-Perl and pure Lua modules, are much too slow to be usable in our
-context.) <code>no-checksums</code> avoids the warning.
+<p>Finally, the <code>no-checksums</code> key needs more explanation. By default,
+package checksums computed and stored on the server (in the TLPDB) are
+compared to checksums computed locally after downloading.
+<code>no-checksums</code> disables this process. The checksum algorithm is
+SHA-512. Your system must have one of (looked for in this order) the
+Perl <code>Digest::SHA</code> module, the <code>openssl</code> program
+(<a href="https://openssl.org">https://openssl.org</a>), the <code>sha512sum</code> program (from GNU Coreutils,
+<a href="https://www.gnu.org/software/coreutils">https://www.gnu.org/software/coreutils</a>), or finally the <code>shasum</code>
+program (just to support old Macs). If none of these are available, a
+warning is issued and <code>tlmgr</code> proceeds without checking checksums.
+<code>no-checksums</code> avoids the warning. (Incidentally, other SHA
+implementations, such as the pure Perl and pure Lua modules, are much
+too slow to be usable in our context.)
</p>
<hr>
-<span id="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-CRYPTOGRAPHIC-VERIFICATION">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">USER MODE</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="CRYPTOGRAPHIC-VERIFICATION"></span><h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3>
@@ -6077,15 +6175,15 @@ of these keys are obtainable from the standard key servers.
</p>
<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">&bull; <a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">tlmgr Configuration of GnuPG invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">Configuration of GnuPG invocation</a></li>
+</ul>
<hr>
-<span id="tlmgr-Configuration-of-GnuPG-invocation"></span><div class="header">
+<div class="appendixsubsec" id="tlmgr-Configuration-of-GnuPG-invocation">
+<div class="header">
<p>
-Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">tlmgr CRYPTOGRAPHIC VERIFICATION</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">CRYPTOGRAPHIC VERIFICATION</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Configuration-of-GnuPG-invocation"></span><h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4>
@@ -6099,9 +6197,12 @@ value for <code>--homedir</code>, and <code>TL_GNUPGARGS</code>, which replaces
options <code>--no-secmem-warning --no-permission-warning</code>.
</p>
<hr>
-<span id="tlmgr-USER-MODE"></span><div class="header">
+</div>
+</div>
+<div class="appendixsec" id="tlmgr-USER-MODE">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="p" rel="prev">CRYPTOGRAPHIC VERIFICATION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="USER-MODE"></span><h3 class="appendixsec">B.9 USER MODE</h3>
@@ -6157,19 +6258,17 @@ installed into a user tree.
</p>
<p>Description of changes of actions in user mode:
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-install" accesskey="1">tlmgr User mode install</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">tlmgr User mode backup, restore, remove, update</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">tlmgr User mode generate, option, paper</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-User-mode-install" accesskey="1">User mode install</a></li>
+<li><a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">User mode backup, restore, remove, update</a></li>
+<li><a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">User mode generate, option, paper</a></li>
+</ul>
<hr>
-<span id="tlmgr-User-mode-install"></span><div class="header">
+<div class="appendixsubsec" id="tlmgr-User-mode-install">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="n" rel="next">User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="User-mode-install"></span><h4 class="appendixsubsec">B.9.1 User mode install</h4>
@@ -6192,9 +6291,11 @@ the user&rsquo;s <code>updmap.cfg</code> in <code>USERTREE/web2c/</code> is made
regenerated from the list of installed packages.
</p>
<hr>
-<span id="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="n" rel="next">User mode generate, option, paper</a>, Previous: <a href="#tlmgr-User-mode-install" accesskey="p" rel="prev">User mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="User-mode-backup_002c-restore_002c-remove_002c-update"></span><h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4>
@@ -6203,20 +6304,24 @@ installed in the user tree before proceeding; otherwise, they behave
just as in normal mode.
</p>
<hr>
-<span id="tlmgr-User-mode-generate_002c-option_002c-paper"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-User-mode-generate_002c-option_002c-paper">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="p" rel="prev">User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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&rsquo;s
configuration files and/or <code>texlive.tlpdb</code>.
-creates configuration files in user tree
</p>
<hr>
-<span id="tlmgr-MULTIPLE-REPOSITORIES"></span><div class="header">
+</div>
+</div>
+<div class="appendixsec" id="tlmgr-MULTIPLE-REPOSITORIES">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="MULTIPLE-REPOSITORIES"></span><h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3>
@@ -6249,15 +6354,15 @@ anything from there. You also have to specify which packages should be
taken from the new repository, by specifying so-called &ldquo;pinning&rdquo;
rules, described next.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Pinning" accesskey="1">tlmgr Pinning</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-Pinning" accesskey="1">Pinning</a></li>
+</ul>
<hr>
-<span id="tlmgr-Pinning"></span><div class="header">
+<div class="appendixsubsec" id="tlmgr-Pinning">
+<div class="header">
<p>
-Up: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="u" rel="up">tlmgr MULTIPLE REPOSITORIES</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Up: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="u" rel="up">MULTIPLE REPOSITORIES</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Pinning"></span><h4 class="appendixsubsec">B.10.1 Pinning</h4>
@@ -6320,9 +6425,12 @@ from a given repository:
<p>A summary of <code>tlmgr pinning</code> actions is given above.
</p>
<hr>
-<span id="tlmgr-GUI-FOR-TLMGR"></span><div class="header">
+</div>
+</div>
+<div class="appendixsec" id="tlmgr-GUI-FOR-TLMGR">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">MACHINE-READABLE OUTPUT</a>, Previous: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="p" rel="prev">MULTIPLE REPOSITORIES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="GUI-FOR-TLMGR"></span><h3 class="appendixsec">B.11 GUI FOR TLMGR</h3>
@@ -6354,35 +6462,31 @@ repository. To load a different repository, see the <code>tlmgr</code> menu ite
<p>Finally, the status area at the bottom of the window gives additional
information about what is going on.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Main-display" accesskey="1">tlmgr Main display</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Menu-bar" accesskey="2">tlmgr Menu bar</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-GUI-options" accesskey="3">tlmgr GUI options</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-Main-display" accesskey="1">Main display</a></li>
+<li><a href="#tlmgr-Menu-bar" accesskey="2">Menu bar</a></li>
+<li><a href="#tlmgr-GUI-options" accesskey="3">GUI options</a></li>
+</ul>
<hr>
-<span id="tlmgr-Main-display"></span><div class="header">
+<div class="appendixsubsec" id="tlmgr-Main-display">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-Menu-bar" accesskey="n" rel="next">Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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">&bull; <a href="#tlmgr-Display-configuration-area" accesskey="1">tlmgr Display configuration area</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Package-list-area" accesskey="2">tlmgr Package list area</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Main-display-action-buttons" accesskey="3">tlmgr Main display action buttons</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-Display-configuration-area" accesskey="1">Display configuration area</a></li>
+<li><a href="#tlmgr-Package-list-area" accesskey="2">Package list area</a></li>
+<li><a href="#tlmgr-Main-display-action-buttons" accesskey="3">Main display action buttons</a></li>
+</ul>
<hr>
-<span id="tlmgr-Display-configuration-area"></span><div class="header">
+<div class="appendixsubsubsec" id="tlmgr-Display-configuration-area">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-Package-list-area" accesskey="n" rel="next">Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">Main display</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Display-configuration-area"></span><h4 class="appendixsubsubsec">B.11.1.1 Display configuration area</h4>
@@ -6391,34 +6495,34 @@ packages are shown. By default, all are shown. Changes here are
reflected right away.
</p>
<dl compact="compact">
-<dt>Status</dt>
+<dt><span>Status</span></dt>
<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>
+<dt><span>Category</span></dt>
<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>
+<dt><span>Match</span></dt>
<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>
+<dt><span>Selection</span></dt>
<dd><span id="tlmgr-Selection"></span>
<p>Select packages to those selected, those not selected, or all. Here,
&ldquo;selected&rdquo; means that the checkbox in the beginning of the line of a
package is ticked.
</p>
</dd>
-<dt>Display configuration buttons</dt>
+<dt><span>Display configuration buttons</span></dt>
<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,
@@ -6428,9 +6532,11 @@ i.e., show all available.
</dl>
<hr>
-<span id="tlmgr-Package-list-area"></span><div class="header">
+</div>
+<div class="appendixsubsubsec" id="tlmgr-Package-list-area">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-Main-display-action-buttons" accesskey="n" rel="next">Main display action buttons</a>, Previous: <a href="#tlmgr-Display-configuration-area" accesskey="p" rel="prev">Display configuration area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">Main display</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Package-list-area"></span><h4 class="appendixsubsubsec">B.11.1.2 Package list area</h4>
@@ -6444,18 +6550,18 @@ further details: the long description, included files, etc.
<p>Each line of the package list consists of the following items:
</p>
<dl compact="compact">
-<dt>a checkbox</dt>
+<dt><span>a checkbox</span></dt>
<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>
+<dt><span>package name</span></dt>
<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>
+<dt><span>local revision (and version)</span></dt>
<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
@@ -6464,7 +6570,7 @@ However, the catalogue version, unlike the TL revision, is not
guaranteed to reflect what is actually installed.
</p>
</dd>
-<dt>remote revision (and version)</dt>
+<dt><span>remote revision (and version)</span></dt>
<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
@@ -6472,7 +6578,7 @@ catalogue version is provided it will be displayed. And also as with
the local column, the catalogue version may be stale.
</p>
</dd>
-<dt>short description</dt>
+<dt><span>short description</span></dt>
<dd><span id="tlmgr-short-description"></span>
<p>The short description of the package.
</p>
@@ -6480,16 +6586,18 @@ the local column, the catalogue version may be stale.
</dl>
<hr>
-<span id="tlmgr-Main-display-action-buttons"></span><div class="header">
+</div>
+<div class="appendixsubsubsec" id="tlmgr-Main-display-action-buttons">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-Package-list-area" accesskey="p" rel="prev">Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">Main display</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
+<dt><span>Update all installed</span></dt>
<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
@@ -6499,26 +6607,26 @@ previously removed packages as part of this action.
where the checkbox at the beginning of the package line is ticked.
</p>
</dd>
-<dt>Update</dt>
+<dt><span>Update</span></dt>
<dd><span id="tlmgr-Update"></span>
<p>Update only the selected packages.
</p>
</dd>
-<dt>Install</dt>
+<dt><span>Install</span></dt>
<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>
+<dt><span>Remove</span></dt>
<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>
+<dt><span>Backup</span></dt>
<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&gt;).
@@ -6527,16 +6635,19 @@ action needs the option <code>backupdir</code> set (see <code>Options -</code> G
</dl>
<hr>
-<span id="tlmgr-Menu-bar"></span><div class="header">
+</div>
+</div>
+<div class="appendixsubsec" id="tlmgr-Menu-bar">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-GUI-options" accesskey="n" rel="next">GUI options</a>, Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="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>
+<dt><span><code>tlmgr</code> menu</span></dt>
<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
@@ -6544,7 +6655,7 @@ specified on the command line (if any), and an arbitrarily
manually-entered one. Also has the so-necessary <code>quit</code> operation.
</p>
</dd>
-<dt><code>Options menu</code></dt>
+<dt><span><code>Options menu</code></span></dt>
<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
@@ -6564,7 +6675,7 @@ choices of what is or isn&rsquo;t installed may lead to an inconsistent TeX Live
installation; e.g., when a package is renamed.
</p>
</dd>
-<dt><code>Actions menu</code></dt>
+<dt><span><code>Actions menu</code></span></dt>
<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
@@ -6576,7 +6687,7 @@ Windows).
on Windows).
</p>
</dd>
-<dt><code>Help menu</code></dt>
+<dt><span><code>Help menu</code></span></dt>
<dd><span id="tlmgr-Help-menu"></span>
<p>Provides access to the TeX Live manual (also on the web at
<a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>) and the usual &ldquo;About&rdquo; box.
@@ -6585,9 +6696,11 @@ on Windows).
</dl>
<hr>
-<span id="tlmgr-GUI-options"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-GUI-options">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="GUI-options"></span><h4 class="appendixsubsec">B.11.3 GUI options</h4>
@@ -6595,30 +6708,30 @@ Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">tlmgr Menu bar</a>,
control the display:
</p>
<dl compact="compact">
-<dt><code>-background</code> <em>color</em></dt>
+<dt><span><code>-background</code> <em>color</em></span></dt>
<dd><span id="tlmgr-_002dbackground-color"></span>
<p>Set background color.
</p>
</dd>
-<dt><code>-font &quot;</code> <em>fontname</em> <em>fontsize</em> <code>&quot;</code></dt>
+<dt><span><code>-font &quot;</code> <em>fontname</em> <em>fontsize</em> <code>&quot;</code></span></dt>
<dd><span id="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></span>
<p>Set font, e.g., <code>tlmgr gui -font &quot;helvetica 18&quot;</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>
+<dt><span><code>-foreground</code> <em>color</em></span></dt>
<dd><span id="tlmgr-_002dforeground-color"></span>
<p>Set foreground color.
</p>
</dd>
-<dt><code>-geometry</code> <em>geomspec</em></dt>
+<dt><span><code>-geometry</code> <em>geomspec</em></span></dt>
<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>
+<dt><span><code>-xrm</code> <em>xresource</em></span></dt>
<dd><span id="tlmgr-_002dxrm-xresource"></span>
<p>Pass the arbitrary X resource string <em>xresource</em>.
</p>
@@ -6630,9 +6743,12 @@ the Perl/Tk documentation (<a href="https://search.cpan.org/perldoc?Tk">https://
complete list, and any X documentation for general information.
</p>
<hr>
-<span id="tlmgr-MACHINE_002dREADABLE-OUTPUT"></span><div class="header">
+</div>
+</div>
+<div class="appendixsec" id="tlmgr-MACHINE_002dREADABLE-OUTPUT">
+<div class="header">
<p>
-Next: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">tlmgr ENVIRONMENT VARIABLES</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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">ENVIRONMENT VARIABLES</a>, Previous: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="p" rel="prev">GUI FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="MACHINE_002dREADABLE-OUTPUT"></span><h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3>
@@ -6647,17 +6763,16 @@ information it needs by reading stdout.
<a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a>, and
<a href="#tlmgr-option">option</a> actions.
</p>
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <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>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="2">tlmgr Machine-readable <code>option</code> output</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
+<ul class="section-toc">
+<li><a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="1">Machine-readable <code>update</code> and <code>install</code> output</a></li>
+<li><a href="#tlmgr-Machine_002dreadable-option-output" accesskey="2">Machine-readable <code>option</code> output</a></li>
+</ul>
<hr>
-<span id="tlmgr-Machine_002dreadable-update-and-install-output"></span><div class="header">
+<div class="appendixsubsec" id="tlmgr-Machine_002dreadable-update-and-install-output">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="n" rel="next">Machine-readable <code>option</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">MACHINE-READABLE OUTPUT</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Machine_002dreadable-update-and-install-output"></span><h4 class="appendixsubsec">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</h4>
@@ -6687,14 +6802,14 @@ and the estimated total time.
<p>Line endings may be either LF or CRLF depending on the current platform.
</p>
<dl compact="compact">
-<dt><code>location-url</code> <em>location</em></dt>
+<dt><span><code>location-url</code> <em>location</em></span></dt>
<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>
+<dt><span><code>total-bytes</code> <em>count</em></span></dt>
<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).
@@ -6709,54 +6824,54 @@ reports on one package. The fields on
each line are separated by a tab. Here are the fields.
</p>
<dl compact="compact">
-<dt><em>pkgname</em></dt>
+<dt><span><em>pkgname</em></span></dt>
<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>
+<dt><span><em>status</em></span></dt>
<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>
+<dt><span><code>d</code></span></dt>
<dd><span id="tlmgr-d"></span>
<p>The package was removed on the server.
</p>
</dd>
-<dt><code>f</code></dt>
+<dt><span><code>f</code></span></dt>
<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>
+<dt><span><code>u</code></span></dt>
<dd><span id="tlmgr-u"></span>
<p>Normal update is needed.
</p>
</dd>
-<dt><code>r</code></dt>
+<dt><span><code>r</code></span></dt>
<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>
+<dt><span><code>a</code></span></dt>
<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>
+<dt><span><code>i</code></span></dt>
<dd><span id="tlmgr-i"></span>
<p>Package will be installed and isn&rsquo;t present in the local installation
(action install).
</p>
</dd>
-<dt><code>I</code></dt>
+<dt><span><code>I</code></span></dt>
<dd><span id="tlmgr-I"></span>
<p>Package is already present but will be reinstalled (action install).
</p>
@@ -6764,30 +6879,30 @@ the server and is (most probably) part of an installed collection.
</dl>
</dd>
-<dt><em>localrev</em></dt>
+<dt><span><em>localrev</em></span></dt>
<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>
+<dt><span><em>serverrev</em></span></dt>
<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>
+<dt><span><em>size</em></span></dt>
<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>
+<dt><span><em>runtime</em></span></dt>
<dd><span id="tlmgr-runtime"></span>
<p>The run time since start of installations or updates.
</p>
</dd>
-<dt><em>esttot</em></dt>
+<dt><span><em>esttot</em></span></dt>
<dd><span id="tlmgr-esttot"></span>
<p>The estimated total time.
</p>
@@ -6795,9 +6910,11 @@ package sizes is given in the <code>total-bytes</code> header field mentioned ab
</dl>
<hr>
-<span id="tlmgr-Machine_002dreadable-option-output"></span><div class="header">
+</div>
+<div class="appendixsubsec" id="tlmgr-Machine_002dreadable-option-output">
+<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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="p" rel="prev">Machine-readable <code>update</code> and <code>install</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">MACHINE-READABLE OUTPUT</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Machine_002dreadable-option-output"></span><h4 class="appendixsubsec">B.12.2 Machine-readable <code>option</code> output</h4>
@@ -6811,9 +6928,12 @@ 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>
-<span id="tlmgr-ENVIRONMENT-VARIABLES"></span><div class="header">
+</div>
+</div>
+<div class="appendixsec" id="tlmgr-ENVIRONMENT-VARIABLES">
+<div class="header">
<p>
-Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">tlmgr AUTHORS AND COPYRIGHT</a>, 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> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">AUTHORS AND COPYRIGHT</a>, Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">MACHINE-READABLE OUTPUT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="ENVIRONMENT-VARIABLES-1"></span><h3 class="appendixsec">B.13 ENVIRONMENT VARIABLES</h3>
@@ -6825,7 +6945,7 @@ following environment variables. These are not of interest for normal
user installations.
</p>
<dl compact="compact">
-<dt><code>TEXLIVE_COMPRESSOR</code></dt>
+<dt><span><code>TEXLIVE_COMPRESSOR</code></span></dt>
<dd><span id="tlmgr-TEXLIVE_005fCOMPRESSOR"></span>
<p>This variable allows selecting a different compressor program for
backups and intermediate rollback containers. The order of selection is:
@@ -6848,13 +6968,13 @@ are preferred. The unconditional use of xz for the tlnet containers is
unaffected, to minimize download sizes.
</p>
</dd>
-<dt><code>TEXLIVE_DOWNLOADER</code></dt>
+<dt><span><code>TEXLIVE_DOWNLOADER</code></span></dt>
<dd><span id="tlmgr-TEXLIVE_005fDOWNLOADER"></span>
</dd>
-<dt><code>TL_DOWNLOAD_PROGRAM</code></dt>
+<dt><span><code>TL_DOWNLOAD_PROGRAM</code></span></dt>
<dd><span id="tlmgr-TL_005fDOWNLOAD_005fPROGRAM"></span>
</dd>
-<dt><code>TL_DOWNLOAD_ARGS</code></dt>
+<dt><span><code>TL_DOWNLOAD_ARGS</code></span></dt>
<dd><span id="tlmgr-TL_005fDOWNLOAD_005fARGS"></span>
<p>These options allow selecting different download programs then the ones
automatically selected by the installer. The order of selection is:
@@ -6881,7 +7001,7 @@ efficient method, as it supports persistent downloads).
download method should always be available.
</p>
</dd>
-<dt><code>TEXLIVE_PREFER_OWN</code></dt>
+<dt><span><code>TEXLIVE_PREFER_OWN</code></span></dt>
<dd><span id="tlmgr-TEXLIVE_005fPREFER_005fOWN"></span>
<p>By default, compression and download programs provided by the system,
i.e., found along <code>PATH</code> are preferred over those shipped with TeX
@@ -6904,9 +7024,11 @@ regardless of any setting.
</dl>
<hr>
-<span id="tlmgr-AUTHORS-AND-COPYRIGHT"></span><div class="header">
+</div>
+<div class="appendixsec" id="tlmgr-AUTHORS-AND-COPYRIGHT">
+<div class="header">
<p>
-Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">tlmgr ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.14 AUTHORS AND COPYRIGHT</h3>
@@ -6914,17 +7036,22 @@ Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">tlmgr
distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
-<p>$Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $
+<p>$Id: tlmgr.pl 62273 2022-02-28 08:52:17Z preining $
</p>
<hr>
-<span id="Index"></span><div class="header">
+</div>
+</div>
+<div class="unnumbered" id="Index">
+<div class="header">
<p>
-Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top" accesskey="u" rel="up">Building TeX Live (2022)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
-<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>$</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-2"><b>-</b></a>
&nbsp;
<br>
<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
@@ -6941,6 +7068,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
&nbsp;
<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
&nbsp;
+<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
+ &nbsp;
<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
&nbsp;
<a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a>
@@ -6975,7 +7104,10 @@ 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>&nbsp;</td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th id="Index_cp_symbol-1">-</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-_0024_0040-target-in-normal-make-rules"><code>$@</code> target in normal <code>make</code> rules</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Index_cp_symbol-2">-</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>&nbsp;</td><td valign="top"><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026"><code>--prefix</code> <code>--bindir</code> &hellip;</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>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr>
@@ -7018,7 +7150,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-_002d_002denable_002dxindy_002drules"><code>--enable-xindy-rules</code></a>:</td><td>&nbsp;</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-_002d_002dhost_003dhost"><code>--host=<var>host</var></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dlibdir-configure-option"><code>--libdir configure <span class="roman">option</span></code></a>:</td><td>&nbsp;</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_002dno_002dclean-Build-option"><code>--no-clean Build <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dprint_002ddirectory-GNU-make-option"><code>--no-print-directory <span class="roman">GNU make option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-one-engine">Build one engine</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dprefix-configure-option"><code>--prefix configure <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026"><code>--prefix</code> <code>--bindir</code> &hellip;</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dwith_002dbanner_002dadd_003dstr"><code>--with-banner-add=<var>str</var></code></a>:</td><td>&nbsp;</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-_002d_002dwith_002dclisp_002druntime_003dfilename"><code>--with-clisp-runtime=<var>filename</var></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-utils_002fxindy">Configure options for <samp>utils/xindy</samp></a></td></tr>
@@ -7043,6 +7175,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ac_002fwithenable_002eac"><code>ac/withenable.ac</code></a>:</td><td>&nbsp;</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-adapting-TeX-Live-for-distros">adapting TeX&nbsp;Live for distros</a>:</td><td>&nbsp;</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-engine">adding a new engine</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-a-new-engine">Adding a new engine</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>&nbsp;</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>&nbsp;</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-adding-a-new-TeX_002dspecific-library">adding a new TeX-specific library</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr>
@@ -7068,7 +7201,6 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-build-on-demand">build on demand</a>:</td><td>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#Building">Building</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-system_002c-design-of">build system, design of</a>:</td><td>&nbsp;</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-build_002daux_002f-top_002dlevel-directory"><samp>build-aux/</samp> top-level directory</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
@@ -7110,6 +7242,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-configure-options_002c-global"><code>configure</code> options, global</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-configure-options">Global configure options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-options_002c-library_002dspecific"><code>configure</code> options, library-specific</a>:</td><td>&nbsp;</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-configure-options_002c-program_002dspecific"><code>configure</code> options, program-specific</a>:</td><td>&nbsp;</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-configure-problems_002c-work-around-by-removing"><code>configure</code> problems, work around by removing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-variables"><code>configure</code> variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure_002eac"><code>configure.ac</code></a>:</td><td>&nbsp;</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-configuring_002c-for-cross-compilation">configuring, for cross compilation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr>
@@ -7139,9 +7272,10 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-dvipdfm_002dx"><code>dvipdfm-x</code></a>:</td><td>&nbsp;</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>&nbsp;</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>&nbsp;</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_002c-requires-C_002b_002b11"><code>dvisvgm</code>, requires C++11</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td colspan="4"> <hr></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-adding-new">engine, adding new</a>:</td><td>&nbsp;</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-engine_002c-adding-new">engine, adding new</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-a-new-engine">Adding a new engine</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-engine_002c-building-one">engine, building one</a>:</td><td>&nbsp;</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>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr>
@@ -7149,12 +7283,11 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-extern-functions"><code>extern</code> functions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td colspan="4"> <hr></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>&nbsp;</td><td valign="top"><a href="#Build-problems">Build problems</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>&nbsp;</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>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-freetype-cross-compiling"><code>freetype</code> cross compiling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-freetype-library"><code>freetype <span class="roman">library</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#freetype-library"><code>freetype</code> library</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-FreeType_002c-requires-gmake">FreeType, requires <code>gmake</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-freetype_002dconfig"><code>freetype-config</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#freetype-library"><code>freetype</code> library</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-freetype_002dconfig-1"><code>freetype-config</code></a>:</td><td>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
@@ -7172,9 +7305,13 @@ 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>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td colspan="4"> <hr></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-HarfBuzz_002c-requires-C_002b_002b11">HarfBuzz, requires C++11</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><td colspan="4"> <hr></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>&nbsp;</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>&nbsp;</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_002c-requires-C_002b_002b11">ICU, requires C++11</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-icu_002dconfig"><code>icu-config</code></a>:</td><td>&nbsp;</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_005fCONFIG"><code>ICU_CONFIG</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-infrastructure_002c-tools-needed-for">infrastructure, tools needed for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr>
@@ -7305,15 +7442,16 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-Preining_002c-Norbert">Preining, Norbert</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-preloaded-binaries">preloaded binaries</a>:</td><td>&nbsp;</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-prerequisites-for-building">prerequisites for building</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-problems-with-build">problems with build</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-program-module_002c-adding">program module, adding</a>:</td><td>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#png-library"><code>png</code> library</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Python_002c-required-by-ICU">Python, required by ICU</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td colspan="4"> <hr></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>&nbsp;</td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-reautoconf_002c-for-new-program"><code>reautoconf<span class="roman">, for new program</span></code></a>:</td><td>&nbsp;</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-removing-build-directories">removing build directories</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-requirements-for-building">requirements for building</a>:</td><td>&nbsp;</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>&nbsp;</td><td valign="top"><a href="#Macros-for-Windows">Macros for Windows</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
@@ -7346,6 +7484,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-tests_002c-running">tests, running</a>:</td><td>&nbsp;</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-TeX_002dspecific-library-module_002c-adding">TeX-specific library module, adding</a>:</td><td>&nbsp;</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-texlive_002etlpdb_002c-TeX-Live-database"><code>texlive.tlpdb<span class="roman">, TeX&nbsp;Live database</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Installing">Installing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TEXMFCNF-for-running-standalone"><code>TEXMFCNF <span class="roman">for running standalone</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-TEXMFROOT-for-running-standalone"><code>TEXMFROOT <span class="roman">for running standalone</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tie"><code>tie</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-timestamps_002c-in-repository">timestamps, in repository</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-TLpatches_002fpatch_002d_002e_002e_002e"><code>TLpatches/patch-...</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr>
@@ -7400,7 +7540,9 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-zlib-library"><code>zlib <span class="roman">library</span></code></a>:</td><td>&nbsp;</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: &nbsp; </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a>
+<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>$</b></a>
+ &nbsp;
+<a class="summary-letter" href="#Index_cp_symbol-2"><b>-</b></a>
&nbsp;
<br>
<a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a>
@@ -7417,6 +7559,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
&nbsp;
<a class="summary-letter" href="#Index_cp_letter-G"><b>G</b></a>
&nbsp;
+<a class="summary-letter" href="#Index_cp_letter-H"><b>H</b></a>
+ &nbsp;
<a class="summary-letter" href="#Index_cp_letter-I"><b>I</b></a>
&nbsp;
<a class="summary-letter" href="#Index_cp_letter-K"><b>K</b></a>
@@ -7449,7 +7593,20 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
&nbsp;
</td></tr></table>
+</div>
+</div>
+<div class="footnote">
<hr>
+<h4 class="footnotes-heading">Footnotes</h4>
+
+<h5><a id="FOOT1" href="#DOCF1">(1)</a></h5>
+<p>There is one exception in TL: the
+<code>tangle-sh</code> and related rules use <code>$@</code> to mean the target
+name, a feature not present in all <code>make</code>s. This could be
+alleviated by laborious editing, but since there&rsquo;s no way to avoid GNU
+<code>make</code> for builds of the entire tree, it does not seem worth the
+trouble.</p>
+</div>
diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
index 50a540320a5..52293aedf7c 100644
--- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
+++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
Binary files differ