summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-02-28 19:14:13 +0000
committerKarl Berry <karl@freefriends.org>2019-02-28 19:14:13 +0000
commitadd3d8683677b558254f61267e1dc6830c9c73da (patch)
tree4379ee2cdd108a2a6a83d11d807f95c8fb82ab67 /Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
parent342f4c70c13251fa670faa123091c128ec8bfdda (diff)
tl19 texinfo update
git-svn-id: svn://tug.org/texlive/trunk@50170 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html')
-rw-r--r--Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html3579
1 files changed, 1670 insertions, 1909 deletions
diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
index 223cee7a568..5cdc2124c48 100644
--- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
+++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
@@ -2,7 +2,7 @@
<html>
<!-- This file documents the TeX Live build system and more.
-Copyright (C) 2016-2018 Karl Berry.
+Copyright (C) 2016-2019 Karl Berry.
Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner.
@@ -20,13 +20,13 @@ Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the TeX Users Group. -->
-<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>Building TeX Live (2018)</title>
+<title>Building TeX Live (2019)</title>
-<meta name="description" content="Building TeX Live (2018)">
-<meta name="keywords" content="Building TeX Live (2018)">
+<meta name="description" content="Building TeX Live (2019)">
+<meta name="keywords" content="Building TeX Live (2019)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -38,23 +38,14 @@ approved by the TeX Users Group. -->
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
-blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
-blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
-div.smalldisplay {margin-left: 3.2em}
-div.smallexample {margin-left: 3.2em}
-div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
-pre.smalldisplay {font-family: inherit; font-size: smaller}
-pre.smallexample {font-size: smaller}
-pre.smallformat {font-family: inherit; font-size: smaller}
-pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
@@ -66,7 +57,7 @@ ul.no-bullet {list-style: none}
</head>
<body lang="en">
-<h1 class="settitle" align="center">Building TeX Live (2018)</h1>
+<h1 class="settitle" align="center">Building TeX Live (2019)</h1>
@@ -76,339 +67,335 @@ ul.no-bullet {list-style: none}
-<a name="SEC_Overview"></a>
+<span id="SEC_Overview"></span>
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
<ul class="no-bullet">
-<li><a name="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li>
-<li><a name="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li>
-<li><a name="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li>
-<li><a name="stoc-Building-1" href="#toc-Building-1">4 Building</a></li>
-<li><a name="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li>
-<li><a name="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li>
-<li><a name="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li>
-<li><a name="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li>
-<li><a name="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li>
-<li><a name="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li>
-<li><a name="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li>
-<li><a name="stoc-Index-1" href="#toc-Index-1">Index</a></li>
+<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li>
+<li><a id="stoc-Overview-of-build-system-1" href="#toc-Overview-of-build-system-1">2 Overview of build system</a></li>
+<li><a id="stoc-Prerequisites-1" href="#toc-Prerequisites-1">3 Prerequisites</a></li>
+<li><a id="stoc-Building-1" href="#toc-Building-1">4 Building</a></li>
+<li><a id="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li>
+<li><a id="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li>
+<li><a id="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li>
+<li><a id="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li>
+<li><a id="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li>
+<li><a id="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li>
+<li><a id="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li>
+<li><a id="stoc-Index-1" href="#toc-Index-1">Index</a></li>
</ul>
</div>
-<a name="SEC_Contents"></a>
+<span id="SEC_Contents"></span>
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="no-bullet">
- <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
- <li><a name="toc-Overview-of-build-system-1" href="#Overview-of-build-system">2 Overview of build system</a></li>
- <li><a name="toc-Prerequisites-1" href="#Prerequisites">3 Prerequisites</a></li>
- <li><a name="toc-Building-1" href="#Building">4 Building</a>
+ <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a></li>
+ <li><a id="toc-Overview-of-build-system-1" href="#Overview-of-build-system">2 Overview of build system</a></li>
+ <li><a id="toc-Prerequisites-1" href="#Prerequisites">3 Prerequisites</a></li>
+ <li><a id="toc-Building-1" href="#Building">4 Building</a>
<ul class="no-bullet">
- <li><a name="toc-Build-iteration-1" href="#Build-iteration">4.1 Build iteration</a></li>
- <li><a name="toc-Build-problems-1" href="#Build-problems">4.2 Build problems</a></li>
- <li><a name="toc-Build-in-parallel-1" href="#Build-in-parallel">4.3 Build in parallel</a></li>
- <li><a name="toc-Build-distribution-1" href="#Build-distribution">4.4 Build distribution</a></li>
- <li><a name="toc-Build-one-package-1" href="#Build-one-package">4.5 Build one package</a></li>
- <li><a name="toc-Cross-compilation-1" href="#Cross-compilation">4.6 Cross compilation</a>
+ <li><a id="toc-Build-iteration-1" href="#Build-iteration">4.1 Build iteration</a></li>
+ <li><a id="toc-Build-problems-1" href="#Build-problems">4.2 Build problems</a></li>
+ <li><a id="toc-Build-in-parallel-1" href="#Build-in-parallel">4.3 Build in parallel</a></li>
+ <li><a id="toc-Build-distribution-1" href="#Build-distribution">4.4 Build distribution</a></li>
+ <li><a id="toc-Build-one-package-1" href="#Build-one-package">4.5 Build one package</a></li>
+ <li><a id="toc-Build-one-engine-1" href="#Build-one-engine">4.6 Build one engine</a></li>
+ <li><a id="toc-Cross-compilation-1" href="#Cross-compilation">4.7 Cross compilation</a>
<ul class="no-bullet">
- <li><a name="toc-Cross-configuring-1" href="#Cross-configuring">4.6.1 Cross configuring</a></li>
- <li><a name="toc-Cross-problems-1" href="#Cross-problems">4.6.2 Cross problems</a></li>
+ <li><a id="toc-Cross-configuring-1" href="#Cross-configuring">4.7.1 Cross configuring</a></li>
+ <li><a id="toc-Cross-problems-1" href="#Cross-problems">4.7.2 Cross problems</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Installing-1" href="#Installing">5 Installing</a>
+ <li><a id="toc-Installing-1" href="#Installing">5 Installing</a>
<ul class="no-bullet">
- <li><a name="toc-Installation-directories-1" href="#Installation-directories">5.1 Installation directories</a></li>
- <li><a name="toc-Linked-scripts-1" href="#Linked-scripts">5.2 Linked scripts</a></li>
- <li><a name="toc-Distro-builds-1" href="#Distro-builds">5.3 Distro builds</a></li>
+ <li><a id="toc-Installation-directories-1" href="#Installation-directories">5.1 Installation directories</a></li>
+ <li><a id="toc-Linked-scripts-1" href="#Linked-scripts">5.2 Linked scripts</a></li>
+ <li><a id="toc-Distro-builds-1" href="#Distro-builds">5.3 Distro builds</a></li>
</ul></li>
- <li><a name="toc-Layout-and-infrastructure-1" href="#Layout-and-infrastructure">6 Layout and infrastructure</a>
+ <li><a id="toc-Layout-and-infrastructure-1" href="#Layout-and-infrastructure">6 Layout and infrastructure</a>
<ul class="no-bullet">
- <li><a name="toc-Build-system-tools-1" href="#Build-system-tools">6.1 Build system tools</a></li>
- <li><a name="toc-Top_002dlevel-directories-1" href="#Top_002dlevel-directories">6.2 Top-level directories</a></li>
- <li><a name="toc-Autoconf-macros-1" href="#Autoconf-macros">6.3 Autoconf macros</a>
+ <li><a id="toc-Build-system-tools-1" href="#Build-system-tools">6.1 Build system tools</a></li>
+ <li><a id="toc-Top_002dlevel-directories-1" href="#Top_002dlevel-directories">6.2 Top-level directories</a></li>
+ <li><a id="toc-Autoconf-macros-1" href="#Autoconf-macros">6.3 Autoconf macros</a>
<ul class="no-bullet">
- <li><a name="toc-General-setup-macros-1" href="#General-setup-macros">6.3.1 General setup macros</a></li>
- <li><a name="toc-Macros-for-programs-1" href="#Macros-for-programs">6.3.2 Macros for programs</a></li>
- <li><a name="toc-Macros-for-compilers-1" href="#Macros-for-compilers">6.3.3 Macros for compilers</a></li>
- <li><a name="toc-Macros-for-libraries-1" href="#Macros-for-libraries">6.3.4 Macros for libraries</a></li>
- <li><a name="toc-Macros-for-library-and-header-flags-1" href="#Macros-for-library-and-header-flags">6.3.5 Macros for library and header flags</a></li>
- <li><a name="toc-Macros-for-Windows-1" href="#Macros-for-Windows">6.3.6 Macros for Windows</a></li>
+ <li><a id="toc-General-setup-macros-1" href="#General-setup-macros">6.3.1 General setup macros</a></li>
+ <li><a id="toc-Macros-for-programs-1" href="#Macros-for-programs">6.3.2 Macros for programs</a></li>
+ <li><a id="toc-Macros-for-compilers-1" href="#Macros-for-compilers">6.3.3 Macros for compilers</a></li>
+ <li><a id="toc-Macros-for-libraries-1" href="#Macros-for-libraries">6.3.4 Macros for libraries</a></li>
+ <li><a id="toc-Macros-for-library-and-header-flags-1" href="#Macros-for-library-and-header-flags">6.3.5 Macros for library and header flags</a></li>
+ <li><a id="toc-Macros-for-Windows-1" href="#Macros-for-Windows">6.3.6 Macros for Windows</a></li>
</ul></li>
- <li><a name="toc-Library-modules-1" href="#Library-modules">6.4 Library modules</a>
+ <li><a id="toc-Library-modules-1" href="#Library-modules">6.4 Library modules</a>
<ul class="no-bullet">
- <li><a name="toc-The-png-library-in-libs_002flibpng" href="#png-library">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></a></li>
- <li><a name="toc-The-zlib-library-in-libs_002fzlib" href="#zlib-library">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></a></li>
- <li><a name="toc-The-freetype-library-in-libs_002ffreetype2" href="#freetype-library">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></a></li>
- <li><a name="toc-The-kpathsea-library-in-texk_002fkpathsea" href="#kpathsea-library">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a></li>
+ <li><a id="toc-The-png-library-in-libs_002flibpng" href="#png-library">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></a></li>
+ <li><a id="toc-The-zlib-library-in-libs_002fzlib" href="#zlib-library">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></a></li>
+ <li><a id="toc-The-freetype-library-in-libs_002ffreetype2" href="#freetype-library">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></a></li>
+ <li><a id="toc-The-kpathsea-library-in-texk_002fkpathsea" href="#kpathsea-library">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></a></li>
</ul></li>
- <li><a name="toc-Program-modules-1" href="#Program-modules">6.5 Program modules</a>
+ <li><a id="toc-Program-modules-1" href="#Program-modules">6.5 Program modules</a>
<ul class="no-bullet">
- <li><a name="toc-The-t1utils-package-in-utils_002ft1utils" href="#t1utils-package">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></a></li>
- <li><a name="toc-The-xindy-package-in-utils_002fxindy" href="#xindy-package">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></a></li>
- <li><a name="toc-The-xdvik-package-in-texk_002fxdvik" href="#xdvik-package">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li>
- <li><a name="toc-The-subdirectory-utils_002fasymptote" href="#asymptote">6.5.4 The subdirectory <samp>utils/asymptote</samp></a></li>
+ <li><a id="toc-The-t1utils-package-in-utils_002ft1utils" href="#t1utils-package">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></a></li>
+ <li><a id="toc-The-xindy-package-in-utils_002fxindy" href="#xindy-package">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></a></li>
+ <li><a id="toc-The-xdvik-package-in-texk_002fxdvik" href="#xdvik-package">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li>
+ <li><a id="toc-The-subdirectory-utils_002fasymptote" href="#asymptote">6.5.4 The subdirectory <samp>utils/asymptote</samp></a></li>
</ul></li>
- <li><a name="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX&nbsp;Live</a>
+ <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 name="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li>
- <li><a name="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.2 Adding a new generic library module</a></li>
- <li><a name="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.3 Adding a new TeX-specific library module</a></li>
+ <li><a id="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li>
+ <li><a id="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.2 Adding a new generic library module</a></li>
+ <li><a id="toc-Adding-a-new-TeX_002dspecific-library-module-1" href="#Adding-a-new-TeX_002dspecific-library-module">6.6.3 Adding a new TeX-specific library module</a></li>
</ul></li>
</ul></li>
- <li><a name="toc-Configure-options-1" href="#Configure-options">7 Configure options</a>
+ <li><a id="toc-Configure-options-1" href="#Configure-options">7 Configure options</a>
<ul class="no-bullet">
- <li><a name="toc-Global-configure-options-1" href="#Global-configure-options">7.1 Global configure options</a>
+ <li><a id="toc-Global-configure-options-1" href="#Global-configure-options">7.1 Global configure options</a>
<ul class="no-bullet">
- <li><a name="toc-_002d_002ddisable_002dnative_002dtexlive_002dbuild-1" href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">7.1.1 <code>--disable-native-texlive-build</code></a></li>
- <li><a name="toc-_002d_002dprefix_002c-_002d_002dbindir_002c-_2026" href="#g_t_002d_002dprefix-_002d_002dbindir-_2026">7.1.2 <code>--prefix</code>, <code>--bindir</code>, &hellip;</a></li>
- <li><a name="toc-_002d_002ddisable_002dlargefile-1" href="#g_t_002d_002ddisable_002dlargefile">7.1.3 <code>--disable-largefile</code></a></li>
- <li><a name="toc-_002d_002ddisable_002dmissing-1" href="#g_t_002d_002ddisable_002dmissing">7.1.4 <code>--disable-missing</code></a></li>
- <li><a name="toc-_002d_002denable_002dcompiler_002dwarnings_003dlevel-1" href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></a></li>
- <li><a name="toc-_002d_002denable_002dcxx_002druntime_002dhack-1" href="#g_t_002d_002denable_002dcxx_002druntime_002dhack">7.1.6 <code>--enable-cxx-runtime-hack</code></a></li>
- <li><a name="toc-_002d_002denable_002dmaintainer_002dmode-1" href="#g_t_002d_002denable_002dmaintainer_002dmode">7.1.7 <code>--enable-maintainer-mode</code></a></li>
- <li><a name="toc-_002d_002denable_002dmultiplatform-1" href="#g_t_002d_002denable_002dmultiplatform">7.1.8 <code>--enable-multiplatform</code></a></li>
- <li><a name="toc-_002d_002denable_002dshared-1" href="#g_t_002d_002denable_002dshared">7.1.9 <code>--enable-shared</code></a></li>
- <li><a name="toc-_002d_002denable_002dsilent_002drules-1" href="#g_t_002d_002denable_002dsilent_002drules">7.1.10 <code>--enable-silent-rules</code></a></li>
- <li><a name="toc-_002d_002dwithout_002dln_002ds-1" href="#g_t_002d_002dwithout_002dln_002ds">7.1.11 <code>--without-ln-s</code></a></li>
- <li><a name="toc-_002d_002dwithout_002dx-1" href="#g_t_002d_002dwithout_002dx">7.1.12 <code>--without-x</code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dnative_002dtexlive_002dbuild-1" href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild">7.1.1 <code>--disable-native-texlive-build</code></a></li>
+ <li><a id="toc-_002d_002dprefix_002c-_002d_002dbindir_002c-_2026" href="#g_t_002d_002dprefix-_002d_002dbindir-_2026">7.1.2 <code>--prefix</code>, <code>--bindir</code>, &hellip;</a></li>
+ <li><a id="toc-_002d_002ddisable_002dlargefile-1" href="#g_t_002d_002ddisable_002dlargefile">7.1.3 <code>--disable-largefile</code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dmissing-1" href="#g_t_002d_002ddisable_002dmissing">7.1.4 <code>--disable-missing</code></a></li>
+ <li><a id="toc-_002d_002denable_002dcompiler_002dwarnings_003dlevel-1" href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></a></li>
+ <li><a id="toc-_002d_002denable_002dcxx_002druntime_002dhack-1" href="#g_t_002d_002denable_002dcxx_002druntime_002dhack">7.1.6 <code>--enable-cxx-runtime-hack</code></a></li>
+ <li><a id="toc-_002d_002denable_002dmaintainer_002dmode-1" href="#g_t_002d_002denable_002dmaintainer_002dmode">7.1.7 <code>--enable-maintainer-mode</code></a></li>
+ <li><a id="toc-_002d_002denable_002dmultiplatform-1" href="#g_t_002d_002denable_002dmultiplatform">7.1.8 <code>--enable-multiplatform</code></a></li>
+ <li><a id="toc-_002d_002denable_002dshared-1" href="#g_t_002d_002denable_002dshared">7.1.9 <code>--enable-shared</code></a></li>
+ <li><a id="toc-_002d_002denable_002dsilent_002drules-1" href="#g_t_002d_002denable_002dsilent_002drules">7.1.10 <code>--enable-silent-rules</code></a></li>
+ <li><a id="toc-_002d_002dwithout_002dln_002ds-1" href="#g_t_002d_002dwithout_002dln_002ds">7.1.11 <code>--without-ln-s</code></a></li>
+ <li><a id="toc-_002d_002dwithout_002dx-1" href="#g_t_002d_002dwithout_002dx">7.1.12 <code>--without-x</code></a></li>
</ul></li>
- <li><a name="toc-Program_002dspecific-configure-options-1" href="#Program_002dspecific-configure-options">7.2 Program-specific configure options</a>
+ <li><a id="toc-Program_002dspecific-configure-options-1" href="#Program_002dspecific-configure-options">7.2 Program-specific configure options</a>
<ul class="no-bullet">
- <li><a name="toc-_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog" href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></a></li>
- <li><a name="toc-_002d_002ddisable_002dall_002dpkgs-1" href="#g_t_002d_002ddisable_002dall_002dpkgs">7.2.2 <code>--disable-all-pkgs</code></a></li>
- <li><a name="toc-Configure-options-for-texk_002fweb2c-1" href="#Configure-options-for-texk_002fweb2c">7.2.3 Configure options for <samp>texk/web2c</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fbibtex_002dx-1" href="#Configure-options-for-texk_002fbibtex_002dx">7.2.4 Configure options for <samp>texk/bibtex-x</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fdvipdfm_002dx-1" href="#Configure-options-for-texk_002fdvipdfm_002dx">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fdvisvgm-1" href="#Configure-options-for-texk_002fdvisvgm">7.2.6 Configure options for <samp>texk/dvisvgm</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002ftexlive-1" href="#Configure-options-for-texk_002ftexlive">7.2.7 Configure options for <samp>texk/texlive</samp></a></li>
- <li><a name="toc-Configure-options-for-texk_002fxdvik-1" href="#Configure-options-for-texk_002fxdvik">7.2.8 Configure options for <samp>texk/xdvik</samp></a></li>
- <li><a name="toc-Configure-options-for-utils_002fxindy-1" href="#Configure-options-for-utils_002fxindy">7.2.9 Configure options for <samp>utils/xindy</samp></a></li>
+ <li><a id="toc-_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog" href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></a></li>
+ <li><a id="toc-_002d_002ddisable_002dall_002dpkgs-1" href="#g_t_002d_002ddisable_002dall_002dpkgs">7.2.2 <code>--disable-all-pkgs</code></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fweb2c-1" href="#Configure-options-for-texk_002fweb2c">7.2.3 Configure options for <samp>texk/web2c</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fbibtex_002dx-1" href="#Configure-options-for-texk_002fbibtex_002dx">7.2.4 Configure options for <samp>texk/bibtex-x</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fdvipdfm_002dx-1" href="#Configure-options-for-texk_002fdvipdfm_002dx">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fdvisvgm-1" href="#Configure-options-for-texk_002fdvisvgm">7.2.6 Configure options for <samp>texk/dvisvgm</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002ftexlive-1" href="#Configure-options-for-texk_002ftexlive">7.2.7 Configure options for <samp>texk/texlive</samp></a></li>
+ <li><a id="toc-Configure-options-for-texk_002fxdvik-1" href="#Configure-options-for-texk_002fxdvik">7.2.8 Configure options for <samp>texk/xdvik</samp></a></li>
+ <li><a id="toc-Configure-options-for-utils_002fxindy-1" href="#Configure-options-for-utils_002fxindy">7.2.9 Configure options for <samp>utils/xindy</samp></a></li>
</ul></li>
- <li><a name="toc-Library_002dspecific-configure-options-1" href="#Library_002dspecific-configure-options">7.3 Library-specific configure options</a>
+ <li><a id="toc-Library_002dspecific-configure-options-1" href="#Library_002dspecific-configure-options">7.3 Library-specific configure options</a>
<ul class="no-bullet">
- <li><a name="toc-Configure-options-for-kpathsea-1" href="#Configure-options-for-kpathsea">7.3.1 Configure options for <code>kpathsea</code></a></li>
- <li><a name="toc-Configure-options-for-system-poppler-1" href="#Configure-options-for-system-poppler">7.3.2 Configure options for system <code>poppler</code></a></li>
+ <li><a id="toc-Configure-options-for-kpathsea-1" href="#Configure-options-for-kpathsea">7.3.1 Configure options for <code>kpathsea</code></a></li>
+ <li><a id="toc-Configure-options-for-system-poppler-1" href="#Configure-options-for-system-poppler">7.3.2 Configure options for system <code>poppler</code></a></li>
</ul></li>
- <li><a name="toc-Variables-for-configure-1" href="#Variables-for-configure">7.4 Variables for configure</a></li>
+ <li><a id="toc-Variables-for-configure-1" href="#Variables-for-configure">7.4 Variables for configure</a></li>
</ul></li>
- <li><a name="toc-Coding-conventions-1" href="#Coding-conventions">8 Coding conventions</a>
+ <li><a id="toc-Coding-conventions-1" href="#Coding-conventions">8 Coding conventions</a>
<ul class="no-bullet">
- <li><a name="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
- <li><a name="toc-Const-1" href="#Const">8.2 Const</a></li>
+ <li><a id="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
+ <li><a id="toc-Const-1" href="#Const">8.2 Const</a></li>
</ul></li>
- <li><a name="toc-Continuous-integration-1" href="#Continuous-integration">9 Continuous integration</a>
+ <li><a id="toc-Continuous-integration-1" href="#Continuous-integration">9 Continuous integration</a>
<ul class="no-bullet">
- <li><a name="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
- <li><a name="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
- <li><a name="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
+ <li><a id="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
+ <li><a id="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
+ <li><a id="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
</ul></li>
- <li><a name="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
+ <li><a id="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
<ul class="no-bullet">
- <li><a name="toc-NAME" href="#install_002dtl-NAME">A.1 NAME</a></li>
- <li><a name="toc-SYNOPSIS" href="#install_002dtl-SYNOPSIS">A.2 SYNOPSIS</a></li>
- <li><a name="toc-DESCRIPTION" href="#install_002dtl-DESCRIPTION">A.3 DESCRIPTION</a></li>
- <li><a name="toc-REFERENCES" href="#install_002dtl-REFERENCES">A.4 REFERENCES</a></li>
- <li><a name="toc-OPTIONS" href="#install_002dtl-OPTIONS">A.5 OPTIONS</a></li>
- <li><a name="toc-PROFILES" href="#install_002dtl-PROFILES">A.6 PROFILES</a></li>
- <li><a name="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.7 ENVIRONMENT VARIABLES</a></li>
- <li><a name="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.8 AUTHORS AND COPYRIGHT</a></li>
+ <li><a id="toc-NAME" href="#install_002dtl-NAME">A.1 NAME</a></li>
+ <li><a id="toc-SYNOPSIS" href="#install_002dtl-SYNOPSIS">A.2 SYNOPSIS</a></li>
+ <li><a id="toc-DESCRIPTION" href="#install_002dtl-DESCRIPTION">A.3 DESCRIPTION</a></li>
+ <li><a id="toc-REFERENCES" href="#install_002dtl-REFERENCES">A.4 REFERENCES</a></li>
+ <li><a id="toc-OPTIONS" href="#install_002dtl-OPTIONS">A.5 OPTIONS</a></li>
+ <li><a id="toc-PROFILES" href="#install_002dtl-PROFILES">A.6 PROFILES</a></li>
+ <li><a id="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.7 ENVIRONMENT VARIABLES</a></li>
+ <li><a id="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.8 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
- <li><a name="toc-tlmgr-1" href="#tlmgr">Appendix B tlmgr</a>
+ <li><a id="toc-tlmgr-1" href="#tlmgr">Appendix B tlmgr</a>
<ul class="no-bullet">
- <li><a name="toc-NAME-1" href="#tlmgr-NAME">B.1 NAME</a></li>
- <li><a name="toc-SYNOPSIS-1" href="#tlmgr-SYNOPSIS">B.2 SYNOPSIS</a></li>
- <li><a name="toc-DESCRIPTION-1" href="#tlmgr-DESCRIPTION">B.3 DESCRIPTION</a></li>
- <li><a name="toc-EXAMPLES" href="#tlmgr-EXAMPLES">B.4 EXAMPLES</a></li>
- <li><a name="toc-OPTIONS-1" href="#tlmgr-OPTIONS">B.5 OPTIONS</a></li>
- <li><a name="toc-ACTIONS" href="#tlmgr-ACTIONS">B.6 ACTIONS</a>
+ <li><a id="toc-NAME-1" href="#tlmgr-NAME">B.1 NAME</a></li>
+ <li><a id="toc-SYNOPSIS-1" href="#tlmgr-SYNOPSIS">B.2 SYNOPSIS</a></li>
+ <li><a id="toc-DESCRIPTION-1" href="#tlmgr-DESCRIPTION">B.3 DESCRIPTION</a></li>
+ <li><a id="toc-EXAMPLES" href="#tlmgr-EXAMPLES">B.4 EXAMPLES</a></li>
+ <li><a id="toc-OPTIONS-1" href="#tlmgr-OPTIONS">B.5 OPTIONS</a></li>
+ <li><a id="toc-ACTIONS" href="#tlmgr-ACTIONS">B.6 ACTIONS</a>
<ul class="no-bullet">
- <li><a name="toc-help" href="#tlmgr-help">B.6.1 help</a></li>
- <li><a name="toc-version" href="#tlmgr-version">B.6.2 version</a></li>
- <li><a name="toc-backup" href="#tlmgr-backup">B.6.3 backup</a></li>
- <li><a name="toc-candidates-pkg" href="#tlmgr-candidates-pkg">B.6.4 candidates <em>pkg</em></a></li>
- <li><a name="toc-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></li>
- <li><a name="toc-conf" href="#tlmgr-conf">B.6.6 conf</a></li>
- <li><a name="toc-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</a></li>
- <li><a name="toc-generate" href="#tlmgr-generate">B.6.8 generate</a></li>
- <li><a name="toc-gui" href="#tlmgr-gui">B.6.9 gui</a></li>
- <li><a name="toc-info" href="#tlmgr-info">B.6.10 info</a></li>
- <li><a name="toc-init_002dusertree" href="#tlmgr-init_002dusertree">B.6.11 init-usertree</a></li>
- <li><a name="toc-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.12 install [<em>option</em>...] <em>pkg</em>...</a></li>
- <li><a name="toc-key" href="#tlmgr-key">B.6.13 key</a></li>
- <li><a name="toc-list" href="#tlmgr-list">B.6.14 list</a></li>
- <li><a name="toc-option" href="#tlmgr-option">B.6.15 option</a></li>
- <li><a name="toc-paper" href="#tlmgr-paper">B.6.16 paper</a></li>
- <li><a name="toc-path" href="#tlmgr-path">B.6.17 path</a></li>
- <li><a name="toc-pinning" href="#tlmgr-pinning">B.6.18 pinning</a></li>
- <li><a name="toc-platform" href="#tlmgr-platform">B.6.19 platform</a></li>
- <li><a name="toc-postaction" href="#tlmgr-postaction">B.6.20 postaction</a></li>
- <li><a name="toc-print_002dplatform" href="#tlmgr-print_002dplatform">B.6.21 print-platform</a></li>
- <li><a name="toc-print_002dplatform_002dinfo" href="#tlmgr-print_002dplatform_002dinfo">B.6.22 print-platform-info</a></li>
- <li><a name="toc-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</a></li>
- <li><a name="toc-repository" href="#tlmgr-repository">B.6.24 repository</a></li>
- <li><a name="toc-restore" href="#tlmgr-restore">B.6.25 restore</a></li>
- <li><a name="toc-search" href="#tlmgr-search">B.6.26 search</a></li>
- <li><a name="toc-shell" href="#tlmgr-shell">B.6.27 shell</a></li>
- <li><a name="toc-show" href="#tlmgr-show">B.6.28 show</a></li>
- <li><a name="toc-uninstall" href="#tlmgr-uninstall">B.6.29 uninstall</a></li>
- <li><a name="toc-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</a></li>
+ <li><a id="toc-help" href="#tlmgr-help">B.6.1 help</a></li>
+ <li><a id="toc-version" href="#tlmgr-version">B.6.2 version</a></li>
+ <li><a id="toc-backup" href="#tlmgr-backup">B.6.3 backup</a></li>
+ <li><a id="toc-candidates-pkg" href="#tlmgr-candidates-pkg">B.6.4 candidates <em>pkg</em></a></li>
+ <li><a id="toc-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></li>
+ <li><a id="toc-conf" href="#tlmgr-conf">B.6.6 conf</a></li>
+ <li><a id="toc-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</a></li>
+ <li><a id="toc-generate" href="#tlmgr-generate">B.6.8 generate</a></li>
+ <li><a id="toc-gui" href="#tlmgr-gui">B.6.9 gui</a></li>
+ <li><a id="toc-info" href="#tlmgr-info">B.6.10 info</a></li>
+ <li><a id="toc-init_002dusertree" href="#tlmgr-init_002dusertree">B.6.11 init-usertree</a></li>
+ <li><a id="toc-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.12 install [<em>option</em>...] <em>pkg</em>...</a></li>
+ <li><a id="toc-key" href="#tlmgr-key">B.6.13 key</a></li>
+ <li><a id="toc-list" href="#tlmgr-list">B.6.14 list</a></li>
+ <li><a id="toc-option" href="#tlmgr-option">B.6.15 option</a></li>
+ <li><a id="toc-paper" href="#tlmgr-paper">B.6.16 paper</a></li>
+ <li><a id="toc-path" href="#tlmgr-path">B.6.17 path</a></li>
+ <li><a id="toc-pinning" href="#tlmgr-pinning">B.6.18 pinning</a></li>
+ <li><a id="toc-platform" href="#tlmgr-platform">B.6.19 platform</a></li>
+ <li><a id="toc-postaction" href="#tlmgr-postaction">B.6.20 postaction</a></li>
+ <li><a id="toc-print_002dplatform" href="#tlmgr-print_002dplatform">B.6.21 print-platform</a></li>
+ <li><a id="toc-print_002dplatform_002dinfo" href="#tlmgr-print_002dplatform_002dinfo">B.6.22 print-platform-info</a></li>
+ <li><a id="toc-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</a></li>
+ <li><a id="toc-repository" href="#tlmgr-repository">B.6.24 repository</a></li>
+ <li><a id="toc-restore" href="#tlmgr-restore">B.6.25 restore</a></li>
+ <li><a id="toc-search" href="#tlmgr-search">B.6.26 search</a></li>
+ <li><a id="toc-shell" href="#tlmgr-shell">B.6.27 shell</a></li>
+ <li><a id="toc-show" href="#tlmgr-show">B.6.28 show</a></li>
+ <li><a id="toc-uninstall" href="#tlmgr-uninstall">B.6.29 uninstall</a></li>
+ <li><a id="toc-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</a></li>
</ul></li>
- <li><a name="toc-CONFIGURATION-FILE-FOR-TLMGR" href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR">B.7 CONFIGURATION FILE FOR TLMGR</a></li>
- <li><a name="toc-CRYPTOGRAPHIC-VERIFICATION" href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION">B.8 CRYPTOGRAPHIC VERIFICATION</a>
+ <li><a id="toc-CONFIGURATION-FILE-FOR-TLMGR" href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR">B.7 CONFIGURATION FILE FOR TLMGR</a></li>
+ <li><a id="toc-CRYPTOGRAPHIC-VERIFICATION" href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION">B.8 CRYPTOGRAPHIC VERIFICATION</a>
<ul class="no-bullet">
- <li><a name="toc-Configuration-of-GnuPG-invocation" href="#tlmgr-Configuration-of-GnuPG-invocation">B.8.1 Configuration of GnuPG invocation</a></li>
+ <li><a id="toc-Configuration-of-GnuPG-invocation" href="#tlmgr-Configuration-of-GnuPG-invocation">B.8.1 Configuration of GnuPG invocation</a></li>
</ul></li>
- <li><a name="toc-USER-MODE" href="#tlmgr-USER-MODE">B.9 USER MODE</a>
+ <li><a id="toc-USER-MODE" href="#tlmgr-USER-MODE">B.9 USER MODE</a>
<ul class="no-bullet">
- <li><a name="toc-User-mode-install" href="#tlmgr-User-mode-install">B.9.1 User mode install</a></li>
- <li><a name="toc-User-mode-backup_002c-restore_002c-remove_002c-update" href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update">B.9.2 User mode backup, restore, remove, update</a></li>
- <li><a name="toc-User-mode-generate_002c-option_002c-paper" href="#tlmgr-User-mode-generate_002c-option_002c-paper">B.9.3 User mode generate, option, paper</a></li>
+ <li><a id="toc-User-mode-install" href="#tlmgr-User-mode-install">B.9.1 User mode install</a></li>
+ <li><a id="toc-User-mode-backup_002c-restore_002c-remove_002c-update" href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update">B.9.2 User mode backup, restore, remove, update</a></li>
+ <li><a id="toc-User-mode-generate_002c-option_002c-paper" href="#tlmgr-User-mode-generate_002c-option_002c-paper">B.9.3 User mode generate, option, paper</a></li>
</ul></li>
- <li><a name="toc-MULTIPLE-REPOSITORIES" href="#tlmgr-MULTIPLE-REPOSITORIES">B.10 MULTIPLE REPOSITORIES</a>
+ <li><a id="toc-MULTIPLE-REPOSITORIES" href="#tlmgr-MULTIPLE-REPOSITORIES">B.10 MULTIPLE REPOSITORIES</a>
<ul class="no-bullet">
- <li><a name="toc-Pinning" href="#tlmgr-Pinning">B.10.1 Pinning</a></li>
+ <li><a id="toc-Pinning" href="#tlmgr-Pinning">B.10.1 Pinning</a></li>
</ul></li>
- <li><a name="toc-GUI-FOR-TLMGR" href="#tlmgr-GUI-FOR-TLMGR">B.11 GUI FOR TLMGR</a>
+ <li><a id="toc-GUI-FOR-TLMGR" href="#tlmgr-GUI-FOR-TLMGR">B.11 GUI FOR TLMGR</a>
<ul class="no-bullet">
- <li><a name="toc-Main-display" href="#tlmgr-Main-display">B.11.1 Main display</a>
+ <li><a id="toc-Main-display" href="#tlmgr-Main-display">B.11.1 Main display</a>
<ul class="no-bullet">
- <li><a name="toc-Display-configuration-area" href="#tlmgr-Display-configuration-area">B.11.1.1 Display configuration area</a></li>
- <li><a name="toc-Package-list-area" href="#tlmgr-Package-list-area">B.11.1.2 Package list area</a></li>
- <li><a name="toc-Main-display-action-buttons" href="#tlmgr-Main-display-action-buttons">B.11.1.3 Main display action buttons</a></li>
+ <li><a id="toc-Display-configuration-area" href="#tlmgr-Display-configuration-area">B.11.1.1 Display configuration area</a></li>
+ <li><a id="toc-Package-list-area" href="#tlmgr-Package-list-area">B.11.1.2 Package list area</a></li>
+ <li><a id="toc-Main-display-action-buttons" href="#tlmgr-Main-display-action-buttons">B.11.1.3 Main display action buttons</a></li>
</ul></li>
- <li><a name="toc-Menu-bar" href="#tlmgr-Menu-bar">B.11.2 Menu bar</a></li>
- <li><a name="toc-GUI-options" href="#tlmgr-GUI-options">B.11.3 GUI options</a></li>
+ <li><a id="toc-Menu-bar" href="#tlmgr-Menu-bar">B.11.2 Menu bar</a></li>
+ <li><a id="toc-GUI-options" href="#tlmgr-GUI-options">B.11.3 GUI options</a></li>
</ul></li>
- <li><a name="toc-MACHINE_002dREADABLE-OUTPUT" href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">B.12 MACHINE-READABLE OUTPUT</a>
+ <li><a id="toc-MACHINE_002dREADABLE-OUTPUT" href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">B.12 MACHINE-READABLE OUTPUT</a>
<ul class="no-bullet">
- <li><a name="toc-Machine_002dreadable-update-and-install-output" href="#tlmgr-Machine_002dreadable-update-and-install-output">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</a></li>
- <li><a name="toc-Machine_002dreadable-option-output" href="#tlmgr-Machine_002dreadable-option-output">B.12.2 Machine-readable <code>option</code> output</a></li>
+ <li><a id="toc-Machine_002dreadable-update-and-install-output" href="#tlmgr-Machine_002dreadable-update-and-install-output">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</a></li>
+ <li><a id="toc-Machine_002dreadable-option-output" href="#tlmgr-Machine_002dreadable-option-output">B.12.2 Machine-readable <code>option</code> output</a></li>
</ul></li>
- <li><a name="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.13 AUTHORS AND COPYRIGHT</a></li>
+ <li><a id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.13 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
- <li><a name="toc-Index-1" href="#Index">Index</a></li>
+ <li><a id="toc-Index-1" href="#Index">Index</a></li>
</ul>
</div>
-<a name="Top"></a>
-<div class="header">
+<span id="Top"></span><div class="header">
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Building-TeX-Live-_00282018_0029"></a>
-<h1 class="top">Building TeX Live (2018)</h1>
+<span id="Building-TeX-Live-_00282019_0029"></span><h1 class="top">Building TeX Live (2019)</h1>
<p>For an overview of this manual, see <a href="#Introduction">Introduction</a>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Introduction" accesskey="1">Introduction</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">About this manual.
+<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.
+<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.
+<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.
+<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).
+<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.
+<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.
+<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.
+<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.
+<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.
+<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.
+<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">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
+<tr><td align="left" valign="top">&bull; <a href="#Index">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
</td></tr>
</table>
<hr>
-<a name="Introduction"></a>
-<div class="header">
+<span id="Introduction"></span><div class="header">
<p>
Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of build system</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Introduction-1"></a>
-<h2 class="chapter">1 Introduction</h2>
+<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
-<a name="index-introduction"></a>
+<span id="index-introduction"></span>
-<p>This manual (dated April 2018) corresponds to the TeX&nbsp;Live
-2018 release.
+<p>This manual (dated February 2019) corresponds to the TeX&nbsp;Live
+2019 release.
</p>
<p>This manual is aimed at system installers and programmers, and focuses
on how to configure, build, and develop the TeX&nbsp;Live (TL) sources. It is
also available as plain text files in the source tree:
<samp>source/README.*</samp>.
</p>
-<p>The <samp>source/README</samp> file in the TL source tree provides the
+<p>The main <samp>source/README</samp> file in the TL source tree provides
maximally-terse information for doing a build, and portability
information for different systems, along with
<samp>source/doc/README.solaris</samp>.
</p>
<p>For information on acquiring the TL sources, see
-<a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>.
+<a href="https://tug.org/texlive/svn">https://tug.org/texlive/svn</a>. The canonical source repository
+uses Subversion, and we have no plans to change this.
</p>
<p>This manual does not duplicate the information found in other TL
documentation resources, such as:
</p>
<ul>
-<li> The TeX&nbsp;Live web pages: <a href="http://tug.org/texlive">http://tug.org/texlive</a>.
+<li> The TeX&nbsp;Live web pages: <a href="https://tug.org/texlive">https://tug.org/texlive</a>.
</li><li> The web page describing how to build the binaries which
-are distributed with TeX&nbsp;Live: <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>.
+are distributed with TeX&nbsp;Live: <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a>.
-</li><li> The TeX&nbsp;Live user manual: <a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>, or
+</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="http://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>,
-<cite><a href="http://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.):
-<a href="http://tug.org/texinfohtml/">http://tug.org/texinfohtml/</a>, or check the &lsquo;<samp>TeX</samp>&rsquo; category in
+</li><li> Other TeX-related Texinfo manuals (see <cite><a href="https://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>,
+<cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>, etc.):
+<a href="https://tug.org/texinfohtml/">https://tug.org/texinfohtml/</a>, or check the &lsquo;<samp>TeX</samp>&rsquo; category in
the GNU Info system.
</li><li> Package documentation:
-<a href="http://tug.org/texlive/Contents/live/doc.html">http://tug.org/texlive/Contents/live/doc.html</a>, or the
+<a href="https://tug.org/texlive/Contents/live/doc.html">https://tug.org/texlive/Contents/live/doc.html</a>, or the
<samp>doc.html</samp> file at the top level of the installed TL.
</li></ul>
<p>As an exception, the full documentation for <code>install-tl</code> and
-<code>tlmgr</code> is included here, just because it is convenient to do so.
-The same text is available online (linked from
-<a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>, or by invoking the program with
-&lsquo;<samp>--help</samp>&rsquo; (or look at the end of the source).
+<code>tlmgr</code> is included here as appendices, simply because it is easy
+to do so. The same text is available online (linked from
+<a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>, or by invoking the program
+with &lsquo;<samp>--help</samp>&rsquo; (or look at the end of the source).
</p>
<hr>
-<a name="Overview-of-build-system"></a>
-<div class="header">
+<span id="Overview-of-build-system"></span><div class="header">
<p>
Next: <a href="#Prerequisites" accesskey="n" rel="next">Prerequisites</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Overview-of-build-system-1"></a>
-<h2 class="chapter">2 Overview of build system</h2>
+<span id="Overview-of-build-system-1"></span><h2 class="chapter">2 Overview of build system</h2>
-<a name="index-build-system_002c-design-of"></a>
+<span id="index-build-system_002c-design-of"></span>
-<a name="index-Autoconf"></a>
-<a name="index-Automake"></a>
-<a name="index-Libtool"></a>
-<a name="index-tests_002c-running"></a>
-<p>The TeX&nbsp;Live build system was redesigned in 2009, consistently using
-Autoconf, Automake, and Libtool. Thus<br>&nbsp;&nbsp;&nbsp;<code>configure &amp;&amp;
-make &amp;&amp; make check &amp;&amp; make install</code><br>or the basically-equivalent
-top-level <code>Build</code> script suffice to build and install the TL
+<span id="index-Autoconf"></span>
+<span id="index-Automake"></span>
+<span id="index-Libtool"></span>
+<span id="index-tests_002c-running"></span>
+<p>The TeX&nbsp;Live build system was redesigned in 2009 to consistently use
+Autoconf, Automake, and Libtool. Thus, running<br>&nbsp;&nbsp;&nbsp;<code>configure
+&amp;&amp; make &amp;&amp; make check &amp;&amp; make install</code><br>or the essentially-equivalent
+top-level <code>Build</code> script suffices to build and install the TL
programs. The <code>make check</code> clause performs various tests of the
generated programs&mdash;not strictly required but strongly recommended.
Running <code>configure --help</code> will display a comprehensive list of
@@ -436,13 +423,13 @@ all <code>configure</code> options.
</dd>
</dl>
-<a name="index-kpse_002dpkgs_002em4"></a>
+<span id="index-kpse_002dpkgs_002em4"></span>
<p>The primary design goal of the build system is modularity. Each
program and library module (or package) specifies its own requirements
and properties, such as required libraries, whether an installed
(system) version of a library can be used, <code>configure</code> options to
be seen at the top level, and more. An explicit list of all available
-modules is kept in only one central place, namely <samp>m4/kpse-pkgs.m4</samp>.
+modules is kept in a single central place: <samp>m4/kpse-pkgs.m4</samp>.
</p>
<p>A second, related goal is to configure and build each library before
configuring any other (program or library) module which uses that
@@ -455,72 +442,71 @@ independently. The corresponding modules use (most of) the
distributed source tree and document any modifications of that source.
</p>
<p>All this is for the sake of simplifying both upgrading of modules and
-integrating new modules into the TL build system. (Not to say that
-either task is trivial.)
+integrating new modules into the TL build system. (Despite all
+efforts, neither task is easy.)
</p>
<hr>
-<a name="Prerequisites"></a>
-<div class="header">
+<span id="Prerequisites"></span><div class="header">
<p>
Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a href="#Overview-of-build-system" accesskey="p" rel="prev">Overview of build system</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Prerequisites-1"></a>
-<h2 class="chapter">3 Prerequisites</h2>
+<span id="Prerequisites-1"></span><h2 class="chapter">3 Prerequisites</h2>
-<a name="index-prerequisites-for-building"></a>
-<a name="index-requirements-for-building"></a>
+<span id="index-prerequisites-for-building"></span>
+<span id="index-requirements-for-building"></span>
-<a name="index-compilers_002c-C-and-C_002b_002b"></a>
+<span id="index-compilers_002c-C-and-C_002b_002b11"></span>
<p>Overall, building the TeX&nbsp;Live programs, when using all libraries from
-the TL source tree, requires only C and C++ compilers and GNU
-<code>make</code>. (If <code>make</code> from your <code>PATH</code> is not GNU make,
-you can set <code>MAKE</code> in the environment to whatever is necessary.)
+the TL source tree, requires C and C++11 compilers and GNU
+<code>make</code>. If <code>make</code> from your <code>PATH</code> is not GNU make,
+you can set the <code>MAKE</code> environment variable to whatever is necessary.
</p>
-<a name="index-GNU-make_002c-required"></a>
-<a name="index-gmake_002c-required"></a>
-<a name="index-FreeType"></a>
+<span id="index-GNU-make_002c-required"></span>
+<span id="index-gmake_002c-required"></span>
+<span id="index-FreeType"></span>
<p>GNU <code>make</code> is required only because of some third-party
libraries, notably FreeType; all the TL-maintained directories (and
-Automake/Autoconf output in general) should work with any reasonable
+Automake/Autoconf output in general) work with any reasonable
<code>make</code>.
</p>
+<span id="index-C_002b_002b11_002c-required"></span>
+<p>A C++11 compiler is similarly required because of the third-party
+libraries ICU and Poppler; the program <code>dvisvgm</code> also requires
+C++11. It is possible to build everything else with older compilers;
+<a href="https://tug.org/texlive/custom-bin.html">https://tug.org/texlive/custom-bin.html</a> links to a build script
+for doing this.
+</p>
<p>However, a few programs in the tree have additional requirements:
</p>
<dl compact="compact">
-<dt><samp>dvisvgm</samp></dt>
-<dd><a name="index-dvisvgm-requirement-for-C_002b_002b11"></a>
-<a name="index-C_002b_002b11_002c-required-by-dvisvgm"></a>
-<p>requires a C++11 compiler, such as gcc 4.8.1 (or later) or clang 3.3
-(or later).
-</p>
-</dd>
<dt><samp>web2c</samp></dt>
-<dd><a name="index-perl_002c-required-by-web2c_002c-etc_002e"></a>
+<dd><span id="index-perl_002c-required-by-web2c_002c-etc_002e"></span>
<p>requires <code>perl</code> for some tests run by <code>make check</code>.
</p>
</dd>
<dt><samp>xdvik</samp></dt>
<dt><samp>xpdfopen</samp></dt>
-<dd><a name="index-X11_002c-required-by-X-clients"></a>
+<dd><span id="index-X11-development_002c-required-by-X-clients"></span>
<p>require X11 headers and libraries, often in &ldquo;development&rdquo; packages
that are not installed by default.
</p>
</dd>
<dt><samp>xetex</samp></dt>
-<dd><a name="index-fontconfig-library_002c-required-by-xetex"></a>
-<a name="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></a>
-<a name="index-Cocoa-Mac-framework_002c-required-by-xetex"></a>
+<dd><span id="index-fontconfig-library_002c-required-by-xetex"></span>
+<span id="index-ApplicationServices-Mac-framework_002c-required-by-xetex"></span>
+<span id="index-Cocoa-Mac-framework_002c-required-by-xetex"></span>
<p>requires <samp>fontconfig</samp> (again both headers and library), or, for
MacOSX only, the <code>ApplicationServices</code> and <code>Cocoa</code>
frameworks.
</p>
</dd>
<dt><samp>xindy</samp></dt>
-<dd><a name="index-clisp_002c-required-by-xindy"></a>
-<a name="index-ffcall_002c-required-by-xindy"></a>
-<p>requires GNU <code>clisp</code> and in addition <code>perl</code>, <code>latex</code>,
-and <code>pdflatex</code> to build the rules and/or documentation.
+<dd><span id="index-clisp_002c-required-by-xindy"></span>
+<span id="index-libsigsegv_002c-required-by-xindy"></span>
+<p>requires GNU <code>clisp</code>, <code>libsigsegv</code>, and <code>libiconv</code>;
+additionally, to build the rules and/or documentation: <code>perl</code>,
+<code>latex</code>, and <code>pdflatex</code>
</p>
</dd>
</dl>
@@ -533,7 +519,7 @@ programs must avoided, e.g.,<br>
</p>
<ul>
<li> Modification of any <code>.y</code> or <code>.l</code> source files requires
-<samp>bison</samp> or <samp>flex</samp> to updatete the corresponding C sources.
+<samp>bison</samp> or <samp>flex</samp> to update the corresponding C sources.
</li><li> Modification of the sources for <code>.info</code> files requires
<code>makeinfo</code>.
@@ -541,7 +527,9 @@ programs must avoided, e.g.,<br>
</li><li> Modification of any part of the build system (M4 macros,
<samp>configure.ac</samp>, <samp>Makefile.am</samp>, or their fragments) requires
GNU M4, GNU Autoconf, GNU Automake, and GNU Libtool to update the
-generated files. See <a href="#Build-system-tools">Build system tools</a>.
+generated files. Furthermore, to reliably reproduce the build files,
+the original GNU releases of these tools must be used, not any distro
+packaging of them. See <a href="#Build-system-tools">Build system tools</a>, for more discussion.
</li></ul>
@@ -551,80 +539,70 @@ your timestamps&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.
</p>
-<a name="index-Debian-installation-of-build-prerequisites"></a>
-<p>As an example, on Debian systems the necessary build dependencies can
-be installed via:
-</p>
-<div class="example">
-<pre class="example">apt-get install libfontconfig-dev libx11-dev libxmu-dev libxaw7-dev
-</pre></div>
-
<hr>
-<a name="Building"></a>
-<div class="header">
+<span id="Building"></span><div class="header">
<p>
Next: <a href="#Installing" accesskey="n" rel="next">Installing</a>, Previous: <a href="#Prerequisites" accesskey="p" rel="prev">Prerequisites</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Building-1"></a>
-<h2 class="chapter">4 Building</h2>
+<span id="Building-1"></span><h2 class="chapter">4 Building</h2>
-<a name="index-building"></a>
-<a name="index-overall-build-process"></a>
+<span id="index-building"></span>
+<span id="index-overall-build-process"></span>
-<a name="index-Build-script"></a>
+<span id="index-Build-script"></span>
<p>The top-level <samp>Build</samp> script is intended to simplify building the
binaries distributed with TeX&nbsp;Live itself&mdash;we call this the &ldquo;native&rdquo;
-TL build. It configures and makes everything in a subdirectory of the
-main build tree (default <samp>Work/</samp>), installs everything in another
-subdirectory (default <samp>inst/</samp>), and finally runs <code>make
-check</code>. The exact directory and command names can be specified via
-environment variables and a few leading options. All remaining
-arguments (assignments or options) are passed to the <samp>configure</samp>
-script. Please take a look at the <samp>./Build</samp> source file itself
-for more information; it is a straightforward shell script.
-</p>
-<a name="index-source-directory-building_002c-not-supported"></a>
-<a name="index-build-directory_002c-required"></a>
+TL build. It runs <code>configure &amp;&amp; make world</code>, which builds
+everything in a subdirectory of the main source tree (default
+<samp>Work/</samp>), installs everything in another subdirectory (default
+<samp>inst/</samp>), and finally runs <code>make check</code>. The exact
+directory and command names can be specified via environment variables
+and a few leading options. All remaining arguments (assignments or
+options) are passed to the <samp>configure</samp> script. Please take a
+look at the <samp>./Build</samp> source file for more information; it is a
+straightforward shell script.
+</p>
+<span id="index-source-directory-building_002c-not-supported"></span>
+<span id="index-build-directory_002c-required"></span>
<p>An alternative, and the one we will mainly discuss here, is to run
-<code>configure</code> and <code>make</code> oneself in a suitable empty
-subdirectory. Building in the source directory itself is not
-supported (sorry).
+<code>configure</code> and <code>make</code> in a suitable empty subdirectory.
+Building in the source directory itself is not supported (sorry).
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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.
+<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-problems" accesskey="2">Build problems</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If the build fails.
+<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-in-parallel" accesskey="3">Build in parallel</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Simultaneous <code>make</code> processes.
+<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-distribution" accesskey="4">Build distribution</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Making a distribution tarball.
+<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-package" accesskey="5">Build one package</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Example of working on just one program.
+<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="6">Cross compilation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Building on host X for target Y.
+<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>
<hr>
-<a name="Build-iteration"></a>
-<div class="header">
+<span id="Build-iteration"></span><div class="header">
<p>
Next: <a href="#Build-problems" accesskey="n" rel="next">Build problems</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-iteration-1"></a>
-<h3 class="section">4.1 Build iteration</h3>
+<span id="Build-iteration-1"></span><h3 class="section">4.1 Build iteration</h3>
-<a name="index-build-iteration"></a>
-<a name="index-iteration-through-sources_002c-by-configure-and-make"></a>
+<span id="index-build-iteration"></span>
+<span id="index-iteration-through-sources_002c-by-configure-and-make"></span>
<p>Running the top-level <samp>configure</samp> script configures the top level
and the subdirectories <samp>libs</samp>, <samp>utils</samp>, and <samp>texk</samp>.
-Running <code>make</code> at the top-level first iterates over all
-TeX-specific libraries, and then runs <code>make</code> in
-<samp>libs</samp>, <samp>utils</samp>, and <samp>texk</samp> to iterate over all generic
-libraries, utility programs, and TeX-specific programs. These
+Running <code>make</code> at the top level first iterates over the
+TeX-specific libraries, and then runs <code>make</code> in <samp>libs</samp>,
+<samp>utils</samp>, and <samp>texk</samp> to iterate over the generic libraries,
+utility programs, and TeX-specific programs, respectively. These
iterations consist of two steps:
</p>
<ol>
@@ -640,70 +618,65 @@ etc.
</li></ol>
<p>Running the top-level <code>make</code> a second time iterates again over
-all the library and program modules, but finds (should find) nothing
-to be done unless some source files have been modified.
+all the library and program modules, and finds (should find) nothing
+to be done.
</p>
<hr>
-<a name="Build-problems"></a>
-<div class="header">
+<span id="Build-problems"></span><div class="header">
<p>
Next: <a href="#Build-in-parallel" accesskey="n" rel="next">Build in parallel</a>, Previous: <a href="#Build-iteration" accesskey="p" rel="prev">Build iteration</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-problems-1"></a>
-<h3 class="section">4.2 Build problems</h3>
+<span id="Build-problems-1"></span><h3 class="section">4.2 Build problems</h3>
-<a name="index-build-problems"></a>
-<a name="index-problems-with-build"></a>
-<a name="index-failure-to-build"></a>
-<a name="index-_002d_002dno_002dclean-Build-option"></a>
-<p>If configuring or building a module fails, you should first find and fix the
-problem, then perhaps remove the subdirectory for that module from the build
-tree, and finally rerun the top level <code>make</code> (or <samp>Build</samp> with
-<code>--no-clean</code> as its first argument).
+<span id="index-build-problems"></span>
+<span id="index-problems-with-build"></span>
+<span id="index-failure-to-build"></span>
+<span id="index-_002d_002dno_002dclean-Build-option"></span>
+<p>If configuring or building a module fails, you should first try to
+find and fix the problem. Failing that, a possible workaround is to
+remove the subdirectory for that module from the build tree (so
+<code>configure</code> won&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>
-<a name="Build-in-parallel"></a>
-<div class="header">
+<span id="Build-in-parallel"></span><div class="header">
<p>
Next: <a href="#Build-distribution" accesskey="n" rel="next">Build distribution</a>, Previous: <a href="#Build-problems" accesskey="p" rel="prev">Build problems</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-in-parallel-1"></a>
-<h3 class="section">4.3 Build in parallel</h3>
+<span id="Build-in-parallel-1"></span><h3 class="section">4.3 Build in parallel</h3>
-<a name="index-building-in-parallel"></a>
-<a name="index-parallel-build"></a>
-<a name="index-cache-for-configure"></a>
+<span id="index-building-in-parallel"></span>
+<span id="index-parallel-build"></span>
+<span id="index-cache-for-configure"></span>
-<a name="index-dependencies_002c-with-several-output-files"></a>
-<a name="index-_002dj-make-option"></a>
+<span id="index-dependencies_002c-with-several-output-files"></span>
+<span id="index-_002dj-make-option"></span>
<p>The TL build system carefully formulates dependencies as well as
<code>make</code> rules when a tool (such as <code>tangle</code>, <code>ctangle</code>,
-or <code>convert</code>) creates several output files. This allows for
+and <code>convert</code>) creates several output files. This allows for
parallel builds (<code>make -j <var>n</var></code> with <em><var>n</var>&gt;1</em> or even
<code>make -j</code>) that can considerably speed up the TL build.
</p>
-<a name="index-cache-file_002c-for-configure"></a>
-<a name="index-_002dC-configure-option"></a>
-<p>Incidentally, a noticeable speed-up can also be (independently) gained
-by using a configure cache file, i.e., with the option <code>-C</code>
-(recommended).
+<span id="index-cache-file_002c-for-configure"></span>
+<span id="index-_002dC-configure-option"></span>
+<p>Incidentally, a noticeable speed-up can be independently gained by
+using a configure cache file, i.e., specifying the <code>configure</code>
+option <code>-C</code> (recommended).
</p>
<hr>
-<a name="Build-distribution"></a>
-<div class="header">
+<span id="Build-distribution"></span><div class="header">
<p>
Next: <a href="#Build-one-package" accesskey="n" rel="next">Build one package</a>, Previous: <a href="#Build-in-parallel" accesskey="p" rel="prev">Build in parallel</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-distribution-1"></a>
-<h3 class="section">4.4 Build distribution</h3>
+<span id="Build-distribution-1"></span><h3 class="section">4.4 Build distribution</h3>
-<a name="index-building-a-distribution"></a>
-<a name="index-distribution-tarball_002c-making"></a>
+<span id="index-building-a-distribution"></span>
+<span id="index-distribution-tarball_002c-making"></span>
-<a name="index-dist-and-distcheck-targets-for-make"></a>
+<span id="index-dist-and-distcheck-targets-for-make"></span>
<p>Running <code>make dist</code> at the top level creates a tarball
<samp>tex-live-<var>yyyy</var>-<var>mm</var>-<var>dd</var>.tar.xz</samp> from the TL source
tree. Running <code>make distcheck</code> also verifies that this tarball
@@ -712,36 +685,36 @@ suffices to build and install all of TL.
<p>This is useful for checking consistency of the source tree and
Makefiles, but the result is not a complete or even usable TeX
system, since all the support files are lacking; see <a href="#Installing">Installing</a>.
+We do not actually distribute any such tarball, and have no plans to
+do so.
</p>
<hr>
-<a name="Build-one-package"></a>
-<div class="header">
+<span id="Build-one-package"></span><div class="header">
<p>
-Next: <a href="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Build-distribution" accesskey="p" rel="prev">Build distribution</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &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-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>
-<a name="Build-one-package-1"></a>
-<h3 class="section">4.5 Build one package</h3>
+<span id="Build-one-package-1"></span><h3 class="section">4.5 Build one package</h3>
-<a name="index-build-one-package"></a>
-<a name="index-one-package_002c-building"></a>
+<span id="index-build-one-package"></span>
+<span id="index-one-package_002c-building"></span>
-<a name="index-_002d_002ddisable_002dall_002dpackages"></a>
-<a name="index-build-on-demand"></a>
+<span id="index-_002d_002ddisable_002dall_002dpackages"></span>
+<span id="index-build-on-demand"></span>
<p>To build one package, the basic idea is to use the <code>configure</code>
option <code>--disable-all-pkgs</code> (see <a href="#g_t_002d_002ddisable_002dall_002dpkgs"><code>--disable-all-pkgs</code></a>).
Then all program and library modules are configured but none are made.
However, the <samp>Makefile</samp>s still contain all build rules and
dependencies and can be invoked to build an individual program or
-library and causes to first build any required libraries.
+library, first building any required libraries.
</p>
<p>This &ldquo;build-on-demand&rdquo; procedure is used, e.g., in the upstream
-LuaTeX repository to build LuaTeX, essentially from a subset of
-the complete TeX&nbsp;Live tree. Similarly, when, e.g., building the original
+LuaTeX repository to build LuaTeX, from a subset of the complete
+TeX&nbsp;Live source tree. As another example, when building the original
e-TeX has been disabled (as it is by default), one can run
<code>make etex</code> (or <code>make etex.exe</code>) in <samp>texk/web2c/</samp> to
-build e-TeX (although there is no comparably simple way to install
-e-TeX).
+build e-TeX (although there is no comparably simple way to
+<em>install</em> e-TeX).
</p>
<p>If you want to work on a single program within the TL sources, this is
the recommended way to do it. Here is an example from start to
@@ -750,7 +723,7 @@ finish for working on <code>dvipdfm-x</code>.
<div class="example">
<pre class="example">mkdir mydir &amp;&amp; cd mydir # new working directory
-# Get sources (<a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>)
+# Get sources (<a href="https://tug.org/texlive/svn">https://tug.org/texlive/svn</a>), e.g.:
rsync -a --delete --exclude=.svn --exclude=Work \
tug.org::tldevsrc/Build/source/ .
@@ -759,72 +732,111 @@ mkdir Work &amp;&amp; cd Work
# Do the configure:
../configure --disable-all-pkgs --enable-dvipdfm-x \
- -C CFLAGS=-g CXXFLAGS=-g &gt;&amp;outc
+ -C CFLAGS=-g CXXFLAGS=-g &gt;&amp;outc || echo fail
# Do the make:
-make &gt;&amp;outm
+make &gt;&amp;outm || echo fail
# Test:
cd texk/dvipdfm-x
make check
</pre></div>
-<p>Then you modify source files in <samp>mydir/texk/dvipdfm-x</samp> and rerun
-<code>make</code> in <samp>mydir/Work/texk/dvipdfm-x</samp> to rebuild.
+<p>Then you can modify source files in <samp>mydir/texk/dvipdfm-x</samp> and
+rerun <code>make</code> in <samp>mydir/Work/texk/dvipdfm-x</samp> to rebuild; that
+build directory is where the binary ends up and where you can run a
+debugger, etc.
</p>
<p>The second line of the <code>configure</code> invocation shows examples of
extra things you likely want to specify if you intend to hack the
-sources (and not just build binaries): the <code>-C</code> speeds up
-<code>configure</code>, and the <code>CFLAGS</code> and <code>CXXFLAGS</code> settings
-eliminate compiler optimization for debugging purposes.
+sources (and not just build binaries): the <code>-C</code> speeds
+<code>configure</code> by enabling a cache file, and the <code>CFLAGS</code> and
+<code>CXXFLAGS</code> settings eliminate compiler optimization for debugging
+purposes.
</p>
-<p>Of course, one should actually look at the output and check that
+<p>Of course, you need to actually look at the output and check that
things are working. There are many <code>configure</code> options you can
-tweak as desired; check the output from <code>configure --help</code>.
+tweak as desired; check the output from <code>configure --help</code>. It
+is also a good idea to run <code>make check</code> after making any changes,
+to ensure that whatever tests have been written still pass.
</p>
-<a name="index-size-of-source-tree"></a>
+
+<span id="index-size-of-source-tree"></span>
<p>Finally, the above retrieves the entire TL source tree (several
-hundred megabytes). It is natural to ask if this is really necessary.
+hundred megabytes). It is natural to ask if this is really necessary.
Strictly speaking, the answer is no, but it is vastly more convenient
-to do so. If you cut down the source tree, you must also give
+to do so. If you cut down the source tree, you must also give
additional <code>configure</code> flags to individually disable using system
versions of libraries, or the intricacies of the dependencies (such as
<code>teckit</code> requiring <code>zlib</code>) will have undesired side effects.
-For an example, see the <code>build-pdftex.sh</code> script in the
-<code>pdftex</code> development source (<a href="http://pdftex.org">http://pdftex.org</a>), which is
-indeed a cut-down TL source tree.
+For an example of this approach, see the <code>build-pdftex.sh</code> script
+in the <code>pdftex</code> development source (details at
+<a href="http://pdftex.org">http://pdftex.org</a>), which is indeed such a cut-down TL source
+tree.
</p>
-<a name="index-_002d_002denable_002dmissing-to-ignore-dependencies"></a>
+<span id="index-_002d_002denable_002dmissing-to-ignore-dependencies"></span>
<p>Even with <code>--disable-all-pkgs</code>, dependencies will be checked.
-For instance, if a non-MacOSX system does not have <code>fontconfig</code>,
-XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>) and <code>configure</code>
-will terminate. To proceed without such dependencies, specify
-<code>--enable-missing</code> also. (Arguably this should happen
-automatically.)
-</p>
-<a name="index-CC_003dc_002dcompiler"></a>
-<a name="index-CXX_003dc_002b_002b_002dcompiler"></a>
-<a name="index-OBJCXX_003dobjc_002dcompiler"></a>
+For instance, if a (non-MacOSX) system does not have
+<code>fontconfig</code>, XeTeX cannot be built (see <a href="#Prerequisites">Prerequisites</a>)
+and <code>configure</code> will terminate. To proceed without such
+dependencies, specify <code>--enable-missing</code> also.
+</p>
+<span id="index-CC_003dc_002dcompiler"></span>
+<span id="index-CXX_003dc_002b_002b_002dcompiler"></span>
+<span id="index-OBJCXX_003dobjc_002dcompiler"></span>
+<span id="index-gcc_002c-default-compilers"></span>
<p>By default, the <code>gcc</code> compilers will be used if present;
otherwise, individual packages may use something different. You can
explicitly specify the compilers to be used with the environment
variables <code>CC</code>, <code>CXX</code>, and <code>OBJCXX</code>.
</p>
+
+<hr>
+<span id="Build-one-engine"></span><div class="header">
+<p>
+Next: <a href="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Build-one-package" accesskey="p" rel="prev">Build one package</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &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="index-build-one-engine"></span>
+<span id="index-one-engine_002c-building"></span>
+<span id="index-engine_002c-building-one"></span>
+
+<p>Unfortunately, there is one common case where the steps in the
+preceding section to build one package (see <a href="#Build-one-package">Build one package</a>) do
+not suffice: wanting to build one, or a subset, of the TeX engines
+(or other Web2c programs).
+</p>
+<p>The simplest way to do this is to disable everything and then
+explicitly specify what to make. For example, to build only LuaTeX:
+</p>
+<div class="example">
+<pre class="example">./configure --disable-all-pkgs # or ./Build
+cd Work/texk/web2c # build directory
+make luatex # specify target
+</pre></div>
+
+<p>This works because the <code>make</code> automatically runs <code>configure</code>
+as necessary for the dependencies and target. Furthermore, the source
+tree can be cut down to just what is needed for the given engine (as
+the separate pdfTeX and LuaTeX source repositories do).
+</p>
+<p>We hope to improve the situation in the future. Patches are welcome.
+</p>
+
<hr>
-<a name="Cross-compilation"></a>
-<div class="header">
+<span id="Cross-compilation"></span><div class="header">
<p>
-Previous: <a href="#Build-one-package" accesskey="p" rel="prev">Build one package</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &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="#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>
-<a name="Cross-compilation-1"></a>
-<h3 class="section">4.6 Cross compilation</h3>
+<span id="Cross-compilation-1"></span><h3 class="section">4.7 Cross compilation</h3>
-<a name="index-cross-compilation"></a>
+<span id="index-cross-compilation"></span>
<p>In a cross compilation a <em>build</em> system is used to create
binaries to be executed on a <em>host</em> system with different
hardware and/or operating system.
</p>
-<a name="index-native-cross-compilation"></a>
+<span id="index-native-cross-compilation"></span>
<p>In simple cases, the build system can execute binaries for the host
system. This typically occurs for bi-arch systems where, e.g.,
<code>i386-linux</code> binaries can run on <code>x86_64-linux</code> systems and
@@ -834,7 +846,7 @@ compilation at all. In most such cases it suffices to specify
suitable compiler flags. It might be useful to add the configure
option <code>--build=<var>host</var></code> to get the correct canonical host
name, but note that this should <em>not</em> be <code>--host=<var>host</var></code>
-(see <a href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
+(see <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
</p>
<p>In order to build, e.g., 32-bit binaries with <code>clang</code> on a 64-bit
MacOSX system one could use:
@@ -847,26 +859,24 @@ MacOSX system one could use:
</pre></div>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Cross-configuring" accesskey="1">Cross configuring</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Configuring for cross compilation.
+<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.
+<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>
<hr>
-<a name="Cross-configuring"></a>
-<div class="header">
+<span id="Cross-configuring"></span><div class="header">
<p>
Next: <a href="#Cross-problems" accesskey="n" rel="next">Cross problems</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Cross-configuring-1"></a>
-<h4 class="subsection">4.6.1 Cross configuring</h4>
+<span id="Cross-configuring-1"></span><h4 class="subsection">4.7.1 Cross configuring</h4>
-<a name="index-cross-compilation-configuring"></a>
-<a name="index-configuring_002c-for-cross-compilation"></a>
+<span id="index-cross-compilation-configuring"></span>
+<span id="index-configuring_002c-for-cross-compilation"></span>
-<a name="index-_002d_002dhost_003dhost"></a>
-<a name="index-_002d_002dbuild_003dhost"></a>
+<span id="index-_002d_002dhost_003dhost"></span>
+<span id="index-_002d_002dbuild_003dhost"></span>
<p>In a standard cross compilation, binaries for the host system cannot
execute on the build system and it is necessary to specify the
configure options <code>--host=<var>host</var></code> and
@@ -892,7 +902,7 @@ variables:
<code>strip</code> STRIP
</pre></div>
-<a name="index-mingw32"></a>
+<span id="index-mingw32"></span>
<p>In order to, e.g., build <code>mingw32</code> binaries on
<code>x86_64-linux</code> with a cross compiler found as
<samp>i386-pc-mingw32-gcc</samp> one would specify
@@ -914,7 +924,7 @@ compiler. If necessary, you can specify compilers and flags for the
few auxiliary C and C++ programs required for the build process as
configure arguments
</p>
-<a name="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></a>
+<span id="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></span>
<div class="example">
<pre class="example">BUILDCC=&hellip;
BUILDCPPFLAGS=&hellip;
@@ -925,15 +935,13 @@ BUILDLDFLAGS=&hellip;
</pre></div>
<hr>
-<a name="Cross-problems"></a>
-<div class="header">
+<span id="Cross-problems"></span><div class="header">
<p>
Previous: <a href="#Cross-configuring" accesskey="p" rel="prev">Cross configuring</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Cross-problems-1"></a>
-<h4 class="subsection">4.6.2 Cross problems</h4>
+<span id="Cross-problems-1"></span><h4 class="subsection">4.7.2 Cross problems</h4>
-<a name="index-cross-compilation-problems"></a>
+<span id="index-cross-compilation-problems"></span>
<p>The fact that binaries for the host system cannot be executed on the
build system causes some problems.
@@ -943,10 +951,10 @@ compile and link the test program but cannot execute it. Such tests
should be avoided if possible and otherwise must supply a pessimistic
test result.
</p>
-<a name="index-squeeze"></a>
-<a name="index-web2c-program"></a>
-<a name="index-freetype-cross-compiling"></a>
-<a name="index-CC_005fBUILD"></a>
+<span id="index-squeeze"></span>
+<span id="index-web2c-program"></span>
+<span id="index-freetype-cross-compiling"></span>
+<span id="index-CC_005fBUILD"></span>
<p>Another problem arises if the build process must execute some
(auxiliary or installable) programs. Auxiliary programs can be placed
into a subdirectory that is configured natively as is done for
@@ -955,80 +963,76 @@ into a subdirectory that is configured natively as is done for
value of <code>CC_BUILD</code>, <samp><var>build</var>-gcc</samp>, <samp>gcc</samp>, or
<samp>cc</samp> as the compiler for the auxiliary program.
</p>
-<a name="index-ICU-cross-compiling"></a>
+<span id="index-ICU-cross-compiling"></span>
<p>The situation for installable programs needed by the build process is
somewhat different. A rather expensive possibility, chosen for the ICU
libraries in module <samp>libs/icu</samp>, is to first compile natively for
the build system and in a second step to use these (uninstalled)
programs during the cross compilation.
</p>
-<a name="index-tangle"></a>
-<a name="index-ctangle"></a>
-<a name="index-otangle"></a>
-<a name="index-tie"></a>
+<span id="index-tangle"></span>
+<span id="index-ctangle"></span>
+<span id="index-otangle"></span>
+<span id="index-tie"></span>
<p>This approach would also be possible for the tools such as
<samp>tangle</samp> used in the module <samp>texk/web2c</samp> to build the WEB
programs, but that would require first building a native
<code>kpathsea</code> library. To avoid this complication, cross
-compilation of the WEB or CWEB programs requires sufficiently recent
+compilation of programs written in (C)WEB requires sufficiently recent
installed versions of <samp>tangle</samp>, <samp>ctangle</samp>, <samp>otangle</samp>,
and <samp>tie</samp>.
</p>
-<a name="index-xindy-cross-compiling-impossible"></a>
-<p>Building <code>xindy</code> requires running the host system <samp>clisp</samp>
-binary, thus cross compilation is not possible.
+<span id="index-xindy-cross-compiling-requires-clisp"></span>
+<p>Building <code>xindy</code> requires running the host system <code>clisp</code>
+binary, thus cross compilation is painful, but possible.
</p>
<hr>
-<a name="Installing"></a>
-<div class="header">
+<span id="Installing"></span><div class="header">
<p>
Next: <a href="#Layout-and-infrastructure" accesskey="n" rel="next">Layout and infrastructure</a>, Previous: <a href="#Building" accesskey="p" rel="prev">Building</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Installing-1"></a>
-<h2 class="chapter">5 Installing</h2>
+<span id="Installing-1"></span><h2 class="chapter">5 Installing</h2>
-<a name="index-installing"></a>
+<span id="index-installing"></span>
<p>This section discusses the results of <code>make install</code> in the
source tree.
</p>
-<a name="index-support-files_002c-separate-from-build"></a>
-<a name="index-texlive_002etlpdb_002c-TeX-Live-database"></a>
-<a name="index-install_002dtl_002c-TeX-Live-installer"></a>
-<a name="index-plain_002etex_002c-not-in-source-tree"></a>
+<span id="index-support-files_002c-separate-from-build"></span>
+<span id="index-texlive_002etlpdb_002c-TeX-Live-database"></span>
+<span id="index-install_002dtl_002c-TeX-Live-installer"></span>
+<span id="index-plain_002etex_002c-not-in-source-tree"></span>
<p>The main consideration is that <code>make install</code> is not enough to
make a usable TeX installation. Beyond the compiled binaries,
-(thousands of) support files are needed; just as a first example
+(thousands of) support files are needed; just as a first example,
<samp>plain.tex</samp> is not in the source tree.
</p>
<p>These support files are maintained completely independently and are
-not present in the source tree. The best basis for dealing with them
+not present in the TL source tree. The best basis for dealing with them
is the TeX&nbsp;Live (plain text) database in
<samp>Master/tlpkg/texlive.tlpdb</samp>, and/or the TeX&nbsp;Live installer,
<code>install-tl</code>. More information is under <samp>Master/tlpkg</samp> and
-at <a href="http://tug.org/texlive/distro.html">http://tug.org/texlive/distro.html</a>.
+at <a href="https://tug.org/texlive/distro.html">https://tug.org/texlive/distro.html</a>.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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.
+<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.
+<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.
+<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>
<hr>
-<a name="Installation-directories"></a>
-<div class="header">
+<span id="Installation-directories"></span><div class="header">
<p>
Next: <a href="#Linked-scripts" accesskey="n" rel="next">Linked scripts</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Installation-directories-1"></a>
-<h3 class="section">5.1 Installation directories</h3>
+<span id="Installation-directories-1"></span><h3 class="section">5.1 Installation directories</h3>
-<a name="index-installation-directories"></a>
-<a name="index-directories_002c-for-installation"></a>
-<a name="index-paths_002c-for-installation"></a>
+<span id="index-installation-directories"></span>
+<span id="index-directories_002c-for-installation"></span>
+<span id="index-paths_002c-for-installation"></span>
<p>Running <code>make install</code> (or <code>make install-strip</code>) installs
executables in <code><var>bindir</var></code>, libraries in <code><var>libdir</var></code>,
@@ -1038,7 +1042,7 @@ scripts&rdquo;, see <a href="#Linked-scripts">Linked scripts</a>) in
and Info files in <code><var>infodir</var></code>.
</p>
<p>The values of these directories are determined by <code>configure</code>
-and can be specified explictly as options such as
+and can be specified explicitly as options such as
<code>--prefix=<var>prefix</var></code> or <code>--bindir=<var>bindir</var></code>;
otherwise, they are given by their usual Autoconf defaults:
</p>
@@ -1073,27 +1077,25 @@ directories used in the TL distribution.
installation paths.
</p>
<p>For the native TL build, the <code>Build</code> script leaves the binaries
-in <samp>./inst/bin/<var>std-platform-name</var></samp>. The new binaries are
+in <samp>./inst/bin/<var>std-system-triplet</var></samp>. The new binaries are
not directly usable from that location; they need to be copied to
<samp>Master/bin/<var>tl-platform</var></samp>. The other files and directories
that end up in <samp>./inst/</samp> are ignored.
</p>
<hr>
-<a name="Linked-scripts"></a>
-<div class="header">
+<span id="Linked-scripts"></span><div class="header">
<p>
Next: <a href="#Distro-builds" accesskey="n" rel="next">Distro builds</a>, Previous: <a href="#Installation-directories" accesskey="p" rel="prev">Installation directories</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Linked-scripts-1"></a>
-<h3 class="section">5.2 Linked scripts</h3>
+<span id="Linked-scripts-1"></span><h3 class="section">5.2 Linked scripts</h3>
-<a name="index-linked-scripts"></a>
-<a name="index-scripts_002c-linked-and-not-maintained"></a>
+<span id="index-linked-scripts"></span>
+<span id="index-scripts_002c-linked-and-not-maintained"></span>
-<a name="index-symlinks_002c-used-for-scripts"></a>
-<a name="index-wrapper-binary-for-scripts-on-Windows"></a>
-<a name="index-Windows_002c-invoking-scripts-on"></a>
+<span id="index-symlinks_002c-used-for-scripts"></span>
+<span id="index-wrapper-binary-for-scripts-on-Windows"></span>
+<span id="index-Windows_002c-invoking-scripts-on"></span>
<p>Quite a few executables are architecture-independent shell, Perl, or
other interpreted scripts, rather than compiled binaries. A few are
maintained as part of the TL source tree, but most are maintained
@@ -1104,57 +1106,55 @@ elsewhere with copies under <samp>texk/texlive/linked_scripts</samp>.
symbolic link is made in <code><var>bindir</var></code>. For example, a symlink
points from <code><var>bindir</var>/ps2eps</code> to
<code><var>datarootdir</var>/texmf-dist/scripts/ps2eps/ps2eps.pl</code>. For
-Windows, a standard wrapper binary (e.g.,
-<code><var>bindir</var>/ps2eps.exe</code>) serves the same purpose. (The source
-for the wrapper is in <samp>texk/texlive/w32_wrapper</samp>.)
+Windows, a standard wrapper binary (copied to, e.g.,
+<code><var>bindir</var>/ps2eps.exe</code>) serves the same purpose. The source
+for the wrapper is in <samp>texk/texlive/w32_wrapper</samp>.
</p>
<p>One reason for this is to avoid having many copies of the same
script; a more important reason is that it guarantees the scripts will
stay in sync across the different supported operating systems.
</p>
-<a name="index-asymptote"></a>
-<a name="index-biber"></a>
-<a name="index-xindy"></a>
-<a name="index-xz"></a>
-<a name="index-wget"></a>
+<span id="index-asymptote"></span>
+<span id="index-biber"></span>
+<span id="index-xindy"></span>
+<span id="index-xz"></span>
+<span id="index-wget"></span>
<p>Most important of all, we want the <code><var>bindir</var></code> resulting from
the build to be as close as possible to what is in the TL
distribution. At present, there are a few exceptions&mdash;Asymptote,
Biber, Xindy&mdash;and each one creates considerable extra work. We don&rsquo;t
-want to add more. (See <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a> for
+want to add more. (See <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a> for
information about building those exceptions, as well as the <code>xz</code>
and <code>wget</code> programs that are used in the TL infrastructure.)
</p>
<hr>
-<a name="Distro-builds"></a>
-<div class="header">
+<span id="Distro-builds"></span><div class="header">
<p>
Previous: <a href="#Linked-scripts" accesskey="p" rel="prev">Linked scripts</a>, Up: <a href="#Installing" accesskey="u" rel="up">Installing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Distro-builds-1"></a>
-<h3 class="section">5.3 Distro builds</h3>
+<span id="Distro-builds-1"></span><h3 class="section">5.3 Distro builds</h3>
-<a name="index-distro_002c-building-for"></a>
-<a name="index-operating-system-distribution_002c-building-for"></a>
-<a name="index-system-distribution_002c-building-for"></a>
+<span id="index-distro_002c-building-for"></span>
+<span id="index-operating-system-distribution_002c-building-for"></span>
+<span id="index-system-distribution_002c-building-for"></span>
-<a name="index-GNU_002fLinux-distro"></a>
-<a name="index-BSD-distro"></a>
+<span id="index-GNU_002fLinux-distro"></span>
+<span id="index-BSD-distro"></span>
<p>Although they use the same code base, building for the native TL
distribution as shipped by the TeX user groups is typically quite
different from a &ldquo;distro&rdquo; build needed by, e.g., a full GNU/Linux or
BSD operating system distribution.
</p>
-<a name="index-shared-libraries_002c-using-vs_002e-avoiding"></a>
+<span id="index-shared-libraries_002c-using-vs_002e-avoiding"></span>
<p>The native TL distribution uses shared libraries only when absolutely
necessary (<samp>libc</samp>, <samp>libm</samp>, X11 libraries, and
-<samp>libfontconfig</samp>). However, a distro typically wants to use as
-many shared libraries as possible from elsewhere on the system,
+<samp>libfontconfig</samp>). In contrast, a distro typically wants to use
+as many shared libraries as possible from elsewhere on the system,
including TeX-specific libraries such as <samp>libkpathsea</samp> (even
though Kpathsea has never officially been released as a shared
-library, but we digress). In addition, the installation paths will,
-in general, be completely different.
+library). In addition, the installation paths will, in general, be
+completely different.
</p>
<p>Here are the <code>configure</code> options that distro builds are likely to
find most relevant:
@@ -1180,7 +1180,7 @@ build and your distro can be distinguished from others.
</p>
</dd>
<dt><code>--with-system-<var>lib</var></code></dt>
-<dd><p>Use system versions for as many libraries <var>lib</var> as possible.
+<dd><p>Look for and use a system version of the library <var>lib</var>.
<code>configure --help</code> will give you the list of possibilities.
</p>
</dd>
@@ -1202,28 +1202,26 @@ you shouldn&rsquo;t install there for a distro.
</dd>
</dl>
-<a name="index-Preining_002c-Norbert"></a>
-<a name="index-adapting-TeX-Live-for-distros"></a>
+<span id="index-Preining_002c-Norbert"></span>
+<span id="index-adapting-TeX-Live-for-distros"></span>
<p>You will need to take care of the support files mentioned above
(see <a href="#Installing">Installing</a>), and many other issues, such as font maps,
languages, and formats, independently of the build. Norbert Preining
has written a detailed article on adapting TL for distros:
-<a href="http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf">http://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf</a>. (If the
+<a href="https://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf">https://tug.org/TUGboat/tb34-3/tb108preining-distro.pdf</a>. (If the
article needs updating in the future, perhaps we will merge it into
this document.)
</p>
<hr>
-<a name="Layout-and-infrastructure"></a>
-<div class="header">
+<span id="Layout-and-infrastructure"></span><div class="header">
<p>
Next: <a href="#Configure-options" accesskey="n" rel="next">Configure options</a>, Previous: <a href="#Installing" accesskey="p" rel="prev">Installing</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Layout-and-infrastructure-1"></a>
-<h2 class="chapter">6 Layout and infrastructure</h2>
+<span id="Layout-and-infrastructure-1"></span><h2 class="chapter">6 Layout and infrastructure</h2>
-<a name="index-layout-of-sources"></a>
-<a name="index-source-tree"></a>
+<span id="index-layout-of-sources"></span>
+<span id="index-source-tree"></span>
<p>The TeX&nbsp;Live source tree is the subtree rooted at <samp>Build/source</samp> of
the complete TL distribution and contains the sources for all executables
@@ -1232,36 +1230,34 @@ rules to build and install them together with some of their support
files.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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.
+<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.
+<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.
+<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.
+<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.
+<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.
+<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>
<hr>
-<a name="Build-system-tools"></a>
-<div class="header">
+<span id="Build-system-tools"></span><div class="header">
<p>
Next: <a href="#Top_002dlevel-directories" accesskey="n" rel="next">Top-level directories</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Build-system-tools-1"></a>
-<h3 class="section">6.1 Build system tools</h3>
+<span id="Build-system-tools-1"></span><h3 class="section">6.1 Build system tools</h3>
-<a name="index-tools_002c-for-building"></a>
-<a name="index-GNU-tools_002c-needed-for-building"></a>
-<a name="index-infrastructure_002c-tools-needed-for"></a>
+<span id="index-tools_002c-for-building"></span>
+<span id="index-GNU-tools_002c-needed-for-building"></span>
+<span id="index-infrastructure_002c-tools-needed-for"></span>
-<p>As mentioned above (see <a href="#Prerequisites">Prerequisites</a>), a normal build requires
-very little. On the other hand, if you want to modify the TeX&nbsp;Live
+<p>As mentioned above (see <a href="#Prerequisites">Prerequisites</a>), a normal build has few
+requirements. On the other hand, if you want to modify the TeX&nbsp;Live
infrastructure sources, such as <samp>configure.ac</samp> or
<samp>Makefile.am</samp> files, you will need to have several additional
tools installed.
@@ -1278,53 +1274,56 @@ may be.
</p>
<div class="display">
<pre class="display">autoconf (GNU Autoconf) 2.69
-automake (GNU automake) 1.15.1
-bison (GNU Bison) 3.0.4
+automake (GNU automake) 1.16.1
+bison (GNU Bison) 3.3.1
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.18
-makeinfo (GNU texinfo) 6.5
+makeinfo (GNU texinfo) 6.6
</pre></div>
-<a name="index-reautoconf"></a>
-<a name="index-_002d_002denable_002dmaintainer_002dmode"></a>
+<span id="index-reautoconf"></span>
+<span id="index-_002d_002denable_002dmaintainer_002dmode"></span>
<p>These versions should be used to update the generated files (e.g.,
<samp>configure</samp> or <samp>Makefile.in</samp>) in all or parts of the TL tree
after their dependencies have been changed. This can be done
explicitly with the top-level <code>reautoconf</code> script or implicitly
by using the configure option <code>--enable-maintainer-mode</code>.
</p>
-<a name="index-Subversion-repository"></a>
-<a name="index-timestamps_002c-in-repository"></a>
-<a name="index-use_002dcommit_002dtimes_002c-Subversion"></a>
+<p>It has often turned out that the bison and flex versions are not
+critical; however, the autotools versions are. If you don&rsquo;t have the
+given versions, get them before modifying the build infrastructure.
+</p>
+<span id="index-Subversion-repository"></span>
+<span id="index-timestamps_002c-in-repository"></span>
+<span id="index-use_002dcommit_002dtimes_002c-Subversion"></span>
<p>The files in the Subversion repository (see
-<a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>) are all up to date, but
-unfortunately this may not be reflected by their timestamps. (For
-starters, be sure to set <samp>use-commit-times=yes</samp> in
-<samp>~/.subversion/config</samp> or the equivalent.)
-</p>
-<a name="index-touching-files-to-avoid-rerunning"></a>
-<a name="index-make-_002dt"></a>
-<p>To avoid unnecessary runs of <code>bison</code>, <code>flex</code>, or
-<code>makeinfo</code> it may be necessary to <code>touch</code> the generated
-(<samp>.c</samp>, <samp>.h</samp>, or <samp>.info</samp>) files. With
-<code>--enable-maintainer-mode</code> it may also be necessary to
-<code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp> and
+<a href="https://tug.org/texlive/svn">https://tug.org/texlive/svn</a>) are all up to date (barring
+bugs). For this to be reflected by their timestamps in your checkout,
+be sure to set <samp>use-commit-times=yes</samp> in
+<samp>~/.subversion/config</samp> or the equivalent.
+</p>
+
+<span id="index-touching-files-to-avoid-rerunning"></span>
+<span id="index-make-_002dt"></span>
+<p>If timestamps are wrong, you may also be able to avoid unnecessary
+runs of <code>bison</code>, <code>flex</code>, or <code>makeinfo</code> with
+<code>touch</code> of the generated (<samp>.c</samp>, <samp>.h</samp>, or <samp>.info</samp>)
+files. With <code>--enable-maintainer-mode</code> it may also be necessary
+to <code>touch</code> first <samp>aclocal.m4</samp>, then <samp>configure</samp> and
<samp>config.h.in</samp> (or <samp>c-auto.in</samp>), and finally all
<samp>Makefile.in</samp> files. Perhaps <code>make -t</code> will help.
</p>
<hr>
-<a name="Top_002dlevel-directories"></a>
-<div class="header">
+<span id="Top_002dlevel-directories"></span><div class="header">
<p>
Next: <a href="#Autoconf-macros" accesskey="n" rel="next">Autoconf macros</a>, Previous: <a href="#Build-system-tools" accesskey="p" rel="prev">Build system tools</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Top_002dlevel-directories-1"></a>
-<h3 class="section">6.2 Top-level directories</h3>
+<span id="Top_002dlevel-directories-1"></span><h3 class="section">6.2 Top-level directories</h3>
-<a name="index-directories_002c-top_002dlevel"></a>
-<a name="index-top_002dlevel-directories"></a>
+<span id="index-directories_002c-top_002dlevel"></span>
+<span id="index-top_002dlevel-directories"></span>
<p>Here is a brief description of the top-level directories in the TeX&nbsp;Live
source tree.
@@ -1333,8 +1332,8 @@ source tree.
(TeX-specific programs and libraries), <samp>utils/</samp> (additional
programs), and <samp>libs/</samp> (generic libraries).
</p>
-<a name="index-am_002f-top_002dlevel-directory"></a>
-<a name="index-m4_002f-top_002dlevel-directory"></a>
+<span id="index-am_002f-top_002dlevel-directory"></span>
+<span id="index-m4_002f-top_002dlevel-directory"></span>
<p>In addition, the top-level directories <samp>am/</samp> and <samp>m4/</samp>
contain <samp>Makefile.am</samp> fragments and Autoconf macros,
respectively, used in many places. Specifically, the file
@@ -1352,205 +1351,190 @@ library can be used. This ultimately determines which modules need to
be built&mdash;although all modules must be configured for the benefit of
<samp>make</samp> targets such as <code>dist</code> or <code>distcheck</code>.
</p>
-<a name="index-build_002daux_002f-top_002dlevel-directory"></a>
-<a name="index-config_002eguess_002c-config_002esub_002c-_2026"></a>
-<a name="index-Gnulib_002c-used-for-common-files"></a>
+<span id="index-build_002daux_002f-top_002dlevel-directory"></span>
+<span id="index-config_002eguess_002c-config_002esub_002c-_2026"></span>
+<span id="index-Gnulib_002c-used-for-common-files"></span>
<p>The top-level <samp>build-aux/</samp> directory contains the common files
<samp>compile</samp>, <samp>config.guess</samp>, <samp>config.sub</samp>,
-<samp>depcomp</samp>, etc.&nbsp;used by most packages. These are from the GNU
-Gnulib sources (<a href="http://www.gnu.org/software/gnulib">http://www.gnu.org/software/gnulib</a>), which in
-turn synchronizes with the appropriate ultimate upstream repository.
-There are, however, independent copies in, e.g.,
-<samp>libs/freetype2/freetype-*/builds/unix/</samp>, and a few other places.
-The <code>reautoconf</code> script does not touch those, but a TL cron job
-keeps them in sync (nightly).
-</p>
-<a name="index-extra_002f-top_002dlevel-directory"></a>
-<p>The directory <samp>extra/</samp> contains things which are not part of the
-TL build, but are present just for (someone&rsquo;s) convenience, e.g.,
-is <samp>epstopdf</samp> development source is here.
-</p>
-<a name="index-Work_002f-top_002dlevel-directory"></a>
-<a name="index-inst_002f-top_002dlevel-directory"></a>
+<samp>depcomp</samp>, etc.&nbsp;used by most packages. These are taken from the
+GNU Gnulib sources (<a href="https://www.gnu.org/software/gnulib">https://www.gnu.org/software/gnulib</a>), which
+in turn synchronizes with any ultimate upstream repository. There are
+independent copies of some of these in a few other places, e.g.,
+<samp>libs/freetype2/freetype-*/builds/unix/</samp>. The <code>reautoconf</code>
+script does not touch those, but a TL cron job keeps them in sync
+(nightly).
+</p>
+<span id="index-Work_002f-top_002dlevel-directory"></span>
+<span id="index-inst_002f-top_002dlevel-directory"></span>
<p>When the top-level <samp>./Build</samp> script is used to build TL, two more
two more top-level directories appear: <samp>Work/</samp> for the build tree,
and <samp>inst/</samp> for the install tree (from <code>make install</code>).
These names (and everything else about <samp>Build</samp>&rsquo;s operation) can
be changed by setting environment variables before running it; see the
-script file.
+script source.
</p>
<hr>
-<a name="Autoconf-macros"></a>
-<div class="header">
+<span id="Autoconf-macros"></span><div class="header">
<p>
Next: <a href="#Library-modules" accesskey="n" rel="next">Library modules</a>, Previous: <a href="#Top_002dlevel-directories" accesskey="p" rel="prev">Top-level directories</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Autoconf-macros-1"></a>
-<h3 class="section">6.3 Autoconf macros</h3>
+<span id="Autoconf-macros-1"></span><h3 class="section">6.3 Autoconf macros</h3>
-<a name="index-autoconf-macros"></a>
+<span id="index-autoconf-macros"></span>
-<p>Here we describe some of the Autoconf macros used in several
-modules&ndash;not a complete list, by any means. These general macros are
-supplemented by module-specific macros in directories such as
-<samp>texk/dvipng/m4/</samp>; some of those are described in <a href="#Library-modules">Library modules</a> and see <a href="#Program-modules">Program modules</a>.
+<p>Here we describe a few of the Autoconf macros used in several
+modules&mdash;many more are defined in the sources; see the top-level
+<code>m4/</code> directory. These general macros are supplemented by
+module-specific macros in directories such as <samp>texk/dvipng/m4/</samp>;
+some of those are described in following sections (see <a href="#Library-modules">Library modules</a> and <a href="#Program-modules">Program modules</a>).
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#General-setup-macros" accesskey="1">Setup</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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>
<hr>
-<a name="General-setup-macros"></a>
-<div class="header">
+<span id="General-setup-macros"></span><div class="header">
<p>
Next: <a href="#Macros-for-programs" accesskey="n" rel="next">Macros for programs</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="General-setup-macros-1"></a>
-<h4 class="subsection">6.3.1 General setup macros</h4>
+<span id="General-setup-macros-1"></span><h4 class="subsection">6.3.1 General setup macros</h4>
-<a name="index-general-setup-macros"></a>
-<a name="index-setup-macros_002c-general"></a>
-<a name="index-macros_002c-general-setup"></a>
+<span id="index-general-setup-macros"></span>
+<span id="index-setup-macros_002c-general"></span>
+<span id="index-macros_002c-general-setup"></span>
<p>The TL sources use two general setup macros:
</p>
<dl>
-<dt><a name="index-KPSE_005fBASIC"></a>Macro: <strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
+<dt id="index-KPSE_005fBASIC">Macro: <strong>KPSE_BASIC</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
<dd><p>Initialize the basic TL infrastructure for module <var>name</var>:<br>&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><a name="index-KPSE_005fCOMMON"></a>Macro: <strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
-<dd><p>Like <code>KPSE_BASIC</code> but add:<br>&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>and check for frequently used functions,
+<dt id="index-KPSE_005fCOMMON">Macro: <strong>KPSE_COMMON</strong> <em>(<var>name</var>, [<var>more-options</var>])</em></dt>
+<dd><p>Like <code>KPSE_BASIC</code> but add:<br>&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>
-<a name="Macros-for-programs"></a>
-<div class="header">
+<span id="Macros-for-programs"></span><div class="header">
<p>
Next: <a href="#Macros-for-compilers" accesskey="n" rel="next">Macros for compilers</a>, Previous: <a href="#General-setup-macros" accesskey="p" rel="prev">General setup macros</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-programs-1"></a>
-<h4 class="subsection">6.3.2 Macros for programs</h4>
+<span id="Macros-for-programs-1"></span><h4 class="subsection">6.3.2 Macros for programs</h4>
-<a name="index-macros_002c-for-programs"></a>
+<span id="index-macros_002c-for-programs"></span>
<p>Macros for program checks:
</p>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fLATEX"></a>Macro: <strong>KPSE_CHECK_LATEX</strong></dt>
-<dd><p>Set <code>LATEX</code> to the name of the first of <code>latex</code>,
-<code>elatex</code>, or <code>lambda</code> which exists in <code>PATH</code>, or to
-<code>no</code> if none of them exists. Call <code>AC_SUBST</code> for
-<code>LATEX</code>. The result of this test can be overridden by setting
-the <code>LATEX</code> environment variable or the cache variable
-<code>ac_cv_prog_LATEX</code>.
+<dt id="index-KPSE_005fCHECK_005fLATEX">Macro: <strong>KPSE_CHECK_LATEX</strong></dt>
+<dd><p>Set <code>LATEX</code> to the first of <code>latex</code>, <code>elatex</code>, or
+<code>lambda</code> which exists in <code>PATH</code>, or to <code>no</code> if none of
+them exists. Call <code>AC_SUBST</code> for <code>LATEX</code>. The result of
+this test can be overridden by setting the <code>LATEX</code> environment
+variable or the cache variable <code>ac_cv_prog_LATEX</code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fPDFLATEX"></a>Macro: <strong>KPSE_CHECK_PDFLATEX</strong></dt>
+<dt id="index-KPSE_005fCHECK_005fPDFLATEX">Macro: <strong>KPSE_CHECK_PDFLATEX</strong></dt>
<dd><p>Check for <code>pdflatex</code> in <code>PATH</code> and set <code>PDFLATEX</code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fPERL"></a>Macro: <strong>KPSE_CHECK_PERL</strong></dt>
+<dt id="index-KPSE_005fCHECK_005fPERL">Macro: <strong>KPSE_CHECK_PERL</strong></dt>
<dd><p>Check for <code>perl</code> or <code>perl5</code> in <code>PATH</code> and set
<code>PERL</code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fPROG_005fLEX"></a>Macro: <strong>KPSE_PROG_LEX</strong></dt>
+<dt id="index-KPSE_005fPROG_005fLEX">Macro: <strong>KPSE_PROG_LEX</strong></dt>
<dd><p>Call <code>AC_PROG_LEX</code> and add the flag <code>-l</code> for <code>flex</code>.
</p></dd></dl>
<hr>
-<a name="Macros-for-compilers"></a>
-<div class="header">
+<span id="Macros-for-compilers"></span><div class="header">
<p>
Next: <a href="#Macros-for-libraries" accesskey="n" rel="next">Macros for libraries</a>, Previous: <a href="#Macros-for-programs" accesskey="p" rel="prev">Macros for programs</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-compilers-1"></a>
-<h4 class="subsection">6.3.3 Macros for compilers</h4>
+<span id="Macros-for-compilers-1"></span><h4 class="subsection">6.3.3 Macros for compilers</h4>
-<a name="index-macros_002c-for-compilers"></a>
+<span id="index-macros_002c-for-compilers"></span>
<p>Macros for compiler-related checks:
</p>
<dl>
-<dt><a name="index-KPSE_005fCOMPILER_005fWARNINGS"></a>Macro: <strong>KPSE_COMPILER_WARNINGS</strong></dt>
-<dd><a name="index-WARNING_005fC_005bXX_005dFLAGS"></a>
+<dt id="index-KPSE_005fCOMPILER_005fWARNINGS">Macro: <strong>KPSE_COMPILER_WARNINGS</strong></dt>
+<dd><span id="index-WARNING_005fC_005bXX_005dFLAGS"></span>
<p>When using the (Objective) C/C++ compiler, set
<code>WARNING_[OBJ]C[XX]FLAGS</code> to suitable warning flags (depending on
the value given to or implied for <code>--enable-compiler-warnings</code>).
-Call <code>AC_SUBST</code> for them. At the moment this only works for GNU
-compilers, but could be extended to others if necessary.
+Call <code>AC_SUBST</code> for them. At present this assumes GNU compiler
+warning options, but could be extended to others if necessary.
</p>
-<a name="index-kpse_005fcv_005fwarning_005fcflags"></a>
+<span id="index-kpse_005fcv_005fwarning_005fcflags"></span>
<p>This macro caches its results in the <code>kpse_cv_warning_cflags</code>,
&hellip; variables.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOMPILER_005fVISIBILITY"></a>Macro: <strong>KPSE_COMPILER_VISIBILITY</strong></dt>
+<dt id="index-KPSE_005fCOMPILER_005fVISIBILITY">Macro: <strong>KPSE_COMPILER_VISIBILITY</strong></dt>
<dd><p>When using the C or C++ compiler, try to set
<code>VISIBILITY_C[XX]FLAGS</code> to flags to hide external symbols. Call
-<code>AC_SUBST</code> for this variable. At the moment this only tests for
-the compiler option <code>-fvisibility=hidden</code>, but that could be
-extended with more checks if necessary.
+<code>AC_SUBST</code> for this variable. At present this only tests for
+the compiler option <code>-fvisibility=hidden</code>, but could be
+extended if necessary.
</p>
-<a name="index-kpse_005fcv_005fvisibility_005fc_005bxx_005dflags"></a>
+<span id="index-kpse_005fcv_005fvisibility_005fc_005bxx_005dflags"></span>
<p>This macro caches its results in the <code>kpse_cv_visibility_cflags</code>
or <code>kpse_cv_visibility_cxxflags</code> variable.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCXX_005fHACK"></a>Macro: <strong>KPSE_CXX_HACK</strong></dt>
-<dd><a name="index-static-linking-for-C_002b_002b"></a>
-<a name="index-linking-C_002b_002b-libraries-statically"></a>
-<a name="index-_002d_002denable_002dcxx_002druntime_002dhack"></a>
-<a name="index-libstc_002b_002b_002c-statically-linking"></a>
+<dt id="index-KPSE_005fCXX_005fHACK">Macro: <strong>KPSE_CXX_HACK</strong></dt>
+<dd><span id="index-static-linking-for-C_002b_002b"></span>
+<span id="index-linking-C_002b_002b-libraries-statically"></span>
+<span id="index-_002d_002denable_002dcxx_002druntime_002dhack"></span>
+<span id="index-libstc_002b_002b_002c-statically-linking"></span>
<p>Provide the configure option <code>--enable-cxx-runtime-hack</code>. If
enabled and when using <code>g++</code>, try to statically link with
-<samp>libstdc++</samp>, somewhat improving portability of the resulting
+<samp>libstdc++</samp>, notably improving portability of the resulting
binary.
</p>
-<a name="index-kpse_005fcv_005fcxx_005fhack"></a>
+<span id="index-kpse_005fcv_005fcxx_005fhack"></span>
<p>This macro caches its result in the <code>kpse_cv_cxx_hack</code> variable.
</p></dd></dl>
<hr>
-<a name="Macros-for-libraries"></a>
-<div class="header">
+<span id="Macros-for-libraries"></span><div class="header">
<p>
Next: <a href="#Macros-for-library-and-header-flags" accesskey="n" rel="next">Macros for library and header flags</a>, Previous: <a href="#Macros-for-compilers" accesskey="p" rel="prev">Macros for compilers</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-libraries-1"></a>
-<h4 class="subsection">6.3.4 Macros for libraries</h4>
+<span id="Macros-for-libraries-1"></span><h4 class="subsection">6.3.4 Macros for libraries</h4>
-<a name="index-macros_002c-for-libraries"></a>
+<span id="index-macros_002c-for-libraries"></span>
<p>One macro for a library check:
</p>
<dl>
-<dt><a name="index-KPSE_005fLARGEFILE"></a>Macro: <strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em></dt>
+<dt id="index-KPSE_005fLARGEFILE">Macro: <strong>KPSE_LARGEFILE</strong> <em>(<var>variable</var>, [<var>extra-define</var>])</em></dt>
<dd><p>Call <code>AC_SYS_LARGEFILE</code> and <code>AC_FUNC_FSEEKO</code> and append
suitable <code>-D</code> flags (optionally including
<code>-D<var>extra-define</var></code>) to <var>variable</var>.
@@ -1558,40 +1542,42 @@ suitable <code>-D</code> flags (optionally including
<hr>
-<a name="Macros-for-library-and-header-flags"></a>
-<div class="header">
+<span id="Macros-for-library-and-header-flags"></span><div class="header">
<p>
Next: <a href="#Macros-for-Windows" accesskey="n" rel="next">Macros for Windows</a>, Previous: <a href="#Macros-for-libraries" accesskey="p" rel="prev">Macros for libraries</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-library-and-header-flags-1"></a>
-<h4 class="subsection">6.3.5 Macros for library and header flags</h4>
+<span id="Macros-for-library-and-header-flags-1"></span><h4 class="subsection">6.3.5 Macros for library and header flags</h4>
-<a name="index-macros_002c-for-library-and-header-flags"></a>
-<a name="index-flags_002c-macros-for-library-and-header"></a>
-<a name="index-KPSE_005fLIB_005fFLAGS"></a>
+<span id="index-macros_002c-for-library-and-header-flags"></span>
+<span id="index-flags_002c-macros-for-library-and-header"></span>
+<span id="index-KPSE_005fLIB_005fFLAGS"></span>
<p>Each library module <samp>libs/<var>lib</var></samp> or <samp>texk/<var>lib</var></samp> is
supplemented by a macro <code>KPSE_<var>LIB</var>_FLAGS</code> (all uppercase)
that provides make variables for that library. E.g., for
<samp>libs/libpng</samp>:
</p>
<dl>
-<dt><a name="index-KPSE_005fLIBPNG_005fFLAGS"></a>Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt>
+<dt id="index-KPSE_005fLIBPNG_005fFLAGS">Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt>
<dd><p>Provide the configure option <code>--with-system-libpng</code>. Set and
<code>AC_SUBST</code> <code>make</code> variables for modules using this library (either
-an installed version or from the TeX&nbsp;Live tree): <code>LIBPNG_INCLUDES</code> for use
-in <code>CPPFLAGS</code>, <code>LIBPNG_LIBS</code> for use in <code>LDADD</code>,
-<code>LIBPNG_DEPEND</code> for use as dependency, and <code>LIBPNG_RULE</code> defining
-<code>make</code> rules to rebuild the library.
-</p></dd></dl>
+an installed version or from the TeX&nbsp;Live tree):
+</p>
+<table>
+<tr><td><code>LIBPNG_INCLUDES</code></td><td>for use in <code>CPPFLAGS</code>,</td></tr>
+<tr><td><code>LIBPNG_LIBS</code></td><td>for use in <code>LDADD</code>,</td></tr>
+<tr><td><code>LIBPNG_DEPEND</code></td><td>for use as a Makefile dependency,</td></tr>
+<tr><td><code>LIBPNG_RULE</code></td><td>for the <code>make</code> rules to rebuild the library.</td></tr>
+</table>
+</dd></dl>
<dl>
-<dt><a name="index-KPSE_005fADD_005fFLAGS"></a>Macro: <strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em></dt>
+<dt id="index-KPSE_005fADD_005fFLAGS">Macro: <strong>KPSE_ADD_FLAGS</strong> <em>(<var>name</var>)</em></dt>
<dd><p>Temporarily extend <code>CPPFLAGS</code> and <code>LIBS</code> with the values required
for the library module <code><var>name</var></code>.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fRESTORE_005fFLAGS"></a>Macro: <strong>KPSE_RESTORE_FLAGS</strong></dt>
+<dt id="index-KPSE_005fRESTORE_005fFLAGS">Macro: <strong>KPSE_RESTORE_FLAGS</strong></dt>
<dd><p>Restore <code>CPPFLAGS</code> and <code>LIBS</code> to their original values.
</p></dd></dl>
@@ -1615,7 +1601,7 @@ foo_DEPENDENCIES = ${ZLIB_DEPEND} ${LIBPNG_DEPEND}
@LIBPNG_RULE@
</pre></div>
-<p>If it was necessary to examine whether certain <samp>zlib</samp> or
+<p>If it were necessary to examine whether certain <samp>zlib</samp> or
<samp>libpng</samp> features were available, <samp>configure.ac</samp> should be
continued this way:
</p><div class="example">
@@ -1628,48 +1614,46 @@ KPSE_RESTORE_FLAGS # <span class="roman">restore <code>CPPFLAGS</code> and <code
<hr>
-<a name="Macros-for-Windows"></a>
-<div class="header">
+<span id="Macros-for-Windows"></span><div class="header">
<p>
Previous: <a href="#Macros-for-library-and-header-flags" accesskey="p" rel="prev">Macros for library and header flags</a>, Up: <a href="#Autoconf-macros" accesskey="u" rel="up">Autoconf macros</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Macros-for-Windows-1"></a>
-<h4 class="subsection">6.3.6 Macros for Windows</h4>
+<span id="Macros-for-Windows-1"></span><h4 class="subsection">6.3.6 Macros for Windows</h4>
-<a name="index-macros_002c-for-Windows"></a>
-<a name="index-Windows_002c-macros-for"></a>
+<span id="index-macros_002c-for-Windows"></span>
+<span id="index-Windows_002c-macros-for"></span>
<p>Windows differs in several aspects from Unix-like systems, many of
them due to the lack of symbolic links.
</p>
<dl>
-<dt><a name="index-KPSE_005fCHECK_005fWIN32"></a>Macro: <strong>KPSE_CHECK_WIN32</strong></dt>
-<dd><a name="index-kpse_005fcv_005fhave_005fwin32"></a>
-<p>Check if compiling for a Windows system. The result is <code>no</code> for
-Unix-like systems (including Cygwin), <code>mingw32</code> for Windows with
-GCC, or <code>native</code> for Windows with MSVC. The result is cached in
-the <code>kpse_cv_have_win32</code> variable.
+<dt id="index-KPSE_005fCHECK_005fWIN32">Macro: <strong>KPSE_CHECK_WIN32</strong></dt>
+<dd><span id="index-kpse_005fcv_005fhave_005fwin32"></span>
+<p>Check if compiling for a Windows system. The result is either
+<code>no</code> for Unix-like systems (including Cygwin), <code>mingw32</code> for
+Windows with GCC, or <code>native</code> for Windows with MSVC. The result
+is cached in the <code>kpse_cv_have_win32</code> variable.
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOND_005fWIN32"></a>Macro: <strong>KPSE_COND_WIN32</strong></dt>
-<dd><a name="index-WIN32_002c-Automake-conditional"></a>
+<dt id="index-KPSE_005fCOND_005fWIN32">Macro: <strong>KPSE_COND_WIN32</strong></dt>
+<dd><span id="index-WIN32_002c-Automake-conditional"></span>
<p>Call <code>KPSE_CHECK_WIN32</code> and define the Automake conditional
<code>WIN32</code> (<code>true</code> if the value of <code>kpse_cv_have_win32</code> is
not <code>no</code>).
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOND_005fMINGW32"></a>Macro: <strong>KPSE_COND_MINGW32</strong></dt>
-<dd><a name="index-MINGW32_002c-Automake-conditional"></a>
+<dt id="index-KPSE_005fCOND_005fMINGW32">Macro: <strong>KPSE_COND_MINGW32</strong></dt>
+<dd><span id="index-MINGW32_002c-Automake-conditional"></span>
<p>Call <code>KPSE_COND_WIN32</code> and define the Automake conditional
<code>MINGW32</code> (<code>true</code> if the value of <code>kpse_cv_have_win32</code> is
<code>mingw32</code>).
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fCOND_005fWIN32_005fWRAP"></a>Macro: <strong>KPSE_COND_WIN32_WRAP</strong></dt>
-<dd><a name="index-WIN32_005fWRAP_002c-Automake-conditional"></a>
-<a name="index-runscript_002eexe"></a>
+<dt id="index-KPSE_005fCOND_005fWIN32_005fWRAP">Macro: <strong>KPSE_COND_WIN32_WRAP</strong></dt>
+<dd><span id="index-WIN32_005fWRAP_002c-Automake-conditional"></span>
+<span id="index-runscript_002eexe"></span>
<p>Call <code>KPSE_COND_WIN32</code> and define the Automake conditional
<code>WIN32_WRAP</code> (<code>true</code> if the standard Windows wrapper
(<samp>texk/texlive/w32_wrapper/runscript.exe</samp>) exists. This wrapper
@@ -1678,9 +1662,9 @@ is used on Windows instead of symlinks for the &ldquo;linked scripts&rdquo;
</p></dd></dl>
<dl>
-<dt><a name="index-KPSE_005fWIN32_005fCALL"></a>Macro: <strong>KPSE_WIN32_CALL</strong></dt>
-<dd><a name="index-callexe_002ec"></a>
-<p>Call <code>KPSE_COND_WIN32</code>, check if the file
+<dt id="index-KPSE_005fWIN32_005fCALL">Macro: <strong>KPSE_WIN32_CALL</strong></dt>
+<dd><span id="index-callexe_002ec"></span>
+<p>Call <code>KPSE_COND_WIN32</code> and check if the file
<samp>texk/texlive/w32_wrapper/callexe.c</samp> exists; if it does, create a
symlink in the build tree. Compiling <samp>callexe.c</samp> with
<code>-DEXEPROG='&quot;<var>foo</var>.exe&quot;'</code> and installing <samp>callexe.exe</samp>
@@ -1690,58 +1674,54 @@ as <code><var>bar</var>.exe</code> is used on Windows instead of a symlink
<hr>
-<a name="Library-modules"></a>
-<div class="header">
+<span id="Library-modules"></span><div class="header">
<p>
Next: <a href="#Program-modules" accesskey="n" rel="next">Program modules</a>, Previous: <a href="#Autoconf-macros" accesskey="p" rel="prev">Autoconf macros</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Library-modules-1"></a>
-<h3 class="section">6.4 Library modules</h3>
+<span id="Library-modules-1"></span><h3 class="section">6.4 Library modules</h3>
-<a name="index-library-modules"></a>
-<a name="index-modules_002c-for-libraries"></a>
+<span id="index-library-modules"></span>
+<span id="index-modules_002c-for-libraries"></span>
<p>Here we discuss some specifics for a few of the libraries in TL, both
for the details themselves, and as a way of illuminating the general
structure and variation.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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>
+<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>
+<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>
+<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>
+<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>
<hr>
-<a name="png-library"></a>
-<div class="header">
+<span id="png-library"></span><div class="header">
<p>
Next: <a href="#zlib-library" accesskey="n" rel="next"><code>zlib</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-png-library-in-libs_002flibpng"></a>
-<h4 class="subsection">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></h4>
+<span id="The-png-library-in-libs_002flibpng"></span><h4 class="subsection">6.4.1 The <code>png</code> library in <samp>libs/libpng</samp></h4>
-<a name="index-png-library"></a>
-<a name="index-libpng-library"></a>
-<p>This generic library uses the source tree in, e.g., the subdirectory
-<samp>libpng-src/</samp> with all modifications for TL recorded in
-<samp>TLpatches/*</samp>. The <samp>configure.ac</samp> fragment
+<span id="index-png-library"></span>
+<span id="index-libpng-library"></span>
+<p>The &ldquo;generic&rdquo; <code>png</code> library uses the source tree in the
+subdirectory <samp>libpng-src/</samp>, with all modifications for TL
+recorded in <samp>TLpatches/*</samp>. The <samp>configure.ac</samp> fragment
<samp>ac/withenable.ac</samp> contains
</p>
<div class="example">
<pre class="example">KPSE_WITH_LIB([libpng], [zlib])
</pre></div>
-<p>specifying the module name, and indicating the dependency on
-<code>zlib</code>. A third literal argument <code>tree</code> would specify that
+<p>to specify the module name and indicate the dependency on
+<code>zlib</code>. A third literal argument &lsquo;<code>tree</code>&rsquo; would specify that
the library from the TeX&nbsp;Live tree cannot be replaced by a system
version. That not being the case here, a second fragment
<samp>ac/libpng.ac</samp> contains
</p>
-<a name="index-KPSE_005fTRY_005fLIB"></a>
+<span id="index-KPSE_005fTRY_005fLIB"></span>
<div class="example">
<pre class="example">KPSE_TRY_LIB([libpng],
[#include &lt;png.h&gt;],
@@ -1759,48 +1739,50 @@ int main ()
return 0; }
</pre></div>
-<a name="index-KPSE_005fTRY_005fLIBXX"></a>
+<span id="index-KPSE_005fTRY_005fLIBXX"></span>
<p>which Autoconf uses to verify the usability of a system
version with C code. The analogous macro <code>KPSE_TRY_LIBXX</code> would
-check using C++ code. These fragments are included by
-<samp>configure.ac</samp> at the top level.
-</p>
-<p>For this library, among many other modules, a proxy build system for
-TL is used (<samp>configure.ac</samp>, <samp>Makefile.am</samp>, and
-<samp>include/Makefile.am</samp>), ignoring the distributed one.
-Consequently, a few generated files and auxiliary scripts are removed
-from the distributed source tree. The public headers <samp>png.h</samp>,
-<samp>pngconf.h</samp>, and <samp>pnglibconf.h</samp> are &ldquo;installed&rdquo; (as
-symlinks) under <samp>include/</samp> in the build tree exactly as they are
-for a system version under, e.g., <samp>/usr/include/</samp>.
-</p>
-<a name="index-kpse_002dlibpng_002dflags_002em4"></a>
-<a name="index-KPSE_005fLIBPNG_005fFLAGS-1"></a>
+check using C++. These fragments are included by the
+<samp>configure.ac</samp> at the top level of TL
+(<code>Build/source/configure.ac</code>).
+</p>
+<span id="index-proxy-build-system"></span>
+<p>For this library, like many other modules, a proxy build system for TL
+is used, consisting of our own <samp>configure.ac</samp>,
+<samp>Makefile.am</samp>, <samp>include/Makefile.am</samp>; the distributed build
+system is not used. (Consequently, a few generated files and
+auxiliary scripts are removed from the distributed source tree.)
+</p>
+<p>The public headers <samp>png.h</samp>, <samp>pngconf.h</samp>, and
+<samp>pnglibconf.h</samp> are &ldquo;installed&rdquo; (as symlinks) under
+<samp>include/</samp> in the build tree exactly as they are for a system
+version under, e.g., <samp>/usr/include/</samp>.
+</p>
+<span id="index-kpse_002dlibpng_002dflags_002em4"></span>
+<span id="index-KPSE_005fLIBPNG_005fFLAGS-1"></span>
<p>The module is supplemented by the file <samp>m4/kpse-libpng-flags.m4</samp>
that defines the M4 macro <code>KPSE_LIBPNG_FLAGS</code> used by all modules
depending on this library in their <samp>configure.ac</samp> to generate the
<code>make</code> variables <code>LIBPNG_INCLUDES</code> for use in
<code>CPPFLAGS</code>, <code>LIBPNG_LIBS</code> for use in <code>LDADD</code>,
<code>LIBPNG_DEPEND</code> for use as dependencies, and <code>LIBPNG_RULE</code>
-defining <code>make</code> rules to rebuild the library.
+for the <code>make</code> rules to rebuild the library.
</p>
<p><samp>m4/kpse-libpng-flags.m4</samp> also supplies the configure option
-<code>--with-system-libpng</code> and uses <code>pkg-config</code> to determine
-the flags required for the system library.
+<code>--with-system-libpng</code>, which then uses <code>pkg-config</code> to
+determine the flags required for the system library.
</p>
<hr>
-<a name="zlib-library"></a>
-<div class="header">
+<span id="zlib-library"></span><div class="header">
<p>
Next: <a href="#freetype-library" accesskey="n" rel="next"><code>freetype</code> library</a>, Previous: <a href="#png-library" accesskey="p" rel="prev"><code>png</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-zlib-library-in-libs_002fzlib"></a>
-<h4 class="subsection">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></h4>
+<span id="The-zlib-library-in-libs_002fzlib"></span><h4 class="subsection">6.4.2 The <code>zlib</code> library in <samp>libs/zlib</samp></h4>
-<a name="index-zlib-library"></a>
+<span id="index-zlib-library"></span>
-<a name="index-kpse_002dzlib_002dflags_002em4"></a>
+<span id="index-kpse_002dzlib_002dflags_002em4"></span>
<p>This generic library is very much analogous to <code>libpng</code>, but
without the dependency on any other library. The file
<samp>m4/kpse-zlib-flags.m4</samp> supplies the configure option
@@ -1810,105 +1792,104 @@ without the dependency on any other library. The file
</p>
<hr>
-<a name="freetype-library"></a>
-<div class="header">
+<span id="freetype-library"></span><div class="header">
<p>
Next: <a href="#kpathsea-library" accesskey="n" rel="next"><code>kpathsea</code> library</a>, Previous: <a href="#zlib-library" accesskey="p" rel="prev"><code>zlib</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-freetype-library-in-libs_002ffreetype2"></a>
-<h4 class="subsection">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></h4>
+<span id="The-freetype-library-in-libs_002ffreetype2"></span><h4 class="subsection">6.4.3 The <code>freetype</code> library in <samp>libs/freetype2</samp></h4>
-<a name="index-freetype-library"></a>
+<span id="index-freetype-library"></span>
+<span id="index-wrapper-build-system"></span>
-<a name="index-freetype_002dconfig"></a>
-<p>This module uses a wrapper build system with an almost trivial
-<samp>configure.ac</samp> and with a <samp>Makefile.am</samp> that invokes
-<code>configure</code> and <code>make</code> for the distributed source, followed
-by <code>make install</code> with the build tree as destination. The flags
-required for the system library are obtained through
+<p>This module uses a wrapper build system. In contrast to the proxy
+build described earlier, the wrapper build has an almost trivial
+<samp>configure.ac</samp> and a <samp>Makefile.am</samp> which invokes the
+<code>configure</code> and <code>make</code> in the distributed source, followed
+by <code>make install</code> with the TL build tree as destination. In
+other words, this actually uses the build system provided by upstream
+(possibly patched).
+</p>
+<span id="index-freetype_002dconfig"></span>
+<p>The flags required for the system library are obtained through
<code>freetype-config</code>.
</p>
<hr>
-<a name="kpathsea-library"></a>
-<div class="header">
+<span id="kpathsea-library"></span><div class="header">
<p>
Previous: <a href="#freetype-library" accesskey="p" rel="prev"><code>freetype</code> library</a>, Up: <a href="#Library-modules" accesskey="u" rel="up">Library modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-kpathsea-library-in-texk_002fkpathsea"></a>
-<h4 class="subsection">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></h4>
+<span id="The-kpathsea-library-in-texk_002fkpathsea"></span><h4 class="subsection">6.4.4 The <code>kpathsea</code> library in <samp>texk/kpathsea</samp></h4>
-<a name="index-kpathsea-library"></a>
+<span id="index-kpathsea-library"></span>
<p>This is one of the TeX-specific libraries that are maintained as
-part of TeX&nbsp;Live (see <cite><a href="http://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>). Despite being a core
-part of the TeX system, it is not a terribly special case in the
-infrastructure. The TeX libraries are Libtool libraries (static
-and/or shared) and are installed by <code>make install</code> together with
-the programs. They are, however, not part of the TL DVD as
-distributed by TeX user groups, and have never been officially
-released for standalone use.
-</p>
-<a name="index-_002d_002dwith_002dsystem_002dkpathsea"></a>
-<p>It is possible, and perhaps even useful for distro builds (see <a href="#Distro-builds">Distro builds</a>), to specify the configure option <code>--with-system-kpathsea</code> in
-order to use a system version of the library. Programs outside the TL tree
-should use <code>pkg-config</code> for the required flags.
-</p>
-<a name="index-kpathsea_002eac"></a>
-<a name="index-mktex_002eac"></a>
-<a name="index-_002d_002denable_002dmktextfm_002ddefault"></a>
-<a name="index-mktextfm"></a>
-<p>In addition to <samp>ac/withenable.ac</samp> and <samp>ac/kpathsea.ac</samp> there
-is a third fragment <samp>ac/mktex.ac</samp> included by both
-<samp>ac/withenable.ac</samp> and <samp>configure.ac</samp> that supplies
-configure options such as <code>--enable-mktextfm-default</code>, which
-determine the compile time default of whether or not to run
-<code>mktextfm</code> to generate a missing <samp>.tfm</samp> file. In any case,
+part of TeX&nbsp;Live (see <cite><a href="https://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea
+<span class="roman">(<a href="tug.org/kpathsea">tug.org/kpathsea</a>)</span></a></cite>); the other is <code>ptexenc</code>. These
+TeX libraries are Libtool libraries (static and/or shared) and are
+installed by <code>make install</code> together with the programs. They
+are, however, not part of the TL DVD as distributed by TeX user
+groups, and have never been officially released for standalone use.
+</p>
+<span id="index-_002d_002dwith_002dsystem_002dkpathsea"></span>
+<p>It is possible, and probably useful for distro builds (see <a href="#Distro-builds">Distro builds</a>), to specify the configure option
+<code>--with-system-kpathsea</code> in order to use a system version of the
+library. Programs outside the TL tree should use <code>pkg-config</code>
+for the required flags.
+</p>
+<span id="index-kpathsea_002eac"></span>
+<span id="index-mktex_002eac"></span>
+<span id="index-_002d_002denable_002dmktextfm_002ddefault"></span>
+<span id="index-mktextfm"></span>
+<p>In addition to <samp>kpathsea/ac/withenable.ac</samp> and
+<samp>kpathsea/ac/kpathsea.ac</samp> here there is a third fragment
+<samp>kpathsea.ac/mktex.ac</samp>, included by both <samp>withenable.ac</samp> and
+<samp>configure.ac</samp>, which supplies configure options such as
+<code>--enable-mktextfm-default</code>. These determine the compile time
+default of whether or not to run <code>mktextfm</code> (and similar) to
+generate a missing <samp>.tfm</samp> (or whatever) file. In any case,
however, the command line options <code>-mktex=tfm</code> or
-<code>-no-mktex=tfm</code> for the TeX-like engines override this default.
+<code>-no-mktex=tfm</code> for the TeX-like engines override this
+default.
</p>
<hr>
-<a name="Program-modules"></a>
-<div class="header">
+<span id="Program-modules"></span><div class="header">
<p>
Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX&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>
-<a name="Program-modules-1"></a>
-<h3 class="section">6.5 Program modules</h3>
+<span id="Program-modules-1"></span><h3 class="section">6.5 Program modules</h3>
-<a name="index-program-modules"></a>
-<a name="index-modules_002c-for-programs"></a>
+<span id="index-program-modules"></span>
+<span id="index-modules_002c-for-programs"></span>
<p>As with libraries (see <a href="#Library-modules">Library modules</a>), here we discuss the
details for a few of the programs in TL.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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>
+<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>
+<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>
+<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>
+<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>
<hr>
-<a name="t1utils-package"></a>
-<div class="header">
+<span id="t1utils-package"></span><div class="header">
<p>
Next: <a href="#xindy-package" accesskey="n" rel="next"><code>xindy</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-t1utils-package-in-utils_002ft1utils"></a>
-<h4 class="subsection">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></h4>
+<span id="The-t1utils-package-in-utils_002ft1utils"></span><h4 class="subsection">6.5.1 The <code>t1utils</code> package in <samp>utils/t1utils</samp></h4>
-<a name="index-t1utils-package"></a>
+<span id="index-t1utils-package"></span>
-<p>Once again we use the distributed source tree <samp>t1utils-src</samp>
-with modifications documented in <samp>TLpatches/*</samp> and
-a proxy build system consisting of <samp>configure.ac</samp> and
-<samp>Makefile.am</samp>. The fragment <samp>ac/withenable.ac</samp> contains
+<p>Here we use the distributed source tree <samp>t1utils-src</samp> with
+modifications documented in <samp>TLpatches/*</samp> and a proxy build
+system consisting of <samp>configure.ac</samp> and <samp>Makefile.am</samp>. The
+fragment <samp>ac/withenable.ac</samp> contains
</p>
<div class="example">
<pre class="example">KPSE_ENABLE_PROG([t1utils])
@@ -1919,54 +1900,52 @@ supplies the configure option <code>--disable-t1utils</code>.
</p>
<hr>
-<a name="xindy-package"></a>
-<div class="header">
+<span id="xindy-package"></span><div class="header">
<p>
Next: <a href="#xdvik-package" accesskey="n" rel="next"><code>xdvik</code> package</a>, Previous: <a href="#t1utils-package" accesskey="p" rel="prev"><code>t1utils</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-xindy-package-in-utils_002fxindy"></a>
-<h4 class="subsection">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></h4>
+<span id="The-xindy-package-in-utils_002fxindy"></span><h4 class="subsection">6.5.2 The <code>xindy</code> package in <samp>utils/xindy</samp></h4>
-<a name="index-xindy-1"></a>
+<span id="index-xindy-1"></span>
<p>This module uses the distributed source tree <samp>xindy-src/</samp> with
-modifications documented in <samp>TLpatches/*</samp>, a proxy
-<samp>configure.ac</samp>, and a wrapper <samp>Makefile.am</samp> that descends
-into <samp>xindy-src</samp>. The <code>xindy</code> build requires a <samp>make</samp>
-that supports a <code>VPATH</code> build, can handle all targets, and do not
-refer to <code>${top_srcdir}</code> or <code>${top_builddir}</code>. The
-fragment <code>ac/withenable.ac</code> contains
+modifications documented in <samp>TLpatches/*</samp>, and a wrapper
+<samp>configure.ac</samp> and <samp>Makefile.am</samp> that descends into
+<samp>xindy-src</samp>.
+</p>
+<p>The <code>xindy</code> build requires a <samp>make</samp> that supports a
+<code>VPATH</code> build, can handle all targets, and do not refer to
+<code>${top_srcdir}</code> or <code>${top_builddir}</code>. The fragment
+<code>xindy/ac/withenable.ac</code> contains
</p>
<div class="example">
-<pre class="example">KPSE_ENABLE_PROG([xindy], , [disable native])
+<pre class="example">KPSE_ENABLE_PROG([xindy], , [disable])
m4_include(kpse_TL[utils/xindy/ac/xindy.ac])
m4_include(kpse_TL[utils/xindy/ac/clisp.ac])
</pre></div>
<p>where <code>disable</code> in the third argument indicates that
<code>xindy</code> is only built if explicitly enabled by the user with
-<code>configure --enable-xindy</code> (the need for <code>clisp</code> is too
-painful to require by default), and <code>native</code> disallows cross
-compilation. The additional fragments <samp>ac/xindy.ac</samp> and
-<samp>ac/clisp.ac</samp> specify more <code>configure</code> options to be seen at
-the top level with <samp>ac/xindy.ac</samp> also included by
-<samp>configure.ac</samp>.
+<code>configure --enable-xindy</code> (the need for <code>clisp</code> makes it
+too painful to enable by default).
+</p>
+<p>The additional fragments <samp>ac/xindy.ac</samp> and <samp>ac/clisp.ac</samp>
+specify more <code>configure</code> options to be seen at the top level,
+with <samp>ac/xindy.ac</samp> also included by <samp>configure.ac</samp>.
</p>
<hr>
-<a name="xdvik-package"></a>
-<div class="header">
+<span id="xdvik-package"></span><div class="header">
<p>
Next: <a href="#asymptote" accesskey="n" rel="next"><code>asymptote</code></a>, Previous: <a href="#xindy-package" accesskey="p" rel="prev"><code>xindy</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-xdvik-package-in-texk_002fxdvik"></a>
-<h4 class="subsection">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></h4>
+<span id="The-xdvik-package-in-texk_002fxdvik"></span><h4 class="subsection">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></h4>
-<a name="index-xdvik"></a>
+<span id="index-xdvik"></span>
<p>This package is maintained as part of the TeX&nbsp;Live tree with sources in
-its top level directory and the subdirectory <samp>gui</samp>. The fragment
-<code>ac/withenable.ac</code> contains
+its own directory (<samp>texk/xdvik/</samp>). The fragment
+<code>xdvik/ac/withenable.ac</code> contains
</p>
<div class="example">
<pre class="example">dnl extra_dirs = texk/xdvik/squeeze
@@ -1974,101 +1953,95 @@ KPSE_ENABLE_PROG([xdvik], [kpathsea freetype2], [x])
m4_include(kpse_TL[texk/xdvik/ac/xdvik.ac])
</pre></div>
-<a name="index-squeeze_002fconfigure_002eac"></a>
-<a name="index-cross-compilation_002c-with-host-binary"></a>
-<p>thus specifying the dependency on the <code>kpathsea</code>,
+<span id="index-squeeze_002fconfigure_002eac"></span>
+<span id="index-cross-compilation_002c-with-host-binary"></span>
+<p>thus specifying dependencies on the <code>kpathsea</code>,
<code>freetype</code>, and X11 libraries. The M4 comment (following
<code>dnl</code>) signals the subsidiary <samp>squeeze/configure.ac</samp>. This
is needed because the main executable <samp>xdvi-bin</samp> (to be installed
as, e.g., <samp>xdvi-xaw</samp>) is for the <code>host</code> system whereas the
auxiliary program <samp>squeeze/squeeze</samp> has to run on the
-<code>build</code> system and in a cross compilation they differ.
+<code>build</code> system; in a cross compilation, these differ.
</p>
-<a name="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit"></a>
+<span id="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit"></span>
<p>The additional fragment <code>ac/xdvik.ac</code> is also included by
<samp>configure.ac</samp> and supplies the configure option
-<code>--with-xdvi-x-toolkit</code> also seen at the top-level.
+<code>--with-xdvi-x-toolkit</code> also seen at the top level.
</p>
<hr>
-<a name="asymptote"></a>
-<div class="header">
+<span id="asymptote"></span><div class="header">
<p>
Previous: <a href="#xdvik-package" accesskey="p" rel="prev"><code>xdvik</code> package</a>, Up: <a href="#Program-modules" accesskey="u" rel="up">Program modules</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="The-subdirectory-utils_002fasymptote"></a>
-<h4 class="subsection">6.5.4 The subdirectory <samp>utils/asymptote</samp></h4>
+<span id="The-subdirectory-utils_002fasymptote"></span><h4 class="subsection">6.5.4 The subdirectory <samp>utils/asymptote</samp></h4>
-<a name="index-asymptote-1"></a>
-<a name="index-xasy"></a>
+<span id="index-asymptote-1"></span>
+<span id="index-xasy"></span>
-<a name="index-OpenGL_002c-required-for-Asymptote"></a>
+<span id="index-OpenGL_002c-required-for-Asymptote"></span>
<p>This subdirectory contains the sources for <samp>asy</samp> and <samp>xasy</samp>
but due to its complexity and prerequisites (e.g., OpenGL) it is
not part of the TL build system. These programs must be built and
installed independently, but are included on the TL DVD together with
-their support files.
+their support files. See <a href="https://tug.org/build.html#asymptote">https://tug.org/build.html#asymptote</a>.
</p>
<hr>
-<a name="Extending-TeX-Live"></a>
-<div class="header">
+<span id="Extending-TeX-Live"></span><div class="header">
<p>
Previous: <a href="#Program-modules" accesskey="p" rel="prev">Program modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Extending-TeX-Live-1"></a>
-<h3 class="section">6.6 Extending TeX&nbsp;Live</h3>
+<span id="Extending-TeX-Live-1"></span><h3 class="section">6.6 Extending TeX&nbsp;Live</h3>
-<a name="index-extending-TeX-Live"></a>
-<a name="index-adding-to-TeX-Live"></a>
+<span id="index-extending-TeX-Live"></span>
+<span id="index-adding-to-TeX-Live"></span>
<p>This section outlines the basic process for adding new packages to the
TL build system.
</p>
<p>In any case, a new package directory <samp>foo</samp> should contain the
-original sources, as modified for TL, in <samp>foo/foo-src</samp>, and the
-changes should be documented in <samp>foo/TLpatches/*</samp>; changes should
-also be submitted upstream whenever reasonable, of course. In
-addition, <samp>foo/</samp> will need the usual Automake build-related files
-(<samp>configure.ac</samp>, <samp>Makefile.am</samp>, etc. Please keep a
-<samp>ChangeLog</samp> for all TL changes.
+original sources, modified only with changes necessary for TL, in
+<samp>foo/foo-src</samp>. The changes should be documented in
+<samp>foo/TLpatches/*</samp>, and also be submitted upstream whenever
+reasonable. In addition, <samp>foo/</samp> will need the usual Automake
+build-related files (<samp>configure.ac</samp>, <samp>Makefile.am</samp>, etc.
+Please maintain <samp>foo/ChangeLog</samp> for all TL changes.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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">
+<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">
+<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>
<hr>
-<a name="Adding-a-new-program-module"></a>
-<div class="header">
+<span id="Adding-a-new-program-module"></span><div class="header">
<p>
Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX&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>
-<a name="Adding-a-new-program-module-1"></a>
-<h4 class="subsection">6.6.1 Adding a new program module</h4>
+<span id="Adding-a-new-program-module-1"></span><h4 class="subsection">6.6.1 Adding a new program module</h4>
-<a name="index-adding-a-new-program"></a>
-<a name="index-program-module_002c-adding"></a>
+<span id="index-adding-a-new-program"></span>
+<span id="index-program-module_002c-adding"></span>
-<a name="index-kpse_005ftexk_005fpkgs"></a>
+<span id="index-kpse_005ftexk_005fpkgs"></span>
<p>A TeX-specific program module in a subdirectory
<samp>texk/<var>prog</var></samp> may use the TeX-specific libraries and is
included by adding its name <samp><var>prog</var></samp> to the M4 list
<code>kpse_texk_pkgs</code> defined in <samp>m4/kpse-pkgs.m4</samp>.
</p>
-<a name="index-kpse_005futils_005fpkgs"></a>
+<span id="index-kpse_005futils_005fpkgs"></span>
<p>A generic program module in a subdirectory <samp>utils/<var>prog</var></samp>
must not use the TeX-specific libraries and is included by adding
its name <samp><var>prog</var></samp> to the M4 list <code>kpse_utils_pkgs</code> in
<samp>m4/kpse-pkgs.m4</samp>.
</p>
-<a name="index-withenable_002eac_002c-for-new-modules"></a>
-<a name="index-KPSE_005fENABLE_005fPROG"></a>
+<span id="index-withenable_002eac_002c-for-new-modules"></span>
+<span id="index-KPSE_005fENABLE_005fPROG"></span>
<p>In either case, the subdirectory <samp>texk/<var>prog</var></samp> or
<samp>utils/<var>prog</var></samp> must provide a fragment
<samp>ac/withenable.ac</samp> that contains the M4 macro
@@ -2079,28 +2052,28 @@ arguments:
<ol>
<li> a list of required libraries from the TL tree;
-</li><li> a list of options (<code>disable</code> if this module is not to be
+</li><li> a list of options: <code>disable</code> if this module is not to be
built without the configure option <code>--enable-<var>prog</var></code>,
<code>native</code> if cross compilation is not possible, <code>x</code> if the
-program requires X11 libraries);
+program requires X11 libraries;
</li><li> a comment added to the help text for the <code>configure</code>
option <code>--enable-<var>prog</var></code> or <code>--disable-<var>prog</var></code>.
</li></ol>
-<p>If the module requires specific configure options to be seen at the
-top level, they should be defined in an additional fragment
+<p>If the module requires specific <code>configure</code> options to be seen at
+the top level, they should be defined in an additional fragment
<samp>ac/<var>prog</var>.ac</samp> included from <samp>ac/withenable.ac</samp> and
<samp>configure.ac</samp>.
</p>
<p>Usually, the new program is maintained somewhere outside of TeX&nbsp;Live. In
-that case, we put the upstream sources into a subdirectory
+that case, as above, we put the upstream sources into a subdirectory
<samp><var>prog</var>-src</samp> (e.g., <samp>utils/newprog/newprog-src</samp>). We do
-not run <code>configure</code> in this original <code>...-src</code> directory,
-only in our own directory, but we do compile using the source files in
-<code>...-src</code>.
+not typically run <code>configure</code> in this original <code>...-src</code>
+directory, but only in our own directory; but we do compile using the
+source files in <code>...-src</code>.
</p>
-<p>So, these are the files that we must generally create:
+<p>So, to summarize the files that we must (usually) create:
</p>
<dl compact="compact">
<dt><samp>ac/withenable.ac</samp></dt>
@@ -2133,10 +2106,10 @@ perhaps they won&rsquo;t have to be.
</dl>
<p>Then, run GNU <code>autoreconf</code> in the new directory (see <a href="#Build-system-tools">Build system tools</a>). After that works, <code>svn add</code> the necessary files,
-notably <samp>Makefile.in aclocal.m4 configure</samp>, and <code>svn:ignore</code>
-the Automake cache <samp>autom4te.cache</samp>. (This is so people checking
-out the TL source tree do not have to run any autotools, but can
-simply run <code>configure</code>.)
+including the generated <samp>Makefile.in aclocal.m4 configure</samp>, and
+<code>svn:ignore</code> the Automake cache <samp>autom4te.cache</samp>. (This is
+so people checking out the TL source tree do not have to run any
+autotools, but can simply run <code>configure</code>.)
</p>
<p>Then, run the TL tool <code>reautoconf</code> in the top-level TL
<code>source/</code> directory, to incorporate the new program into the
@@ -2150,38 +2123,36 @@ directory, <code>make</code> in the build directory, etc.
</p>
<hr>
-<a name="Adding-a-new-generic-library-module"></a>
-<div class="header">
+<span id="Adding-a-new-generic-library-module"></span><div class="header">
<p>
Next: <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel="next">Adding a new TeX-specific library module</a>, Previous: <a href="#Adding-a-new-program-module" accesskey="p" rel="prev">Adding a new program module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX&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>
-<a name="Adding-a-new-generic-library-module-1"></a>
-<h4 class="subsection">6.6.2 Adding a new generic library module</h4>
+<span id="Adding-a-new-generic-library-module-1"></span><h4 class="subsection">6.6.2 Adding a new generic library module</h4>
-<a name="index-adding-a-new-generic-library"></a>
-<a name="index-generic-library-module_002c-adding"></a>
-<a name="index-library-module_002c-generic_002c-adding"></a>
+<span id="index-adding-a-new-generic-library"></span>
+<span id="index-generic-library-module_002c-adding"></span>
+<span id="index-library-module_002c-generic_002c-adding"></span>
-<a name="index-kpse_005flibs_005fpkgs"></a>
+<span id="index-kpse_005flibs_005fpkgs"></span>
<p>A generic library module in a subdirectory <samp>libs/<var>lib</var></samp> must
not depend on TeX-specific libraries, by definition. It is
-included by adding its name <samp><var>lib</var></samp> to the M4 list
+included by adding its name <samp><var>lib</var></samp> to the M4 macro
<code>kpse_libs_pkgs</code> in <samp>m4/kpse-pkgs.m4</samp>&mdash;before any other
libraries from the TeX&nbsp;Live tree on which it depends.
</p>
-<a name="index-KPSE_005fWITH_005fLIB"></a>
+<span id="index-KPSE_005fWITH_005fLIB"></span>
<p>As with program modules, the subdirectory <samp>libs/<var>lib</var></samp> must
contain the sources and build system for the library (and any
installable support programs) and a fragment <samp>ac/withenable.ac</samp>
that contains the M4 macro <code>KPSE_WITH_LIB</code> defined in
<samp>m4/kpse-setup.m4</samp> with <code><var>lib</var></code> as the mandatory first
argument and two optional arguments: a list of required libraries from
-the TL tree, and a list of options (currently there is only one:
-specify <code>tree</code> if this library cannot be replaced by a system
-version).
+the TL tree, and a list of options: for libraries, currently there is
+only one&mdash;specify <code>tree</code> if this library cannot be replaced by a
+system version.
</p>
-<a name="index-KPSE_005fTRY_005fLIB-1"></a>
-<a name="index-KPSE_005fTRY_005fLIBXX-1"></a>
+<span id="index-KPSE_005fTRY_005fLIB-1"></span>
+<span id="index-KPSE_005fTRY_005fLIBXX-1"></span>
<p>If a system version can be used, a second fragment
<samp>ac/<var>lib</var>.ac</samp> is needed, containing the M4 macro
<code>KPSE_TRY_LIB</code> (or <code>KPSE_TRY_LIBXX</code>) with <code><var>lib</var></code>
@@ -2189,7 +2160,7 @@ as the mandatory first argument and two additional arguments for the
Autoconf macro <code>AC_LANG_PROGRAM</code> used to compile and link a small
C (or C++) program as sanity check for using the system library.
</p>
-<a name="index-KPSE_005fLIB_005fFLAGS-1"></a>
+<span id="index-KPSE_005fLIB_005fFLAGS-1"></span>
<p>In addition a file <samp>m4/kpse-<var>lib</var>-flags</samp> (at the top level)
must define the M4 macro <code>KPSE_<var>LIB</var>_FLAGS</code> (all uppercase)
setting up the <code>make</code> variables <code><var>LIB</var>_INCLUDES</code>,
@@ -2199,29 +2170,27 @@ setting up the <code>make</code> variables <code><var>LIB</var>_INCLUDES</code>,
rebuild the library when necessary. All of that is needed for the
library from the TL tree and, if supported, for a system version.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dlib"></a>
-<a name="index-KPSE_005fLIB_005fSYSTEM_005fFLAGS"></a>
-<a name="index-KPSE_005fALL_005fSYSTEM_005fFLAGS"></a>
+<span id="index-_002d_002dwith_002dsystem_002dlib"></span>
+<span id="index-KPSE_005fLIB_005fSYSTEM_005fFLAGS"></span>
+<span id="index-KPSE_005fALL_005fSYSTEM_005fFLAGS"></span>
<p>If a system library is allowed, <code>KPSE_<var>LIB</var>_FLAGS</code> also
provides the configure option <code>--with-system-<var>lib</var></code> and uses
the additional M4 macro <code>KPSE_<var>LIB</var>_SYSTEM_FLAGS</code> to generate
-the <code>make</code> variables for a system library. Furthermore the
+the <code>make</code> variables for a system library. In addition, the
definition of the M4 macro <code>KPSE_ALL_SYSTEM_FLAGS</code> in
<samp>m4/kpse-pkgs.m4</samp> must be extended by the line:<br>&nbsp;&nbsp;&nbsp;<code>AC_REQUIRE([KPSE_<var>LIB</var>_SYSTEM_FLAGS])</code>
</p>
<hr>
-<a name="Adding-a-new-TeX_002dspecific-library-module"></a>
-<div class="header">
+<span id="Adding-a-new-TeX_002dspecific-library-module"></span><div class="header">
<p>
Previous: <a href="#Adding-a-new-generic-library-module" accesskey="p" rel="prev">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX&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>
-<a name="Adding-a-new-TeX_002dspecific-library-module-1"></a>
-<h4 class="subsection">6.6.3 Adding a new TeX-specific library module</h4>
+<span id="Adding-a-new-TeX_002dspecific-library-module-1"></span><h4 class="subsection">6.6.3 Adding a new TeX-specific library module</h4>
-<a name="index-adding-a-new-TeX_002dspecific-library"></a>
-<a name="index-TeX_002dspecific-library-module_002c-adding"></a>
-<a name="index-library-module_002c-TeX_002dspecific_002c-adding"></a>
+<span id="index-adding-a-new-TeX_002dspecific-library"></span>
+<span id="index-TeX_002dspecific-library-module_002c-adding"></span>
+<span id="index-library-module_002c-TeX_002dspecific_002c-adding"></span>
<p>A TeX-specific library module in a subdirectory
<samp>texk/<var>lib</var></samp> may depend on other TeX-specific libraries
@@ -2230,25 +2199,23 @@ included in the same general ways as a generic library (see the
previous section), with these modifications:
</p>
<ul>
-<li> <a name="index-kpse_005ftexlibs_005fpkgs"></a>
-The library name <code><var>lib</var></code> is added to the M4 list
-<code>kpse_texlibs_pkgs</code> also in <samp>m4/kpse-pkgs.m4</samp>.
+<li> <span id="index-kpse_005ftexlibs_005fpkgs"></span>
+The library name <code><var>lib</var></code> is added to the M4 macro
+<code>kpse_texlibs_pkgs</code>, which is also in <samp>m4/kpse-pkgs.m4</samp>.
-</li><li> <a name="index-KPSE_005fWITH_005fTEXLIB"></a>
+</li><li> <span id="index-KPSE_005fWITH_005fTEXLIB"></span>
The fragment <code>ac/withenable.ac</code> must use <code>KPSE_WITH_TEXLIB</code>.
</li></ul>
<hr>
-<a name="Configure-options"></a>
-<div class="header">
+<span id="Configure-options"></span><div class="header">
<p>
Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-1"></a>
-<h2 class="chapter">7 Configure options</h2>
+<span id="Configure-options-1"></span><h2 class="chapter">7 Configure options</h2>
-<a name="index-configure-options"></a>
+<span id="index-configure-options"></span>
<p>Corresponding to the large number of program and library modules there
are a large number <code>configure</code> options, most of which are
@@ -2256,86 +2223,82 @@ described here. The command<br>&nbsp;&nbsp;&nbsp;<code>configure --help</code><
top level gives an exhaustive list of all global options and a few
important module-specific ones, whereas, e.g.,<br>&nbsp;&nbsp;&nbsp;<code>texk/lcdf-typetools/configure --help</code><br> also displays the
<code>lcdf-typetools</code> specific options, which are not shown at the
-top-level.
+top level.
</p>
-<a name="index-environment-variables_002c-for-configure"></a>
+<span id="index-environment-variables_002c-for-configure"></span>
<p>The help text also mentions several influential environment variables,
-but for TeX&nbsp;Live it is better to specify them as assigments on the
+but for TeX&nbsp;Live it is better to specify them as assignments on the
command line.
</p>
<p>The <samp>./Build</samp> script used to make the binaries shipped with TeX&nbsp;Live
invokes the top-level <code>configure</code> with a few additional options
(see <a href="#Building">Building</a>). The defaults discussed below are those for the
actual <code>configure</code> script; invoking <code>configure</code> via
-<samp>./Build</samp> may yield different results.
+<samp>./Build</samp> yields different results.
</p>
<p>Defaults for most options are set at the top level and propagated
explicitly to all subdirectories. Options specified on the command
line are checked for consistency but never modified.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Global-configure-options" accesskey="1">Global configure options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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">
+<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>
<hr>
-<a name="Global-configure-options"></a>
-<div class="header">
+<span id="Global-configure-options"></span><div class="header">
<p>
Next: <a href="#Program_002dspecific-configure-options" accesskey="n" rel="next">Program-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Global-configure-options-1"></a>
-<h3 class="section">7.1 Global configure options</h3>
+<span id="Global-configure-options-1"></span><h3 class="section">7.1 Global configure options</h3>
-<a name="index-global-configure-options"></a>
-<a name="index-configure-options_002c-global"></a>
+<span id="index-global-configure-options"></span>
+<span id="index-configure-options_002c-global"></span>
<p>Here are the global configure options.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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>
<hr>
-<a name="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="n" rel="next"><code>--prefix</code> <code>--bindir</code> &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>
-<a name="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild-1"></a>
-<h4 class="subsection">7.1.1 <code>--disable-native-texlive-build</code></h4>
+<span id="g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild-1"></span><h4 class="subsection">7.1.1 <code>--disable-native-texlive-build</code></h4>
-<a name="index-_002d_002ddisable_002dnative_002dtexlive_002dbuild"></a>
+<span id="index-_002d_002ddisable_002dnative_002dtexlive_002dbuild"></span>
<p>If enabled (the default), build for a TL binary distribution as
shipped by the TeX user groups. This requires GNU <code>make</code> and
implies <code>--enable-multiplatform</code> and
@@ -2343,57 +2306,53 @@ implies <code>--enable-multiplatform</code> and
and enforces <code>--disable-shared</code>.
</p>
<p>If building TL for a GNU/Linux or other distribution, this should be
-disabled and system versions of most libraries would be used
-(see <a href="#Distro-builds">Distro builds</a>). This may fail without GNU <code>make</code>, but
-will be tried regardless.
+disabled and system versions of most libraries should be used
+(see <a href="#Distro-builds">Distro builds</a>).
</p>
-<a name="index-_002d_002denable_002dtexlive_002dbuild"></a>
+<span id="index-_002d_002denable_002dtexlive_002dbuild"></span>
<p>A related option, <code>--enable-texlive-build</code>, is automatically
passed to all subdirectories (and cannot be disabled). Subdirectories
that can also be built independently from the TL tree (such as
-<samp>utils/xindy</samp> and <samp>texk/dvipng</samp>) can use this option, e.g.,
-to choose TL-specific installation paths.
+<samp>utils/xindy</samp> and <samp>texk/dvipng</samp>) but cooperate with TL can
+use this option to enable TL-specific adaptations, such as
+installation paths.
</p>
<hr>
-<a name="g_t_002d_002dprefix-_002d_002dbindir-_2026"></a>
-<div class="header">
+<span id="g_t_002d_002dprefix-_002d_002dbindir-_2026"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="n" rel="next"><code>--disable-largefile</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dnative_002dtexlive_002dbuild" accesskey="p" rel="prev"><code>--disable-native-texlive-build</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_2026"></a>
-<h4 class="subsection">7.1.2 <code>--prefix</code>, <code>--bindir</code>, &hellip;</h4>
+<span id="g_t_002d_002dprefix_002c-_002d_002dbindir_002c-_2026"></span><h4 class="subsection">7.1.2 <code>--prefix</code>, <code>--bindir</code>, &hellip;</h4>
-<a name="index-_002d_002dprefix-configure-option"></a>
-<a name="index-_002d_002dbindir-configure-option"></a>
+<span id="index-_002d_002dprefix-configure-option"></span>
+<span id="index-_002d_002dbindir-configure-option"></span>
<p>These standard Autoconf options specify various installation
directories as usual. For the complete list, see <a href="#Installation-directories">Installation directories</a>.
</p>
-<a name="index-DESTDIR"></a>
+<span id="index-DESTDIR"></span>
<p>Also as usual, all values are prefixed by the value of <code>DESTDIR</code>,
-if set, on the <code>make</code> command line (see <a href="http://www.gnu.org/software/automake/manual/automake.html#Staged-Installs">Installation in a temporary location</a> in <cite>GNU Automake</cite>).
+if set, on the <code>make</code> command line (see <a href="https://www.gnu.org/software/automake/manual/automake.html#Staged-Installs">Installation in a temporary location</a> in <cite>GNU Automake</cite>).
</p>
<hr>
-<a name="g_t_002d_002ddisable_002dlargefile"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dlargefile"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="n" rel="next"><code>--disable-missing</code></a>, Previous: <a href="#g_t_002d_002dprefix-_002d_002dbindir-_2026" accesskey="p" rel="prev"><code>--prefix</code> <code>--bindir</code> &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>
-<a name="g_t_002d_002ddisable_002dlargefile-1"></a>
-<h4 class="subsection">7.1.3 <code>--disable-largefile</code></h4>
+<span id="g_t_002d_002ddisable_002dlargefile-1"></span><h4 class="subsection">7.1.3 <code>--disable-largefile</code></h4>
-<a name="index-_002d_002ddisable_002dlargefile"></a>
-<a name="index-large-file-support"></a>
-<a name="index-LFS-_0028large-file-support_0029"></a>
-<p>Omit large file support (LFS), needed on most 32-bit Unix systems for
-files with 2GB or more. Regardless of this, the size of <code>DVI</code>
-and <code>GF</code> files must always be <em>&lt;2</em>GB, due to the file format
-specifications.
+<span id="index-_002d_002ddisable_002dlargefile"></span>
+<span id="index-large-file-support"></span>
+<span id="index-LFS-_0028large-file-support_0029"></span>
+<p>Omit large file support (LFS), which is needed on most 32-bit Unix
+systems for files with 2GB or more. Regardless of this option, the
+size of <code>DVI</code> and <code>GF</code> files must always be <em>&lt;2</em>GB, due
+to the file format specifications.
</p>
-<a name="index-size-of-PDF-and-PS-files"></a>
-<a name="index-PDF-files_002c-size-of"></a>
-<a name="index-PostScript-files_002c-size-of"></a>
+<span id="index-size-of-PDF-and-PS-files"></span>
+<span id="index-PDF-files_002c-size-of"></span>
+<span id="index-PostScript-files_002c-size-of"></span>
<p>With LFS, there is no fixed limit on the size of PDF files created by
<samp>pdftex</samp> or PostScript files created by <samp>dvips</samp>. The size
of PDF images included by <samp>pdftex</samp> or <samp>luatex</samp> must, however,
@@ -2402,87 +2361,75 @@ be <em>&lt;2</em>GB when using <samp>poppler</samp> version&nbsp;0.22 or before
</p>
<hr>
-<a name="g_t_002d_002ddisable_002dmissing"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dmissing"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="n" rel="next"><code>--enable-compiler-warnings=</code><var>level</var></a>, Previous: <a href="#g_t_002d_002ddisable_002dlargefile" accesskey="p" rel="prev"><code>--disable-largefile</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002ddisable_002dmissing-1"></a>
-<h4 class="subsection">7.1.4 <code>--disable-missing</code></h4>
+<span id="g_t_002d_002ddisable_002dmissing-1"></span><h4 class="subsection">7.1.4 <code>--disable-missing</code></h4>
-<a name="index-_002d_002ddisable_002dmissing"></a>
+<span id="index-_002d_002ddisable_002dmissing"></span>
<p>Immediately terminate the build process if a requested program or feature
must be disabled, e.g., due to missing libraries. This can help when
figuring out a specific (sub)set of modules to enable.
</p>
<hr>
-<a name="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="n" rel="next"><code>--enable-cxx-runtime-hack</code></a>, Previous: <a href="#g_t_002d_002ddisable_002dmissing" accesskey="p" rel="prev"><code>--disable-missing</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel-1"></a>
-<h4 class="subsection">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></h4>
+<span id="g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel-1"></span><h4 class="subsection">7.1.5 <code>--enable-compiler-warnings=</code><var>level</var></h4>
-<a name="index-_002d_002denable_002dcompiler_002dwarnings_003dlevel"></a>
-<p>Enable various levels of compiler warnings for (Objective) C and C++:
-the <var>level</var> value can be one of: <code>no min yes max all</code>.
-The default is <code>yes</code> in <code>maintainer-mode</code> (see below) and
-<code>min</code> otherwise. This option defines
-<code>WARNING_[OBJ]C[XX]FLAGS</code> but these flags are not used in all
-library and program modules. Using them should help to resolve
-portability problems.
-</p>
-<p>At present, these warning flags are only defined for the GNU compilers
-but flags for other compilers could be added when needed.
+<span id="index-_002d_002denable_002dcompiler_002dwarnings_003dlevel"></span>
+<p>Enable various levels of compiler warnings for C, C++, and/or
+Objective&nbsp;C: the <var>level</var> value can be one of: <code>no min
+yes max all</code>. The default is <code>yes</code> in <code>maintainer-mode</code>
+(see below) and <code>min</code> otherwise. This option defines the
+variables <code>WARNING_[OBJ]C[XX]FLAGS</code>, but these variables are not
+consistently used in all library and program modules. At present,
+these warning flags assume options from the GNU compilers.
</p>
<hr>
-<a name="g_t_002d_002denable_002dcxx_002druntime_002dhack"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dcxx_002druntime_002dhack"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="n" rel="next"><code>--enable-maintainer-mode</code></a>, Previous: <a href="#g_t_002d_002denable_002dcompiler_002dwarnings_003dlevel" accesskey="p" rel="prev"><code>--enable-compiler-warnings=</code><var>level</var></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dcxx_002druntime_002dhack-1"></a>
-<h4 class="subsection">7.1.6 <code>--enable-cxx-runtime-hack</code></h4>
+<span id="g_t_002d_002denable_002dcxx_002druntime_002dhack-1"></span><h4 class="subsection">7.1.6 <code>--enable-cxx-runtime-hack</code></h4>
-<p>If enabled (as it is for the native TL build) and when using
-<code>g++</code>, try to statically link with <code>libstdc++</code>, somewhat
-improving portability of the resulting binary. See <a href="#Macros-for-compilers">Macros for compilers</a>.
+<p>If enabled (as it is for the native TL build), when using <code>g++</code>,
+try to statically link with <code>libstdc++</code>, thus improving
+portability of the resulting binary. See <a href="#Macros-for-compilers">Macros for compilers</a>.
</p>
<hr>
-<a name="g_t_002d_002denable_002dmaintainer_002dmode"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dmaintainer_002dmode"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="n" rel="next"><code>--enable-multiplatform</code></a>, Previous: <a href="#g_t_002d_002denable_002dcxx_002druntime_002dhack" accesskey="p" rel="prev"><code>--enable-cxx-runtime-hack</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dmaintainer_002dmode-1"></a>
-<h4 class="subsection">7.1.7 <code>--enable-maintainer-mode</code></h4>
+<span id="g_t_002d_002denable_002dmaintainer_002dmode-1"></span><h4 class="subsection">7.1.7 <code>--enable-maintainer-mode</code></h4>
-<a name="index-_002d_002denable_002dmaintainer_002dmode-1"></a>
+<span id="index-_002d_002denable_002dmaintainer_002dmode-1"></span>
<p>Enable <samp>make</samp> rules and dependencies not useful (and sometimes
confusing) to the casual user. This requires current versions of the
GNU build tools (see <a href="#Build-system-tools">Build system tools</a>), as it automatically
-rebuilds infrastructure files as needed. See <a href="http://www.gnu.org/software/automake/manual/automake.html#maintainer_002dmode"><code>missing</code> and <code>AM_MAINTAINER_MODE</code></a> in <cite>GNU Automake</cite>.
+rebuilds infrastructure files as needed. See <a href="https://www.gnu.org/software/automake/manual/automake.html#maintainer_002dmode"><code>missing</code> and <code>AM_MAINTAINER_MODE</code></a> in <cite>GNU Automake</cite>.
</p>
<hr>
-<a name="g_t_002d_002denable_002dmultiplatform"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dmultiplatform"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dshared" accesskey="n" rel="next"><code>--enable-shared</code></a>, Previous: <a href="#g_t_002d_002denable_002dmaintainer_002dmode" accesskey="p" rel="prev"><code>--enable-maintainer-mode</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dmultiplatform-1"></a>
-<h4 class="subsection">7.1.8 <code>--enable-multiplatform</code></h4>
+<span id="g_t_002d_002denable_002dmultiplatform-1"></span><h4 class="subsection">7.1.8 <code>--enable-multiplatform</code></h4>
-<a name="index-_002d_002denable_002dmultiplatform"></a>
-<a name="index-exec_005fprefix"></a>
-<a name="index-_002d_002dbindir-configure-option-1"></a>
-<a name="index-_002d_002dlibdir-configure-option"></a>
-<p>If enabled and <code>--bindir=<var>dir</var></code> or <code>--libdir=<var>dir</var></code>
-are not specified, install executables and libraries in per-platform
+<span id="index-_002d_002denable_002dmultiplatform"></span>
+<span id="index-exec_005fprefix"></span>
+<span id="index-_002d_002dbindir-configure-option-1"></span>
+<span id="index-_002d_002dlibdir-configure-option"></span>
+<p>If enabled (as it is for the native TL build) and
+<code>--bindir=<var>dir</var></code> or <code>--libdir=<var>dir</var></code> are not
+specified, install executables and libraries in per-platform
subdirectories of <samp><var>eprefix</var>/bin</samp> and
<samp><var>eprefix</var>/lib</samp> where <var>eprefix</var> is the value given or
implied for <code>exec_prefix</code>. In any case, the values for
@@ -2491,134 +2438,117 @@ subdirectories.
</p>
<hr>
-<a name="g_t_002d_002denable_002dshared"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dshared"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="n" rel="next"><code>--enable-silent-rules</code></a>, Previous: <a href="#g_t_002d_002denable_002dmultiplatform" accesskey="p" rel="prev"><code>--enable-multiplatform</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dshared-1"></a>
-<h4 class="subsection">7.1.9 <code>--enable-shared</code></h4>
+<span id="g_t_002d_002denable_002dshared-1"></span><h4 class="subsection">7.1.9 <code>--enable-shared</code></h4>
-<a name="index-_002d_002denable_002dshared"></a>
+<span id="index-_002d_002denable_002dshared"></span>
<p>Build shared versions of the TeX-specific libraries such as
<samp>libkpathsea</samp>. This is not allowed for a native TL build (i.e.,
<code>--disable-native-texlive-build</code> must also be specified).
</p>
<hr>
-<a name="g_t_002d_002denable_002dsilent_002drules"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dsilent_002drules"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="n" rel="next"><code>--without-ln-s</code></a>, Previous: <a href="#g_t_002d_002denable_002dshared" accesskey="p" rel="prev"><code>--enable-shared</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dsilent_002drules-1"></a>
-<h4 class="subsection">7.1.10 <code>--enable-silent-rules</code></h4>
+<span id="g_t_002d_002denable_002dsilent_002drules-1"></span><h4 class="subsection">7.1.10 <code>--enable-silent-rules</code></h4>
-<a name="index-_002d_002denable_002dsilent_002drules"></a>
+<span id="index-_002d_002denable_002dsilent_002drules"></span>
+<span id="index-make-rules_002c-verbose-vs_002e-silent"></span>
<p>Enable the use of less verbose build rules. When using GNU
-<code>make</code> (or another <code>make</code> implementation supporting nested
-variable expansions), you can specify <code>V=1</code> on the <code>make</code> command
-line to get more verbosity, or <code>V=0</code> to get less, regardless of
-this option.
+<code>make</code> (or any <code>make</code> implementation supporting nested
+variable expansions), you can specify <code>V=1</code> on the <code>make</code>
+command line to get more verbosity, or <code>V=0</code> to get less,
+regardless of this option.
</p>
<hr>
-<a name="g_t_002d_002dwithout_002dln_002ds"></a>
-<div class="header">
+<span id="g_t_002d_002dwithout_002dln_002ds"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002dwithout_002dx" accesskey="n" rel="next"><code>--without-x</code></a>, Previous: <a href="#g_t_002d_002denable_002dsilent_002drules" accesskey="p" rel="prev"><code>--enable-silent-rules</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002dwithout_002dln_002ds-1"></a>
-<h4 class="subsection">7.1.11 <code>--without-ln-s</code></h4>
+<span id="g_t_002d_002dwithout_002dln_002ds-1"></span><h4 class="subsection">7.1.11 <code>--without-ln-s</code></h4>
-<a name="index-_002d_002dwithout_002dln_002ds"></a>
+<span id="index-_002d_002dwithout_002dln_002ds"></span>
<p>Required when using a system without a working <code>ln -s</code> to build
binaries for a Unix-like system. However, <code>make install</code> will
-not create anything useful and might even fail.
+not create anything useful, and might fail.
</p>
<hr>
-<a name="g_t_002d_002dwithout_002dx"></a>
-<div class="header">
+<span id="g_t_002d_002dwithout_002dx"></span><div class="header">
<p>
Previous: <a href="#g_t_002d_002dwithout_002dln_002ds" accesskey="p" rel="prev"><code>--without-ln-s</code></a>, Up: <a href="#Global-configure-options" accesskey="u" rel="up">Global configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002dwithout_002dx-1"></a>
-<h4 class="subsection">7.1.12 <code>--without-x</code></h4>
+<span id="g_t_002d_002dwithout_002dx-1"></span><h4 class="subsection">7.1.12 <code>--without-x</code></h4>
-<a name="index-_002d_002dwithout_002dx"></a>
+<span id="index-_002d_002dwithout_002dx"></span>
<p>Disable all programs using the X Window System.
</p>
<hr>
-<a name="Program_002dspecific-configure-options"></a>
-<div class="header">
+<span id="Program_002dspecific-configure-options"></span><div class="header">
<p>
Next: <a href="#Library_002dspecific-configure-options" accesskey="n" rel="next">Library-specific configure options</a>, Previous: <a href="#Global-configure-options" accesskey="p" rel="prev">Global configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Program_002dspecific-configure-options-1"></a>
-<h3 class="section">7.2 Program-specific configure options</h3>
+<span id="Program_002dspecific-configure-options-1"></span><h3 class="section">7.2 Program-specific configure options</h3>
-<a name="index-program_002dspecific-configure-options"></a>
-<a name="index-configure-options_002c-program_002dspecific"></a>
+<span id="index-program_002dspecific-configure-options"></span>
+<span id="index-configure-options_002c-program_002dspecific"></span>
<p>Here are (some of) the program-specific <code>configure</code> options.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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>
<hr>
-<a name="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"></a>
-<div class="header">
+<span id="g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog"></span><div class="header">
<p>
Next: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="n" rel="next"><code>--disable-all-pkgs</code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog"></a>
-<h4 class="subsection">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></h4>
+<span id="g_t_002d_002denable_002dprog_002c-_002d_002ddisable_002dprog"></span><h4 class="subsection">7.2.1 <code>--enable-<var>prog</var></code>, <code>--disable-<var>prog</var></code></h4>
-<a name="index-_002d_002denable_002dprog"></a>
-<a name="index-_002d_002ddisable_002dprog"></a>
-<p>Do or do not build and install the program(s) of the module <code><var>prog</var></code>.
+<span id="index-_002d_002denable_002dprog"></span>
+<span id="index-_002d_002ddisable_002dprog"></span>
+<p>Do or do not build and install the program(s) of module <code><var>prog</var></code>.
</p>
<hr>
-<a name="g_t_002d_002ddisable_002dall_002dpkgs"></a>
-<div class="header">
+<span id="g_t_002d_002ddisable_002dall_002dpkgs"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fweb2c" accesskey="n" rel="next">Configure options for <samp>texk/web2c</samp></a>, Previous: <a href="#g_t_002d_002denable_002dprog-_002d_002ddisable_002dprog" accesskey="p" rel="prev"><code>--enable-<var>prog</var></code> <code>--disable-<var>prog</var></code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="g_t_002d_002ddisable_002dall_002dpkgs-1"></a>
-<h4 class="subsection">7.2.2 <code>--disable-all-pkgs</code></h4>
+<span id="g_t_002d_002ddisable_002dall_002dpkgs-1"></span><h4 class="subsection">7.2.2 <code>--disable-all-pkgs</code></h4>
-<a name="index-_002d_002ddisable_002dall_002dpkgs"></a>
+<span id="index-_002d_002ddisable_002dall_002dpkgs"></span>
<p>Do not build any program modules by default&mdash;only those explicitly
enabled. This is useful when one wants to work on only a single
program, which is specified with an additional <code>--enable</code> option,
e.g., <code>--enable-dvipdfm-x</code>. It&rsquo;s still simplest to check out and
configure the whole source tree, but at least only the program you are
-interested in, and its dependencies, are built. The <code>configure</code>
-will generally take less than a minute with everything disabled. (It
-is a good idea to run <code>make check</code> after doing this, and after
-making any changes, to ensure that whatever tests have been written
-still pass.)
+interested in, and its dependencies, are built. See <a href="#Build-one-package">Build one package</a>.
</p>
<p>Without this option, all modules are built except those that are
explicitly disabled or specify <code>disable</code> in their
@@ -2626,31 +2556,29 @@ explicitly disabled or specify <code>disable</code> in their
</p>
<hr>
-<a name="Configure-options-for-texk_002fweb2c"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fweb2c"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="n" rel="next">Configure options for <samp>texk/bibtex-x</samp></a>, Previous: <a href="#g_t_002d_002ddisable_002dall_002dpkgs" accesskey="p" rel="prev"><code>--disable-all-pkgs</code></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fweb2c-1"></a>
-<h4 class="subsection">7.2.3 Configure options for <samp>texk/web2c</samp></h4>
+<span id="Configure-options-for-texk_002fweb2c-1"></span><h4 class="subsection">7.2.3 Configure options for <samp>texk/web2c</samp></h4>
-<a name="index-configure-options_002c-for-web2c"></a>
+<span id="index-configure-options_002c-for-web2c"></span>
-<a name="index-_002d_002dwith_002dbanner_002dadd_003dstr"></a>
+<span id="index-_002d_002dwith_002dbanner_002dadd_003dstr"></span>
<p><code>--with-banner-add=<var>str</var></code><br>Add <code><var>str</var></code> to the
-default version string (<code>TeX Live <var>year</var></code> or <code>Web2C
-<var>year</var></code>) appended to banner lines. This is ignored for a native
-TL build, but distro builds should specify, e.g.,
+default version string (which is &lsquo;<code>TeX Live <var>year</var></code>&rsquo; or
+&lsquo;<code>Web2C <var>year</var></code>&rsquo;) appended to banner lines. This is ignored
+for a native TL build, but distro builds should specify, e.g.,
<code>/<var>SomeDistro</var></code>.
</p>
-<a name="index-_002d_002dwith_002deditor_003dcmd"></a>
+<span id="index-_002d_002dwith_002deditor_003dcmd"></span>
<p><code>--with-editor=<var>cmd</var></code><br>Specify the command
-<code><var>cmd</var></code> to invoke from the <code>e</code> option of TeX-like engines,
+<code><var>cmd</var></code> to invoke from the <code>e</code> option of TeX and friends,
replacing the default <code>vi +%d '%s'</code> for Unix or <code>texworks
--position=%d &quot;%s&quot;</code> for Windows.
</p>
-<a name="index-_002d_002dwith_002dfontconfig_002dincludes_003ddir"></a>
-<a name="index-_002d_002dwith_002dfontconfig_002dlibdir_003ddir"></a>
+<span id="index-_002d_002dwith_002dfontconfig_002dincludes_003ddir"></span>
+<span id="index-_002d_002dwith_002dfontconfig_002dlibdir_003ddir"></span>
<p><code>--with-fontconfig-includes=<var>dir</var></code>,
<code>--with-fontconfig-libdir=<var>dir</var></code><br>Building XeTeX on
non-Mac systems requires the <code>fontconfig</code> library headers and
@@ -2658,109 +2586,109 @@ code. If one or both of these options are given, the required flags
are derived from them; otherwise, they are determined via
<samp>pkg-config</samp> (if present).
</p>
-<a name="index-X-toolkit"></a>
-<a name="index-libXt"></a>
-<a name="index-Xlib"></a>
+<span id="index-X-toolkit"></span>
+<span id="index-libXt"></span>
+<span id="index-Xlib"></span>
<p><code>--with-mf-x-toolkit</code><br>Use the X toolkit (<samp>libXt</samp>) for
Metafont (the default is to use the lowest-level <samp>Xlib</samp> support;
it seems this has the best chance of working across X installations
nowadays).
</p>
-<a name="index-_002d_002ddisable_002ddump_002dshare"></a>
-<a name="index-LittleEndian-architectures"></a>
+<span id="index-_002d_002ddisable_002ddump_002dshare"></span>
+<span id="index-LittleEndian-architectures"></span>
<p><code>--disable-dump-share</code><br>Make the <code>fmt</code>/<code>base</code>
dump files architecture dependent (somewhat faster on LittleEndian
architectures).
</p>
-<a name="index-_002d_002ddisable_002dipc"></a>
-<a name="index-interprocess-communication"></a>
+<span id="index-_002d_002ddisable_002dipc"></span>
+<span id="index-interprocess-communication"></span>
<p><code>--disable-ipc</code><br>Disable TeX&rsquo;s <code>--ipc</code> option.
</p>
-<a name="index-_002d_002ddisable_002dmf_002dnowin"></a>
-<a name="index-mf_002dnowin"></a>
+<span id="index-_002d_002ddisable_002dmf_002dnowin"></span>
+<span id="index-mf_002dnowin"></span>
<p><code>--disable-mf-nowin</code><br>Do not build a separate
non-graphically-capable Metafont (<samp>mf-nowin</samp>).
</p>
-<a name="index-_002d_002ddisable_002dtex"></a>
-<a name="index-_002d_002denable_002detex"></a>
-<a name="index-web2c_002eac"></a>
+<span id="index-_002d_002ddisable_002dtex"></span>
+<span id="index-_002d_002denable_002detex"></span>
+<span id="index-web2c_002eac"></span>
<p><code>--disable-tex</code>, <code>--enable-etex</code>, &hellip;<br>Do not or
do build the various TeX, Metafont, and MetaPost engines (defaults are
defined in the fragment <samp>texk/web2c/ac/web2c.ac</samp>).
</p>
-<a name="index-_002d_002ddisable_002dweb_002dprogs"></a>
-<p><code>--disable-web-progs</code><br>Do not build the core WEB programs
+<span id="index-_002d_002ddisable_002dweb_002dprogs"></span>
+<p><code>--disable-web-progs</code><br>Do not build the original WEB programs
<samp>bibtex</samp>, &hellip;, <samp>weave</samp>. Useful if, e.g., you only want
to (re)build some engines.
</p>
-<a name="index-_002d_002denable_002dauto_002dcore"></a>
-<a name="index-preloaded-binaries"></a>
+<span id="index-_002d_002denable_002dauto_002dcore"></span>
+<span id="index-preloaded-binaries"></span>
<p><code>--enable-auto-core</code><br>This option causes TeX and Metafont
to produce a core dump when a particular hacky filename is
encountered, for use in creating preloaded binaries. This is rarely
done nowadays.
</p>
-<a name="index-_002d_002denable_002dlibtool_002dhack"></a>
-<a name="index-libtool_002c-hack-for-avoiding-excessive-linking"></a>
+<span id="index-_002d_002denable_002dlibtool_002dhack"></span>
+<span id="index-libtool_002c-hack-for-avoiding-excessive-linking"></span>
+<span id="index-libfontconfig_002c-hack-for-avoiding-linking-dependencies"></span>
+<span id="index-libexpat_002c-dependency-of-libfontconfig"></span>
<p><code>--enable-libtool-hack</code><br>
If enabled (which is the default for all platforms), prevents
<code>libtool</code> from linking explicitly with dependencies of
<samp>libfontconfig</samp> such as <samp>libexpat</samp>.
</p>
-<a name="index-_002d_002denable_002d_002awin-for-Metafont-window-support"></a>
-<p><code>--enable-*win</code><br>Include various types of other window
-support for Metafont (EPSF output, <code>mftalk</code>, old terminals, &hellip;).
+<span id="index-_002d_002denable_002d_002awin-for-Metafont-window-support"></span>
+<p><code>--enable-*win</code><br>Include various types of non-X window
+support for Metafont (EPSF output, <code>mftalk</code>, old graphics
+terminals, &hellip;).
</p>
-<a name="index-_002d_002denable_002dtex_002dsynctex"></a>
-<a name="index-_002d_002ddisable_002detex_002dsynctex"></a>
-<a name="index-synctex"></a>
+<span id="index-_002d_002denable_002dtex_002dsynctex"></span>
+<span id="index-_002d_002ddisable_002detex_002dsynctex"></span>
+<span id="index-synctex"></span>
<p><code>--enable-tex-synctex</code>, <code>--disable-etex-synctex</code>,
&hellip;<br>Build the TeX engines with or without <code>SyncTeX</code>
-support; ignored for a native TeX&nbsp;Live build, defaults are again defined
-in <samp>texk/web2c/ac/web2c.ac</samp>.
+support; ignored for a native TeX&nbsp;Live build. Defaults are defined in
+<samp>texk/web2c/ac/web2c.ac</samp>.
</p>
-<a name="index-_002d_002ddisable_002dsynctex"></a>
-<a name="index-synctex-1"></a>
+<span id="index-_002d_002ddisable_002dsynctex"></span>
+<span id="index-synctex-1"></span>
<p><code>--disable-synctex</code>
<br>Do not build the <code>SyncTeX</code> library and tool.
</p>
<hr>
-<a name="Configure-options-for-texk_002fbibtex_002dx"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fbibtex_002dx"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="n" rel="next">Configure options for <samp>texk/dvipdfm-x</samp></a>, Previous: <a href="#Configure-options-for-texk_002fweb2c" accesskey="p" rel="prev">Configure options for <samp>texk/web2c</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fbibtex_002dx-1"></a>
-<h4 class="subsection">7.2.4 Configure options for <samp>texk/bibtex-x</samp></h4>
+<span id="Configure-options-for-texk_002fbibtex_002dx-1"></span><h4 class="subsection">7.2.4 Configure options for <samp>texk/bibtex-x</samp></h4>
-<a name="index-configure-options_002c-for-bibtex_002dx"></a>
-<a name="index-bibtex8"></a>
-<a name="index-bibtexu"></a>
-<a name="index-bibtex_002dx"></a>
+<span id="index-configure-options_002c-for-bibtex_002dx"></span>
+<span id="index-bibtex8"></span>
+<span id="index-bibtexu"></span>
+<span id="index-bibtex_002dx"></span>
<p>The programs <code>bibtex8</code> and <code>bibtexu</code> have been merged into the
module <code>bibtex-x</code> (extended BibTeX).
</p>
-<a name="index-_002d_002ddisable_002dbibtex8"></a>
+<span id="index-_002d_002ddisable_002dbibtex8"></span>
<p><code>--disable-bibtex8</code><br>Do not build the <samp>bibtex8</samp> program.
</p>
-<a name="index-_002d_002ddisable_002dbibtexu"></a>
+<span id="index-_002d_002ddisable_002dbibtexu"></span>
<p><code>--disable-bibtexu</code><br>Do not build the <samp>bibtexu</samp> program
(building <samp>bibtexu</samp> requires <code>ICU</code> libraries).
</p>
<hr>
-<a name="Configure-options-for-texk_002fdvipdfm_002dx"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fdvipdfm_002dx"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="n" rel="next">Configure options for <samp>texk/dvisvgm</samp></a>, Previous: <a href="#Configure-options-for-texk_002fbibtex_002dx" accesskey="p" rel="prev">Configure options for <samp>texk/bibtex-x</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fdvipdfm_002dx-1"></a>
-<h4 class="subsection">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></h4>
+<span id="Configure-options-for-texk_002fdvipdfm_002dx-1"></span><h4 class="subsection">7.2.5 Configure options for <samp>texk/dvipdfm-x</samp></h4>
-<a name="index-configure-options_002c-for-dvipdfm_002dx"></a>
-<a name="index-dvipdfmx"></a>
-<a name="index-xdvipdfmx"></a>
+<span id="index-configure-options_002c-for-dvipdfm_002dx"></span>
+<span id="index-dvipdfm_002dx"></span>
+<span id="index-dvipdfmx"></span>
+<span id="index-xdvipdfmx"></span>
<p>The former modules <code>dvipdfmx</code> (extended DVI to PDF converter) and
<code>xdvipdfmx</code> (the same, as used by XeTeX) have been merged into
@@ -2769,147 +2697,138 @@ created by default. In addition, <samp>dvipdfm</samp> is created as a
symlink to <samp>dvipdfmx</samp>, with backward-compatible (very slightly
different) behavior.
</p>
-<a name="index-_002d_002ddisable_002ddvipdfmx"></a>
+<span id="index-_002d_002ddisable_002ddvipdfmx"></span>
<p><code>--disable-dvipdfmx</code><br>Do not build the <samp>dvipdfmx</samp>
-program with the <samp>dvipdfm</samp> symlink.
+program or make the <samp>dvipdfm</samp> symlink.
</p>
-<a name="index-_002d_002ddisable_002dxdvipdfmx"></a>
+<span id="index-_002d_002ddisable_002dxdvipdfmx"></span>
<p><code>--disable-xdvipdfmx</code><br>Do not build the <samp>xdvipdfmx</samp>
program.
</p>
<hr>
-<a name="Configure-options-for-texk_002fdvisvgm"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fdvisvgm"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002ftexlive" accesskey="n" rel="next">Configure options for <samp>texk/texlive</samp></a>, Previous: <a href="#Configure-options-for-texk_002fdvipdfm_002dx" accesskey="p" rel="prev">Configure options for <samp>texk/dvipdfm-x</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fdvisvgm-1"></a>
-<h4 class="subsection">7.2.6 Configure options for <samp>texk/dvisvgm</samp></h4>
+<span id="Configure-options-for-texk_002fdvisvgm-1"></span><h4 class="subsection">7.2.6 Configure options for <samp>texk/dvisvgm</samp></h4>
-<a name="index-configure-options_002c-for-dvisvgm"></a>
-<a name="index-dvisvgm"></a>
+<span id="index-configure-options_002c-for-dvisvgm"></span>
+<span id="index-dvisvgm"></span>
-<a name="index-_002d_002dwith_002dsystem_002dlibgs"></a>
+<span id="index-_002d_002dwith_002dsystem_002dlibgs"></span>
<p><code>--with-system-libgs</code><br>Build <samp>dvisvgm</samp> using installed
Ghostscript (<code>gs</code>) headers and library (not allowed for a native
TL build). The default is to load the <code>gs</code> library at runtime if
-possible, or otherwise disable support for PostScript specials.
+possible, else to disable support for PostScript specials.
</p>
-<a name="index-_002d_002dwithout_002dlibgs"></a>
+<span id="index-_002d_002dwithout_002dlibgs"></span>
<p><code>--without-libgs</code><br>Build <samp>dvisvgm</samp> without PostScript
support at all. Because the dynamic loading just mentioned defeats all
attempts at static linking, the result can crash due to library
incompatibilities, e.g., on CentOS 5.
</p>
-<a name="index-_002d_002dwith_002dlibgs_002dincludes_002c-_002dlibdir"></a>
+<span id="index-_002d_002dwith_002dlibgs_002dincludes_002c-_002dlibdir"></span>
<p><code>--with-libgs-includes=<var>dir</var></code>,
<code>--with-libgs-libdir=<var>dir</var></code><br>Specify non-standard locations
of the Ghostscript headers and library.
</p>
<hr>
-<a name="Configure-options-for-texk_002ftexlive"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002ftexlive"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-texk_002fxdvik" accesskey="n" rel="next">Configure options for <samp>texk/xdvik</samp></a>, Previous: <a href="#Configure-options-for-texk_002fdvisvgm" accesskey="p" rel="prev">Configure options for <samp>texk/dvisvgm</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002ftexlive-1"></a>
-<h4 class="subsection">7.2.7 Configure options for <samp>texk/texlive</samp></h4>
+<span id="Configure-options-for-texk_002ftexlive-1"></span><h4 class="subsection">7.2.7 Configure options for <samp>texk/texlive</samp></h4>
-<a name="index-configure-options_002c-for-texk_002ftexlive"></a>
-<a name="index-_002d_002ddisable_002dlinked_002dscripts"></a>
+<span id="index-configure-options_002c-for-texk_002ftexlive"></span>
+<span id="index-_002d_002ddisable_002dlinked_002dscripts"></span>
<p><code>--disable-linked-scripts</code><br>Do not install the &ldquo;linked
scripts&rdquo; (see <a href="#Linked-scripts">Linked scripts</a>), except for the TL scripts required
to run <code>texlinks</code>.
</p>
<hr>
-<a name="Configure-options-for-texk_002fxdvik"></a>
-<div class="header">
+<span id="Configure-options-for-texk_002fxdvik"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-utils_002fxindy" accesskey="n" rel="next">Configure options for <samp>utils/xindy</samp></a>, Previous: <a href="#Configure-options-for-texk_002ftexlive" accesskey="p" rel="prev">Configure options for <samp>texk/texlive</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-texk_002fxdvik-1"></a>
-<h4 class="subsection">7.2.8 Configure options for <samp>texk/xdvik</samp></h4>
+<span id="Configure-options-for-texk_002fxdvik-1"></span><h4 class="subsection">7.2.8 Configure options for <samp>texk/xdvik</samp></h4>
-<a name="index-configure-options_002c-for-xdvik"></a>
-<a name="index-xdvik-1"></a>
+<span id="index-configure-options_002c-for-xdvik"></span>
+<span id="index-xdvik-1"></span>
-<a name="index-_002d_002dwith_002dgs_003dfilename"></a>
+<span id="index-_002d_002dwith_002dgs_003dfilename"></span>
+<span id="index-Ghostscript-location-for-Xdvik"></span>
<p><code>--with-gs=<var>filename</var></code><br>Hardwire the location of Ghostscript
-(<samp>gs</samp>).
+(<samp>gs</samp>) as called by Xdvik.
</p>
-<a name="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit_003dkit"></a>
-<a name="index-motif"></a>
-<a name="index-xaw"></a>
+<span id="index-_002d_002dwith_002dxdvi_002dx_002dtoolkit_003dkit"></span>
+<span id="index-motif"></span>
+<span id="index-xaw"></span>
<p><code>--with-xdvi-x-toolkit=<var>kit</var></code><br>Use toolkit
<code><var>kit</var></code> for <samp>xdvik</samp>, one of: <code>motif xaw xaw3d
neXtaw</code>. The default is <code>motif</code> if available, else <code>xaw</code>.
</p>
-<a name="index-_002d_002denable_002dxi2_002dscrolling"></a>
-<a name="index-XInput"></a>
-<a name="index-scrolling"></a>
+<span id="index-_002d_002denable_002dxi2_002dscrolling"></span>
+<span id="index-XInput"></span>
+<span id="index-scrolling_002c-smooth"></span>
<p><code>--enable-xi2-scrolling</code><br>Use XInput 2.1 &ldquo;smooth scrolling&rdquo;
-if available. (default: yes, except for a native TL build).
+if available (default: yes, except for a native TL build).
</p>
<hr>
-<a name="Configure-options-for-utils_002fxindy"></a>
-<div class="header">
+<span id="Configure-options-for-utils_002fxindy"></span><div class="header">
<p>
Previous: <a href="#Configure-options-for-texk_002fxdvik" accesskey="p" rel="prev">Configure options for <samp>texk/xdvik</samp></a>, Up: <a href="#Program_002dspecific-configure-options" accesskey="u" rel="up">Program-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-utils_002fxindy-1"></a>
-<h4 class="subsection">7.2.9 Configure options for <samp>utils/xindy</samp></h4>
+<span id="Configure-options-for-utils_002fxindy-1"></span><h4 class="subsection">7.2.9 Configure options for <samp>utils/xindy</samp></h4>
-<a name="index-configure-options_002c-for-xindy"></a>
-<a name="index-xindy-2"></a>
+<span id="index-configure-options_002c-for-xindy"></span>
+<span id="index-xindy-2"></span>
-<a name="index-_002d_002denable_002dxindy_002drules"></a>
+<span id="index-_002d_002denable_002dxindy_002drules"></span>
<p><code>--enable-xindy-rules</code><br>Build and install <code>xindy</code> rules
(default: yes, except for a native TL build).
</p>
-<a name="index-_002d_002denable_002dxindy_002ddocs"></a>
+<span id="index-_002d_002denable_002dxindy_002ddocs"></span>
<p><code>--enable-xindy-docs</code><br>Build and install <code>xindy</code>
documentation (default: yes, except for a native TL build).
</p>
-<a name="index-_002d_002dwith_002dclisp_002druntime_003dfilename"></a>
-<a name="index-lisp_002erun_002c-lisp_002eexe"></a>
-<a name="index-CLISP"></a>
+<span id="index-_002d_002dwith_002dclisp_002druntime_003dfilename"></span>
+<span id="index-lisp_002erun_002c-lisp_002eexe"></span>
+<span id="index-CLISP"></span>
<p><code>--with-clisp-runtime=<var>filename</var></code><br>Specifies the
-Full path for the CLISP runtime file (<samp>lisp.run</samp> or
+full path for the Clisp runtime file (<samp>lisp.run</samp> or
<samp>lisp.exe</samp>) to be installed. When specified as <code>default</code>
(the default for a native TL build) the path is determined by the
-CLISP executable; the value <code>system</code> (not allowed for a native TL
-build, but the default for a non-native one) indicates that
-<samp>xindy</samp> will use the installed version of <samp>clisp</samp> (which
-must be identical to the one used to build <samp>xindy</samp>).
+Clisp executable; the value <code>system</code> (not allowed for a native TL
+build, but the default otherwise) indicates that <samp>xindy</samp> will use
+the installed version of <samp>clisp</samp> (which must be identical to the
+one used to build <samp>xindy</samp>).
</p>
<hr>
-<a name="Library_002dspecific-configure-options"></a>
-<div class="header">
+<span id="Library_002dspecific-configure-options"></span><div class="header">
<p>
Next: <a href="#Variables-for-configure" accesskey="n" rel="next">Variables for configure</a>, Previous: <a href="#Program_002dspecific-configure-options" accesskey="p" rel="prev">Program-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Library_002dspecific-configure-options-1"></a>
-<h3 class="section">7.3 Library-specific configure options</h3>
+<span id="Library_002dspecific-configure-options-1"></span><h3 class="section">7.3 Library-specific configure options</h3>
-<a name="index-library_002dspecific-configure-options"></a>
-<a name="index-configure-options_002c-library_002dspecific"></a>
+<span id="index-library_002dspecific-configure-options"></span>
+<span id="index-configure-options_002c-library_002dspecific"></span>
<p>Here are (some of) the library-specific <code>configure</code> options,
starting with this generic one:
</p>
-<a name="index-_002d_002dwith_002dsystem_002dlib-1"></a>
+<span id="index-_002d_002dwith_002dsystem_002dlib-1"></span>
<p><code>--with-system-<var>lib</var></code>
</p>
<p>Use an installed (system) version of the library <code><var>lib</var></code>;
this option exists for most libraries, but is not allowed for a native
TL build. Using a system version implies also using the system
-versions of all libraries (if any) that <var>lib</var> depends on.
+versions of all libraries that <var>lib</var> depends on.
</p>
-<a name="index-_002d_002dwith_002dlib_002dincludes_003ddir_002c-_002dlibdir"></a>
+<span id="index-_002d_002dwith_002dlib_002dincludes_003ddir_002c-_002dlibdir"></span>
<p>For many libraries <code>--with-<var>lib</var>-includes=<var>dir</var></code> and
<code>--with-<var>lib</var>-libdir=<var>dir</var></code> can specify non-standard
search locations; others use <samp>pkg-config</samp> or similar to determine
@@ -2919,27 +2838,25 @@ the required flags.
required system libraries and bails out if tests fail.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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>
-<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-system-poppler" accesskey="2">Configure options for system <code>poppler</code></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#Configure-options-for-system-poppler" accesskey="2">Configure options for system <code>poppler</code></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="Configure-options-for-kpathsea"></a>
-<div class="header">
+<span id="Configure-options-for-kpathsea"></span><div class="header">
<p>
Next: <a href="#Configure-options-for-system-poppler" accesskey="n" rel="next">Configure options for system <code>poppler</code></a>, Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Library-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-kpathsea-1"></a>
-<h4 class="subsection">7.3.1 Configure options for <code>kpathsea</code></h4>
+<span id="Configure-options-for-kpathsea-1"></span><h4 class="subsection">7.3.1 Configure options for <code>kpathsea</code></h4>
-<a name="index-configure-options_002c-for-kpathsea"></a>
+<span id="index-configure-options_002c-for-kpathsea"></span>
<p><code>--enable-<var>cmd</var>-default</code>,
<code>--disable-<var>cmd</var>-default</code><br>Determine the compile time default
-whether or not to run <var>cmd</var>, one of:
+for whether or not to run <var>cmd</var>, which is one of:
</p><dl compact="compact">
<dt><code>mkocp</code></dt>
<dd><p>(Omega compiled translation process file)
@@ -2965,48 +2882,44 @@ whether or not to run <var>cmd</var>, one of:
</dl>
<p>to generate the specified type of file dynamically.
-The default can be overridden by the user in any case.
+The default can be overridden by the user in any case
+(see <a href="#kpathsea-library"><code>kpathsea</code> library</a>).
</p>
-
<hr>
-<a name="Configure-options-for-system-poppler"></a>
-<div class="header">
+<span id="Configure-options-for-system-poppler"></span><div class="header">
<p>
Previous: <a href="#Configure-options-for-kpathsea" accesskey="p" rel="prev">Configure options for <code>kpathsea</code></a>, Up: <a href="#Library_002dspecific-configure-options" accesskey="u" rel="up">Library-specific configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configure-options-for-system-poppler-1"></a>
-<h4 class="subsection">7.3.2 Configure options for system <code>poppler</code></h4>
+<span id="Configure-options-for-system-poppler-1"></span><h4 class="subsection">7.3.2 Configure options for system <code>poppler</code></h4>
-<a name="index-configure-options_002c-for-system-poppler"></a>
+<span id="index-configure-options_002c-for-system-poppler"></span>
-<a name="index-poppler"></a>
-<a name="index-xpdf-as-library"></a>
-<p>Building LuaTeX (or LuaJITTeX) and XeTeX requires
-<code>poppler</code>, either from the TL tree or system headers and
-library. Building pdfTeX requires either <code>xpdf</code> from
-the TeX&nbsp;Live tree or system <code>poppler</code> headers and library.
+<span id="index-poppler"></span>
+<span id="index-xpdf-as-library"></span>
+<p>Building XeTeX requires <code>poppler</code>, either from the TL tree or
+system headers and library. Building pdfTeX requires either
+<code>xpdf</code> from the TeX&nbsp;Live tree or system <code>poppler</code> headers and
+library.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dpoppler"></a>
+<span id="index-_002d_002dwith_002dsystem_002dpoppler"></span>
<p><code>--with-system-poppler</code><br>Use a system version (0.18 or
newer) of <code>poppler</code> for LuaTeX (or LuaJITTeX) and XeTeX,
and use <samp>pkg-config</samp> to obtain the required flags.
</p>
-<a name="index-_002d_002dwith_002dsystem_002dxpdf"></a>
-<p><code>--with-system-xpdf</code><br>Use a system version (0.12 or better)
+<span id="index-_002d_002dwith_002dsystem_002dxpdf"></span>
+<p><code>--with-system-xpdf</code><br>Use a system version (0.12 or newer)
of <code>poppler</code> (and <samp>pkg-config</samp>) for pdfTeX instead of
<code>xpdf</code> from the TL tree. See <a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a>.
</p>
<hr>
-<a name="Variables-for-configure"></a>
-<div class="header">
+<span id="Variables-for-configure"></span><div class="header">
<p>
Previous: <a href="#Library_002dspecific-configure-options" accesskey="p" rel="prev">Library-specific configure options</a>, Up: <a href="#Configure-options" accesskey="u" rel="up">Configure options</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Variables-for-configure-1"></a>
-<h3 class="section">7.4 Variables for configure</h3>
+<span id="Variables-for-configure-1"></span><h3 class="section">7.4 Variables for configure</h3>
-<a name="index-variables-for-configure"></a>
-<a name="index-configure-variables"></a>
+<span id="index-variables-for-configure"></span>
+<span id="index-configure-variables"></span>
<p>The values for these variables can be specified as <code>configure</code>
arguments of the form <code><var>VAR</var>=<var>value</var></code>. They can also be
@@ -3015,73 +2928,73 @@ compilations.
</p>
<dl compact="compact">
<dt><code>CC</code>
-<a name="index-CC"></a>
+<span id="index-CC"></span>
</dt>
<dt><code>CXX</code>
-<a name="index-CXX"></a>
+<span id="index-CXX"></span>
</dt>
<dt><code>CPPFLAGS</code>
-<a name="index-CPPFLAGS"></a>
+<span id="index-CPPFLAGS"></span>
</dt>
<dd><p>And plenty more. As usual with Autoconf, these variables specify the
name (or full path) of compilers, preprocessor flags, and similar.
-See <a href="GNU Autoconf.html#Preset-Output-Variables">(GNU Autoconf)autoconf</a>.
+See <a href="https://www.gnu.org/software/autoconf/manual/autoconf.html#Preset-Output-Variables">Preset Output Variables</a> in <cite>GNU Autoconf</cite>.
</p>
</dd>
<dt><code>CLISP</code>
-<a name="index-CLISP-1"></a>
+<span id="index-CLISP-1"></span>
</dt>
-<dd><a name="index-clisp"></a>
+<dd><span id="index-clisp"></span>
<p>Name (or full path) of the <samp>clisp</samp> executable, used to build
<code>xindy</code>.
</p>
</dd>
<dt><code>FT2_CONFIG</code>
-<a name="index-FT2_005fCONFIG"></a>
+<span id="index-FT2_005fCONFIG"></span>
</dt>
<dt><code>ICU_CONFIG</code>
-<a name="index-ICU_005fCONFIG"></a>
+<span id="index-ICU_005fCONFIG"></span>
</dt>
<dt><code>PKG_CONFIG</code>
-<a name="index-PKG_005fCONFIG"></a>
+<span id="index-PKG_005fCONFIG"></span>
</dt>
-<dd><a name="index-freetype_002dconfig-1"></a>
-<a name="index-icu_002dconfig"></a>
-<a name="index-libfreetype"></a>
-<a name="index-ICU-libraries"></a>
+<dd><span id="index-freetype_002dconfig-1"></span>
+<span id="index-icu_002dconfig"></span>
+<span id="index-libfreetype"></span>
+<span id="index-ICU-libraries"></span>
<p>These specify the name (or path) for the <samp>freetype-config</samp>,
<samp>icu-config</samp>, and <samp>pkg-config</samp> commands used to determine the
flags required for system versions of <samp>libfreetype</samp>, the ICU
-libraries, or many other libraries.
+libraries, and other libraries, respectively.
</p>
</dd>
<dt><code>KPSEWHICH</code>
-<a name="index-KPSEWHICH"></a>
+<span id="index-KPSEWHICH"></span>
</dt>
-<dd><a name="index-kpsewhich"></a>
+<dd><span id="index-kpsewhich"></span>
<p>Name (or path) of an installed <samp>kpsewhich</samp> binary, used by
<code>make check</code> to determine the location of, e.g.,
<samp>cmbx10.tfm</samp>.
</p>
</dd>
<dt><code>MAKE</code>
-<a name="index-MAKE"></a>
+<span id="index-MAKE"></span>
</dt>
<dt><code>SED</code>
-<a name="index-SED"></a>
+<span id="index-SED"></span>
</dt>
<dd><p>And more. Name (or path) of the <code>make</code>, <code>sed</code>, and similar
programs; used at the top level and propagated to all subdirectories.
</p>
</dd>
<dt><code>PERL</code>
-<a name="index-PERL"></a>
+<span id="index-PERL"></span>
</dt>
<dt><code>LATEX</code>
-<a name="index-LATEX"></a>
+<span id="index-LATEX"></span>
</dt>
<dt><code>PDFLATEX</code>
-<a name="index-PDFLATEX"></a>
+<span id="index-PDFLATEX"></span>
</dt>
<dd><p>Name (or full path) for the <samp>perl</samp>, <samp>latex</samp>, and <samp>pdflatex</samp>
commands used, e.g., to build the <code>xindy</code> documentation.
@@ -3091,51 +3004,47 @@ commands used, e.g., to build the <code>xindy</code> documentation.
<hr>
-<a name="Coding-conventions"></a>
-<div class="header">
+<span id="Coding-conventions"></span><div class="header">
<p>
Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Coding-conventions-1"></a>
-<h2 class="chapter">8 Coding conventions</h2>
+<span id="Coding-conventions-1"></span><h2 class="chapter">8 Coding conventions</h2>
-<a name="index-coding-conventions"></a>
-<a name="index-conventions_002c-coding"></a>
+<span id="index-coding-conventions"></span>
+<span id="index-conventions_002c-coding"></span>
-<p>Ideally, building all of TeX&nbsp;Live with <code>--enable-compiler-warnings=max</code>
-should produce no (GCC) compiler warnings at all. In spite of
-considerable efforts into that direction we are still far from that goal and
-there are reasons that we may never fully reach it. Below are some rules
-about declarations of functions or variables and the use of <code>const</code>.
-These rules should be applied to most of the TeX&nbsp;Live tree, the exception
-being code that is maintained independently and whose maintainers
-don&rsquo;t want to accept patches.
+<p>Ideally, building all of TeX&nbsp;Live with
+<code>--enable-compiler-warnings=max</code> should produce no (GCC) compiler
+warnings at all. In spite of considerable efforts into that direction
+we are still far from that goal and there are reasons that we may
+never fully reach it. Below are some rules about declarations of
+functions or variables and the use of <code>const</code>. These rules
+should be applied to the code maintained in the TeX&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">
+<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">
+<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>
<hr>
-<a name="Declarations-and-definitions"></a>
-<div class="header">
+<span id="Declarations-and-definitions"></span><div class="header">
<p>
Next: <a href="#Const" accesskey="n" rel="next">Const</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Declarations-and-definitions-1"></a>
-<h3 class="section">8.1 Declarations and definitions</h3>
+<span id="Declarations-and-definitions-1"></span><h3 class="section">8.1 Declarations and definitions</h3>
-<a name="index-declarations-and-definitions_002c-in-source-code"></a>
-<a name="index-source-code-declarations"></a>
-<a name="index-ANSI-C"></a>
-<a name="index-C_002c-ANSI_002c-required"></a>
-<a name="index-C99_002c-avoided"></a>
+<span id="index-declarations-and-definitions_002c-in-source-code"></span>
+<span id="index-source-code-declarations"></span>
+<span id="index-ANSI-C"></span>
+<span id="index-declarations-before-statements_002c-avoiding"></span>
+<span id="index-C_002c-ANSI_002c-required"></span>
+<span id="index-C99_002c-avoided"></span>
-<a name="C-standards"></a>
-<h4 class="subsubheading">C standards</h4>
+<span id="C-standards"></span><h4 class="subsubheading">C standards</h4>
<p>The TeX&nbsp;Live build system no longer supports pre-ANSI C compilers. Thus
all function prototypes and definitions must conform to the ANSI C
@@ -3143,18 +3052,18 @@ standard (including <code>void</code> in the declaration of C functions with
no parameters). On the other hand, TL is built for a wide variety of
systems, not all of which support the C99 standard. Therefore using
C99 features should be avoided if that can easily be done. In
-particular C code must not contain declarations after statements or
+particular, C code must not contain declarations after statements or
C++-style comments.
</p>
-<a name="index-chktex"></a>
-<a name="index-stpcpy"></a>
+<span id="index-chktex"></span>
+<span id="index-stpcpy"></span>
<p>If some C99 (or later) constructs must be used, the module should
verify that they are available and otherwise provide an alternative.
For example, the module <samp>texk/chktex</samp> uses the C99 function
<code>stpcpy()</code> that may or may not be available on a particular
system. It uses <code>AC_CHECK_DECLS([stpcpy])</code> in
-<samp>configure.ac</samp> to test this, and provides the perhaps slightly
-less efficient alternative
+<samp>configure.ac</samp> to test this, and provides a perhaps
+less efficient alternative (in the file <samp>Utility.h</samp>):
</p>
<div class="example">
<pre class="example">#if !(defined HAVE_DECL_STPCPY &amp;&amp; HAVE_DECL_STPCPY)
@@ -3165,20 +3074,15 @@ static inline char *stpcpy(char *dest, const char *src)
#endif
</pre></div>
-<p>in the file <samp>Utility.h</samp>.
-</p>
-
-<a name="Static-functions"></a>
-<h4 class="subsubheading">Static functions</h4>
+<span id="Static-functions"></span><h4 class="subsubheading">Static functions</h4>
-<a name="index-static-functions"></a>
+<span id="index-static-functions"></span>
<p>Functions used in only one file should be declared <code>static</code>; they
-require no prototype except as forward declaration.
+require no prototype except in forward declarations.
</p>
-<a name="Extern-functions"></a>
-<h4 class="subsubheading">Extern functions</h4>
+<span id="Extern-functions"></span><h4 class="subsubheading">Extern functions</h4>
-<a name="index-extern-functions"></a>
+<span id="index-extern-functions"></span>
<p>Functions not declared <code>static</code>, usually because they are used in
several files, require an (<code>extern</code>) prototype in exactly one
header file, which is included in the file defining the function and
@@ -3187,30 +3091,26 @@ consistency between definition and use. There should be no
<code>extern</code> declarations sprinkled throughout the C code (with or
without comments as to where that function is defined).
</p>
-<a name="Variable-declarations"></a>
-<h4 class="subsubheading">Variable declarations</h4>
+<span id="Variable-declarations"></span><h4 class="subsubheading">Variable declarations</h4>
-<a name="index-variable-declarations_002c-in-source-code"></a>
+<span id="index-variable-declarations_002c-in-source-code"></span>
<p>The declaration of global variables follows analogous rules: they are
either declared <code>static</code> if used in only one file or declared
<code>extern</code> in exactly one header and instantiated in exactly one
file.
</p>
<hr>
-<a name="Const"></a>
-<div class="header">
+<span id="Const"></span><div class="header">
<p>
Previous: <a href="#Declarations-and-definitions" accesskey="p" rel="prev">Declarations and definitions</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Const-1"></a>
-<h3 class="section">8.2 Const</h3>
+<span id="Const-1"></span><h3 class="section">8.2 Const</h3>
-<a name="index-const"></a>
+<span id="index-const"></span>
<p>The <code>const</code> feature of C is valuable, but easy to mis-use.
</p>
-<a name="Function-parameters"></a>
-<h4 class="subsubheading">Function parameters</h4>
+<span id="Function-parameters"></span><h4 class="subsubheading">Function parameters</h4>
<p>Ideally, a function parameter not modified by the function should be
declared as <code>const</code>. This is important in particular for strings
@@ -3223,29 +3123,27 @@ char*const*</code> variable, but not for a type <code>const char**</code> variab
since that might cause modification of a quantity supposed to be
constant.
</p>
-<a name="index-X11-headers_002c-and-const"></a>
-<a name="index-libfreetype_002c-and-const"></a>
+<span id="index-X11-headers_002c-and-const"></span>
+<span id="index-libfreetype_002c-and-const"></span>
<p>Getting all <code>const</code> qualifiers right can get quite involved but
can almost always be done. There are only a couple notable
exceptions: the X11 headers are full of declarations that ought to use
-<code>const</code> but do not, and the same is true to some extent for
-<samp>libfreetype</samp> (but, thankfully, not for <code>zlib</code> nowadays).
+<code>const</code> but do not; at one time, <samp>libfreetype</samp> also did not
+fully specify <code>const</code>, but this has not been checked recently.
</p>
-<a name="What-must-be-avoided-with-const"></a>
-<h4 class="subsubheading">What must be avoided with <code>const</code></h4>
+<span id="What-must-be-avoided-with-const"></span><h4 class="subsubheading">What must be avoided with <code>const</code></h4>
-<a name="index-warning_002c-discards-qualifiers"></a>
-<a name="index-discards-qualifiers-warning"></a>
+<span id="index-warning_002c-discards-qualifiers"></span>
+<span id="index-discards-qualifiers-warning"></span>
<p>The GCC compiler warnings &ldquo;assignment discards qualifiers&hellip;&rdquo;
and analogous warnings for &ldquo;initialization&rdquo;, &ldquo;passing arg&rdquo;, or
-&ldquo;return&rdquo; must be strenously avoided in our own code. The only
-exception is when they are caused by X11 headers or macros or other
-third party code.
+&ldquo;return&rdquo; must be strenuously avoided in our own code. The only
+exception is when they are caused by X11 declarations or other third
+party code.
</p>
-<a name="What-should-be-avoided-with-const"></a>
-<h4 class="subsubheading">What should be avoided with <code>const</code></h4>
+<span id="What-should-be-avoided-with-const"></span><h4 class="subsubheading">What should be avoided with <code>const</code></h4>
-<a name="index-type-cast_002c-avoiding"></a>
+<span id="index-type-cast-from-const_002c-avoiding"></span>
<p>A type cast, e.g., from <code>const char*</code> to <code>char*</code> does not
solve any problems; depending on warning options, it may only hide
them. Therefore such casts should be avoided whenever possible and
@@ -3254,84 +3152,81 @@ cause the modification of quantities supposed to be constant.
</p>
<hr>
-<a name="Continuous-integration"></a>
-<div class="header">
+<span id="Continuous-integration"></span><div class="header">
<p>
Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Continuous-integration-1"></a>
-<h2 class="chapter">9 Continuous integration</h2>
+<span id="Continuous-integration-1"></span><h2 class="chapter">9 Continuous integration</h2>
-<a name="index-ci"></a>
-<a name="index-continuous-integration"></a>
-<a name="index-Travis_002dCI"></a>
+<span id="index-continuous-integration"></span>
+<span id="index-Travis_002dCI"></span>
-<p>Overview: the sources of TeX&nbsp;Live are subjected to continuous integration
-testing on Travis-CI
-(<a href="https://travis-ci.org/TeX-Live/texlive-source">https://travis-ci.org/TeX-Live/texlive-source</a>) via a git-svn
-mirror of the sources that is pushed to Github
+<p>The TeX&nbsp;Live sources are subjected to continuous integration testing on
+Travis-CI (<a href="https://travis-ci.org/TeX-Live/texlive-source">https://travis-ci.org/TeX-Live/texlive-source</a>) via a
+git-svn mirror of the sources that is pushed to Github
(<a href="https://github.com/TeX-Live/texlive-source">https://github.com/TeX-Live/texlive-source</a>). The git-svn mirror
is updated (currently) at 30 minute intervals, and only the last
commit pushed is tested on Travis-CI.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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">
+<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">
+<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>
</table>
+
<hr>
-<a name="Transfer-from-Subversion-to-Github"></a>
-<div class="header">
+<span id="Transfer-from-Subversion-to-Github"></span><div class="header">
<p>
Next: <a href="#Automatic-update-of-the-Git-mirror" accesskey="n" rel="next">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Transfer-from-Subversion-to-Github-1"></a>
-<h3 class="section">9.1 Transfer from Subversion to Github</h3>
+<span id="Transfer-from-Subversion-to-Github-1"></span><h3 class="section">9.1 Transfer from Subversion to Github</h3>
-<p>git-svn (<a href="https://git-scm.com/docs/git-svn">https://git-scm.com/docs/git-svn</a>) is used to check out
-the subtree <code>Build/source</code> of the Subversion repository. The
-author index file used is not maintained in either Git or Subversion
-but can be provided on request.
+<span id="index-git_002dsvn"></span>
+<p>The git-svn program (<a href="https://git-scm.com/docs/git-svn">https://git-scm.com/docs/git-svn</a>) is used
+to check out the subtree <code>Build/source</code> of the canonical
+Subversion repository. The author index file used is not maintained
+in either Git or Subversion but can be provided on request.
</p>
<p>The initial checkout was done by invoking
</p><div class="example">
-<pre class="example">git svn --authors-file usermap clone svn://USER@tug.org/texlive/trunk/Build/source
+<pre class="example">git svn --authors-file usermap clone \
+ svn://<var>user</var>@tug.org/texlive/trunk/Build/source
</pre></div>
<p>where the <code>usermap</code> file maps Subversion user names to
-name and emails of the authors. If no user account at <a href="tug.org">tug.org</a> is
-available, anonymous checkout is possible, too:
+name and emails of the authors. Anonymous checkout is also possible:
</p><div class="example">
-<pre class="example">git svn --authors-file usermap clone svn://tug.org/texlive/trunk/Build/source
+<pre class="example">git svn --authors-file usermap clone \
+ svn://tug.org/texlive/trunk/Build/source
</pre></div>
<p>In the following, we will use <em>admin</em> to refer to a user who has
read/write access to the TeX&nbsp;Live subversion repository, and is also an
-administrator of the <code>TeX-Live</code> Team on Github. The above initial
-checkout has been carried out by <em>admin</em> on the server
+administrator of the &lsquo;<code>TeX-Live</code>&rsquo; team at Github. The above
+initial checkout has been carried out by <em>admin</em> on the server
<code>texlive.info</code>.
</p>
-<p>On Github (<a href="https://github.com">https://github.com</a>), a new git repository named
-<code>texlive-source</code> was created by <em>admin</em> within the
-<code>TeX-Live</code> &ldquo;organization&rdquo; (<a href="https://github.com/TeX-Live">https://github.com/TeX-Live</a>).
-The remote was added to the checkout with <code>git remote add origin
+<p>On Github, a new git repository named <code>texlive-source</code> was
+created by <em>admin</em> within the <code>TeX-Live</code> &ldquo;organization&rdquo;
+(<a href="https://github.com/TeX-Live">https://github.com/TeX-Live</a>). The remote was added to the
+checkout with <code>git remote add origin
git@github.com:TeX-Live/texlive-source.git</code>.
</p>
-<p>To automate the update on Github, a new ssh key was generated and added
-to the <code>texlive-source</code> repository on Github as deployment
-key. This way pushes using this key can only go to the
+<p>To automate the update on Github, a new ssh key was generated and
+added to the <code>texlive-source</code> repository on Github as deployment
+key. Thus, pushes using this key can only go to the
<code>texlive-source</code> repository and not anywhere else.
</p>
<p>The usage of <code>git-svn</code> requires a strict discipline to keep a
linear history in the master branch. Since we are aiming at a pure
-mirror facility, we have decided to further restrict the <code>master</code>
-branch of the <code>texlive-source</code> repository on Github to changes by
-<em>admin</em>.
+mirror facility on Github, we have decided to further restrict the
+<code>master</code> branch of the <code>texlive-source</code> repository on Github
+to changes by <em>admin</em>.
</p>
<p>This setup allows other developers to branch off <code>master</code> and
push their branches to the Github repository, but all updates need to
@@ -3340,88 +3235,79 @@ Subversion, back to <code>master</code> on <code>texlive.info</code>, and from
there to Github.
</p>
<hr>
-<a name="Automatic-update-of-the-Git-mirror"></a>
-<div class="header">
+<span id="Automatic-update-of-the-Git-mirror"></span><div class="header">
<p>
Next: <a href="#CI-testing-on-Travis_002dCI" accesskey="n" rel="next">CI testing on Travis-CI</a>, Previous: <a href="#Transfer-from-Subversion-to-Github" accesskey="p" rel="prev">Transfer from Subversion to Github</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Automatic-update-of-the-Git-mirror-1"></a>
-<h3 class="section">9.2 Automatic update of the Git mirror</h3>
+<span id="Automatic-update-of-the-Git-mirror-1"></span><h3 class="section">9.2 Automatic update of the Git mirror</h3>
<p><em>admin</em> has installed a cron job on <code>texlive.info</code> running
every 30 minute which essentially runs <code>git svn rebase</code> and
<code>git push</code> in the <code>master</code> branch of the checkout. The first
command fetches the changes from the Subversion repository and updates
-the <code>master</code> branch with them, the second one pushes changes (if
-available) to Github.
+the <code>master</code> branch with them, and the second pushes changes (if
+any) to Github.
</p>
<hr>
-<a name="CI-testing-on-Travis_002dCI"></a>
-<div class="header">
+<span id="CI-testing-on-Travis_002dCI"></span><div class="header">
<p>
Previous: <a href="#Automatic-update-of-the-Git-mirror" accesskey="p" rel="prev">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="CI-testing-on-Travis_002dCI-1"></a>
-<h3 class="section">9.3 CI testing on Travis-CI</h3>
+<span id="CI-testing-on-Travis_002dCI-1"></span><h3 class="section">9.3 CI testing on Travis-CI</h3>
-<a name="index-_002etravis_002eyml"></a>
+<span id="index-travis_002eyml"></span>
<p>The <code>source</code> tree of TeX&nbsp;Live contains a top-level file
<code>.travis.yml</code> which controls the automatic testing on
-Travis-CI. <em>admin</em> has registered to Travis-CI and allowed access
-to the Github&rsquo;s <code>TeX-Live</code> organization&rsquo;s <code>texlive-source</code>
-repository. The default settings are to build the last commit of each
-push. No further action is necessary on Travis-CI.
+Travis-CI. <em>admin</em> has registered with Travis-CI and allowed
+access to the Github&rsquo;s <code>TeX-Live</code> organization&rsquo;s
+<code>texlive-source</code> repository. The default settings are to build
+the last commit of each push. No further action is necessary on
+Travis-CI.
</p>
<p>If changes have been pushed via the cron job above, Travis-CI will
automatically checkout the last pushed commit and try building it.
</p>
<hr>
-<a name="install_002dtl"></a>
-<div class="header">
+<span id="install_002dtl"></span><div class="header">
<p>
Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="install_002dtl-1"></a>
-<h2 class="appendix">Appendix A install-tl</h2>
+<span id="install_002dtl-1"></span><h2 class="appendix">Appendix A install-tl</h2>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-NAME" accesskey="1">install-tl NAME</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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>
<hr>
-<a name="install_002dtl-NAME"></a>
-<div class="header">
+<span id="install_002dtl-NAME"></span><div class="header">
<p>
Next: <a href="#install_002dtl-SYNOPSIS" accesskey="n" rel="next">install-tl SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="NAME"></a>
-<h3 class="appendixsec">A.1 NAME</h3>
+<span id="NAME"></span><h3 class="appendixsec">A.1 NAME</h3>
<p>install-tl - TeX Live cross-platform installer
</p>
<hr>
-<a name="install_002dtl-SYNOPSIS"></a>
-<div class="header">
+<span id="install_002dtl-SYNOPSIS"></span><div class="header">
<p>
Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl DESCRIPTION</a>, Previous: <a href="#install_002dtl-NAME" accesskey="p" rel="prev">install-tl NAME</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="SYNOPSIS"></a>
-<h3 class="appendixsec">A.2 SYNOPSIS</h3>
+<span id="SYNOPSIS"></span><h3 class="appendixsec">A.2 SYNOPSIS</h3>
<p>install-tl [<em>option</em>]...
</p>
@@ -3430,13 +3316,11 @@ Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl
<p>install-tl-advanced.bat [<em>option</em>]...
</p>
<hr>
-<a name="install_002dtl-DESCRIPTION"></a>
-<div class="header">
+<span id="install_002dtl-DESCRIPTION"></span><div class="header">
<p>
Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">install-tl REFERENCES</a>, Previous: <a href="#install_002dtl-SYNOPSIS" accesskey="p" rel="prev">install-tl SYNOPSIS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="DESCRIPTION"></a>
-<h3 class="appendixsec">A.3 DESCRIPTION</h3>
+<span id="DESCRIPTION"></span><h3 class="appendixsec">A.3 DESCRIPTION</h3>
<p>This installer creates a runnable TeX Live installation from various
media, including over the network, from local hard disk, a DVD, etc.
@@ -3458,13 +3342,11 @@ initial installation is complete.
highly recommended.
</p>
<hr>
-<a name="install_002dtl-REFERENCES"></a>
-<div class="header">
+<span id="install_002dtl-REFERENCES"></span><div class="header">
<p>
Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">install-tl OPTIONS</a>, Previous: <a href="#install_002dtl-DESCRIPTION" accesskey="p" rel="prev">install-tl DESCRIPTION</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="REFERENCES"></a>
-<h3 class="appendixsec">A.4 REFERENCES</h3>
+<span id="REFERENCES"></span><h3 class="appendixsec">A.4 REFERENCES</h3>
<p>Post-installation configuration, package updates, and much more, are
handled through <strong>tlmgr</strong>(1), the TeX Live Manager
@@ -3477,13 +3359,11 @@ Internet at <a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/
<a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
</p>
<hr>
-<a name="install_002dtl-OPTIONS"></a>
-<div class="header">
+<span id="install_002dtl-OPTIONS"></span><div class="header">
<p>
Next: <a href="#install_002dtl-PROFILES" accesskey="n" rel="next">install-tl PROFILES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">install-tl REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="OPTIONS"></a>
-<h3 class="appendixsec">A.5 OPTIONS</h3>
+<span id="OPTIONS"></span><h3 class="appendixsec">A.5 OPTIONS</h3>
<p>As usual, all options can be specified in any order, and with either a
leading <code>-</code> or <code>--</code>. An argument value can be separated from its
@@ -3491,7 +3371,7 @@ option by either a space or <code>=</code>.
</p>
<dl compact="compact">
<dt><strong>-gui</strong> [[=]<em>module</em>]</dt>
-<dd><a name="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></a>
+<dd><span id="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></span>
<p>If no <em>module</em> is given, starts the <code>perltk</code> (see below) GUI installer.
</p>
<p>If <em>module</em> is given loads the given installer module. Currently the
@@ -3499,19 +3379,19 @@ following modules are supported:
</p>
<dl compact="compact">
<dt><code>text</code></dt>
-<dd><a name="install_002dtl-text"></a>
+<dd><span id="install_002dtl-text"></span>
<p>The text mode user interface (default on Unix systems). Same as the
<code>-no-gui</code> option.
</p>
</dd>
<dt><code>wizard</code></dt>
-<dd><a name="install_002dtl-wizard"></a>
+<dd><span id="install_002dtl-wizard"></span>
<p>The wizard mode user interface (default on Windows), asking only minimal
questions before installing all of TeX Live.
</p>
</dd>
<dt><code>perltk</code></dt>
-<dd><a name="install_002dtl-perltk"></a>
+<dd><span id="install_002dtl-perltk"></span>
<p>The expert GUI installer, providing access to more options.
Can also be invoked on Windows by running <code>install-tl-advanced.bat</code>.
</p>
@@ -3525,12 +3405,12 @@ available, installation continues in text mode.
</p>
</dd>
<dt><strong>-no-gui</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dgui"></a>
+<dd><span id="install_002dtl-_002dno_002dgui"></span>
<p>Use the text mode installer (default except on Windows).
</p>
</dd>
<dt><strong>-lang</strong> <em>llcode</em></dt>
-<dd><a name="install_002dtl-_002dlang-llcode"></a>
+<dd><span id="install_002dtl-_002dlang-llcode"></span>
<p>By default, the GUI tries to deduce your language from the environment
(on Windows via the registry, on Unix via <code>LC_MESSAGES</code>). If that fails
you can select a different language by giving this option with a
@@ -3543,7 +3423,7 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
</p>
</dd>
<dt><strong>-repository</strong> <em>url|path</em></dt>
-<dd><a name="install_002dtl-_002drepository-url_007cpath"></a>
+<dd><span id="install_002dtl-_002drepository-url_007cpath"></span>
<p>Specify the package repository to be used as the source of the
installation, either a local directory via <code>/path/to/directory</code> or a
<code>file:/</code> url, or a network location via a <code>http://</code>, <code>https://</code>, or
@@ -3584,7 +3464,7 @@ are accepted as aliases for this option.
</p>
</dd>
<dt><strong>-select-repository</strong></dt>
-<dd><a name="install_002dtl-_002dselect_002drepository"></a>
+<dd><span id="install_002dtl-_002dselect_002drepository"></span>
<p>This option allows manual selection of a mirror from the current list of
active CTAN mirrors. This option is supported in all installer modes
(text, wizard, perltk), and will also offer to install from local media
@@ -3594,7 +3474,7 @@ choose a good host for you.
</p>
</dd>
<dt><strong>-all-options</strong></dt>
-<dd><a name="install_002dtl-_002dall_002doptions"></a>
+<dd><span id="install_002dtl-_002dall_002doptions"></span>
<p>Normally options not relevant to the current platform are not shown
(e.g., when running on Unix, Windows-specific options are omitted).
Giving this command line option allows configuring such &quot;foreign&quot;
@@ -3602,7 +3482,7 @@ settings.
</p>
</dd>
<dt><strong>-custom-bin</strong> <em>path</em></dt>
-<dd><a name="install_002dtl-_002dcustom_002dbin-path"></a>
+<dd><span id="install_002dtl-_002dcustom_002dbin-path"></span>
<p>If you have built your own set of TeX Live binaries (perhaps because
your platform was not supported by TeX Live out of the box), this option
allows you to specify the <em>path</em> to a directory where the binaries for
@@ -3610,7 +3490,7 @@ the current system are present. The installation will continue as
usual, but at the end all files from <em>path</em> are copied over to
<code>bin/custom/</code> under your installation directory and this <code>bin/custom/</code>
directory is what will be added to the path for the post-install
-actions. To install multiple custom binary sets, manully rename
+actions. To install multiple custom binary sets, manually rename
<code>custom</code> before doing each.
</p>
<p>For more information on custom binaries, see
@@ -3619,21 +3499,21 @@ building TeX Live, see <a href="http://tug.org/texlive/build.html">http://tug.or
</p>
</dd>
<dt><strong>-debug-translation</strong></dt>
-<dd><a name="install_002dtl-_002ddebug_002dtranslation"></a>
+<dd><span id="install_002dtl-_002ddebug_002dtranslation"></span>
<p>In GUI mode, this switch makes <code>tlmgr</code> report any missing, or more
likely untranslated, messages to standard error. Helpful for
translators to see what remains to be done.
</p>
</dd>
<dt><strong>-force-platform</strong> <em>platform</em></dt>
-<dd><a name="install_002dtl-_002dforce_002dplatform-platform"></a>
+<dd><span id="install_002dtl-_002dforce_002dplatform-platform"></span>
<p>Instead of auto-detecting the current platform, use <em>platform</em>.
Binaries for this platform must be present and they must actually be
runnable, or installation will fail. <code>-force-arch</code> is a synonym.
</p>
</dd>
<dt><strong>-help</strong>, <strong>&ndash;help</strong>, <strong>-?</strong></dt>
-<dd><a name="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></a>
+<dd><span id="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></span>
<p>Display this help and exit. (This help is on the web at
<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>). Sometimes the
<code>perldoc</code> and/or <code>PAGER</code> programs on the system have problems,
@@ -3643,7 +3523,7 @@ variable and <code>perldoc</code> will not be used.
</p>
</dd>
<dt><strong>-in-place</strong></dt>
-<dd><a name="install_002dtl-_002din_002dplace"></a>
+<dd><span id="install_002dtl-_002din_002dplace"></span>
<p>This is a quick-and-dirty installation option in case you already have
an rsync or svn checkout of TeX Live. It will use the checkout as-is
and will just do the necessary post-install. Be warned that the file
@@ -3654,14 +3534,14 @@ installer interfaces. USE AT YOUR OWN RISK.
</p>
</dd>
<dt><strong>-init-from-profile</strong> <em>profile_file</em></dt>
-<dd><a name="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></a>
+<dd><span id="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></span>
<p>Similar to <strong>-profile</strong> (see <a href="#install_002dtl-PROFILES">PROFILES</a> below), but only initializes the
installation configuration from <em>profile_file</em> and then starts the
interactive session.
</p>
</dd>
<dt><strong>-logfile</strong> <em>file</em></dt>
-<dd><a name="install_002dtl-_002dlogfile-file"></a>
+<dd><span id="install_002dtl-_002dlogfile-file"></span>
<p>Write both all messages (informational, debugging, warnings) to <em>file</em>,
in addition to standard output or standard error.
</p>
@@ -3672,21 +3552,21 @@ release.
</p>
</dd>
<dt><strong>-no-cls</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dcls"></a>
+<dd><span id="install_002dtl-_002dno_002dcls"></span>
<p>For the text mode installer only: do not clear the screen when entering
a new menu (for debugging purposes).
</p>
</dd>
<dt><strong>-non-admin</strong></dt>
-<dd><a name="install_002dtl-_002dnon_002dadmin"></a>
+<dd><span id="install_002dtl-_002dnon_002dadmin"></span>
<p>For Windows only: configure for the current user, not for all users.
</p>
</dd>
<dt><strong>-persistent-downloads</strong></dt>
-<dd><a name="install_002dtl-_002dpersistent_002ddownloads"></a>
+<dd><span id="install_002dtl-_002dpersistent_002ddownloads"></span>
</dd>
<dt><strong>-no-persistent-downloads</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dpersistent_002ddownloads"></a>
+<dd><span id="install_002dtl-_002dno_002dpersistent_002ddownloads"></span>
<p>For network installs, activating this option makes the installer try to
set up a persistent connection using the <code>Net::LWP</code> Perl module. This
opens only one connection between your computer and the server per
@@ -3699,7 +3579,7 @@ LWP and persistent connections, use <code>-no-persistent-downloads</code>.
</p>
</dd>
<dt><strong>-no-verify-downloads</strong></dt>
-<dd><a name="install_002dtl-_002dno_002dverify_002ddownloads"></a>
+<dd><span id="install_002dtl-_002dno_002dverify_002ddownloads"></span>
<p>By default, if a GnuPG <code>gpg</code> binary is found in PATH, downloads are
verified against a cryptographic signature. This option disables such
verification. The full description is in the Crytographic Verification
@@ -3708,31 +3588,31 @@ section of the <code>tlmgr</code> documentation, e.g.,
</p>
</dd>
<dt><strong>-portable</strong></dt>
-<dd><a name="install_002dtl-_002dportable"></a>
+<dd><span id="install_002dtl-_002dportable"></span>
<p>Install for portable use, e.g., on a USB stick. Also selectable from
within the perltk and text installers.
</p>
</dd>
<dt><strong>-print-platform</strong></dt>
-<dd><a name="install_002dtl-_002dprint_002dplatform"></a>
+<dd><span id="install_002dtl-_002dprint_002dplatform"></span>
<p>Print the TeX Live identifier for the detected platform
(hardware/operating system) combination to standard output, and exit.
<code>-print-arch</code> is a synonym.
</p>
</dd>
<dt><strong>-profile</strong> <em>profile_file</em></dt>
-<dd><a name="install_002dtl-_002dprofile-profile_005ffile"></a>
+<dd><span id="install_002dtl-_002dprofile-profile_005ffile"></span>
<p>Load <em>profile_file</em> and do the installation with no user interaction,
that is, a batch (unattended) install. See <a href="#install_002dtl-PROFILES">PROFILES</a> below.
</p>
</dd>
<dt><strong>-q</strong></dt>
-<dd><a name="install_002dtl-_002dq"></a>
+<dd><span id="install_002dtl-_002dq"></span>
<p>Omit normal informational messages.
</p>
</dd>
<dt><strong>-scheme</strong> <em>scheme</em></dt>
-<dd><a name="install_002dtl-_002dscheme-scheme"></a>
+<dd><span id="install_002dtl-_002dscheme-scheme"></span>
<p>Schemes are the highest level of package grouping in TeX Live; the
default is to use the <code>full</code> scheme, which includes everything. This
option overrides that default. You can change the scheme again before
@@ -3743,13 +3623,13 @@ menu list.
</p>
</dd>
<dt><strong>-v</strong></dt>
-<dd><a name="install_002dtl-_002dv"></a>
+<dd><span id="install_002dtl-_002dv"></span>
<p>Include verbose debugging messages; repeat for maximum debugging: <code>-v
-v</code>. (Further repeats are accepted but ignored.)
</p>
</dd>
<dt><strong>-version</strong>, <strong>&ndash;version</strong></dt>
-<dd><a name="install_002dtl-_002dversion_002c-_002d_002dversion"></a>
+<dd><span id="install_002dtl-_002dversion_002c-_002d_002dversion"></span>
<p>Output version information and exit. If <code>-v</code> has also been given the
revisions of the used modules are reported, too.
</p>
@@ -3757,13 +3637,11 @@ revisions of the used modules are reported, too.
</dl>
<hr>
-<a name="install_002dtl-PROFILES"></a>
-<div class="header">
+<span id="install_002dtl-PROFILES"></span><div class="header">
<p>
Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">install-tl ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">install-tl OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="PROFILES"></a>
-<h3 class="appendixsec">A.6 PROFILES</h3>
+<span id="PROFILES"></span><h3 class="appendixsec">A.6 PROFILES</h3>
<p>A <em>profile</em> file contains all the values needed to perform an
installation. After a normal installation has finished, a profile for
@@ -3831,28 +3709,28 @@ that could cause problems later.
</p>
<dl compact="compact">
<dt><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</dt>
-<dd><a name="install_002dtl-instopt_005fadjustpath-_0028default-0-on-Unix_002c-1-on-Windows_0029"></a>
+<dd><span id="install_002dtl-instopt_005fadjustpath-_0028default-0-on-Unix_002c-1-on-Windows_0029"></span>
<p>Adjust <code>PATH</code> environment variable.
</p>
</dd>
<dt><code>instopt_adjustrepo</code> (default 1)</dt>
-<dd><a name="install_002dtl-instopt_005fadjustrepo-_0028default-1_0029"></a>
+<dd><span id="install_002dtl-instopt_005fadjustrepo-_0028default-1_0029"></span>
<p>Set remote repository to a multiplexed CTAN mirror after installation;
see <code>-repository</code> above.
</p>
</dd>
<dt><code>instopt_letter</code> (default 0)</dt>
-<dd><a name="install_002dtl-instopt_005fletter-_0028default-0_0029"></a>
+<dd><span id="install_002dtl-instopt_005fletter-_0028default-0_0029"></span>
<p>Set letter size paper as the default, instead of a4.
</p>
</dd>
<dt><code>instopt_portable</code> (default 0)</dt>
-<dd><a name="install_002dtl-instopt_005fportable-_0028default-0_0029"></a>
+<dd><span id="install_002dtl-instopt_005fportable-_0028default-0_0029"></span>
<p>Install for portable use, e.g., on a USB stick.
</p>
</dd>
<dt><code>instopt_write18_restricted</code> (default 1)</dt>
-<dd><a name="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></a>
+<dd><span id="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></span>
<p>Enable <code>\write18</code> for a restricted set of programs.
</p>
</dd>
@@ -3898,13 +3776,11 @@ written, the names above are always used.
installation manual, linked from <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
</p>
<hr>
-<a name="install_002dtl-ENVIRONMENT-VARIABLES"></a>
-<div class="header">
+<span id="install_002dtl-ENVIRONMENT-VARIABLES"></span><div class="header">
<p>
Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">install-tl AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-PROFILES" accesskey="p" rel="prev">install-tl PROFILES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="ENVIRONMENT-VARIABLES"></a>
-<h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3>
+<span id="ENVIRONMENT-VARIABLES"></span><h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3>
<p>For ease in scripting and debugging, <code>install-tl</code> will look for the
following environment variables. They are not of interest for normal
@@ -3912,46 +3788,46 @@ user installations.
</p>
<dl compact="compact">
<dt><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></span>
<p>Omit the check for environment variables containing the string <code>tex</code>.
People developing TeX-related software are likely to have many such
variables.
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_NO_CONTEXT_CACHE</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fCONTEXT_005fCACHE"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fCONTEXT_005fCACHE"></span>
<p>Omit creating the ConTeXt cache. This is useful for redistributors.
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_NO_WELCOME</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></span>
<p>Omit printing the welcome message after successful installation, e.g.,
for testing.
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_PREFIX</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXDIR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFVAR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFHOME</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFLOCAL</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFLOCAL"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFLOCAL"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFSYSCONFIG</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSCONFIG"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSCONFIG"></span>
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSVAR"></a>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSVAR"></span>
<p>Specify the respective directories. <code>TEXLIVE_INSTALL_PREFIX</code> defaults
to <code>/usr/local/texlive</code>, while <code>TEXLIVE_INSTALL_TEXDIR</code> defaults to
the release directory within that prefix, e.g.,
@@ -3960,20 +3836,18 @@ installer interactively and then typing <code>D</code> for the directory menu.
</p>
</dd>
<dt><code>NOPERLDOC</code></dt>
-<dd><a name="install_002dtl-NOPERLDOC"></a>
+<dd><span id="install_002dtl-NOPERLDOC"></span>
<p>Don&rsquo;t try to run the <code>--help</code> message through <code>perldoc</code>.
</p>
</dd>
</dl>
<hr>
-<a name="install_002dtl-AUTHORS-AND-COPYRIGHT"></a>
-<div class="header">
+<span id="install_002dtl-AUTHORS-AND-COPYRIGHT"></span><div class="header">
<p>
Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">install-tl ENVIRONMENT VARIABLES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="AUTHORS-AND-COPYRIGHT"></a>
-<h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3>
+<span id="AUTHORS-AND-COPYRIGHT"></span><h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3>
<p>This script and its documentation were written for the TeX Live
distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the
@@ -3982,73 +3856,65 @@ GNU General Public License Version 2 or later.
<p>$Id: install-tl 46908 2018-03-10 00:46:28Z preining $
</p>
<hr>
-<a name="tlmgr"></a>
-<div class="header">
+<span id="tlmgr"></span><div class="header">
<p>
Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#install_002dtl" accesskey="p" rel="prev">install-tl</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="tlmgr-1"></a>
-<h2 class="appendix">Appendix B tlmgr</h2>
+<span id="tlmgr-1"></span><h2 class="appendix">Appendix B tlmgr</h2>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-NAME" accesskey="1">tlmgr NAME</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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-AUTHORS-AND-COPYRIGHT">tlmgr AUTHORS AND COPYRIGHT</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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>
<hr>
-<a name="tlmgr-NAME"></a>
-<div class="header">
+<span id="tlmgr-NAME"></span><div class="header">
<p>
Next: <a href="#tlmgr-SYNOPSIS" accesskey="n" rel="next">tlmgr SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="NAME-1"></a>
-<h3 class="appendixsec">B.1 NAME</h3>
+<span id="NAME-1"></span><h3 class="appendixsec">B.1 NAME</h3>
<p>tlmgr - the native TeX Live Manager
</p>
<hr>
-<a name="tlmgr-SYNOPSIS"></a>
-<div class="header">
+<span id="tlmgr-SYNOPSIS"></span><div class="header">
<p>
Next: <a href="#tlmgr-DESCRIPTION" accesskey="n" rel="next">tlmgr DESCRIPTION</a>, Previous: <a href="#tlmgr-NAME" accesskey="p" rel="prev">tlmgr NAME</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="SYNOPSIS-1"></a>
-<h3 class="appendixsec">B.2 SYNOPSIS</h3>
+<span id="SYNOPSIS-1"></span><h3 class="appendixsec">B.2 SYNOPSIS</h3>
<p>tlmgr [<em>option</em>...] <em>action</em> [<em>option</em>...] [<em>operand</em>...]
</p>
<hr>
-<a name="tlmgr-DESCRIPTION"></a>
-<div class="header">
+<span id="tlmgr-DESCRIPTION"></span><div class="header">
<p>
Next: <a href="#tlmgr-EXAMPLES" accesskey="n" rel="next">tlmgr EXAMPLES</a>, Previous: <a href="#tlmgr-SYNOPSIS" accesskey="p" rel="prev">tlmgr SYNOPSIS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="DESCRIPTION-1"></a>
-<h3 class="appendixsec">B.3 DESCRIPTION</h3>
+<span id="DESCRIPTION-1"></span><h3 class="appendixsec">B.3 DESCRIPTION</h3>
<p><strong>tlmgr</strong> manages an existing TeX Live installation, both packages and
configuration options. For information on initially downloading and
@@ -4070,23 +3936,21 @@ A TeX Live installation can be customized and managed at any level.
available.
</p>
<hr>
-<a name="tlmgr-EXAMPLES"></a>
-<div class="header">
+<span id="tlmgr-EXAMPLES"></span><div class="header">
<p>
Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">tlmgr OPTIONS</a>, Previous: <a href="#tlmgr-DESCRIPTION" accesskey="p" rel="prev">tlmgr DESCRIPTION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="EXAMPLES"></a>
-<h3 class="appendixsec">B.4 EXAMPLES</h3>
+<span id="EXAMPLES"></span><h3 class="appendixsec">B.4 EXAMPLES</h3>
<p>After successfully installing TeX Live, here are a few common operations
with <code>tlmgr</code>:
</p>
<dl compact="compact">
<dt><code>tlmgr option repository ctan</code></dt>
-<dd><a name="tlmgr-tlmgr-option-repository-ctan"></a>
+<dd><span id="tlmgr-tlmgr-option-repository-ctan"></span>
</dd>
<dt><code>tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet</code></dt>
-<dd><a name="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></a>
+<dd><span id="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span>
<p>Tell <code>tlmgr</code> to use a nearby CTAN mirror for future updates; useful if
you installed TeX Live from the DVD image and want to have continuing
updates. The two commands are equivalent; <code>ctan</code> is just an alias for
@@ -4096,18 +3960,18 @@ only daily (at most), and not more often.
</p>
</dd>
<dt><code>tlmgr update --list</code></dt>
-<dd><a name="tlmgr-tlmgr-update-_002d_002dlist"></a>
+<dd><span id="tlmgr-tlmgr-update-_002d_002dlist"></span>
<p>Report what would be updated without actually updating anything.
</p>
</dd>
<dt><code>tlmgr update --all</code></dt>
-<dd><a name="tlmgr-tlmgr-update-_002d_002dall"></a>
+<dd><span id="tlmgr-tlmgr-update-_002d_002dall"></span>
<p>Make your local TeX installation correspond to what is in the package
repository (typically useful when updating from CTAN).
</p>
</dd>
<dt><code>tlmgr info</code> <em>what</em></dt>
-<dd><a name="tlmgr-tlmgr-info-what"></a>
+<dd><span id="tlmgr-tlmgr-info-what"></span>
<p>Display detailed information about a package <em>what</em>, such as the installation
status and description, of searches for <em>what</em> in all packages.
</p>
@@ -4118,13 +3982,11 @@ status and description, of searches for <em>what</em> in all packages.
following voluminous information.
</p>
<hr>
-<a name="tlmgr-OPTIONS"></a>
-<div class="header">
+<span id="tlmgr-OPTIONS"></span><div class="header">
<p>
Next: <a href="#tlmgr-ACTIONS" accesskey="n" rel="next">tlmgr ACTIONS</a>, Previous: <a href="#tlmgr-EXAMPLES" accesskey="p" rel="prev">tlmgr EXAMPLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="OPTIONS-1"></a>
-<h3 class="appendixsec">B.5 OPTIONS</h3>
+<span id="OPTIONS-1"></span><h3 class="appendixsec">B.5 OPTIONS</h3>
<p>The following options to <code>tlmgr</code> are global options, not specific to
any action. All options, whether global or action-specific, can be
@@ -4135,7 +3997,7 @@ between an option name and its value.
</p>
<dl compact="compact">
<dt><strong>&ndash;repository</strong> <em>url|path</em></dt>
-<dd><a name="tlmgr-_002d_002drepository-url_007cpath"></a>
+<dd><span id="tlmgr-_002d_002drepository-url_007cpath"></span>
<p>Specifies the package repository from which packages should be installed
or updated, overriding the default package repository found in the
installation&rsquo;s TeX Live Package Database (a.k.a. the TLPDB, defined
@@ -4152,7 +4014,7 @@ are accepted as aliases for this option.
</p>
</dd>
<dt><strong>&ndash;gui</strong> [<em>action</em>]</dt>
-<dd><a name="tlmgr-_002d_002dgui-_005baction_005d"></a>
+<dd><span id="tlmgr-_002d_002dgui-_005baction_005d"></span>
<p><code>tlmgr</code> has a graphical interface as well as the command line
interface. You can give this option, <code>--gui</code>, together with an action
to be brought directly into the respective screen of the GUI. For
@@ -4165,7 +4027,7 @@ GUI will be started at the main screen.
</p>
</dd>
<dt><strong>&ndash;gui-lang</strong> <em>llcode</em></dt>
-<dd><a name="tlmgr-_002d_002dgui_002dlang-llcode"></a>
+<dd><span id="tlmgr-_002d_002dgui_002dlang-llcode"></span>
<p>By default, the GUI tries to deduce your language from the environment
(on Windows via the registry, on Unix via <code>LC_MESSAGES</code>). If that fails
you can select a different language by giving this option with a
@@ -4178,28 +4040,28 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
</p>
</dd>
<dt><strong>&ndash;debug-translation</strong></dt>
-<dd><a name="tlmgr-_002d_002ddebug_002dtranslation"></a>
+<dd><span id="tlmgr-_002d_002ddebug_002dtranslation"></span>
<p>In GUI mode, this switch tells <code>tlmgr</code> to report any untranslated (or
missing) messages to standard error. This can help translators to see
what remains to be done.
</p>
</dd>
<dt><strong>&ndash;machine-readable</strong></dt>
-<dd><a name="tlmgr-_002d_002dmachine_002dreadable"></a>
+<dd><span id="tlmgr-_002d_002dmachine_002dreadable"></span>
<p>Instead of the normal output intended for human consumption, write (to
standard output) a fixed format more suitable for machine parsing. See
the <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">MACHINE-READABLE OUTPUT</a> section below.
</p>
</dd>
<dt><strong>&ndash;no-execute-actions</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002dexecute_002dactions"></a>
+<dd><span id="tlmgr-_002d_002dno_002dexecute_002dactions"></span>
<p>Suppress the execution of the execute actions as defined in the tlpsrc
files. Documented only for completeness, as this is only useful in
debugging.
</p>
</dd>
<dt><strong>&ndash;package-logfile</strong> <em>file</em></dt>
-<dd><a name="tlmgr-_002d_002dpackage_002dlogfile-file"></a>
+<dd><span id="tlmgr-_002d_002dpackage_002dlogfile-file"></span>
<p><code>tlmgr</code> logs all package actions (install, remove, update, failed
updates, failed restores) to a separate log file, by default
<code>TEXMFSYSVAR/web2c/tlmgr.log</code>. This option allows you to specify a
@@ -4207,16 +4069,16 @@ different file for the log.
</p>
</dd>
<dt><strong>&ndash;pause</strong></dt>
-<dd><a name="tlmgr-_002d_002dpause"></a>
+<dd><span id="tlmgr-_002d_002dpause"></span>
<p>This option makes <code>tlmgr</code> wait for user input before exiting. Useful on
Windows to avoid disappearing command windows.
</p>
</dd>
<dt><strong>&ndash;persistent-downloads</strong></dt>
-<dd><a name="tlmgr-_002d_002dpersistent_002ddownloads"></a>
+<dd><span id="tlmgr-_002d_002dpersistent_002ddownloads"></span>
</dd>
<dt><strong>&ndash;no-persistent-downloads</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002dpersistent_002ddownloads"></a>
+<dd><span id="tlmgr-_002d_002dno_002dpersistent_002ddownloads"></span>
<p>For network-based installations, this option (on by default) makes
<code>tlmgr</code> try to set up a persistent connection (using the <code>LWP</code> Perl
module). The idea is to open and reuse only one connection per session
@@ -4228,24 +4090,24 @@ disable these persistent connections, use <code>--no-persistent-downloads</code>
</p>
</dd>
<dt><strong>&ndash;pin-file</strong></dt>
-<dd><a name="tlmgr-_002d_002dpin_002dfile"></a>
+<dd><span id="tlmgr-_002d_002dpin_002dfile"></span>
<p>Change the pinning file location from <code>TEXMFLOCAL/tlpkg/pinning.txt</code>
(see <a href="#tlmgr-Pinning">Pinning</a> below). Documented only for completeness, as this is
only useful in debugging.
</p>
</dd>
<dt><strong>&ndash;usermode</strong></dt>
-<dd><a name="tlmgr-_002d_002dusermode"></a>
+<dd><span id="tlmgr-_002d_002dusermode"></span>
<p>Activates user mode for this run of <code>tlmgr</code>; see <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
</dd>
<dt><strong>&ndash;usertree</strong> <em>dir</em></dt>
-<dd><a name="tlmgr-_002d_002dusertree-dir"></a>
+<dd><span id="tlmgr-_002d_002dusertree-dir"></span>
<p>Uses <em>dir</em> for the tree in user mode; see <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
</dd>
<dt><strong>&ndash;verify-repo=[none|main|all]</strong></dt>
-<dd><a name="tlmgr-_002d_002dverify_002drepo_003d_005bnone_007cmain_007call_005d"></a>
+<dd><span id="tlmgr-_002d_002dverify_002drepo_003d_005bnone_007cmain_007call_005d"></span>
<p>Defines the level of verification done: If <code>none</code> is specified, no
verification whatsoever is done. If <code>main</code> is given and a working GnuPG
(<code>gpg</code>) binary is available, all repositories are checked, but only the
@@ -4266,85 +4128,81 @@ release and about the <code>tlmgr</code> script itself. If <code>-v</code> is a
revision number for the loaded TeX Live Perl modules are shown, too.
</p>
<hr>
-<a name="tlmgr-ACTIONS"></a>
-<div class="header">
+<span id="tlmgr-ACTIONS"></span><div class="header">
<p>
Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">tlmgr OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="ACTIONS"></a>
-<h3 class="appendixsec">B.6 ACTIONS</h3>
+<span id="ACTIONS"></span><h3 class="appendixsec">B.6 ACTIONS</h3>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-help" accesskey="1">tlmgr help</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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">
+<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-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></td><td>&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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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">
+<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>
<hr>
-<a name="tlmgr-help"></a>
-<div class="header">
+<span id="tlmgr-help"></span><div class="header">
<p>
Next: <a href="#tlmgr-version" accesskey="n" rel="next">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="help"></a>
-<h4 class="appendixsubsec">B.6.1 help</h4>
+<span id="help"></span><h4 class="appendixsubsec">B.6.1 help</h4>
<p>Display this help information and exit (same as <code>--help</code>, and on the
web at <a href="http://tug.org/texlive/doc/tlmgr.html">http://tug.org/texlive/doc/tlmgr.html</a>). Sometimes the
@@ -4354,33 +4212,29 @@ always be detected, but you can set the <code>NOPERLDOC</code> environment
variable and <code>perldoc</code> will not be used.
</p>
<hr>
-<a name="tlmgr-version"></a>
-<div class="header">
+<span id="tlmgr-version"></span><div class="header">
<p>
Next: <a href="#tlmgr-backup" accesskey="n" rel="next">tlmgr backup</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">tlmgr help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="version"></a>
-<h4 class="appendixsubsec">B.6.2 version</h4>
+<span id="version"></span><h4 class="appendixsubsec">B.6.2 version</h4>
<p>Gives version information (same as <code>--version</code>).
</p>
<p>If <code>-v</code> has been given the revisions of the used modules are reported, too.
</p>
<hr>
-<a name="tlmgr-backup"></a>
-<div class="header">
+<span id="tlmgr-backup"></span><div class="header">
<p>
Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">tlmgr candidates <em>pkg</em></a>, Previous: <a href="#tlmgr-version" accesskey="p" rel="prev">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="backup"></a>
-<h4 class="appendixsubsec">B.6.3 backup</h4>
+<span id="backup"></span><h4 class="appendixsubsec">B.6.3 backup</h4>
<dl compact="compact">
<dt><strong>backup [<em>option</em>...] &ndash;all</strong></dt>
-<dd><a name="tlmgr-backup-_005boption_002e_002e_002e_005d-_002d_002dall"></a>
+<dd><span id="tlmgr-backup-_005boption_002e_002e_002e_005d-_002d_002dall"></span>
</dd>
<dt><strong>backup [<em>option</em>...] <em>pkg</em>...</strong></dt>
-<dd><a name="tlmgr-backup-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+<dd><span id="tlmgr-backup-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span>
<p>If the <code>--clean</code> option is not specified, this action makes a backup of
the given packages, or all packages given <code>--all</code>. These backups are
saved to the value of the <code>--backupdir</code> option, if that is an existing and
@@ -4399,21 +4253,21 @@ the <code>option</code> action.
</p>
<dl compact="compact">
<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory"></span>
<p>Overrides the <code>backupdir</code> option setting in the TLPDB.
The <em>directory</em> argument is required and must specify an existing,
writable directory where backups are to be placed.
</p>
</dd>
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall"></a>
+<dd><span id="tlmgr-_002d_002dall"></span>
<p>If <code>--clean</code> is not specified, make a backup of all packages in the TeX
Live installation; this will take quite a lot of space and time. If
<code>--clean</code> is specified, all packages are pruned.
</p>
</dd>
<dt><strong>&ndash;clean</strong>[=<em>N</em>]</dt>
-<dd><a name="tlmgr-_002d_002dclean_005b_003dN_005d"></a>
+<dd><span id="tlmgr-_002d_002dclean_005b_003dN_005d"></span>
<p>Instead of making backups, prune the backup directory of old backups, as
explained above. The optional integer argument <em>N</em> overrides the
<code>autobackup</code> option set in the TLPDB. You must use <code>--all</code> or a list
@@ -4421,7 +4275,7 @@ of packages together with this option, as desired.
</p>
</dd>
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun"></span>
<p>Nothing is actually backed up or removed; instead, the actions to be
performed are written to the terminal.
</p>
@@ -4432,37 +4286,33 @@ performed are written to the terminal.
</dl>
<hr>
-<a name="tlmgr-candidates-pkg"></a>
-<div class="header">
+<span id="tlmgr-candidates-pkg"></span><div class="header">
<p>
Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">tlmgr backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="candidates-pkg"></a>
-<h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
+<span id="candidates-pkg"></span><h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
<p>Shows the available candidate repositories for package <em>pkg</em>.
See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below.
</p>
<hr>
-<a name="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
-<div class="header">
+<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><div class="header">
<p>
Next: <a href="#tlmgr-conf" accesskey="n" rel="next">tlmgr conf</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">tlmgr candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
-<h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</h4>
+<span id="check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</h4>
<p>Executes one (or all) check(s) on the consistency of the installation.
</p>
<dl compact="compact">
<dt><strong>files</strong></dt>
-<dd><a name="tlmgr-files"></a>
+<dd><span id="tlmgr-files"></span>
<p>Checks that all files listed in the local TLPDB (<code>texlive.tlpdb</code>) are
actually present, and lists those missing.
</p>
</dd>
<dt><strong>depends</strong></dt>
-<dd><a name="tlmgr-depends"></a>
+<dd><span id="tlmgr-depends"></span>
<p>Lists those packages which occur as dependencies in an installed collection,
but are themselves not installed, and those packages which are not
contained in any collection.
@@ -4472,13 +4322,13 @@ instead since former versions for <code>tlmgr</code> called it that way.
</p>
</dd>
<dt><strong>executes</strong></dt>
-<dd><a name="tlmgr-executes"></a>
+<dd><span id="tlmgr-executes"></span>
<p>Check that the files referred to by <code>execute</code> directives in the TeX
Live Database are present.
</p>
</dd>
<dt><strong>runfiles</strong></dt>
-<dd><a name="tlmgr-runfiles"></a>
+<dd><span id="tlmgr-runfiles"></span>
<p>List those filenames that are occurring more than one time in the
runfiles sections.
</p>
@@ -4489,7 +4339,7 @@ runfiles sections.
</p>
<dl compact="compact">
<dt><strong>&ndash;use-svn</strong></dt>
-<dd><a name="tlmgr-_002d_002duse_002dsvn"></a>
+<dd><span id="tlmgr-_002d_002duse_002dsvn"></span>
<p>Use the output of <code>svn status</code> instead of listing the files; for
checking the TL development repository.
</p>
@@ -4497,20 +4347,18 @@ checking the TL development repository.
</dl>
<hr>
-<a name="tlmgr-conf"></a>
-<div class="header">
+<span id="tlmgr-conf"></span><div class="header">
<p>
Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="conf"></a>
-<h4 class="appendixsubsec">B.6.6 conf</h4>
+<span id="conf"></span><h4 class="appendixsubsec">B.6.6 conf</h4>
<dl compact="compact">
<dt><strong>conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</strong></dt>
-<dd><a name="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></a>
+<dd><span id="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></span>
</dd>
<dt><strong>conf auxtrees [&ndash;conffile <em>file</em>] [show|add|delete] [<em>value</em>]</strong></dt>
-<dd><a name="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></a>
+<dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></span>
<p>With only <code>conf</code>, show general configuration information for TeX Live,
including active configuration files, path settings, and more. This is
like running <code>texconfig conf</code>, but works on all supported platforms.
@@ -4562,13 +4410,11 @@ breakage is possible.
</dl>
<hr>
-<a name="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></a>
-<div class="header">
+<span id="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><div class="header">
<p>
Next: <a href="#tlmgr-generate" accesskey="n" rel="next">tlmgr generate</a>, Previous: <a href="#tlmgr-conf" accesskey="p" rel="prev">tlmgr conf</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></a>
-<h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</h4>
+<span id="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></span><h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</h4>
<p>Dump complete local or remote TLPDB to standard output, as-is. The
output is analogous to the <code>--machine-readable</code> output; see
@@ -4578,17 +4424,17 @@ output is analogous to the <code>--machine-readable</code> output; see
</p>
<dl compact="compact">
<dt><strong>&ndash;local</strong></dt>
-<dd><a name="tlmgr-_002d_002dlocal"></a>
+<dd><span id="tlmgr-_002d_002dlocal"></span>
<p>Dump the local TLPDB.
</p>
</dd>
<dt><strong>&ndash;remote</strong></dt>
-<dd><a name="tlmgr-_002d_002dremote"></a>
+<dd><span id="tlmgr-_002d_002dremote"></span>
<p>Dump the remote TLPDB.
</p>
</dd>
<dt><strong>&ndash;json</strong></dt>
-<dd><a name="tlmgr-_002d_002djson"></a>
+<dd><span id="tlmgr-_002d_002djson"></span>
<p>Instead of dumping the actual content, the database is dumped as
JSON. For the format of JSON output see <code>tlpkg/doc/JSON-formats.txt</code>,
format definition <code>TLPDB</code>.
@@ -4609,26 +4455,24 @@ location, in this format:
<p>Line endings may be either LF or CRLF depending on the current platform.
</p>
<hr>
-<a name="tlmgr-generate"></a>
-<div class="header">
+<span id="tlmgr-generate"></span><div class="header">
<p>
Next: <a href="#tlmgr-gui" accesskey="n" rel="next">tlmgr gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="p" rel="prev">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="generate"></a>
-<h4 class="appendixsubsec">B.6.8 generate</h4>
+<span id="generate"></span><h4 class="appendixsubsec">B.6.8 generate</h4>
<dl compact="compact">
<dt><strong>generate [<em>option</em>...] language</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></span>
</dd>
<dt><strong>generate [<em>option</em>...] language.dat</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></span>
</dd>
<dt><strong>generate [<em>option</em>...] language.def</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edef"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edef"></span>
</dd>
<dt><strong>generate [<em>option</em>...] language.dat.lua</strong></dt>
-<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></a>
+<dd><span id="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></span>
</dd>
</dl>
@@ -4693,7 +4537,7 @@ extension recreates only that given language file.
</p>
<dl compact="compact">
<dt><strong>&ndash;dest</strong> <em>output_file</em></dt>
-<dd><a name="tlmgr-_002d_002ddest-output_005ffile"></a>
+<dd><span id="tlmgr-_002d_002ddest-output_005ffile"></span>
<p>specifies the output file (defaults to the respective location in
<code>TEXMFSYSVAR</code>). If <code>--dest</code> is given to <code>generate language</code>, it
serves as a basename onto which <code>.dat</code> will be appended for the name of
@@ -4705,13 +4549,13 @@ recommend invoking <code>tlmgr</code> twice.)
</p>
</dd>
<dt><strong>&ndash;localcfg</strong> <em>local_conf_file</em></dt>
-<dd><a name="tlmgr-_002d_002dlocalcfg-local_005fconf_005ffile"></a>
+<dd><span id="tlmgr-_002d_002dlocalcfg-local_005fconf_005ffile"></span>
<p>specifies the (optional) local additions (defaults to the respective
location in <code>TEXMFLOCAL</code>).
</p>
</dd>
<dt><strong>&ndash;rebuild-sys</strong></dt>
-<dd><a name="tlmgr-_002d_002drebuild_002dsys"></a>
+<dd><span id="tlmgr-_002d_002drebuild_002dsys"></span>
<p>tells <code>tlmgr</code> to run necessary programs after config files have been
regenerated. These are:
<code>fmtutil-sys --all</code> after <code>generate fmtutil</code>,
@@ -4734,34 +4578,30 @@ succession before invoking these programs.
tex/generic/config/language.dat.lua (and language-local.dat.lua)
</pre>
<hr>
-<a name="tlmgr-gui"></a>
-<div class="header">
+<span id="tlmgr-gui"></span><div class="header">
<p>
Next: <a href="#tlmgr-info" accesskey="n" rel="next">tlmgr info</a>, Previous: <a href="#tlmgr-generate" accesskey="p" rel="prev">tlmgr generate</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="gui"></a>
-<h4 class="appendixsubsec">B.6.9 gui</h4>
+<span id="gui"></span><h4 class="appendixsubsec">B.6.9 gui</h4>
<p>Start the graphical user interface. See <strong>GUI</strong> below.
</p>
<hr>
-<a name="tlmgr-info"></a>
-<div class="header">
+<span id="tlmgr-info"></span><div class="header">
<p>
Next: <a href="#tlmgr-init_002dusertree" accesskey="n" rel="next">tlmgr init-usertree</a>, Previous: <a href="#tlmgr-gui" accesskey="p" rel="prev">tlmgr gui</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="info"></a>
-<h4 class="appendixsubsec">B.6.10 info</h4>
+<span id="info"></span><h4 class="appendixsubsec">B.6.10 info</h4>
<dl compact="compact">
<dt><strong>info [<em>option</em>...] <em>pkg</em>...</strong></dt>
-<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span>
</dd>
<dt><strong>info [<em>option</em>...] collections</strong></dt>
-<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></a>
+<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></span>
</dd>
<dt><strong>info [<em>option</em>...] schemes</strong></dt>
-<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-schemes"></a>
+<dd><span id="tlmgr-info-_005boption_002e_002e_002e_005d-schemes"></span>
<p>With no argument, lists all packages available at the package
repository, prefixing those already installed with <code>i</code>.
</p>
@@ -4796,7 +4636,7 @@ but are still supported for backward compatibility.
</p>
<dl compact="compact">
<dt><strong>&ndash;list</strong></dt>
-<dd><a name="tlmgr-_002d_002dlist"></a>
+<dd><span id="tlmgr-_002d_002dlist"></span>
<p>If the option <code>--list</code> is given with a package, the list of contained
files is also shown, including those for platform-specific dependencies.
When given with schemes and collections, <code>--list</code> outputs their
@@ -4804,13 +4644,13 @@ dependencies in a similar way.
</p>
</dd>
<dt><strong>&ndash;only-installed</strong></dt>
-<dd><a name="tlmgr-_002d_002donly_002dinstalled"></a>
+<dd><span id="tlmgr-_002d_002donly_002dinstalled"></span>
<p>If this option is given, the installation source will not be used; only
locally installed packages, collections, or schemes are listed.
</p>
</dd>
<dt><strong>&ndash;data <code>item1,item2,...</code></strong></dt>
-<dd><a name="tlmgr-_002d_002ddata-item1_002citem2_002c_002e_002e_002e"></a>
+<dd><span id="tlmgr-_002d_002ddata-item1_002citem2_002c_002e_002e_002e"></span>
<p>If the option <code>--data</code> is given, its argument must be a comma separated
list of field names from: <code>name</code>, <code>category</code>, <code>localrev</code>, <code>remoterev</code>,
<code>shortdesc</code>, <code>longdesc</code>, <code>installed</code>, <code>size</code>, <code>relocatable</code>, <code>depends</code>,
@@ -4821,7 +4661,7 @@ the name of all dependencies separated by <code>:</code>.
</p>
</dd>
<dt><strong>&ndash;json</strong></dt>
-<dd><a name="tlmgr-_002d_002djson-1"></a>
+<dd><span id="tlmgr-_002d_002djson-1"></span>
<p>In case <code>--json</code> is specified, the output is a
JSON encoded array where each array element is the JSON representation of
a single <code>TLPOBJ</code> but with additional information. For details see
@@ -4835,26 +4675,22 @@ If both <code>--json</code> and <code>--data</code> are given, <code>--json</cod
</dl>
<hr>
-<a name="tlmgr-init_002dusertree"></a>
-<div class="header">
+<span id="tlmgr-init_002dusertree"></span><div class="header">
<p>
Next: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info" accesskey="p" rel="prev">tlmgr info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="init_002dusertree"></a>
-<h4 class="appendixsubsec">B.6.11 init-usertree</h4>
+<span id="init_002dusertree"></span><h4 class="appendixsubsec">B.6.11 init-usertree</h4>
<p>Sets up a texmf tree for so-called user mode management, either the
default user tree (<code>TEXMFHOME</code>), or one specified on the command line
with <code>--usertree</code>. See <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
<hr>
-<a name="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<div class="header">
+<span id="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header">
<p>
Next: <a href="#tlmgr-key" accesskey="n" rel="next">tlmgr key</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">tlmgr init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.12 install [<em>option</em>...] <em>pkg</em>...</h4>
+<span id="install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><h4 class="appendixsubsec">B.6.12 install [<em>option</em>...] <em>pkg</em>...</h4>
<p>Install each <em>pkg</em> given on the command line, if it is not already
installed. (It does not touch existing packages; see the <code>update</code>
@@ -4865,33 +4701,33 @@ dependent. Options:
</p>
<dl compact="compact">
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-1"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-1"></span>
<p>Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
</p>
</dd>
<dt><strong>&ndash;file</strong></dt>
-<dd><a name="tlmgr-_002d_002dfile"></a>
+<dd><span id="tlmgr-_002d_002dfile"></span>
<p>Instead of fetching a package from the installation repository, use
the package files given on the command line. These files must
be standard TeX Live package files (with contained tlpobj file).
</p>
</dd>
<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce"></a>
+<dd><span id="tlmgr-_002d_002dforce"></span>
<p>If updates to <code>tlmgr</code> itself (or other parts of the basic
infrastructure) are present, <code>tlmgr</code> will bail out and not perform the
installation unless this option is given. Not recommended.
</p>
</dd>
<dt><strong>&ndash;no-depends</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends"></span>
<p>Do not install dependencies. (By default, installing a package ensures
that all dependencies of this package are fulfilled.)
</p>
</dd>
<dt><strong>&ndash;no-depends-at-all</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall"></span>
<p>Normally, when you install a package which ships binary files the
respective binary package will also be installed. That is, for a
package <code>foo</code>, the package <code>foo.i386-linux</code> will also be installed on
@@ -4901,7 +4737,7 @@ are doing.
</p>
</dd>
<dt><strong>&ndash;reinstall</strong></dt>
-<dd><a name="tlmgr-_002d_002dreinstall"></a>
+<dd><span id="tlmgr-_002d_002dreinstall"></span>
<p>Reinstall a package (including dependencies for collections) even if it
already seems to be installed (i.e, is present in the TLPDB). This is
useful to recover from accidental removal of files in the hierarchy.
@@ -4911,10 +4747,10 @@ useful to recover from accidental removal of files in the hierarchy.
</p>
</dd>
<dt><strong>&ndash;with-doc</strong></dt>
-<dd><a name="tlmgr-_002d_002dwith_002ddoc"></a>
+<dd><span id="tlmgr-_002d_002dwith_002ddoc"></span>
</dd>
<dt><strong>&ndash;with-src</strong></dt>
-<dd><a name="tlmgr-_002d_002dwith_002dsrc"></a>
+<dd><span id="tlmgr-_002d_002dwith_002dsrc"></span>
<p>While not recommended, the <code>install-tl</code> program provides an option to
omit installation of all documentation and/or source files. (By
default, everything is installed.) After such an installation, you may
@@ -4928,23 +4764,21 @@ after all. You can get them by using these options in conjunction with
</dl>
<hr>
-<a name="tlmgr-key"></a>
-<div class="header">
+<span id="tlmgr-key"></span><div class="header">
<p>
Next: <a href="#tlmgr-list" accesskey="n" rel="next">tlmgr list</a>, Previous: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="key"></a>
-<h4 class="appendixsubsec">B.6.13 key</h4>
+<span id="key"></span><h4 class="appendixsubsec">B.6.13 key</h4>
<dl compact="compact">
<dt><strong>key list</strong></dt>
-<dd><a name="tlmgr-key-list"></a>
+<dd><span id="tlmgr-key-list"></span>
</dd>
<dt><strong>key add <em>file</em></strong></dt>
-<dd><a name="tlmgr-key-add-file"></a>
+<dd><span id="tlmgr-key-add-file"></span>
</dd>
<dt><strong>key remove <em>keyid</em></strong></dt>
-<dd><a name="tlmgr-key-remove-keyid"></a>
+<dd><span id="tlmgr-key-remove-keyid"></span>
<p>The action <code>key</code> allows listing, adding and removing additional GPG
keys to the set of trusted keys, that is, those that are used to verify
the TeX Live databases.
@@ -4963,34 +4797,30 @@ from the local keyring.
</dl>
<hr>
-<a name="tlmgr-list"></a>
-<div class="header">
+<span id="tlmgr-list"></span><div class="header">
<p>
Next: <a href="#tlmgr-option" accesskey="n" rel="next">tlmgr option</a>, Previous: <a href="#tlmgr-key" accesskey="p" rel="prev">tlmgr key</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="list"></a>
-<h4 class="appendixsubsec">B.6.14 list</h4>
+<span id="list"></span><h4 class="appendixsubsec">B.6.14 list</h4>
<p>Synonym for <a href="#tlmgr-info">info</a>.
</p>
<hr>
-<a name="tlmgr-option"></a>
-<div class="header">
+<span id="tlmgr-option"></span><div class="header">
<p>
Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous: <a href="#tlmgr-list" accesskey="p" rel="prev">tlmgr list</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="option"></a>
-<h4 class="appendixsubsec">B.6.15 option</h4>
+<span id="option"></span><h4 class="appendixsubsec">B.6.15 option</h4>
<dl compact="compact">
<dt><strong>option [&ndash;json] [show]</strong></dt>
-<dd><a name="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></a>
+<dd><span id="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></span>
</dd>
<dt><strong>option [&ndash;json] showall</strong></dt>
-<dd><a name="tlmgr-option-_005b_002d_002djson_005d-showall"></a>
+<dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall"></span>
</dd>
<dt><strong>option <em>key</em> [<em>value</em>]</strong></dt>
-<dd><a name="tlmgr-option-key-_005bvalue_005d"></a>
+<dd><span id="tlmgr-option-key-_005bvalue_005d"></span>
</dd>
</dl>
@@ -5087,23 +4917,21 @@ to the registry and the menus are done for all users on the system
instead of only the current user. All three options are on by default.
</p>
<hr>
-<a name="tlmgr-paper"></a>
-<div class="header">
+<span id="tlmgr-paper"></span><div class="header">
<p>
Next: <a href="#tlmgr-path" accesskey="n" rel="next">tlmgr path</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">tlmgr option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="paper"></a>
-<h4 class="appendixsubsec">B.6.16 paper</h4>
+<span id="paper"></span><h4 class="appendixsubsec">B.6.16 paper</h4>
<dl compact="compact">
<dt><strong>paper [a4|letter]</strong></dt>
-<dd><a name="tlmgr-paper-_005ba4_007cletter_005d"></a>
+<dd><span id="tlmgr-paper-_005ba4_007cletter_005d"></span>
</dd>
<dt><strong>[xdvi|pdftex|dvips|dvipdfmx|context|psutils]&nbsp;paper&nbsp;[<em>papersize</em>|&ndash;list]<!-- /@w --></strong></dt>
-<dd><a name="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></a>
+<dd><span id="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></span>
</dd>
<dt><strong>paper &ndash;json</strong></dt>
-<dd><a name="tlmgr-paper-_002d_002djson"></a>
+<dd><span id="tlmgr-paper-_002d_002djson"></span>
</dd>
</dl>
@@ -5136,20 +4964,18 @@ some programs, notably <code>dvips</code>. <code>tlmgr</code> does not support
settings.
</p>
<hr>
-<a name="tlmgr-path"></a>
-<div class="header">
+<span id="tlmgr-path"></span><div class="header">
<p>
Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">tlmgr pinning</a>, Previous: <a href="#tlmgr-paper" accesskey="p" rel="prev">tlmgr paper</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="path"></a>
-<h4 class="appendixsubsec">B.6.17 path</h4>
+<span id="path"></span><h4 class="appendixsubsec">B.6.17 path</h4>
<dl compact="compact">
<dt><strong>path [&ndash;w32mode=user|admin] add</strong></dt>
-<dd><a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></a>
+<dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></span>
</dd>
<dt><strong>path [&ndash;w32mode=user|admin] remove</strong></dt>
-<dd><a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></a>
+<dd><span id="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></span>
<p>On Unix, merely adds or removes symlinks for binaries, man pages, and
info pages in the system directories specified by the respective options
(see the <a href="#tlmgr-option">option</a> description above). Does not change any
@@ -5179,59 +5005,55 @@ is issued that the caller does not have enough privileges.
</dl>
<hr>
-<a name="tlmgr-pinning"></a>
-<div class="header">
+<span id="tlmgr-pinning"></span><div class="header">
<p>
Next: <a href="#tlmgr-platform" accesskey="n" rel="next">tlmgr platform</a>, Previous: <a href="#tlmgr-path" accesskey="p" rel="prev">tlmgr path</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="pinning"></a>
-<h4 class="appendixsubsec">B.6.18 pinning</h4>
+<span id="pinning"></span><h4 class="appendixsubsec">B.6.18 pinning</h4>
<p>The <code>pinning</code> action manages the pinning file, see <a href="#tlmgr-Pinning">Pinning</a> below.
</p>
<dl compact="compact">
<dt><code>pinning show</code></dt>
-<dd><a name="tlmgr-pinning-show"></a>
+<dd><span id="tlmgr-pinning-show"></span>
<p>Shows the current pinning data.
</p>
</dd>
<dt><code>pinning add</code> <em>repo</em> <em>pkgglob</em>...</dt>
-<dd><a name="tlmgr-pinning-add-repo-pkgglob_002e_002e_002e"></a>
+<dd><span id="tlmgr-pinning-add-repo-pkgglob_002e_002e_002e"></span>
<p>Pins the packages matching the <em>pkgglob</em>(s) to the repository
<em>repo</em>.
</p>
</dd>
<dt><code>pinning remove</code> <em>repo</em> <em>pkgglob</em>...</dt>
-<dd><a name="tlmgr-pinning-remove-repo-pkgglob_002e_002e_002e"></a>
+<dd><span id="tlmgr-pinning-remove-repo-pkgglob_002e_002e_002e"></span>
<p>Any packages recorded in the pinning file matching the &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>
-<dd><a name="tlmgr-pinning-remove-repo-_002d_002dall"></a>
+<dd><span id="tlmgr-pinning-remove-repo-_002d_002dall"></span>
<p>Remove all pinning data for repository <em>repo</em>.
</p>
</dd>
</dl>
<hr>
-<a name="tlmgr-platform"></a>
-<div class="header">
+<span id="tlmgr-platform"></span><div class="header">
<p>
Next: <a href="#tlmgr-postaction" accesskey="n" rel="next">tlmgr postaction</a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">tlmgr pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="platform"></a>
-<h4 class="appendixsubsec">B.6.19 platform</h4>
+<span id="platform"></span><h4 class="appendixsubsec">B.6.19 platform</h4>
<dl compact="compact">
<dt><strong>platform list|add|remove <em>platform</em>...</strong></dt>
-<dd><a name="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></a>
+<dd><span id="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></span>
</dd>
<dt><strong>platform set <em>platform</em></strong></dt>
-<dd><a name="tlmgr-platform-set-platform"></a>
+<dd><span id="tlmgr-platform-set-platform"></span>
</dd>
<dt><strong>platform set auto</strong></dt>
-<dd><a name="tlmgr-platform-set-auto"></a>
+<dd><span id="tlmgr-platform-set-auto"></span>
<p><code>platform list</code> lists the TeX Live names of all the platforms
(a.k.a. architectures), (<code>i386-linux</code>, ...) available at the package
repository.
@@ -5257,7 +5079,7 @@ platform instead of auto detection.
</p>
<dl compact="compact">
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-2"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-2"></span>
<p>Nothing is actually installed; instead, the actions to be performed are
written to the terminal.
</p>
@@ -5268,20 +5090,18 @@ written to the terminal.
</dl>
<hr>
-<a name="tlmgr-postaction"></a>
-<div class="header">
+<span id="tlmgr-postaction"></span><div class="header">
<p>
Next: <a href="#tlmgr-print_002dplatform" accesskey="n" rel="next">tlmgr print-platform</a>, Previous: <a href="#tlmgr-platform" accesskey="p" rel="prev">tlmgr platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="postaction"></a>
-<h4 class="appendixsubsec">B.6.20 postaction</h4>
+<span id="postaction"></span><h4 class="appendixsubsec">B.6.20 postaction</h4>
<dl compact="compact">
<dt><strong>postaction [<em>option</em>...] install [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt>
-<dd><a name="tlmgr-postaction-_005boption_002e_002e_002e_005d-install-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-postaction-_005boption_002e_002e_002e_005d-install-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></span>
</dd>
<dt><strong>postaction [<em>option</em>...] remove [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt>
-<dd><a name="tlmgr-postaction-_005boption_002e_002e_002e_005d-remove-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-postaction-_005boption_002e_002e_002e_005d-remove-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></span>
<p>Carry out the postaction <code>shortcut</code>, <code>fileassoc</code>, or <code>script</code> given
as the second required argument in install or remove mode (which is the
first required argument), for either the packages given on the command
@@ -5291,7 +5111,7 @@ line, or for all if <code>--all</code> is given.
</p>
<dl compact="compact">
<dt><strong>&ndash;w32mode=[user|admin]</strong></dt>
-<dd><a name="tlmgr-_002d_002dw32mode_003d_005buser_007cadmin_005d"></a>
+<dd><span id="tlmgr-_002d_002dw32mode_003d_005buser_007cadmin_005d"></span>
<p>If the option <code>--w32mode</code> is given the value <code>user</code>, all actions will
only be carried out in the user-accessible parts of the
registry/filesystem, while the value <code>admin</code> selects the system-wide
@@ -5300,7 +5120,7 @@ enough permissions, using <code>--w32mode=admin</code> will not succeed.
</p>
</dd>
<dt><strong>&ndash;fileassocmode=[1|2]</strong></dt>
-<dd><a name="tlmgr-_002d_002dfileassocmode_003d_005b1_007c2_005d"></a>
+<dd><span id="tlmgr-_002d_002dfileassocmode_003d_005b1_007c2_005d"></span>
<p><code>--fileassocmode</code> specifies the action for file associations. If it is
set to 1 (the default), only new associations are added; if it is set to
2, all associations are set to the TeX Live programs. (See also
@@ -5308,7 +5128,7 @@ set to 1 (the default), only new associations are added; if it is set to
</p>
</dd>
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-1"></a>
+<dd><span id="tlmgr-_002d_002dall-1"></span>
<p>Carry out the postactions for all packages
</p>
</dd>
@@ -5318,38 +5138,32 @@ set to 1 (the default), only new associations are added; if it is set to
</dl>
<hr>
-<a name="tlmgr-print_002dplatform"></a>
-<div class="header">
+<span id="tlmgr-print_002dplatform"></span><div class="header">
<p>
Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">tlmgr print-platform-info</a>, Previous: <a href="#tlmgr-postaction" accesskey="p" rel="prev">tlmgr postaction</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="print_002dplatform"></a>
-<h4 class="appendixsubsec">B.6.21 print-platform</h4>
+<span id="print_002dplatform"></span><h4 class="appendixsubsec">B.6.21 print-platform</h4>
<p>Print the TeX Live identifier for the detected platform
(hardware/operating system) combination to standard output, and exit.
<code>--print-arch</code> is a synonym.
</p>
<hr>
-<a name="tlmgr-print_002dplatform_002dinfo"></a>
-<div class="header">
+<span id="tlmgr-print_002dplatform_002dinfo"></span><div class="header">
<p>
Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">tlmgr print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="print_002dplatform_002dinfo"></a>
-<h4 class="appendixsubsec">B.6.22 print-platform-info</h4>
+<span id="print_002dplatform_002dinfo"></span><h4 class="appendixsubsec">B.6.22 print-platform-info</h4>
<p>Print the TeX Live platform identifier, TL platform long name, and
original output from guess.
</p>
<hr>
-<a name="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<div class="header">
+<span id="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><div class="header">
<p>
Next: <a href="#tlmgr-repository" accesskey="n" rel="next">tlmgr repository</a>, Previous: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="p" rel="prev">tlmgr print-platform-info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</h4>
+<span id="remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></span><h4 class="appendixsubsec">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</h4>
<p>Remove each <em>pkg</em> specified. Removing a collection removes all package
dependencies (unless <code>--no-depends</code> is specified), but not any
@@ -5358,16 +5172,16 @@ package, dependencies are never removed. Options:
</p>
<dl compact="compact">
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-2"></a>
+<dd><span id="tlmgr-_002d_002dall-2"></span>
<p>Uninstalls all of TeX Live, asking for confirmation unless <code>--force</code> is
also specified.
</p>
</dd>
<dt><strong>&ndash;backup</strong></dt>
-<dd><a name="tlmgr-_002d_002dbackup"></a>
+<dd><span id="tlmgr-_002d_002dbackup"></span>
</dd>
<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-1"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory-1"></span>
<p>These options behave just as with the <a href="update.html#tlmgr-update-_005boption_002e_002e_002e_005d-_005b_002e_002e_002e_005d">(update)update</a> action (q.v.), except they apply to making
backups of packages before they are removed. The default is to make
such a backup, that is, to save a copy of packages before removal.
@@ -5376,17 +5190,17 @@ such a backup, that is, to save a copy of packages before removal.
</p>
</dd>
<dt><strong>&ndash;no-depends</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends-1"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends-1"></span>
<p>Do not remove dependent packages.
</p>
</dd>
<dt><strong>&ndash;no-depends-at-all</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall-1"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall-1"></span>
<p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware).
</p>
</dd>
<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-1"></a>
+<dd><span id="tlmgr-_002d_002dforce-1"></span>
<p>By default, removal of a package or collection that is a dependency of
another collection or scheme is not allowed. With this option, the
package will be removed unconditionally. Use with care.
@@ -5398,7 +5212,7 @@ updated, and will be mentioned as <code>forcibly removed</code> in the output of
</p>
</dd>
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-3"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-3"></span>
<p>Nothing is actually removed; instead, the actions to be performed are
written to the terminal.
</p>
@@ -5406,29 +5220,27 @@ written to the terminal.
</dl>
<hr>
-<a name="tlmgr-repository"></a>
-<div class="header">
+<span id="tlmgr-repository"></span><div class="header">
<p>
Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previous: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="repository"></a>
-<h4 class="appendixsubsec">B.6.24 repository</h4>
+<span id="repository"></span><h4 class="appendixsubsec">B.6.24 repository</h4>
<dl compact="compact">
<dt><strong>repository list</strong></dt>
-<dd><a name="tlmgr-repository-list"></a>
+<dd><span id="tlmgr-repository-list"></span>
</dd>
<dt><strong>repository list <em>path|tag</em></strong></dt>
-<dd><a name="tlmgr-repository-list-path_007ctag"></a>
+<dd><span id="tlmgr-repository-list-path_007ctag"></span>
</dd>
<dt><strong>repository add <em>path</em> [<em>tag</em>]</strong></dt>
-<dd><a name="tlmgr-repository-add-path-_005btag_005d"></a>
+<dd><span id="tlmgr-repository-add-path-_005btag_005d"></span>
</dd>
<dt><strong>repository remove <em>path|tag</em></strong></dt>
-<dd><a name="tlmgr-repository-remove-path_007ctag"></a>
+<dd><span id="tlmgr-repository-remove-path_007ctag"></span>
</dd>
<dt><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></dt>
-<dd><a name="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></span>
<p>This action manages the list of repositories. See <a href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
</p>
<p>The first form (<code>list</code>) lists all configured repositories and the
@@ -5452,20 +5264,18 @@ otherwise, all operations will fail!
</dl>
<hr>
-<a name="tlmgr-restore"></a>
-<div class="header">
+<span id="tlmgr-restore"></span><div class="header">
<p>
Next: <a href="#tlmgr-search" accesskey="n" rel="next">tlmgr search</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">tlmgr repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="restore"></a>
-<h4 class="appendixsubsec">B.6.25 restore</h4>
+<span id="restore"></span><h4 class="appendixsubsec">B.6.25 restore</h4>
<dl compact="compact">
<dt><strong>restore [<em>option</em>...] <em>pkg</em> [<em>rev</em>]</strong></dt>
-<dd><a name="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></a>
+<dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></span>
</dd>
<dt><strong>restore [<em>option</em>...] &ndash;all</strong></dt>
-<dd><a name="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></a>
+<dd><span id="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></span>
<p>Restore a package from a previously-made backup.
</p>
<p>If <code>--all</code> is given, try to restore the latest revision of all
@@ -5485,31 +5295,31 @@ specified, try to restore the package from the specified backup.
</p>
<dl compact="compact">
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-3"></a>
+<dd><span id="tlmgr-_002d_002dall-3"></span>
<p>Try to restore the latest revision of all package backups found in the
backup directory. Additional non-option arguments (like <em>pkg</em>) are not
allowed.
</p>
</dd>
<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-2"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory-2"></span>
<p>Specify the directory where the backups are to be found. If not given it
will be taken from the configuration setting in the TLPDB.
</p>
</dd>
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-4"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-4"></span>
<p>Nothing is actually restored; instead, the actions to be performed are
written to the terminal.
</p>
</dd>
<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-2"></a>
+<dd><span id="tlmgr-_002d_002dforce-2"></span>
<p>Don&rsquo;t ask questions.
</p>
</dd>
<dt><strong>&ndash;json</strong></dt>
-<dd><a name="tlmgr-_002d_002djson-2"></a>
+<dd><span id="tlmgr-_002d_002djson-2"></span>
<p>When listing backups, the option <code>--json</code> turn on JSON output.
The format is an array of JSON objects (<code>name</code>, <code>rev</code>, <code>date</code>).
For details see <code>tlpkg/doc/JSON-formats.txt</code>, format definition: <code>TLBACKUPS</code>.
@@ -5522,23 +5332,21 @@ If both <code>--json</code> and <code>--data</code> are given, <code>--json</cod
</dl>
<hr>
-<a name="tlmgr-search"></a>
-<div class="header">
+<span id="tlmgr-search"></span><div class="header">
<p>
Next: <a href="#tlmgr-shell" accesskey="n" rel="next">tlmgr shell</a>, Previous: <a href="#tlmgr-restore" accesskey="p" rel="prev">tlmgr restore</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="search"></a>
-<h4 class="appendixsubsec">B.6.26 search</h4>
+<span id="search"></span><h4 class="appendixsubsec">B.6.26 search</h4>
<dl compact="compact">
<dt><strong>search [<em>option</em>...] <em>what</em></strong></dt>
-<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-what"></a>
+<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-what"></span>
</dd>
<dt><strong>search [<em>option</em>...] &ndash;file <em>what</em></strong></dt>
-<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></a>
+<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></span>
</dd>
<dt><strong>search [<em>option</em>...] &ndash;all <em>what</em></strong></dt>
-<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></a>
+<dd><span id="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></span>
<p>By default, search the names, short descriptions, and long descriptions
of all locally installed packages for the argument <em>what</em>, interpreted
as a (Perl) regular expression.
@@ -5547,23 +5355,23 @@ as a (Perl) regular expression.
</p>
<dl compact="compact">
<dt><strong>&ndash;file</strong></dt>
-<dd><a name="tlmgr-_002d_002dfile-1"></a>
+<dd><span id="tlmgr-_002d_002dfile-1"></span>
<p>List all filenames containing <em>what</em>.
</p>
</dd>
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-4"></a>
+<dd><span id="tlmgr-_002d_002dall-4"></span>
<p>Search everything: package names, descriptions and filenames.
</p>
</dd>
<dt><strong>&ndash;global</strong></dt>
-<dd><a name="tlmgr-_002d_002dglobal"></a>
+<dd><span id="tlmgr-_002d_002dglobal"></span>
<p>Search the TeX Live Database of the installation medium, instead of the
local installation.
</p>
</dd>
<dt><strong>&ndash;word</strong></dt>
-<dd><a name="tlmgr-_002d_002dword"></a>
+<dd><span id="tlmgr-_002d_002dword"></span>
<p>Restrict the search of package names and descriptions (but not
filenames) to match only full words. For example, searching for
<code>table</code> with this option will not output packages containing the word
@@ -5576,13 +5384,11 @@ filenames) to match only full words. For example, searching for
</dl>
<hr>
-<a name="tlmgr-shell"></a>
-<div class="header">
+<span id="tlmgr-shell"></span><div class="header">
<p>
Next: <a href="#tlmgr-show" accesskey="n" rel="next">tlmgr show</a>, Previous: <a href="#tlmgr-search" accesskey="p" rel="prev">tlmgr search</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="shell"></a>
-<h4 class="appendixsubsec">B.6.27 shell</h4>
+<span id="shell"></span><h4 class="appendixsubsec">B.6.27 shell</h4>
<p>Starts an interactive mode, where tlmgr prompts for commands. This can
be used directly, or for scripting. The first line of output is
@@ -5599,43 +5405,43 @@ the session.
</p>
<dl compact="compact">
<dt>protocol</dt>
-<dd><a name="tlmgr-protocol"></a>
+<dd><span id="tlmgr-protocol"></span>
<p>Print <code>protocol <em>n</em></code>, the current protocol version.
</p>
</dd>
<dt>help</dt>
-<dd><a name="tlmgr-help-1"></a>
+<dd><span id="tlmgr-help-1"></span>
<p>Print pointers to this documentation.
</p>
</dd>
<dt>version</dt>
-<dd><a name="tlmgr-version-1"></a>
+<dd><span id="tlmgr-version-1"></span>
<p>Print tlmgr version information.
</p>
</dd>
<dt>quit, end, bye, byebye, EOF</dt>
-<dd><a name="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></a>
+<dd><span id="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></span>
<p>Exit.
</p>
</dd>
<dt>restart</dt>
-<dd><a name="tlmgr-restart"></a>
+<dd><span id="tlmgr-restart"></span>
<p>Restart <code>tlmgr shell</code> with the original command line; most useful when
developing <code>tlmgr</code>.
</p>
</dd>
<dt>load [local|remote]</dt>
-<dd><a name="tlmgr-load-_005blocal_007cremote_005d"></a>
+<dd><span id="tlmgr-load-_005blocal_007cremote_005d"></span>
<p>Explicitly load the local or remote, respectively, TLPDB.
</p>
</dd>
<dt>save</dt>
-<dd><a name="tlmgr-save"></a>
+<dd><span id="tlmgr-save"></span>
<p>Save the local TLPDB, presumably after other operations have changed it.
</p>
</dd>
<dt>get [<em>var</em>] =item set [<em>var</em> [<em>val</em>]]</dt>
-<dd><a name="tlmgr-get-_005bvar_005d-_003ditem-set-_005bvar-_005bval_005d_005d"></a>
+<dd><span id="tlmgr-get-_005bvar_005d-_003ditem-set-_005bvar-_005bval_005d_005d"></span>
<p>Get the value of <em>var</em>, or set it to <em>val</em>. Possible <em>var</em> names:
<code>debug-translation</code>, <code>machine-readable</code>, <code>no-execute-actions</code>,
<code>require-verification</code>, <code>verify-downloads</code>, <code>repository</code>, and
@@ -5651,35 +5457,29 @@ current default prompt.
</dl>
<hr>
-<a name="tlmgr-show"></a>
-<div class="header">
+<span id="tlmgr-show"></span><div class="header">
<p>
Next: <a href="#tlmgr-uninstall" accesskey="n" rel="next">tlmgr uninstall</a>, Previous: <a href="#tlmgr-shell" accesskey="p" rel="prev">tlmgr shell</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="show"></a>
-<h4 class="appendixsubsec">B.6.28 show</h4>
+<span id="show"></span><h4 class="appendixsubsec">B.6.28 show</h4>
<p>Synonym for <a href="#tlmgr-info">info</a>.
</p>
<hr>
-<a name="tlmgr-uninstall"></a>
-<div class="header">
+<span id="tlmgr-uninstall"></span><div class="header">
<p>
Next: <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" accesskey="n" rel="next">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-show" accesskey="p" rel="prev">tlmgr show</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="uninstall"></a>
-<h4 class="appendixsubsec">B.6.29 uninstall</h4>
+<span id="uninstall"></span><h4 class="appendixsubsec">B.6.29 uninstall</h4>
<p>Synonym for <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">remove</a>.
</p>
<hr>
-<a name="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></a>
-<div class="header">
+<span id="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><div class="header">
<p>
Previous: <a href="#tlmgr-uninstall" accesskey="p" rel="prev">tlmgr uninstall</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></a>
-<h4 class="appendixsubsec">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</h4>
+<span id="update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></span><h4 class="appendixsubsec">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</h4>
<p>Updates the packages given as arguments to the latest version available
at the installation source. Either <code>--all</code> or at least one <em>pkg</em> name
@@ -5687,7 +5487,7 @@ must be specified. Options:
</p>
<dl compact="compact">
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-5"></a>
+<dd><span id="tlmgr-_002d_002dall-5"></span>
<p>Update all installed packages except for <code>tlmgr</code> itself. Thus, if
updates to <code>tlmgr</code> itself are present, this will simply give an error,
unless also the option <code>--force</code> or <code>--self</code> is given. (See below.)
@@ -5720,7 +5520,7 @@ due to a slow link), see the <code>--exclude</code> option below.
</p>
</dd>
<dt><strong>&ndash;self</strong></dt>
-<dd><a name="tlmgr-_002d_002dself"></a>
+<dd><span id="tlmgr-_002d_002dself"></span>
<p>Update <code>tlmgr</code> itself (that is, the infrastructure packages) if updates
to it are present. On Windows this includes updates to the private Perl
interpreter shipped inside TeX Live.
@@ -5739,13 +5539,13 @@ updates.
</pre>
</dd>
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-5"></a>
+<dd><span id="tlmgr-_002d_002ddry_002drun-5"></span>
<p>Nothing is actually installed; instead, the actions to be performed are
written to the terminal. This is a more detailed report than <code>--list</code>.
</p>
</dd>
<dt><strong>&ndash;list</strong> [<em>pkg</em>]</dt>
-<dd><a name="tlmgr-_002d_002dlist-_005bpkg_005d"></a>
+<dd><span id="tlmgr-_002d_002dlist-_005bpkg_005d"></span>
<p>Concisely list the packages which would be updated, newly installed, or
removed, without actually changing anything.
If <code>--all</code> is also given, all available updates are listed.
@@ -5760,7 +5560,7 @@ given, those packages are checked for updates.
</p>
</dd>
<dt><strong>&ndash;exclude</strong> <em>pkg</em></dt>
-<dd><a name="tlmgr-_002d_002dexclude-pkg"></a>
+<dd><span id="tlmgr-_002d_002dexclude-pkg"></span>
<p>Exclude <em>pkg</em> from the update process. If this option is given more
than once, its arguments accumulate.
</p>
@@ -5782,7 +5582,7 @@ the key <code>update-exclude</code>.
</p>
</dd>
<dt><strong>&ndash;no-auto-remove</strong> [<em>pkg</em>...]</dt>
-<dd><a name="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></span>
<p>By default, <code>tlmgr</code> tries to remove packages which have disappeared on
the server, as described above under <code>--all</code>. This option prevents
such removals, either for all packages (with <code>--all</code>), or for just the
@@ -5792,7 +5592,7 @@ authors. Therefore this is not recommend.
</p>
</dd>
<dt><strong>&ndash;no-auto-install</strong> [<em>pkg</em>...]</dt>
-<dd><a name="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_002e_002e_002e_005d"></a>
+<dd><span id="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_002e_002e_002e_005d"></span>
<p>Under normal circumstances <code>tlmgr</code> will install packages which are new
on the server, as described above under <code>--all</code>. This option prevents
any such automatic installation, either for all packages (with
@@ -5812,7 +5612,7 @@ server, then
</pre>
</dd>
<dt><strong>&ndash;reinstall-forcibly-removed</strong></dt>
-<dd><a name="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></a>
+<dd><span id="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></span>
<p>Under normal circumstances <code>tlmgr</code> will not install packages that have
been forcibly removed by the user; that is, removed with <code>remove
--force</code>, or whose installation was prohibited by <code>--no-auto-install</code>
@@ -5826,10 +5626,10 @@ installation with the server&rsquo;s idea of what is available:
</pre>
</dd>
<dt><strong>&ndash;backup</strong></dt>
-<dd><a name="tlmgr-_002d_002dbackup-1"></a>
+<dd><span id="tlmgr-_002d_002dbackup-1"></span>
</dd>
<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-3"></a>
+<dd><span id="tlmgr-_002d_002dbackupdir-directory-3"></span>
<p>These two options control the creation of backups of packages <em>before</em>
updating; that is, backup of packages as currently installed. If
neither options is given, no backup will made. If <code>--backupdir</code> is
@@ -5852,19 +5652,19 @@ incompatibility.
</p>
</dd>
<dt><strong>&ndash;no-depends</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends-2"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends-2"></span>
<p>If you call for updating a package normally all depending packages
will also be checked for updates and updated if necessary. This switch
suppresses this behavior.
</p>
</dd>
<dt><strong>&ndash;no-depends-at-all</strong></dt>
-<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall-2"></a>
+<dd><span id="tlmgr-_002d_002dno_002ddepends_002dat_002dall-2"></span>
<p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware).
</p>
</dd>
<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-3"></a>
+<dd><span id="tlmgr-_002d_002dforce-3"></span>
<p>Force update of normal packages, without updating <code>tlmgr</code> itself
(unless the <code>--self</code> option is also given). Not recommended.
</p>
@@ -5885,13 +5685,11 @@ fallback information, but if you don&rsquo;t like them accumulating (e.g.,
a possibly different hash), it&rsquo;s harmless to delete them.
</p>
<hr>
-<a name="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></a>
-<div class="header">
+<span id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></span><div class="header">
<p>
Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">tlmgr ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="CONFIGURATION-FILE-FOR-TLMGR"></a>
-<h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3>
+<span id="CONFIGURATION-FILE-FOR-TLMGR"></span><h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3>
<p>There are two configuration files for <code>tlmgr</code>: One is system-wide in
<code>TEXMFSYSCONFIG/tlmgr/config</code>, and the other is user-specific in
@@ -5915,28 +5713,28 @@ ignored. All other lines must look like:
</p>
<dl compact="compact">
<dt><code>auto-remove</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><a name="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
<dt><code>gui-expertmode</code>, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.</dt>
-<dd><a name="tlmgr-gui_002dexpertmode_002c-value-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></a>
+<dd><span id="tlmgr-gui_002dexpertmode_002c-value-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></span>
</dd>
<dt><code>gui-lang</code> <em>llcode</em>, with a language code value as with the command-line option.</dt>
-<dd><a name="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></span>
</dd>
<dt><code>no-checksums</code>, value 0 or 1 (default 0, see below).</dt>
-<dd><a name="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></a>
+<dd><span id="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></span>
</dd>
<dt><code>persistent-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><a name="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
<dt><code>require-verification</code>, value 0 or 1 (default 0), same as command-line option.</dt>
-<dd><a name="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
<dt><code>update-exclude</code>, value: comma-separated list of packages (no space allowed). Same as the command line option <code>--exclude</code> for the action <code>update</code>.</dt>
-<dd><a name="tlmgr-update_002dexclude_002c-value_003a-comma_002dseparated-list-of-packages-_0028no-space-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-action-update_002e"></a>
+<dd><span id="tlmgr-update_002dexclude_002c-value_003a-comma_002dseparated-list-of-packages-_0028no-space-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-action-update_002e"></span>
</dd>
<dt><code>verify-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
-<dd><a name="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+<dd><span id="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></span>
</dd>
</dl>
@@ -5944,7 +5742,7 @@ ignored. All other lines must look like:
</p>
<dl compact="compact">
<dt><code>allowed-actions</code> <em>action1</em> [,<em>action</em>,...] The value is a comma-separated list of <code>tlmgr</code> actions which are allowed to be executed when <code>tlmgr</code> is invoked in system mode (that is, without <code>--usermode</code>).</dt>
-<dd><a name="tlmgr-allowed_002dactions-action1-_005b_002caction_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e"></a>
+<dd><span id="tlmgr-allowed_002dactions-action1-_005b_002caction_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e"></span>
<p>This allows distributors to include the <code>tlmgr</code> in their packaging, but
allow only a restricted set of actions that do not interfere with their
distro package manager. For native TeX Live installations, it doesn&rsquo;t
@@ -5969,13 +5767,11 @@ Perl and pure Lua modules, are much too slow to be usable in our
context.) <code>no-checksums</code> avoids the warning.
</p>
<hr>
-<a name="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></a>
-<div class="header">
+<span id="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></span><div class="header">
<p>
Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">tlmgr USER MODE</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="CRYPTOGRAPHIC-VERIFICATION"></a>
-<h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3>
+<span id="CRYPTOGRAPHIC-VERIFICATION"></span><h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3>
<p><code>tlmgr</code> and <code>install-tl</code> perform cryptographic verification if
possible. If verification is performed and successful, the programs
@@ -6013,18 +5809,16 @@ of these keys are obtainable from the standard key servers.
<p>Additional trusted keys can be added using the <code>key</code> action.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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>
<hr>
-<a name="tlmgr-Configuration-of-GnuPG-invocation"></a>
-<div class="header">
+<span id="tlmgr-Configuration-of-GnuPG-invocation"></span><div class="header">
<p>
Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">tlmgr CRYPTOGRAPHIC VERIFICATION</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Configuration-of-GnuPG-invocation"></a>
-<h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4>
+<span id="Configuration-of-GnuPG-invocation"></span><h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4>
<p>The executable used for GnuPG is searched as follows: If the environment
variable <code>TL_GNUPG</code> is set, it is tested and used; otherwise <code>gpg</code> is
@@ -6036,13 +5830,11 @@ value for <code>--homedir</code>, and <code>TL_GNUPGARGS</code>, which replaces
options <code>--no-secmem-warning --no-permission-warning</code>.
</p>
<hr>
-<a name="tlmgr-USER-MODE"></a>
-<div class="header">
+<span id="tlmgr-USER-MODE"></span><div class="header">
<p>
Next: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">tlmgr MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="p" rel="prev">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="USER-MODE"></a>
-<h3 class="appendixsec">B.9 USER MODE</h3>
+<span id="USER-MODE"></span><h3 class="appendixsec">B.9 USER MODE</h3>
<p><code>tlmgr</code> provides a restricted way, called &ldquo;user mode&rdquo;, to manage
arbitrary texmf trees in the same way as the main installation. For
@@ -6097,22 +5889,20 @@ installed into a user tree.
<p>Description of changes of actions in user mode:
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-install" accesskey="1">tlmgr User mode install</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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>
<hr>
-<a name="tlmgr-User-mode-install"></a>
-<div class="header">
+<span id="tlmgr-User-mode-install"></span><div class="header">
<p>
Next: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="n" rel="next">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User-mode-install"></a>
-<h4 class="appendixsubsec">B.9.1 User mode install</h4>
+<span id="User-mode-install"></span><h4 class="appendixsubsec">B.9.1 User mode install</h4>
<p>In user mode, the <code>install</code> action checks that the package and all
dependencies are all either relocated or already installed in the system
@@ -6133,39 +5923,33 @@ the user&rsquo;s <code>updmap.cfg</code> in <code>USERTREE/web2c/</code> is made
regenerated from the list of installed packages.
</p>
<hr>
-<a name="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></a>
-<div class="header">
+<span id="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></span><div class="header">
<p>
Next: <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="n" rel="next">tlmgr User mode generate, option, paper</a>, Previous: <a href="#tlmgr-User-mode-install" accesskey="p" rel="prev">tlmgr User mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User-mode-backup_002c-restore_002c-remove_002c-update"></a>
-<h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4>
+<span id="User-mode-backup_002c-restore_002c-remove_002c-update"></span><h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4>
<p>In user mode, these actions check that all packages to be acted on are
installed in the user tree before proceeding; otherwise, they behave
just as in normal mode.
</p>
<hr>
-<a name="tlmgr-User-mode-generate_002c-option_002c-paper"></a>
-<div class="header">
+<span id="tlmgr-User-mode-generate_002c-option_002c-paper"></span><div class="header">
<p>
Previous: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="p" rel="prev">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="User-mode-generate_002c-option_002c-paper"></a>
-<h4 class="appendixsubsec">B.9.3 User mode generate, option, paper</h4>
+<span id="User-mode-generate_002c-option_002c-paper"></span><h4 class="appendixsubsec">B.9.3 User mode generate, option, paper</h4>
<p>In user mode, these actions operate only on the user tree&rsquo;s
configuration files and/or <code>texlive.tlpdb</code>.
creates configuration files in user tree
</p>
<hr>
-<a name="tlmgr-MULTIPLE-REPOSITORIES"></a>
-<div class="header">
+<span id="tlmgr-MULTIPLE-REPOSITORIES"></span><div class="header">
<p>
Next: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">tlmgr GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">tlmgr USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="MULTIPLE-REPOSITORIES"></a>
-<h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3>
+<span id="MULTIPLE-REPOSITORIES"></span><h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3>
<p>The main TeX Live repository contains a vast array of packages.
Nevertheless, additional local repositories can be useful to provide
@@ -6197,18 +5981,16 @@ taken from the new repository, by specifying so-called &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">
+<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>
<hr>
-<a name="tlmgr-Pinning"></a>
-<div class="header">
+<span id="tlmgr-Pinning"></span><div class="header">
<p>
Up: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="u" rel="up">tlmgr MULTIPLE REPOSITORIES</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Pinning"></a>
-<h4 class="appendixsubsec">B.10.1 Pinning</h4>
+<span id="Pinning"></span><h4 class="appendixsubsec">B.10.1 Pinning</h4>
<p>When a package <code>foo</code> is pinned to a repository, a package <code>foo</code> in any
other repository, even if it has a higher revision number, will not be
@@ -6271,13 +6053,11 @@ from a given repository:
<p>A summary of the <code>tlmgr pinning</code> actions is given above.
</p>
<hr>
-<a name="tlmgr-GUI-FOR-TLMGR"></a>
-<div class="header">
+<span id="tlmgr-GUI-FOR-TLMGR"></span><div class="header">
<p>
Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">tlmgr MACHINE-READABLE OUTPUT</a>, Previous: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="p" rel="prev">tlmgr MULTIPLE REPOSITORIES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="GUI-FOR-TLMGR"></a>
-<h3 class="appendixsec">B.11 GUI FOR TLMGR</h3>
+<span id="GUI-FOR-TLMGR"></span><h3 class="appendixsec">B.11 GUI FOR TLMGR</h3>
<p>The graphical user interface for <code>tlmgr</code> requires Perl/Tk
<a href="http://search.cpan.org/search?query=perl%2Ftk">http://search.cpan.org/search?query=perl%2Ftk</a>. For Windows the
@@ -6302,40 +6082,36 @@ repository. To load a different repository, see the <code>tlmgr</code> menu ite
information about what is going on.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Main-display" accesskey="1">tlmgr Main display</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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>
<hr>
-<a name="tlmgr-Main-display"></a>
-<div class="header">
+<span id="tlmgr-Main-display"></span><div class="header">
<p>
Next: <a href="#tlmgr-Menu-bar" accesskey="n" rel="next">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Main-display"></a>
-<h4 class="appendixsubsec">B.11.1 Main display</h4>
+<span id="Main-display"></span><h4 class="appendixsubsec">B.11.1 Main display</h4>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Display-configuration-area" accesskey="1">tlmgr Display configuration area</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<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">
+<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">
+<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>
<hr>
-<a name="tlmgr-Display-configuration-area"></a>
-<div class="header">
+<span id="tlmgr-Display-configuration-area"></span><div class="header">
<p>
Next: <a href="#tlmgr-Package-list-area" accesskey="n" rel="next">tlmgr Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Display-configuration-area"></a>
-<h4 class="appendixsubsubsec">B.11.1.1 Display configuration area</h4>
+<span id="Display-configuration-area"></span><h4 class="appendixsubsubsec">B.11.1.1 Display configuration area</h4>
<p>The first part of the main display allows you to specify (filter) which
packages are shown. By default, all are shown. Changes here are
@@ -6343,34 +6119,34 @@ reflected right away.
</p>
<dl compact="compact">
<dt>Status</dt>
-<dd><a name="tlmgr-Status"></a>
+<dd><span id="tlmgr-Status"></span>
<p>Select whether to show all packages (the default), only those installed,
only those <em>not</em> installed, or only those with update available.
</p>
</dd>
<dt>Category</dt>
-<dd><a name="tlmgr-Category"></a>
+<dd><span id="tlmgr-Category"></span>
<p>Select which categories are shown: packages, collections, and/or
schemes. These are briefly explained in the <a href="#tlmgr-DESCRIPTION">DESCRIPTION</a> section
above.
</p>
</dd>
<dt>Match</dt>
-<dd><a name="tlmgr-Match"></a>
+<dd><span id="tlmgr-Match"></span>
<p>Select packages matching for a specific pattern. By default, this
searches both descriptions and filenames. You can also select a subset
for searching.
</p>
</dd>
<dt>Selection</dt>
-<dd><a name="tlmgr-Selection"></a>
+<dd><span id="tlmgr-Selection"></span>
<p>Select packages to those selected, those not selected, or all. Here,
&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>
-<dd><a name="tlmgr-Display-configuration-buttons"></a>
+<dd><span id="tlmgr-Display-configuration-buttons"></span>
<p>To the right there are three buttons: select all packages, select none
(a.k.a. deselect all), and reset all these filters to the defaults,
i.e., show all available.
@@ -6379,13 +6155,11 @@ i.e., show all available.
</dl>
<hr>
-<a name="tlmgr-Package-list-area"></a>
-<div class="header">
+<span id="tlmgr-Package-list-area"></span><div class="header">
<p>
Next: <a href="#tlmgr-Main-display-action-buttons" accesskey="n" rel="next">tlmgr Main display action buttons</a>, Previous: <a href="#tlmgr-Display-configuration-area" accesskey="p" rel="prev">tlmgr Display configuration area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Package-list-area"></a>
-<h4 class="appendixsubsubsec">B.11.1.2 Package list area</h4>
+<span id="Package-list-area"></span><h4 class="appendixsubsubsec">B.11.1.2 Package list area</h4>
<p>The second are of the main display lists all installed packages. If a
repository is loaded, those that are available but not installed are
@@ -6398,18 +6172,18 @@ further details: the long description, included files, etc.
</p>
<dl compact="compact">
<dt>a checkbox</dt>
-<dd><a name="tlmgr-a-checkbox"></a>
+<dd><span id="tlmgr-a-checkbox"></span>
<p>Used to select particular packages; some of the action buttons (see
below) work only on the selected packages.
</p>
</dd>
<dt>package name</dt>
-<dd><a name="tlmgr-package-name"></a>
+<dd><span id="tlmgr-package-name"></span>
<p>The name (identifier) of the package as given in the database.
</p>
</dd>
<dt>local revision (and version)</dt>
-<dd><a name="tlmgr-local-revision-_0028and-version_0029"></a>
+<dd><span id="tlmgr-local-revision-_0028and-version_0029"></span>
<p>If the package is installed the TeX Live revision number for the
installed package will be shown. If there is a catalogue version given
in the database for this package, it will be shown in parentheses.
@@ -6418,7 +6192,7 @@ guaranteed to reflect what is actually installed.
</p>
</dd>
<dt>remote revision (and version)</dt>
-<dd><a name="tlmgr-remote-revision-_0028and-version_0029"></a>
+<dd><span id="tlmgr-remote-revision-_0028and-version_0029"></span>
<p>If a repository has been loaded the revision of the package in the
repository (if present) is shown. As with the local column, if a
catalogue version is provided it will be displayed. And also as with
@@ -6426,26 +6200,24 @@ the local column, the catalogue version may be stale.
</p>
</dd>
<dt>short description</dt>
-<dd><a name="tlmgr-short-description"></a>
+<dd><span id="tlmgr-short-description"></span>
<p>The short description of the package.
</p>
</dd>
</dl>
<hr>
-<a name="tlmgr-Main-display-action-buttons"></a>
-<div class="header">
+<span id="tlmgr-Main-display-action-buttons"></span><div class="header">
<p>
Previous: <a href="#tlmgr-Package-list-area" accesskey="p" rel="prev">tlmgr Package list area</a>, Up: <a href="#tlmgr-Main-display" accesskey="u" rel="up">tlmgr Main display</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Main-display-action-buttons"></a>
-<h4 class="appendixsubsubsec">B.11.1.3 Main display action buttons</h4>
+<span id="Main-display-action-buttons"></span><h4 class="appendixsubsubsec">B.11.1.3 Main display action buttons</h4>
<p>Below the list of packages are several buttons:
</p>
<dl compact="compact">
<dt>Update all installed</dt>
-<dd><a name="tlmgr-Update-all-installed"></a>
+<dd><span id="tlmgr-Update-all-installed"></span>
<p>This calls <code>tlmgr update --all</code>, i.e., tries to update all available
packages. Below this button is a toggle to allow reinstallation of
previously removed packages as part of this action.
@@ -6455,26 +6227,26 @@ where the checkbox at the beginning of the package line is ticked.
</p>
</dd>
<dt>Update</dt>
-<dd><a name="tlmgr-Update"></a>
+<dd><span id="tlmgr-Update"></span>
<p>Update only the selected packages.
</p>
</dd>
<dt>Install</dt>
-<dd><a name="tlmgr-Install"></a>
+<dd><span id="tlmgr-Install"></span>
<p>Install the selected packages; acts like <code>tlmgr install</code>, i.e., also
installs dependencies. Thus, installing a collection installs all its
constituent packages.
</p>
</dd>
<dt>Remove</dt>
-<dd><a name="tlmgr-Remove"></a>
+<dd><span id="tlmgr-Remove"></span>
<p>Removes the selected packages; acts like <code>tlmgr remove</code>, i.e., it will
also remove dependencies of collections (but not dependencies of normal
packages).
</p>
</dd>
<dt>Backup</dt>
-<dd><a name="tlmgr-Backup"></a>
+<dd><span id="tlmgr-Backup"></span>
<p>Makes a backup of the selected packages; acts like <code>tlmgr backup</code>. This
action needs the option <code>backupdir</code> set (see <code>Options -</code> General&gt;).
</p>
@@ -6482,19 +6254,17 @@ action needs the option <code>backupdir</code> set (see <code>Options -</code> G
</dl>
<hr>
-<a name="tlmgr-Menu-bar"></a>
-<div class="header">
+<span id="tlmgr-Menu-bar"></span><div class="header">
<p>
Next: <a href="#tlmgr-GUI-options" accesskey="n" rel="next">tlmgr GUI options</a>, Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">tlmgr Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Menu-bar"></a>
-<h4 class="appendixsubsec">B.11.2 Menu bar</h4>
+<span id="Menu-bar"></span><h4 class="appendixsubsec">B.11.2 Menu bar</h4>
<p>The following entries can be found in the menu bar:
</p>
<dl compact="compact">
<dt><code>tlmgr</code> menu</dt>
-<dd><a name="tlmgr-tlmgr-menu"></a>
+<dd><span id="tlmgr-tlmgr-menu"></span>
<p>The items here load various repositories: the default as specified in
the TeX Live database, the default network repository, the repository
specified on the command line (if any), and an arbitrarily
@@ -6502,7 +6272,7 @@ manually-entered one. Also has the so-necessary <code>quit</code> operation.
</p>
</dd>
<dt><code>Options menu</code></dt>
-<dd><a name="tlmgr-Options-menu"></a>
+<dd><span id="tlmgr-Options-menu"></span>
<p>Provides access to several groups of options: <code>Paper</code> (configuration of
default paper sizes), <code>Platforms</code> (only on Unix, configuration of the
supported/installed platforms), <code>GUI Language</code> (select language used in
@@ -6522,7 +6292,7 @@ installation; e.g., when a package is renamed.
</p>
</dd>
<dt><code>Actions menu</code></dt>
-<dd><a name="tlmgr-Actions-menu"></a>
+<dd><span id="tlmgr-Actions-menu"></span>
<p>Provides access to several actions: update the filename database (aka
<code>ls-R</code>, <code>mktexlsr</code>, <code>texhash</code>), rebuild all formats (<code>fmtutil-sys
--all</code>), update the font map database (<code>updmap-sys</code>), restore from a backup
@@ -6534,7 +6304,7 @@ on Windows).
</p>
</dd>
<dt><code>Help menu</code></dt>
-<dd><a name="tlmgr-Help-menu"></a>
+<dd><span id="tlmgr-Help-menu"></span>
<p>Provides access to the TeX Live manual (also on the web at
<a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>) and the usual &ldquo;About&rdquo; box.
</p>
@@ -6542,43 +6312,41 @@ on Windows).
</dl>
<hr>
-<a name="tlmgr-GUI-options"></a>
-<div class="header">
+<span id="tlmgr-GUI-options"></span><div class="header">
<p>
Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="GUI-options"></a>
-<h4 class="appendixsubsec">B.11.3 GUI options</h4>
+<span id="GUI-options"></span><h4 class="appendixsubsec">B.11.3 GUI options</h4>
<p>Some generic Perl/Tk options can be specified with <code>tlmgr gui</code> to
control the display:
</p>
<dl compact="compact">
<dt><code>-background</code> <em>color</em></dt>
-<dd><a name="tlmgr-_002dbackground-color"></a>
+<dd><span id="tlmgr-_002dbackground-color"></span>
<p>Set background color.
</p>
</dd>
<dt><code>-font &quot;</code> <em>fontname</em> <em>fontsize</em> <code>&quot;</code></dt>
-<dd><a name="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></a>
+<dd><span id="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></span>
<p>Set font, e.g., <code>tlmgr gui -font &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>
-<dd><a name="tlmgr-_002dforeground-color"></a>
+<dd><span id="tlmgr-_002dforeground-color"></span>
<p>Set foreground color.
</p>
</dd>
<dt><code>-geometry</code> <em>geomspec</em></dt>
-<dd><a name="tlmgr-_002dgeometry-geomspec"></a>
+<dd><span id="tlmgr-_002dgeometry-geomspec"></span>
<p>Set the X geometry, e.g., <code>tlmgr gui -geometry 1024x512-0+0</code> creates
the window of (approximately) the given size in the upper-right corner
of the display.
</p>
</dd>
<dt><code>-xrm</code> <em>xresource</em></dt>
-<dd><a name="tlmgr-_002dxrm-xresource"></a>
+<dd><span id="tlmgr-_002dxrm-xresource"></span>
<p>Pass the arbitrary X resource string <em>xresource</em>.
</p>
</dd>
@@ -6589,13 +6357,11 @@ the Perl/Tk documentation (<a href="http://search.cpan.org/perldoc?Tk">http://se
complete list, and any X documentation for general information.
</p>
<hr>
-<a name="tlmgr-MACHINE_002dREADABLE-OUTPUT"></a>
-<div class="header">
+<span id="tlmgr-MACHINE_002dREADABLE-OUTPUT"></span><div class="header">
<p>
Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">tlmgr AUTHORS AND COPYRIGHT</a>, Previous: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="p" rel="prev">tlmgr GUI FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="MACHINE_002dREADABLE-OUTPUT"></a>
-<h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3>
+<span id="MACHINE_002dREADABLE-OUTPUT"></span><h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3>
<p>With the <code>--machine-readable</code> option, <code>tlmgr</code> writes to stdout in the
fixed line-oriented format described here, and the usual informational
@@ -6609,20 +6375,18 @@ information it needs by reading stdout.
<a href="#tlmgr-option">option</a> actions.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&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">
+<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">
+<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>
<hr>
-<a name="tlmgr-Machine_002dreadable-update-and-install-output"></a>
-<div class="header">
+<span id="tlmgr-Machine_002dreadable-update-and-install-output"></span><div class="header">
<p>
Next: <a href="#tlmgr-Machine_002dreadable-option-output" accesskey="n" rel="next">tlmgr Machine-readable <code>option</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">tlmgr MACHINE-READABLE OUTPUT</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Machine_002dreadable-update-and-install-output"></a>
-<h4 class="appendixsubsec">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</h4>
+<span id="Machine_002dreadable-update-and-install-output"></span><h4 class="appendixsubsec">B.12.1 Machine-readable <code>update</code> and <code>install</code> output</h4>
<p>The output format is as follows:
</p>
@@ -6651,14 +6415,14 @@ and the estimated total time.
</p>
<dl compact="compact">
<dt><code>location-url</code> <em>location</em></dt>
-<dd><a name="tlmgr-location_002durl-location"></a>
+<dd><span id="tlmgr-location_002durl-location"></span>
<p>The <em>location</em> may be a url (including <code>file:///foo/bar/...</code>), or a
directory name (<code>/foo/bar</code>). It is the package repository from which
the new package information was drawn.
</p>
</dd>
<dt><code>total-bytes</code> <em>count</em></dt>
-<dd><a name="tlmgr-total_002dbytes-count"></a>
+<dd><span id="tlmgr-total_002dbytes-count"></span>
<p>The <em>count</em> is simply a decimal number, the sum of the sizes of all the
packages that need updating or installing (which are listed subsequently).
</p>
@@ -6673,54 +6437,54 @@ each line are separated by a tab. Here are the fields.
</p>
<dl compact="compact">
<dt><em>pkgname</em></dt>
-<dd><a name="tlmgr-pkgname"></a>
+<dd><span id="tlmgr-pkgname"></span>
<p>The TeX Live package identifier, with a possible platform suffix for
executables. For instance, <code>pdftex</code> and <code>pdftex.i386-linux</code> are given
as two separate packages, one on each line.
</p>
</dd>
<dt><em>status</em></dt>
-<dd><a name="tlmgr-status"></a>
+<dd><span id="tlmgr-status"></span>
<p>The status of the package update. One character, as follows:
</p>
<dl compact="compact">
<dt><code>d</code></dt>
-<dd><a name="tlmgr-d"></a>
+<dd><span id="tlmgr-d"></span>
<p>The package was removed on the server.
</p>
</dd>
<dt><code>f</code></dt>
-<dd><a name="tlmgr-f"></a>
+<dd><span id="tlmgr-f"></span>
<p>The package was removed in the local installation, even though a
collection depended on it. (E.g., the user ran <code>tlmgr remove
--force</code>.)
</p>
</dd>
<dt><code>u</code></dt>
-<dd><a name="tlmgr-u"></a>
+<dd><span id="tlmgr-u"></span>
<p>Normal update is needed.
</p>
</dd>
<dt><code>r</code></dt>
-<dd><a name="tlmgr-r"></a>
+<dd><span id="tlmgr-r"></span>
<p>Reversed non-update: the locally-installed version is newer than the
version on the server.
</p>
</dd>
<dt><code>a</code></dt>
-<dd><a name="tlmgr-a"></a>
+<dd><span id="tlmgr-a"></span>
<p>Automatically-determined need for installation, the package is new on
the server and is (most probably) part of an installed collection.
</p>
</dd>
<dt><code>i</code></dt>
-<dd><a name="tlmgr-i"></a>
+<dd><span id="tlmgr-i"></span>
<p>Package will be installed and isn&rsquo;t present in the local installation
(action install).
</p>
</dd>
<dt><code>I</code></dt>
-<dd><a name="tlmgr-I"></a>
+<dd><span id="tlmgr-I"></span>
<p>Package is already present but will be reinstalled (action install).
</p>
</dd>
@@ -6728,43 +6492,41 @@ the server and is (most probably) part of an installed collection.
</dd>
<dt><em>localrev</em></dt>
-<dd><a name="tlmgr-localrev"></a>
+<dd><span id="tlmgr-localrev"></span>
<p>The revision number of the installed package, or <code>-</code> if it is not
present locally.
</p>
</dd>
<dt><em>serverrev</em></dt>
-<dd><a name="tlmgr-serverrev"></a>
+<dd><span id="tlmgr-serverrev"></span>
<p>The revision number of the package on the server, or <code>-</code> if it is not
present on the server.
</p>
</dd>
<dt><em>size</em></dt>
-<dd><a name="tlmgr-size"></a>
+<dd><span id="tlmgr-size"></span>
<p>The size in bytes of the package on the server. The sum of all the
package sizes is given in the <code>total-bytes</code> header field mentioned above.
</p>
</dd>
<dt><em>runtime</em></dt>
-<dd><a name="tlmgr-runtime"></a>
+<dd><span id="tlmgr-runtime"></span>
<p>The run time since start of installations or updates.
</p>
</dd>
<dt><em>esttot</em></dt>
-<dd><a name="tlmgr-esttot"></a>
+<dd><span id="tlmgr-esttot"></span>
<p>The estimated total time.
</p>
</dd>
</dl>
<hr>
-<a name="tlmgr-Machine_002dreadable-option-output"></a>
-<div class="header">
+<span id="tlmgr-Machine_002dreadable-option-output"></span><div class="header">
<p>
Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="p" rel="prev">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a>, Up: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="u" rel="up">tlmgr MACHINE-READABLE OUTPUT</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Machine_002dreadable-option-output"></a>
-<h4 class="appendixsubsec">B.12.2 Machine-readable <code>option</code> output</h4>
+<span id="Machine_002dreadable-option-output"></span><h4 class="appendixsubsec">B.12.2 Machine-readable <code>option</code> output</h4>
<p>The output format is as follows:
</p>
@@ -6776,13 +6538,11 @@ Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" access
changes would be helpful, do not hesitate to write the mailing list.
</p>
<hr>
-<a name="tlmgr-AUTHORS-AND-COPYRIGHT"></a>
-<div class="header">
+<span id="tlmgr-AUTHORS-AND-COPYRIGHT"></span><div class="header">
<p>
Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">tlmgr MACHINE-READABLE OUTPUT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="AUTHORS-AND-COPYRIGHT-1"></a>
-<h3 class="appendixsec">B.13 AUTHORS AND COPYRIGHT</h3>
+<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.13 AUTHORS AND COPYRIGHT</h3>
<p>This script and its documentation were written for the TeX Live
distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the
@@ -6792,18 +6552,14 @@ GNU General Public License Version 2 or later.
</p>
<hr>
-<a name="Index"></a>
-<div class="header">
+<span id="Index"></span><div class="header">
<p>
Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="Index-1"></a>
-<h2 class="unnumbered">Index</h2>
+<span id="Index-1"></span><h2 class="unnumbered">Index</h2>
<table><tr><th valign="top">Jump to: &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>
&nbsp;
@@ -6853,7 +6609,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td>&nbsp;</td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-1">-</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_symbol-1">-</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dbindir-configure-option"><code>--bindir configure <span class="roman">option</span></code></a>:</td><td>&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>
@@ -6920,10 +6676,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-_002dC-configure-option"><code>-C configure <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002dj-make-option"><code>-j make <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_symbol-2">.</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002etravis_002eyml"><code>.travis.yml</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#CI-testing-on-Travis_002dCI">CI testing on Travis-CI</a></td></tr>
-<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-adapting-TeX-Live-for-distros">adapting TeX&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-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>
@@ -6938,7 +6691,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-autoconf-macros">autoconf macros</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autoconf-macros">Autoconf macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Automake">Automake</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-B">B</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-B">B</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-biber"><code>biber</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bibtex_002dx"><code>bibtex-x</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp>texk/bibtex-x</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bibtex8"><code>bibtex8</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp>texk/bibtex-x</samp></a></td></tr>
@@ -6947,6 +6700,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-build-directory_002c-required">build directory, required</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Building">Building</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-iteration">build iteration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-iteration">Build iteration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-build-on-demand">build on demand</a>:</td><td>&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>
@@ -6957,8 +6711,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-building-a-distribution">building a distribution</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-building-in-parallel">building in parallel</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-C">C</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-C_002b_002b11_002c-required-by-dvisvgm">C++11, required by <code>dvisvgm</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><th id="Index_cp_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-C_002b_002b11_002c-required">C++11, required</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002c-ANSI_002c-required">C, ANSI, required</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C99_002c-avoided">C99, avoided</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cache-file_002c-for-configure">cache file, for <code>configure</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
@@ -6968,14 +6722,13 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-CC_003dc_002dcompiler"><code>CC=<var>c-compiler</var></code></a>:</td><td>&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-CC_005fBUILD"><code>CC_BUILD</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-chktex"><code>chktex</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ci">ci</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clisp"><code>clisp</code></a>:</td><td>&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-CLISP-1"><code>CLISP</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-CLISP">CLISP</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-clisp_002c-required-by-xindy"><code>clisp</code>, required by <code>xindy</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-Cocoa-Mac-framework_002c-required-by-xetex"><code>Cocoa</code> Mac framework, 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-coding-conventions">coding conventions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Coding-conventions">Coding conventions</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-compilers_002c-C-and-C_002b_002b">compilers, C and C++</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-compilers_002c-C-and-C_002b_002b11">compilers, C and C++11</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-config_002eguess_002c-config_002esub_002c-_2026"><code>config.guess<span class="roman">,</span> config.sub, &hellip;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-options"><code>configure</code> options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options">Configure options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configure-options_002c-for-bibtex_002dx"><code>configure</code> options, for <code>bibtex-x</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fbibtex_002dx">Configure options for <samp>texk/bibtex-x</samp></a></td></tr>
@@ -7004,9 +6757,9 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-CXX"><code>CXX</code></a>:</td><td>&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-CXX_003dc_002b_002b_002dcompiler"><code>CXX=<var>c++-compiler</var></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-D">D</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Debian-installation-of-build-prerequisites">Debian installation of build prerequisites</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
+<tr><th id="Index_cp_letter-D">D</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-declarations-and-definitions_002c-in-source-code">declarations and definitions, in source code</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-declarations-before-statements_002c-avoiding">declarations before statements, avoiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dependencies_002c-with-several-output-files">dependencies, with several output files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-DESTDIR"><code>DESTDIR</code></a>:</td><td>&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-directories_002c-for-installation">directories, for installation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Installation-directories">Installation directories</a></td></tr>
@@ -7015,20 +6768,19 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-dist-and-distcheck-targets-for-make"><code>dist</code> and <code>distcheck</code> targets for <code>make</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-distribution-tarball_002c-making">distribution tarball, making</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-distribution">Build distribution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-distro_002c-building-for">distro, building for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-dvipdfm_002dx"><code>dvipdfm-x</code></a>:</td><td>&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-requirement-for-C_002b_002b11"><code>dvisvgm</code> requirement for 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><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-engine_002c-building-one">engine, building one</a>:</td><td>&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>
<tr><td></td><td valign="top"><a href="#index-extending-TeX-Live">extending TeX&nbsp;Live</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Extending-TeX-Live">Extending TeX&nbsp;Live</a></td></tr>
<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></td><td valign="top"><a href="#index-extra_002f-top_002dlevel-directory"><samp>extra/</samp> top-level directory</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><a name="Index_cp_letter-F">F</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-F">F</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-failure-to-build">failure to build</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-problems">Build problems</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ffcall_002c-required-by-xindy"><code>ffcall</code>, required by <code>xindy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-flags_002c-macros-for-library-and-header">flags, macros for library and header</a>:</td><td>&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>
@@ -7038,9 +6790,12 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-freetype_002dconfig-1"><code>freetype-config</code></a>:</td><td>&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>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-G">G</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-gcc_002c-default-compilers"><code>gcc<span class="roman">, default compilers</span></code></a>:</td><td>&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-general-setup-macros">general setup macros</a>:</td><td>&nbsp;</td><td valign="top"><a href="#General-setup-macros">General setup macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-generic-library-module_002c-adding">generic library module, adding</a>:</td><td>&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-Ghostscript-location-for-Xdvik">Ghostscript location for Xdvik</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-git_002dsvn"><code>git-svn</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transfer-from-Subversion-to-Github">Transfer from Subversion to Github</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-configure-options">global <code>configure</code> options</a>:</td><td>&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-gmake_002c-required"><code>gmake</code>, required</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GNU-make_002c-required">GNU <code>make</code>, required</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
@@ -7048,7 +6803,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-GNU_002fLinux-distro">GNU/Linux distro</a>:</td><td>&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><a name="Index_cp_letter-I">I</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-I">I</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ICU-cross-compiling">ICU cross compiling</a>:</td><td>&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_002dconfig"><code>icu-config</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
@@ -7062,7 +6817,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-introduction">introduction</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Introduction">Introduction</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-iteration-through-sources_002c-by-configure-and-make">iteration through sources, by <code>configure</code> and <code>make</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-iteration">Build iteration</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-K">K</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-K">K</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpathsea-library"><code>kpathsea <span class="roman">library</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#kpathsea-library"><code>kpathsea</code> library</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpathsea_002eac"><code>kpathsea.ac</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#kpathsea-library"><code>kpathsea</code> library</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kpse_002dlibpng_002dflags_002em4"><code>kpse-libpng-flags.m4</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#png-library"><code>png</code> library</a></td></tr>
@@ -7109,11 +6864,13 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-KPSE_005fWITH_005fLIB"><code>KPSE_WITH_LIB</code></a>:</td><td>&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-KPSE_005fWITH_005fTEXLIB"><code>KPSE_WITH_TEXLIB</code></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 colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-L">L</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-large-file-support">large file support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-LATEX"><code>LATEX</code></a>:</td><td>&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-layout-of-sources">layout of sources</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Layout-and-infrastructure">Layout and infrastructure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-LFS-_0028large-file-support_0029">LFS (large file support)</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-libexpat_002c-dependency-of-libfontconfig"><code>libexpat<span class="roman">, dependency of <code>libfontconfig</code></span></code></a>:</td><td>&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-libfontconfig_002c-hack-for-avoiding-linking-dependencies"><code>libfontconfig<span class="roman">, hack for avoiding linking dependencies</span></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-libfreetype"><code>libfreetype</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-libfreetype_002c-and-const"><code>libfreetype</code>, and <code>const</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Const">Const</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-libpng-library"><code>libpng <span class="roman">library</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#png-library"><code>png</code> library</a></td></tr>
@@ -7121,6 +6878,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-library-module_002c-TeX_002dspecific_002c-adding">library module, TeX-specific, adding</a>:</td><td>&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-library-modules">library modules</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Library-modules">Library modules</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-library_002dspecific-configure-options">library-specific <code>configure</code> options</a>:</td><td>&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-libsigsegv_002c-required-by-xindy"><code>libsigsegv</code>, required by <code>xindy</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-libstc_002b_002b_002c-statically-linking"><code>libstc++<span class="roman">, statically linking</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Libtool">Libtool</a>:</td><td>&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-libtool_002c-hack-for-avoiding-excessive-linking"><code>libtool<span class="roman">, hack for avoiding excessive linking</span></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>
@@ -7130,7 +6888,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-lisp_002erun_002c-lisp_002eexe"><code>lisp.run<span class="roman">,</span> lisp.exe</code></a>:</td><td>&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-LittleEndian-architectures">LittleEndian architectures</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 colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-M">M</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-m4_002f-top_002dlevel-directory"><samp>m4/</samp> top-level directory</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-macros_002c-for-compilers">macros, for compilers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-macros_002c-for-libraries">macros, for libraries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Macros-for-libraries">Macros for libraries</a></td></tr>
@@ -7140,6 +6898,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-macros_002c-general-setup">macros, general setup</a>:</td><td>&nbsp;</td><td valign="top"><a href="#General-setup-macros">General setup macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-MAKE"><code>MAKE</code></a>:</td><td>&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-make-_002dt"><code>make -t</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-make-rules_002c-verbose-vs_002e-silent"><code>make</code> rules, verbose vs. silent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_002d_002denable_002dsilent_002drules"><code>--enable-silent-rules</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mf_002dnowin"><code>mf-nowin</code></a>:</td><td>&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-mingw32"><code>mingw32</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-MINGW32_002c-Automake-conditional"><code>MINGW32<span class="roman">, Automake conditional</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Macros-for-Windows">Macros for Windows</a></td></tr>
@@ -7149,18 +6908,19 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-modules_002c-for-programs">modules, for programs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Program-modules">Program modules</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-motif"><code>motif</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-N">N</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-N">N</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-native-cross-compilation">native cross compilation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-compilation">Cross compilation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-O">O</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-O">O</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-OBJCXX_003dobjc_002dcompiler"><code>OBJCXX=<var>objc-compiler</var></code></a>:</td><td>&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-one-engine_002c-building">one engine, building</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-one-package_002c-building">one package, building</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-OpenGL_002c-required-for-Asymptote">OpenGL, required for Asymptote</a>:</td><td>&nbsp;</td><td valign="top"><a href="#asymptote"><code>asymptote</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-operating-system-distribution_002c-building-for">operating system distribution, building for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-otangle"><code>otangle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-overall-build-process">overall build process</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Building">Building</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-P">P</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-P">P</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-parallel-build">parallel build</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-paths_002c-for-installation">paths, for installation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Installation-directories">Installation directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PDF-files_002c-size-of">PDF files, size of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#g_t_002d_002ddisable_002dlargefile"><code>--disable-largefile</code></a></td></tr>
@@ -7179,15 +6939,16 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-program-module_002c-adding">program module, adding</a>:</td><td>&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 colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-R">R</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-reautoconf"><code>reautoconf</code></a>:</td><td>&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-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>
-<tr><th><a name="Index_cp_letter-S">S</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-S">S</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-scripts_002c-linked-and-not-maintained">scripts, linked and not maintained</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Linked-scripts">Linked scripts</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-scrolling"><code>scrolling</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-scrolling_002c-smooth"><code>scrolling, smooth</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SED"><code>SED</code></a>:</td><td>&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-setup-macros_002c-general">setup macros, general</a>:</td><td>&nbsp;</td><td valign="top"><a href="#General-setup-macros">General setup macros</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shared-libraries_002c-using-vs_002e-avoiding">shared libraries, using vs. avoiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
@@ -7208,7 +6969,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-synctex-1">synctex</a>:</td><td>&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-system-distribution_002c-building-for">system distribution, building for</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-T">T</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-t1utils-package"><code>t1utils <span class="roman">package</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#t1utils-package"><code>t1utils</code> package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tangle"><code>tangle</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tests_002c-running">tests, running</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr>
@@ -7220,16 +6981,17 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-directories">top-level directories</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-touching-files-to-avoid-rerunning">touching files to avoid rerunning</a>:</td><td>&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-Travis_002dCI">Travis-CI</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-type-cast_002c-avoiding">type cast, avoiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Const">Const</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-travis_002eyml"><code>travis.yml</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#CI-testing-on-Travis_002dCI">CI testing on Travis-CI</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-type-cast-from-const_002c-avoiding">type cast from const, avoiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Const">Const</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-U">U</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-U">U</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-use_002dcommit_002dtimes_002c-Subversion"><code>use-commit-times<span class="roman">, Subversion</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-V">V</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-V">V</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-variable-declarations_002c-in-source-code">variable declarations, in source code</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-variables-for-configure">variables for <code>configure</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-W">W</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-W">W</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-warning_002c-discards-qualifiers">warning, discards qualifiers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Const">Const</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-WARNING_005fC_005bXX_005dFLAGS"><code>WARNING_C[XX]FLAGS</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Macros-for-compilers">Macros for compilers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-web2c-program"><code>web2c <span class="roman">program</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr>
@@ -7242,11 +7004,12 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-withenable_002eac_002c-for-new-modules"><code>withenable.ac<span class="roman">, for new modules</span></code></a>:</td><td>&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-Work_002f-top_002dlevel-directory"><samp>Work/</samp> top-level directory</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-wrapper-binary-for-scripts-on-Windows">wrapper binary for scripts on Windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Linked-scripts">Linked scripts</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-wrapper-build-system">wrapper build system</a>:</td><td>&nbsp;</td><td valign="top"><a href="#freetype-library"><code>freetype</code> library</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-X">X</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-X">X</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-X-toolkit">X toolkit</a>:</td><td>&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-X11-development_002c-required-by-X-clients">X11 development, required by X clients</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-X11-headers_002c-and-const">X11 headers, and <code>const</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Const">Const</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-X11_002c-required-by-X-clients">X11, required by X clients</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xasy"><code>xasy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#asymptote"><code>asymptote</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xaw"><code>xaw</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xdvik"><code>xdvik</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#xdvik-package"><code>xdvik</code> package</a></td></tr>
@@ -7255,20 +7018,18 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-xindy"><code>xindy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xindy-1"><code>xindy</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#xindy-package"><code>xindy</code> package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xindy-2"><code>xindy</code></a>:</td><td>&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-xindy-cross-compiling-impossible"><code>xindy</code> cross compiling impossible</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-xindy-cross-compiling-requires-clisp"><code>xindy</code> cross compiling requires <code>clisp</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-XInput"><code>XInput</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-texk_002fxdvik">Configure options for <samp>texk/xdvik</samp></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Xlib"><code>Xlib</code></a>:</td><td>&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-xpdf-as-library"><code>xpdf <span class="roman">as library</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Configure-options-for-system-poppler">Configure options for system <code>poppler</code></a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xz"><code>xz</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Linked-scripts">Linked scripts</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
-<tr><th><a name="Index_cp_letter-Z">Z</a></th><td></td><td></td></tr>
+<tr><th id="Index_cp_letter-Z">Z</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-zlib-library"><code>zlib <span class="roman">library</span></code></a>:</td><td>&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>
&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>
&nbsp;