summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-03-13 17:38:53 +0000
committerKarl Berry <karl@freefriends.org>2020-03-13 17:38:53 +0000
commiteaea0d35a703f47bc759ec85ecc1533c8aacc404 (patch)
tree343d24ac887960c960257a545f84767300909154 /Master/texmf-dist/doc/texlive
parent3166b3e1095114d49cbef65216417c43bcd932d7 (diff)
texinfo manual updates for 2020
git-svn-id: svn://tug.org/texlive/trunk@54279 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/texlive')
-rw-r--r--Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html887
-rw-r--r--Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdfbin496534 -> 508822 bytes
2 files changed, 607 insertions, 280 deletions
diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
index 5cdc2124c48..2747b2b718c 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-2019 Karl Berry.
+Copyright (C) 2016-2020 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.6, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
-<title>Building TeX Live (2019)</title>
+<title>Building TeX Live (2020)</title>
-<meta name="description" content="Building TeX Live (2019)">
-<meta name="keywords" content="Building TeX Live (2019)">
+<meta name="description" content="Building TeX Live (2020)">
+<meta name="keywords" content="Building TeX Live (2020)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
@@ -57,7 +57,7 @@ ul.no-bullet {list-style: none}
</head>
<body lang="en">
-<h1 class="settitle" align="center">Building TeX Live (2019)</h1>
+<h1 class="settitle" align="center">Building TeX Live (2020)</h1>
@@ -83,7 +83,7 @@ ul.no-bullet {list-style: none}
<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>
+<li><a id="stoc-Index-1" href="#toc-Index-1" rel="index">Index</a></li>
</ul>
</div>
@@ -196,6 +196,7 @@ ul.no-bullet {list-style: none}
<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>
+ <li><a id="toc-Releases-on-Github-1" href="#Releases-on-Github">9.4 Releases on Github</a></li>
</ul></li>
<li><a id="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
<ul class="no-bullet">
@@ -221,7 +222,7 @@ ul.no-bullet {list-style: none}
<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-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d">B.6.5 check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|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>
@@ -279,9 +280,10 @@ ul.no-bullet {list-style: none}
<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 id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.13 AUTHORS AND COPYRIGHT</a></li>
+ <li><a id="toc-ENVIRONMENT-VARIABLES-1" href="#tlmgr-ENVIRONMENT-VARIABLES">B.13 ENVIRONMENT VARIABLES</a></li>
+ <li><a id="toc-AUTHORS-AND-COPYRIGHT-1" href="#tlmgr-AUTHORS-AND-COPYRIGHT">B.14 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
- <li><a id="toc-Index-1" href="#Index">Index</a></li>
+ <li><a id="toc-Index-1" href="#Index" rel="index">Index</a></li>
</ul>
</div>
@@ -290,7 +292,7 @@ ul.no-bullet {list-style: none}
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Building-TeX-Live-_00282019_0029"></span><h1 class="top">Building TeX Live (2019)</h1>
+<span id="Building-TeX-Live-_00282020_0029"></span><h1 class="top">Building TeX Live (2020)</h1>
<p>For an overview of this manual, see <a href="#Introduction">Introduction</a>.
</p>
@@ -317,7 +319,7 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr">tlmgr</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The native TeX&nbsp;Live package manager.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Index">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
+<tr><td align="left" valign="top">&bull; <a href="#Index" rel="index">Index</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">General index.
</td></tr>
</table>
@@ -331,8 +333,8 @@ Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of b
<span id="index-introduction"></span>
-<p>This manual (dated February 2019) corresponds to the TeX&nbsp;Live
-2019 release.
+<p>This manual (dated March 2020) corresponds to the TeX&nbsp;Live
+2020 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
@@ -473,11 +475,10 @@ Automake/Autoconf output in general) work with any reasonable
<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.
+C++11. It is possible to build everything else with older compilers,
+but you have to remove the C++11-dependent sources. See <a href="#Build-one-package">Build one package</a>.
</p>
-<p>However, a few programs in the tree have additional requirements:
+<p>A few programs in the tree have additional requirements:
</p>
<dl compact="compact">
<dt><samp>web2c</samp></dt>
@@ -488,7 +489,7 @@ for doing this.
<dt><samp>xdvik</samp></dt>
<dt><samp>xpdfopen</samp></dt>
<dd><span id="index-X11-development_002c-required-by-X-clients"></span>
-<p>require X11 headers and libraries, often in &ldquo;development&rdquo; packages
+<p>require X11 headers and libraries, typically in &ldquo;development&rdquo; packages
that are not installed by default.
</p>
</dd>
@@ -506,7 +507,7 @@ frameworks.
<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>
+<code>latex</code>, <code>pdflatex</code>.
</p>
</dd>
</dl>
@@ -708,17 +709,9 @@ However, the <samp>Makefile</samp>s still contain all build rules and
dependencies and can be invoked to build an individual program or
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, 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
-<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
-finish for working on <code>dvipdfm-x</code>.
+<p>Here is an example from start to finish for working on
+<code>dvipdfm-x</code>. (Unfortunately, this does not suffice for building
+one, or a subset, of the TeX engines; see the next section.)
</p>
<div class="example">
<pre class="example">mkdir mydir &amp;&amp; cd mydir # new working directory
@@ -760,7 +753,6 @@ tweak as desired; check the output from <code>configure --help</code>. It
is also a good idea to run <code>make check</code> after making any changes,
to ensure that whatever tests have been written still pass.
</p>
-
<span id="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.
@@ -774,12 +766,23 @@ in the <code>pdftex</code> development source (details at
<a href="http://pdftex.org">http://pdftex.org</a>), which is indeed such a cut-down TL source
tree.
</p>
+<span id="index-C_002b_002b11_002c-removing-dependent-sources"></span>
+<p>Some libraries and programs require C++11. If you want to build with
+an older compiler lacking such support, you need to (re)move those
+source directories; specifying <code>--disable</code> for them does not
+suffice, unfortunately. Specifically, before running <code>configure</code>:
+</p>
+<div class="example">
+<pre class="example">rm -rf libs/icu libs/poppler libs/graphite2 texk/dvisvgm
+</pre></div>
+
<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.
+<p>Also, even with <code>--disable-all-pkgs</code>, dependencies are (currently)
+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 even with <code>--disable-xetex</code>.
+To proceed without such dependencies, specify <code>--enable-missing</code>
+also. (Patches to improve this would be most welcome.)
</p>
<span id="index-CC_003dc_002dcompiler"></span>
<span id="index-CXX_003dc_002b_002b_002dcompiler"></span>
@@ -818,8 +821,9 @@ make luatex # specify target
<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).
+tree can be cut down to just what is needed for the given engine
+(the separate pdfTeX and LuaTeX source repositories do this, if
+you want to peruse examples).
</p>
<p>We hope to improve the situation in the future. Patches are welcome.
</p>
@@ -1275,11 +1279,11 @@ may be.
<div class="display">
<pre class="display">autoconf (GNU Autoconf) 2.69
automake (GNU automake) 1.16.1
-bison (GNU Bison) 3.3.1
+bison (GNU Bison) 3.5.2
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.18
-makeinfo (GNU texinfo) 6.6
+makeinfo (GNU texinfo) 6.7
</pre></div>
<span id="index-reautoconf"></span>
@@ -1303,7 +1307,6 @@ 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
@@ -1312,7 +1315,7 @@ runs of <code>bison</code>, <code>flex</code>, or <code>makeinfo</code> with
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.
+<samp>Makefile.in</samp> files.
</p>
<hr>
@@ -2548,7 +2551,7 @@ 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. See <a href="#Build-one-package">Build one package</a>.
+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
@@ -3175,6 +3178,8 @@ commit pushed is tested on Travis-CI.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Releases-on-Github" accesskey="4">Releases on Github</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
</table>
@@ -3251,7 +3256,7 @@ any) to Github.
<hr>
<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>
+Next: <a href="#Releases-on-Github" accesskey="n" rel="next">Releases on Github</a>, Previous: <a href="#Automatic-update-of-the-Git-mirror" accesskey="p" rel="prev">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="CI-testing-on-Travis_002dCI-1"></span><h3 class="section">9.3 CI testing on Travis-CI</h3>
@@ -3268,6 +3273,26 @@ Travis-CI.
automatically checkout the last pushed commit and try building it.
</p>
<hr>
+<span id="Releases-on-Github"></span><div class="header">
+<p>
+Previous: <a href="#CI-testing-on-Travis_002dCI" accesskey="p" rel="prev">CI testing on Travis-CI</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Releases-on-Github-1"></span><h3 class="section">9.4 Releases on Github</h3>
+
+<p>Given a git checkout of <code>texlive-source</code>:
+</p>
+<div class="example">
+<pre class="example">git pull
+git tag build-svnNNNN
+git push --tags
+</pre></div>
+
+<p>and the result will appear at
+<a href="https://github.com/TeX-Live/texlive-source/releases">https://github.com/TeX-Live/texlive-source/releases</a>.
+Releases can also be made manually from that web page (see
+<code>tl-update-bindir</code> for hints).
+</p>
+<hr>
<span id="install_002dtl"></span><div class="header">
<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>
@@ -3323,10 +3348,10 @@ Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">install-tl R
<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.
-The installer works across all platforms supported by TeX Live. For
-information on initially downloading the TeX Live, see
-<a href="http://tug.org/texlive/acquire.html">http://tug.org/texlive/acquire.html</a>.
+media, including over the network, from local hard disk, a DVD, etc. The
+installer works on all platforms supported by TeX Live. For information
+on initially downloading TeX Live, see
+<a href="https://tug.org/texlive/acquire.html">https://tug.org/texlive/acquire.html</a>.
</p>
<p>The basic idea of TeX Live installation is for you to choose one of the
top-level <em>schemes</em>, each of which is defined as a different set of
@@ -3348,15 +3373,15 @@ Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">install-tl OPTI
</div>
<span id="REFERENCES"></span><h3 class="appendixsec">A.4 REFERENCES</h3>
-<p>Post-installation configuration, package updates, and much more, are
+<p>Post-installation configuration, package updates, and more, are
handled through <strong>tlmgr</strong>(1), the TeX Live Manager
-(<a href="http://tug.org/texlive/tlmgr.html">http://tug.org/texlive/tlmgr.html</a>).
+(<a href="https://tug.org/texlive/tlmgr.html">https://tug.org/texlive/tlmgr.html</a>).
</p>
<p>The most up-to-date version of this installer documentation is on the
-Internet at <a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>.
+Internet at <a href="https://tug.org/texlive/doc/install-tl.html">https://tug.org/texlive/doc/install-tl.html</a>.
</p>
<p>For the full documentation of TeX Live, see
-<a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
+<a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>.
</p>
<hr>
<span id="install_002dtl-OPTIONS"></span><div class="header">
@@ -3372,7 +3397,7 @@ option by either a space or <code>=</code>.
<dl compact="compact">
<dt><strong>-gui</strong> [[=]<em>module</em>]</dt>
<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>If no <em>module</em> is given, starts the Tcl/Tk (see below) GUI installer.
</p>
<p>If <em>module</em> is given loads the given installer module. Currently the
following modules are supported:
@@ -3384,93 +3409,92 @@ following modules are supported:
<code>-no-gui</code> option.
</p>
</dd>
+<dt><code>tcl</code></dt>
+<dd><span id="install_002dtl-tcl"></span>
+<p>The Tcl/Tk user interface (default on Macs and Windows). It starts
+with a small number of configuration options, roughly equivalent
+to what the wizard option below offers, but a button <code>Advanced</code>
+takes you to a screen with roughly the same options as the <code>perltk</code>
+interface.
+</p>
+</dd>
<dt><code>wizard</code></dt>
<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>The wizard mode user interface, asking only minimal questions before
+installing all of TeX Live.
+</p>
+</dd>
+<dt><code>expert</code></dt>
+<dd><span id="install_002dtl-expert"></span>
+<p>A generic name for, currently, <code>perltk</code>; it may select a different GUI
+in the future.
</p>
</dd>
<dt><code>perltk</code></dt>
<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>The expert GUI installer, providing access to more options.
</p>
</dd>
</dl>
-<p>The <code>perltk</code> and <code>wizard</code> modules, and thus also when calling with
-bare <code>-gui</code> (with no <em>module</em>), require the Perl/Tk module
-(<a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a>); if Perl/Tk is not
-available, installation continues in text mode.
+<p>The <code>perltk</code> and <code>wizard</code> modules require the Perl/Tk module
+(<a href="https://tug.org/texlive/distro.html#perltk">https://tug.org/texlive/distro.html#perltk</a>). if Perl/Tk is not
+available, installation continues in text mode, except on Windows,
+where all gui options except <code>text</code> are diverted to the default
+<code>tcl</code> GUI.
+</p>
+<p>The <code>tcl</code> GUI requires Tcl/Tk. This is standard on Macs and is often
+already installed on GNU/Linux. For Windows, TeX Live provides a Tcl/Tk
+runtime.
</p>
</dd>
<dt><strong>-no-gui</strong></dt>
<dd><span id="install_002dtl-_002dno_002dgui"></span>
-<p>Use the text mode installer (default except on Windows).
+<p>Use the text mode installer (default except on Windows and Macs).
</p>
</dd>
<dt><strong>-lang</strong> <em>llcode</em></dt>
<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
-language code (based on ISO 639-1). Currently supported (but not
-necessarily completely translated) are: English (en, default), Czech
-(cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl),
-Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk),
-Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi),
-simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
+<p>By default, the GUI tries to deduce your language from the
+environment. The Tcl GUI uses the language detection built into
+Tcl/Tk; the Perl/Tk GUIs use the <code>LC_MESSAGES</code> environment
+variable. If that fails you can select a different language by
+giving this option with a language code (based on ISO 639-1).
+Currently supported (but not necessarily completely translated) are:
+English (en, default), Czech (cs), German (de), French (fr), Italian
+(it), Japanese (ja), Dutch (nl), Polish (pl), Brazilian Portuguese
+(pt_BR), Russian (ru), Slovak (sk), Slovenian (sl), Serbian (sr),
+Ukrainian (uk), Vietnamese (vi), simplified Chinese (zh_CN), and
+traditional Chinese (zh_TW).
</p>
</dd>
<dt><strong>-repository</strong> <em>url|path</em></dt>
<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
-<code>ftp://</code> url. (No other protocols are supported, and <code>https://</code> may
-not work on all platforms.)
+installation. In short, this can be a directory name or a url using
+http(s), ftp, or scp. The documentation for <code>tlmgr</code> has the details
+(<a href="https://tug.org/texlive/doc/tlmgr.html#OPTIONS">https://tug.org/texlive/doc/tlmgr.html#OPTIONS</a>).
</p>
-<p>The default is to pick a mirror automatically, using
+<p>For installation, the default is to pick a mirror automatically, using
<a href="http://mirror.ctan.org/systems/texlive/tlnet">http://mirror.ctan.org/systems/texlive/tlnet</a>; the chosen mirror is
-used for the entire download. You can use the special argument <code>ctan</code>
-as an abbreviation for this. See <a href="http://ctan.org">http://ctan.org</a> for more about CTAN
-and its mirrors.
-</p>
-<p>If the repository is on the network, trailing <code>/</code> characters and/or
-trailing <code>/tlpkg</code> and <code>/archive</code> components are ignored. For example,
-you could choose a particular CTAN mirror with something like this:
+used for the entire download. You can use the special argument <code>ctan</code>
+as an abbreviation for this. (See <a href="https://ctan.org">https://ctan.org</a> for more about CTAN
+and its mirrors.)
</p>
-<pre class="verbatim"> -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
-</pre>
-<p>Of course a real hostname and its particular top-level CTAN directory
-have to be specified. The list of CTAN mirrors is available at
-<a href="http://ctan.org/mirrors">http://ctan.org/mirrors</a>.
-</p>
-<p>If the repository is local, the installation type (compressed or live) is
-automatically determined, by checking for the presence of a
-<code>archive</code> directory relative to the root. Compressed is
-preferred if both are available, since it is faster. Here&rsquo;s an example
-of using a local directory:
-</p>
-<pre class="verbatim"> -repository /local/TL/repository
-</pre>
<p>After installation is complete, you can use that installation as the
repository for another installation. If you chose to install less than
the full scheme containing all packages, the list of available schemes
will be adjusted accordingly.
</p>
-<p>For backward compatibility and convenience, <code>--location</code> and <code>--repo</code>
-are accepted as aliases for this option.
-</p>
</dd>
<dt><strong>-select-repository</strong></dt>
<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
-if available, or from a repository specified on the command line (see
-above). It&rsquo;s useful when the (default) automatic redirection does not
-choose a good host for you.
+<p>This option allows you to choose a particular mirror from the current
+list of active CTAN mirrors. This option is supported in the <code>text</code>,
+<code>wizard</code> and <code>perltk</code> installer modes, and will also offer to install
+from local media if available, or from a repository specified on the
+command line. It&rsquo;s useful when the (default) automatic redirection does
+not choose a good host for you.
</p>
</dd>
<dt><strong>-all-options</strong></dt>
@@ -3494,14 +3518,14 @@ actions. To install multiple custom binary sets, manually rename
<code>custom</code> before doing each.
</p>
<p>For more information on custom binaries, see
-<a href="http://tug.org/texlive/custom-bin.html">http://tug.org/texlive/custom-bin.html</a>. For general information on
-building TeX Live, see <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>.
+<a href="https://tug.org/texlive/custom-bin.html">https://tug.org/texlive/custom-bin.html</a>. For general information on
+building TeX Live, see <a href="https://tug.org/texlive/build.html">https://tug.org/texlive/build.html</a>.
</p>
</dd>
<dt><strong>-debug-translation</strong></dt>
<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
+<p>In the Perl/Tk GUI modes, this option reports any missing, or more
+likely untranslated, messages to standard error. Helpful for
translators to see what remains to be done.
</p>
</dd>
@@ -3514,12 +3538,12 @@ runnable, or installation will fail. <code>-force-arch</code> is a synonym.
</dd>
<dt><strong>-help</strong>, <strong>&ndash;help</strong>, <strong>-?</strong></dt>
<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,
-possibly resulting in control characters being literally output. This
-can&rsquo;t always be detected, but you can set the <code>NOPERLDOC</code> environment
-variable and <code>perldoc</code> will not be used.
+<p>Display this help and exit. (This help is also on the web at
+<a href="https://tug.org/texlive/doc/install-tl.html">https://tug.org/texlive/doc/install-tl.html</a>). Sometimes the <code>perldoc</code>
+and/or <code>PAGER</code> programs on the system have problems, possibly resulting
+in control characters being literally output. This can&rsquo;t always be
+detected, but you can set the <code>NOPERLDOC</code> environment variable and
+<code>perldoc</code> will not be used.
</p>
</dd>
<dt><strong>-in-place</strong></dt>
@@ -3535,9 +3559,9 @@ installer interfaces. USE AT YOUR OWN RISK.
</dd>
<dt><strong>-init-from-profile</strong> <em>profile_file</em></dt>
<dd><span id="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></span>
-<p>Similar to <strong>-profile</strong> (see <a href="#install_002dtl-PROFILES">PROFILES</a> below), but only initializes the
-installation configuration from <em>profile_file</em> and then starts the
-interactive session.
+<p>Similar to <strong>-profile</strong> (see <a href="#install_002dtl-PROFILES">PROFILES</a> below), but only initializes
+the installation configuration from <em>profile_file</em> and then starts a
+normal interactive session. Environment variables are not ignored.
</p>
</dd>
<dt><strong>-logfile</strong> <em>file</em></dt>
@@ -3557,16 +3581,11 @@ release.
a new menu (for debugging purposes).
</p>
</dd>
-<dt><strong>-non-admin</strong></dt>
-<dd><span id="install_002dtl-_002dnon_002dadmin"></span>
-<p>For Windows only: configure for the current user, not for all users.
-</p>
+<dt><strong>-no-persistent-downloads</strong></dt>
+<dd><span id="install_002dtl-_002dno_002dpersistent_002ddownloads"></span>
</dd>
<dt><strong>-persistent-downloads</strong></dt>
<dd><span id="install_002dtl-_002dpersistent_002ddownloads"></span>
-</dd>
-<dt><strong>-no-persistent-downloads</strong></dt>
-<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
@@ -3584,7 +3603,12 @@ LWP and persistent connections, use <code>-no-persistent-downloads</code>.
verified against a cryptographic signature. This option disables such
verification. The full description is in the Crytographic Verification
section of the <code>tlmgr</code> documentation, e.g.,
-<a href="http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION">http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION</a>
+<a href="https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION">https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION</a>
+</p>
+</dd>
+<dt><strong>-non-admin</strong></dt>
+<dd><span id="install_002dtl-_002dnon_002dadmin"></span>
+<p>For Windows only: configure for the current user, not for all users.
</p>
</dd>
<dt><strong>-portable</strong></dt>
@@ -3603,7 +3627,8 @@ within the perltk and text installers.
<dt><strong>-profile</strong> <em>profile_file</em></dt>
<dd><span id="install_002dtl-_002dprofile-profile_005ffile"></span>
<p>Load <em>profile_file</em> and do the installation with no user interaction,
-that is, a batch (unattended) install. See <a href="#install_002dtl-PROFILES">PROFILES</a> below.
+that is, a batch (unattended) install. Environment variables are
+ignored. See <a href="#install_002dtl-PROFILES">PROFILES</a> below.
</p>
</dd>
<dt><strong>-q</strong></dt>
@@ -3630,8 +3655,8 @@ menu list.
</dd>
<dt><strong>-version</strong>, <strong>&ndash;version</strong></dt>
<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>Output version information and exit. If <code>-v</code> is also given, the
+versions of the TeX Live modules used are also reported.
</p>
</dd>
</dl>
@@ -3647,11 +3672,17 @@ Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">i
installation. After a normal installation has finished, a profile for
that exact installation is written to the file <code>tlpkg/texlive.profile</code>.
In addition, from the text menu one can select <code>P</code> to save the current
-setup as a profile at any time. Such a profile file can be given as the
-argument to <code>-profile</code>, for example to redo the exact same installation
-on a different system. Alternatively, you can use a custom profile,
-most easily created by starting from a generated one and changing
-values, or an empty file, which will take all the defaults.
+setup as a profile at any time.
+</p>
+<p>Such a profile file can be given as the argument to <code>-profile</code>, for
+example to redo the exact same installation on a different system.
+Alternatively, you can use a custom profile, most easily created by
+starting from a generated one and changing values, or an empty file,
+which will take all the defaults.
+</p>
+<p>As mentioned above, the installer only supports selection by scheme and
+collections, not individual packages, so packages cannot be specified in
+profile files either. Use <code>tlmgr</code> to work at the package level.
</p>
<p>Within a profile file, each line consists of
</p>
@@ -3738,7 +3769,7 @@ see <code>-repository</code> above.
<p><strong>tlpdb options</strong> (prefix <code>tlpdbopt_</code>)
</p>
-<p>The definitive list is given in <code>tlpkg/TeXLive/TLConfig.pm</code>, in
+<p>The definitive list is given in <code>tlpkg/TeXLive/TLConfig.pm</code>, in the hash
<code>%TeXLive::TLConfig::TLPDBOptions</code>, together with explanations. All
items given there <em>except</em> for <code>tlpdbopt_location</code> can be specified.
Here is the current list:
@@ -3760,11 +3791,11 @@ Here is the current list:
<p><strong>platform options</strong> (prefix <code>binary_</code>)
</p>
<p>For each supported platform in TeX Live (directories under <code>bin/</code>), the
-variable <code>binary_</code><em>PLATFORM</em> can be set. For example:
+variable <code>binary_</code><em>PLATFORM</em> can be set with value 1. For example:
</p>
-<pre class="verbatim"> binary_x86_64-linux
+<pre class="verbatim"> binary_x86_64-linux 1
</pre>
-<p>If no <code>binary_</code> variable is specified, the default is whatever the
+<p>If no <code>binary_</code> settings are made, the default is whatever the
current machine is running.
</p>
<p>In releases before 2017, many profile variables had different
@@ -3773,7 +3804,7 @@ accepted and transformed to the names given above. When a profile is
written, the names above are always used.
</p>
<p>For more details on all of the above options, consult the TeX Live
-installation manual, linked from <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
+installation manual, linked from <a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a>.
</p>
<hr>
<span id="install_002dtl-ENVIRONMENT-VARIABLES"></span><div class="header">
@@ -3782,11 +3813,24 @@ Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">i
</div>
<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
+<p>For ease in scripting and debugging, <code>install-tl</code> looks for the
+following environment variables. They are not of interest for normal
user installations.
</p>
<dl compact="compact">
+<dt><code>TEXLIVE_DOWNLOADER</code></dt>
+<dd><span id="install_002dtl-TEXLIVE_005fDOWNLOADER"></span>
+</dd>
+<dt><code>TL_DOWNLOAD_PROGRAM</code></dt>
+<dd><span id="install_002dtl-TL_005fDOWNLOAD_005fPROGRAM"></span>
+</dd>
+<dt><code>TL_DOWNLOAD_ARGS</code></dt>
+<dd><span id="install_002dtl-TL_005fDOWNLOAD_005fARGS"></span>
+<p>These override the normal choice of a download program; see the <code>tlmgr</code>
+documentation, e.g.,
+<a href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>.
+</p>
+</dd>
<dt><code>TEXLIVE_INSTALL_ENV_NOCHECK</code></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fENV_005fNOCHECK"></span>
<p>Omit the check for environment variables containing the string <code>tex</code>.
@@ -3799,10 +3843,16 @@ variables.
<p>Omit creating the ConTeXt cache. This is useful for redistributors.
</p>
</dd>
+<dt><code>TEXLIVE_INSTALL_NO_IMPORT</code></dt>
+<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fIMPORT"></span>
+<p>Omit check for installing on top of a previous installation and then
+asking about importing previous settings.
+</p>
+</dd>
<dt><code>TEXLIVE_INSTALL_NO_WELCOME</code></dt>
<dd><span id="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></span>
<p>Omit printing the welcome message after successful installation, e.g.,
-for testing.
+when testing.
</p>
</dd>
<dt><code>TEXLIVE_INSTALL_PREFIX</code></dt>
@@ -3850,10 +3900,10 @@ Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="pre
<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
+distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
-<p>$Id: install-tl 46908 2018-03-10 00:46:28Z preining $
+<p>$Id: install-tl 54143 2020-03-06 23:51:18Z karl $
</p>
<hr>
<span id="tlmgr"></span><div class="header">
@@ -3887,6 +3937,8 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#i
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">tlmgr MACHINE-READABLE OUTPUT</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-ENVIRONMENT-VARIABLES">tlmgr ENVIRONMENT VARIABLES</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-AUTHORS-AND-COPYRIGHT">tlmgr AUTHORS AND COPYRIGHT</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>
@@ -3918,11 +3970,11 @@ Next: <a href="#tlmgr-EXAMPLES" accesskey="n" rel="next">tlmgr EXAMPLES</a>, Pre
<p><strong>tlmgr</strong> manages an existing TeX Live installation, both packages and
configuration options. For information on initially downloading and
-installing TeX Live, see <a href="http://tug.org/texlive/acquire.html">http://tug.org/texlive/acquire.html</a>.
+installing TeX Live, see <a href="https://tug.org/texlive/acquire.html">https://tug.org/texlive/acquire.html</a>.
</p>
<p>The most up-to-date version of this documentation (updated nightly from
the development sources) is available at
-<a href="http://tug.org/texlive/tlmgr.html">http://tug.org/texlive/tlmgr.html</a>, along with procedures for updating
+<a href="https://tug.org/texlive/tlmgr.html">https://tug.org/texlive/tlmgr.html</a>, along with procedures for updating
<code>tlmgr</code> itself and information about test versions.
</p>
<p>TeX Live is organized into a few top-level <em>schemes</em>, each of which is
@@ -3932,7 +3984,7 @@ files. Schemes typically contain a mix of collections and packages, but
each package is included in exactly one collection, no more and no less.
A TeX Live installation can be customized and managed at any level.
</p>
-<p>See <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a> for all the TeX Live documentation
+<p>See <a href="https://tug.org/texlive/doc">https://tug.org/texlive/doc</a> for all the TeX Live documentation
available.
</p>
<hr>
@@ -3954,9 +4006,13 @@ with <code>tlmgr</code>:
<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
-the given url. Caveat: <code>mirror.ctan.org</code> resolves to many different
-hosts, and they are not perfectly synchronized; we recommend updating
-only daily (at most), and not more often.
+the given url.
+</p>
+<p>Caveat: <code>mirror.ctan.org</code> resolves to many different hosts, and they
+are not perfectly synchronized; we recommend updating only daily (at
+most), and not more often. You can choose a particular mirror if
+problems; the list of all CTAN mirrors with the status of each is at
+<a href="https://ctan.org/mirrors/mirmon">https://ctan.org/mirrors/mirmon</a>.
</p>
</dd>
<dt><code>tlmgr update --list</code></dt>
@@ -3998,32 +4054,117 @@ between an option name and its value.
<dl compact="compact">
<dt><strong>&ndash;repository</strong> <em>url|path</em></dt>
<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
-entirely in the file <code>tlpkg/texlive.tlpdb</code>). The documentation for
-<code>install-tl</code> has more details about this
-(<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>).
-</p>
-<p><code>--repository</code> changes the repository location only for the current
+<p>Specify the package repository from which packages should be installed
+or updated, either a local directory or network location, as below. This
+overridesthe default package repository found in the installation&rsquo;s TeX
+Live Package Database (a.k.a. the TLPDB, which is given entirely in the
+file <code>tlpkg/texlive.tlpdb</code>).
+</p>
+<p>This <code>--repository</code> option changes the location only for the current
run; to make a permanent change, use <code>option repository</code> (see the
<a href="#tlmgr-option">option</a> action).
</p>
+<p>As an example, you can choose a particular CTAN mirror with something
+like this:
+</p>
+<pre class="verbatim"> -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
+</pre>
+<p>Of course a real hostname and its particular top-level CTAN directory
+have to be specified. The list of CTAN mirrors is available at
+<a href="https://ctan.org/mirrors/mirmon">https://ctan.org/mirrors/mirmon</a>.
+</p>
+<p>Here&rsquo;s an example of using a local directory:
+</p>
+<pre class="verbatim"> -repository /local/TL/repository
+</pre>
<p>For backward compatibility and convenience, <code>--location</code> and <code>--repo</code>
are accepted as aliases for this option.
</p>
+<p>Locations can be specified as any of the following:
+</p>
+<dl compact="compact">
+<dt><code>/some/local/dir</code></dt>
+<dd><span id="tlmgr-_002fsome_002flocal_002fdir"></span>
+</dd>
+<dt><code>file:/some/local/dir</code></dt>
+<dd><span id="tlmgr-file_003a_002fsome_002flocal_002fdir"></span>
+<p>Equivalent ways of specifying a local directory.
+</p>
+</dd>
+<dt><code>ctan</code></dt>
+<dd><span id="tlmgr-ctan"></span>
+</dd>
+<dt><code>http://mirror.ctan.org/systems/texlive/tlnet</code></dt>
+<dd><span id="tlmgr-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></span>
+<p>Pick a CTAN mirror automatically, trying for one that is both nearby and
+up-to-date. The chosen mirror is used for the entire download. The bare
+<code>ctan</code> is merely an alias for the full url. (See <a href="https://ctan.org">https://ctan.org</a> for
+more about CTAN and its mirrors.)
+</p>
+</dd>
+<dt><code>http://server/path/to/tlnet</code></dt>
+<dd><span id="tlmgr-http_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span>
+<p>Standard HTTP. If the (default) LWP method is used, persistent
+connections are supported. TL can also use <code>curl</code> or <code>wget</code> to do the
+downloads, or an arbitrary user-specified program, as described in the
+<code>tlmgr</code> documentation
+(<a href="https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES">https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES</a>).
+</p>
+</dd>
+<dt><code>https://server/path/to/tlnet</code></dt>
+<dd><span id="tlmgr-https_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span>
+<p>Again, if the (default) LWP method is used, this supports persistent
+connections. Unfortunately, some versions of <code>wget</code> and <code>curl</code> do not
+support https, and even when <code>wget</code> supports https, certificates may be
+rejected even when the certificate is fine, due to a lack of local
+certificate roots. The simplest workaround for this problem is to use
+http or ftp.
+</p>
+</dd>
+<dt><code>ftp://server/path/to/tlnet</code></dt>
+<dd><span id="tlmgr-ftp_003a_002f_002fserver_002fpath_002fto_002ftlnet"></span>
+<p>If the (default) LWP method is used, persistent connections are
+supported.
+</p>
+</dd>
+<dt><code>user@machine:/path/to/tlnet</code></dt>
+<dd><span id="tlmgr-user_0040machine_003a_002fpath_002fto_002ftlnet"></span>
+</dd>
+<dt><code>scp://user@machine/path/to/tlnet</code></dt>
+<dd><span id="tlmgr-scp_003a_002f_002fuser_0040machine_002fpath_002fto_002ftlnet"></span>
+</dd>
+<dt><code>ssh://user@machine/path/to/tlnet</code></dt>
+<dd><span id="tlmgr-ssh_003a_002f_002fuser_0040machine_002fpath_002fto_002ftlnet"></span>
+<p>These forms are equivalent; they all use <code>scp</code> to transfer files. Using
+<code>ssh-agent</code> is recommended. (Info:
+<a href="https://en.wikipedia.org/wiki/OpenSSH">https://en.wikipedia.org/wiki/OpenSSH</a>,
+<a href="https://en.wikipedia.org/wiki/Ssh-agent">https://en.wikipedia.org/wiki/Ssh-agent</a>.)
+</p>
+</dd>
+</dl>
+
+<p>If the repository is on the network, trailing <code>/</code> characters and/or
+trailing <code>/tlpkg</code> and/or <code>/archive</code> components are ignored.
+</p>
</dd>
<dt><strong>&ndash;gui</strong> [<em>action</em>]</dt>
<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
-example, running
+<p>Two notable GUI front-ends for <code>tlmgr</code>, <code>tlshell</code> and <code>tlcockpit</code>,
+are started up as separate programs; see their own documentation.
+</p>
+<p><code>tlmgr</code> itself has a graphical interface as well as the command line
+interface. You can give the option to invoke it, <code>--gui</code>, together with
+an action to be brought directly into the respective screen of the GUI.
+For example, running
</p>
<pre class="verbatim"> tlmgr --gui update
</pre>
<p>starts you directly at the update screen. If no action is given, the
-GUI will be started at the main screen.
+GUI will be started at the main screen. See <a href="#tlmgr-GUI-FOR-TLMGR">GUI FOR TLMGR</a>.
+</p>
+<p>However, the native GUI requires Perl/TK, which is no longer included in
+TeX Live&rsquo;s Perl distribution for Windows. You may find <code>tlshell</code> or
+<code>tlcockpit</code> easier to work with.
</p>
</dd>
<dt><strong>&ndash;gui-lang</strong> <em>llcode</em></dt>
@@ -4031,12 +4172,12 @@ GUI will be started at the main screen.
<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
-language code (based on ISO 639-1). Currently supported (but not
-necessarily completely translated) are: English (en, default), Czech
-(cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl),
-Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk),
-Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi),
-simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
+language code (based on ISO 639-1). Currently supported (but not
+necessarily completely translated) are: English&nbsp;(en,&nbsp;default)<!-- /@w -->,
+Czech&nbsp;(cs)<!-- /@w -->, German&nbsp;(de)<!-- /@w -->, French&nbsp;(fr)<!-- /@w -->, Italian&nbsp;(it)<!-- /@w -->,
+Japanese&nbsp;(ja)<!-- /@w -->, Dutch&nbsp;(nl)<!-- /@w -->, Polish&nbsp;(pl)<!-- /@w -->, Brazilian&nbsp;Portuguese&nbsp;<span class="nolinebreak">(pt_BR)</span><!-- /@w -->, Russian&nbsp;(ru)<!-- /@w -->, Slovak&nbsp;(sk)<!-- /@w -->, Slovenian&nbsp;(sl)<!-- /@w -->, Serbian&nbsp;(sr)<!-- /@w -->, Ukrainian&nbsp;(uk)<!-- /@w -->, Vietnamese&nbsp;(vi)<!-- /@w -->, simplified&nbsp;Chinese&nbsp;<span class="nolinebreak">(zh_CN)</span><!-- /@w -->, and traditional&nbsp;Chinese&nbsp;<span class="nolinebreak">(zh_TW)</span><!-- /@w -->.
+</p>
+<p>tlshell shares its message catalog with tlmgr.
</p>
</dd>
<dt><strong>&ndash;debug-translation</strong></dt>
@@ -4143,7 +4284,7 @@ Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlm
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-candidates-pkg" accesskey="4">tlmgr candidates <em>pkg</em></a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_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-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-conf" accesskey="6">tlmgr conf</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
@@ -4205,7 +4346,7 @@ Next: <a href="#tlmgr-version" accesskey="n" rel="next">tlmgr version</a>, Up: <
<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
+web at <a href="https://tug.org/texlive/doc/tlmgr.html">https://tug.org/texlive/doc/tlmgr.html</a>). Sometimes the
<code>perldoc</code> and/or <code>PAGER</code> programs on the system have problems,
resulting in control characters being literally output. This can&rsquo;t
always be detected, but you can set the <code>NOPERLDOC</code> environment
@@ -4237,10 +4378,12 @@ Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">tlmgr candidates
<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
-writable directory. If <code>--backupdir</code> is not given, the <code>backupdir</code>
-option setting in the TLPDB is used, if present. If both are missing,
-no backups are made.
+saved to the value of the <code>--backupdir</code> option, if that is an existing
+and writable directory. If <code>--backupdir</code> is not given, the <code>backupdir</code>
+option setting in the TLPDB is used, if present. If both are missing, no
+backups are made. (The installer sets <code>backupdir</code> to
+<code>.../tlpkg/backups</code>, under the TL root installation directory, so it is
+usually defined; see the <a href="#tlmgr-option">option</a> description for more information.)
</p>
<p>If the <code>--clean</code> option is specified, backups are pruned (removed)
instead of saved. The optional integer value <em>N</em> may be specified to
@@ -4288,7 +4431,7 @@ performed are written to the terminal.
<hr>
<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>
+Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">tlmgr backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="candidates-pkg"></span><h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
@@ -4296,21 +4439,17 @@ Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepen
See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below.
</p>
<hr>
-<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></span><div class="header">
+<span id="tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_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>
-<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>
+<span id="check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d"></span><h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</h4>
-<p>Executes one (or all) check(s) on the consistency of the installation.
+<p>Execute one (or all) check(s) of the consistency of the installation.
+If no problems are found, there will be no output. (To get a view of
+what is being done, run <code>tlmgr -v check</code>.)
</p>
<dl compact="compact">
-<dt><strong>files</strong></dt>
-<dd><span id="tlmgr-files"></span>
-<p>Checks that all files listed in the local TLPDB (<code>texlive.tlpdb</code>) are
-actually present, and lists those missing.
-</p>
-</dd>
<dt><strong>depends</strong></dt>
<dd><span id="tlmgr-depends"></span>
<p>Lists those packages which occur as dependencies in an installed collection,
@@ -4327,12 +4466,40 @@ instead since former versions for <code>tlmgr</code> called it that way.
Live Database are present.
</p>
</dd>
+<dt><strong>files</strong></dt>
+<dd><span id="tlmgr-files"></span>
+<p>Checks that all files listed in the local TLPDB (<code>texlive.tlpdb</code>) are
+actually present, and lists those missing.
+</p>
+</dd>
<dt><strong>runfiles</strong></dt>
<dd><span id="tlmgr-runfiles"></span>
<p>List those filenames that are occurring more than one time in the
-runfiles sections.
+runfiles sections, except for known duplicates.
</p>
</dd>
+<dt><strong>texmfdbs</strong></dt>
+<dd><span id="tlmgr-texmfdbs"></span>
+<p>Checks related to the <code>ls-R</code> files. If you have defined new trees, or
+changed the <code>TEXMF</code> or <code>TEXMFDBS</code> variables, it can&rsquo;t hurt to run
+this. It checks that:
+</p>
+<dl compact="compact">
+<dt>- all items in <code>TEXMFDBS</code> have the <code>!!</code> prefix.</dt>
+<dd><span id="tlmgr-_002d-all-items-in-TEXMFDBS-have-the-_0021_0021-prefix_002e"></span>
+</dd>
+<dt>- all items in <code>TEXMFBDS</code> have an <code>ls-R</code> file (if they exist at all).</dt>
+<dd><span id="tlmgr-_002d-all-items-in-TEXMFBDS-have-an-ls_002dR-file-_0028if-they-exist-at-all_0029_002e"></span>
+</dd>
+<dt>- all items in <code>TEXMF</code> with <code>!!</code> are listed in <code>TEXMFDBS</code>.</dt>
+<dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-_0021_0021-are-listed-in-TEXMFDBS_002e"></span>
+</dd>
+<dt>- all items in <code>TEXMF</code> with an <code>ls-R</code> file are listed in <code>TEXMFDBS</code>.</dt>
+<dd><span id="tlmgr-_002d-all-items-in-TEXMF-with-an-ls_002dR-file-are-listed-in-TEXMFDBS_002e"></span>
+</dd>
+</dl>
+
+</dd>
</dl>
<p>Options:
@@ -4341,7 +4508,7 @@ runfiles sections.
<dt><strong>&ndash;use-svn</strong></dt>
<dd><span id="tlmgr-_002d_002duse_002dsvn"></span>
<p>Use the output of <code>svn status</code> instead of listing the files; for
-checking the TL development repository.
+checking the TL development repository. (This is run nightly.)
</p>
</dd>
</dl>
@@ -4349,7 +4516,7 @@ checking the TL development repository.
<hr>
<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>
+Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bdepends_007cexecutes_007cfiles_007crunfiles_007ctexmfdbs_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [depends|executes|files|runfiles|texmfdbs|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="conf"></span><h4 class="appendixsubsec">B.6.6 conf</h4>
@@ -4357,8 +4524,8 @@ Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_
<dt><strong>conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</strong></dt>
<dd><span id="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></span>
</dd>
-<dt><strong>conf auxtrees [&ndash;conffile <em>file</em>] [show|add|delete] [<em>value</em>]</strong></dt>
-<dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></span>
+<dt><strong>conf auxtrees [&ndash;conffile <em>file</em>] [show|add|remove] [<em>value</em>]</strong></dt>
+<dd><span id="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cremove_005d-_005bvalue_005d"></span>
<p>With only <code>conf</code>, show general configuration information for TeX Live,
including active configuration files, path settings, and more. This is
like running <code>texconfig conf</code>, but works on all supported platforms.
@@ -4391,15 +4558,16 @@ additional texmf trees, completely under user control. <code>auxtrees show</cod
shows the list of additional trees, <code>auxtrees add</code> <em>tree</em> adds a tree
to the list, and <code>auxtrees remove</code> <em>tree</em> removes a tree from the list
(if present). The trees should not contain an <code>ls-R</code> file (or files
-might not be found if the <code>ls-R</code> becomes stale). This works by
-manipulating the Kpathsea variable <code>TEXMFAUXTREES</code>, in
+will not be found if the <code>ls-R</code> becomes stale). This works by
+manipulating the Kpathsea variable <code>TEXMFAUXTREES</code>, in (by default)
<code>ROOT/texmf.cnf</code>. Example:
</p>
<pre class="verbatim"> tlmgr conf auxtrees add /quick/test/tree
tlmgr conf auxtrees remove /quick/test/tree
</pre>
<p>In all cases the configuration file can be explicitly specified via the
-option <code>--conffile</code> <em>file</em>, if desired.
+option <code>--conffile</code> <em>file</em>, e.g., if you don&rsquo;t want to change the
+system-wide configuration.
</p>
<p>Warning: The general facility for changing configuration values is here,
but tinkering with settings in this way is strongly discouraged. Again,
@@ -4483,7 +4651,7 @@ The TeX Live installer and <code>tlmgr</code> routinely call <code>generate</cod
all of these files.
</p>
<p>For managing your own fonts, please read the <code>updmap --help</code>
-information and/or <a href="http://tug.org/fonts/fontinstall.html">http://tug.org/fonts/fontinstall.html</a>.
+information and/or <a href="https://tug.org/fonts/fontinstall.html">https://tug.org/fonts/fontinstall.html</a>.
</p>
<p>For managing your own formats, please read the <code>fmtutil --help</code>
information.
@@ -4649,6 +4817,14 @@ dependencies in a similar way.
locally installed packages, collections, or schemes are listed.
</p>
</dd>
+<dt><strong>&ndash;only-remote</strong></dt>
+<dd><span id="tlmgr-_002d_002donly_002dremote"></span>
+<p>Only list packages from the remote repository. Useful when checking what
+is available in a remote repository using
+<code>tlmgr --repo ... --only-remote info</code>. Note that
+<code>--only-installed</code> and <code>--only-remote</code> cannot both be specified.
+</p>
+</dd>
<dt><strong>&ndash;data <code>item1,item2,...</code></strong></dt>
<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
@@ -4693,8 +4869,8 @@ Next: <a href="#tlmgr-key" accesskey="n" rel="next">tlmgr key</a>, Previous: <a
<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>
-action for how to get the latest version of a package.)
+installed. It does not touch existing packages; see the <code>update</code>
+action for how to get the latest version of a package.
</p>
<p>By default this also installs all packages on which the given <em>pkg</em>s are
dependent. Options:
@@ -4763,6 +4939,10 @@ after all. You can get them by using these options in conjunction with
</dd>
</dl>
+<p>This action does not automatically add new symlinks in system
+directories; you need to run <code>tlmgr path add</code> (<a href="#tlmgr-path">path</a>) yourself if
+you are using this feature and want new symlinks added.
+</p>
<hr>
<span id="tlmgr-key"></span><div class="header">
<p>
@@ -4787,7 +4967,7 @@ the TeX Live databases.
</p>
<p>The <code>add</code> argument requires another argument, either a filename or
<code>-</code> for stdin, from which the key is added. The key is added to the
-local keyring <code>GNUPGHOME/repository-keys.gpg</code>, which is normally)
+local keyring <code>GNUPGHOME/repository-keys.gpg</code>, which is normally
<code>tlpkg/gpg/repository-keys.gpg</code>.
</p>
<p>The <code>remove</code> argument requires a key id and removes the requested id
@@ -4816,8 +4996,8 @@ Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous:
<dt><strong>option [&ndash;json] [show]</strong></dt>
<dd><span id="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></span>
</dd>
-<dt><strong>option [&ndash;json] showall</strong></dt>
-<dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall"></span>
+<dt><strong>option [&ndash;json] showall|help</strong></dt>
+<dd><span id="tlmgr-option-_005b_002d_002djson_005d-showall_007chelp"></span>
</dd>
<dt><strong>option <em>key</em> [<em>value</em>]</strong></dt>
<dd><span id="tlmgr-option-key-_005bvalue_005d"></span>
@@ -4829,7 +5009,8 @@ saved in the TLPDB with a short description and the <code>key</code> used for
changing it in parentheses.
</p>
<p>The second form, <code>showall</code>, is similar, but also shows options which
-can be defined but are not currently set to any value.
+can be defined but are not currently set to any value (<code>help</code> is a
+synonym).
</p>
<p>Both <code>show...</code> forms take an option <code>--json</code>, which dumps the option
information in JSON format. In this case, both forms dump the same
@@ -4844,7 +5025,7 @@ for <em>key</em> is displayed. If <em>value</em> is present, <em>key</em> is se
the definitive list):
</p>
<pre class="verbatim"> repository (default package repository),
- formats (create formats at installation time),
+ formats (generate formats at installation or update time),
postcode (run postinst code blobs)
docfiles (install documentation files),
srcfiles (install source files),
@@ -4869,7 +5050,8 @@ be used as a synonym for <code>repository</code>.)
</p>
<p>If <code>formats</code> is set (this is the default), then formats are regenerated
when either the engine or the format files have changed. Disable this
-only when you know how and want to regenerate formats yourself.
+only when you know how and want to regenerate formats yourself whenever
+needed (which is often, in practice).
</p>
<p>The <code>postcode</code> option controls execution of per-package
postinstallation action code. It is set by default, and again disabling
@@ -4883,10 +5065,11 @@ testing installations, etc. When disabled, the respective files are not
downloaded at all.
</p>
<p>The options <code>autobackup</code> and <code>backupdir</code> determine the defaults for
-the actions <code>update</code>, <code>backup</code> and <code>restore</code>. These three actions
-need a directory in which to read or write the backups. If
+the actions <code>update</code>, <code>backup</code> and <code>restore</code>. These three actions
+need a directory in which to read or write the backups. If
<code>--backupdir</code> is not specified on the command line, the <code>backupdir</code>
-option value is used (if set).
+option value is used (if set). The TL installer sets <code>backupdir</code> to
+<code>.../tlpkg/backups</code>, under the TL root installation directory.
</p>
<p>The <code>autobackup</code> option (de)activates automatic generation of backups.
Its value is an integer. If the <code>autobackup</code> value is <code>-1</code>, no
@@ -4927,8 +5110,8 @@ Next: <a href="#tlmgr-path" accesskey="n" rel="next">tlmgr path</a>, Previous: <
<dt><strong>paper [a4|letter]</strong></dt>
<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><span id="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></span>
+<dt><strong>&lt;[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [<em>papersize</em>|&ndash;list]</strong>&gt;</dt>
+<dd><span id="tlmgr-_003c_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d_003e"></span>
</dd>
<dt><strong>paper &ndash;json</strong></dt>
<dd><span id="tlmgr-paper-_002d_002djson"></span>
@@ -4976,10 +5159,12 @@ Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">tlmgr pinning</a>, Previ
</dd>
<dt><strong>path [&ndash;w32mode=user|admin] remove</strong></dt>
<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
-initialization files, either system or personal.
+<p>On Unix, adds or removes symlinks for executables, 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 initialization
+files, either system or personal. Furthermore, any executables added or
+removed by future updates are not taken care of automatically; this
+command must be rerun as needed.
</p>
<p>On Windows, the registry part where the binary directory is added or
removed is determined in the following way:
@@ -5070,7 +5255,7 @@ platform instead of auto detection.
</p>
<p><code>platform set auto</code> switches TeX Live to auto detection mode for platform.
</p>
-<p>Platform detection is needed to select the proper <code>xz</code>, <code>xzdec</code> and
+<p>Platform detection is needed to select the proper <code>xz</code> and
<code>wget</code> binaries that are shipped with TeX Live.
</p>
<p><code>arch</code> is a synonym for <code>platform</code>.
@@ -5219,6 +5404,10 @@ written to the terminal.
</dd>
</dl>
+<p>This action does not automatically remove symlinks to executables from
+system directories; you need to run <code>tlmgr path remove</code> (<a href="#tlmgr-path">path</a>)
+yourself if you are using this feature and want stale symlinks removed.
+</p>
<hr>
<span id="tlmgr-repository"></span><div class="header">
<p>
@@ -5230,8 +5419,8 @@ Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previ
<dt><strong>repository list</strong></dt>
<dd><span id="tlmgr-repository-list"></span>
</dd>
-<dt><strong>repository list <em>path|tag</em></strong></dt>
-<dd><span id="tlmgr-repository-list-path_007ctag"></span>
+<dt><strong>repository list <em>path|url|tag</em></strong></dt>
+<dd><span id="tlmgr-repository-list-path_007curl_007ctag"></span>
</dd>
<dt><strong>repository add <em>path</em> [<em>tag</em>]</strong></dt>
<dd><span id="tlmgr-repository-add-path-_005btag_005d"></span>
@@ -5241,21 +5430,46 @@ Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previ
</dd>
<dt><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></dt>
<dd><span id="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></span>
+</dd>
+<dt><strong>repository status</strong></dt>
+<dd><span id="tlmgr-repository-status"></span>
<p>This action manages the list of repositories. See <a href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
</p>
-<p>The first form (<code>list</code>) lists all configured repositories and the
-respective tags if set. If a path, url, or tag is given after the
-<code>list</code> keyword, it is interpreted as source from where to
-initialize a TeX Live Database and lists the contained packages.
-This can also be an up-to-now not used repository, both locally
-and remote. If one pass in addition <code>--with-platforms</code>, for each
-package the available platforms (if any) are listed, too.
+<p>The first form, <code>repository list</code>, lists all configured repositories
+and the respective tags if set. If a path, url, or tag is given after
+the <code>list</code> keyword, it is interpreted as the source from which to
+initialize a TL database and lists the contained packages. This can also
+be an otherwise-unused repository, either local or remote. If the option
+<code>--with-platforms</code> is specified in addition, for each package the
+available platforms (if any) are also listed.
+</p>
+<p>The form <code>repository add</code> adds a repository (optionally attaching a
+tag) to the list of repositories, while <code>repository remove</code> removes a
+repository, either by full path/url, or by tag.
</p>
-<p>The third form (<code>add</code>) adds a repository
-(optionally attaching a tag) to the list of repositories. The forth
-form (<code>remove</code>) removes a repository, either by full path/url, or by
-tag. The last form (<code>set</code>) sets the list of repositories to the items
-given on the command line, not keeping previous settings
+<p>The form <code>repository set</code> sets the list of available repositories to
+the items given on the command line, overwriting previous settings.
+</p>
+<p>The form <code>repository status</code> reports the verification status of the
+loaded repositories with the format of one repository per line
+with fields separated by a single space:
+</p>
+<dl compact="compact">
+<dt>The tag (which can be the same as the url);</dt>
+<dd><span id="tlmgr-The-tag-_0028which-can-be-the-same-as-the-url_0029_003b"></span>
+<p>= the url;
+</p>
+<p>= iff machine-readable output is specified, the verification code (a
+number);
+</p>
+<p>= a textual description of the verification status, as the last field
+extending to the end of line.
+</p>
+</dd>
+</dl>
+
+<p>That is, in normal (not machine-readable) output, the third field
+(numeric verification status) is not present.
</p>
<p>In all cases, one of the repositories must be tagged as <code>main</code>;
otherwise, all operations will fail!
@@ -5488,9 +5702,9 @@ must be specified. Options:
<dl compact="compact">
<dt><strong>&ndash;all</strong></dt>
<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.)
+<p>Update all installed packages except for <code>tlmgr</code> itself. If updates to
+<code>tlmgr</code> itself are present, this gives an error, unless also the option
+<code>--force</code> or <code>--self</code> is given. (See below.)
</p>
<p>In addition to updating the installed packages, during the update of a
collection the local installation is (by default) synchronized to the
@@ -5507,7 +5721,7 @@ remove the package in the local installation. This is called
that is also installed locally, it will be added to the local
installation. This is called &ldquo;auto-install&rdquo; and is announced as such
when using the option <code>--list</code>. This auto-installation can be
-suppressed using the option <code>--no-auto-install</code>.
+suppressed using the option <code>--no-auto-install</code> (also not recommended).
</p>
<p>An exception to the collection dependency checks (including the
auto-installation of packages just mentioned) are those that have been
@@ -5515,6 +5729,13 @@ auto-installation of packages just mentioned) are those that have been
on them. (See the <code>remove</code> action documentation.) To reinstall any
such forcibly removed packages use <code>--reinstall-forcibly-removed</code>.
</p>
+<p>To reiterate: automatic removals and additions are entirely determined
+by comparison of collections. Thus, if you manually install an
+individual package <code>foo</code> which is later removed from the server,
+<code>tlmgr</code> will not notice and will not remove it locally. (It has to be
+this way, without major rearchitecture work, because the tlpdb does not
+record the repository from which packages come from.)
+</p>
<p>If you want to exclude some packages from the current update run (e.g.,
due to a slow link), see the <code>--exclude</code> option below.
</p>
@@ -5583,12 +5804,12 @@ the key <code>update-exclude</code>.
</dd>
<dt><strong>&ndash;no-auto-remove</strong> [<em>pkg</em>...]</dt>
<dd><span id="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></span>
-<p>By default, <code>tlmgr</code> tries to remove packages 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
-given <em>pkg</em> names. This can lead to an inconsistent TeX installation,
-since packages are not infrequently renamed or replaced by their
-authors. Therefore this is not recommend.
+<p>By default, <code>tlmgr</code> tries to remove packages in an existing collection
+which have disappeared on the server, as described above under <code>--all</code>.
+This option prevents such removals, either for all packages (with
+<code>--all</code>), or for just the given <em>pkg</em> names. This can lead to an
+inconsistent TeX installation, since packages are not infrequently
+renamed or replaced by their authors. Therefore this is not recommended.
</p>
</dd>
<dt><strong>&ndash;no-auto-install</strong> [<em>pkg</em>...]</dt>
@@ -5610,6 +5831,9 @@ server, then
<pre class="verbatim"> tlmgr update --all
tlmgr remove --force foobar
</pre>
+<p>Again, since packages are sometimes renamed or replaced, using this
+option is not recommended.
+</p>
</dd>
<dt><strong>&ndash;reinstall-forcibly-removed</strong></dt>
<dd><span id="tlmgr-_002d_002dreinstall_002dforcibly_002dremoved"></span>
@@ -5631,8 +5855,8 @@ installation with the server&rsquo;s idea of what is available:
<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
<dd><span id="tlmgr-_002d_002dbackupdir-directory-3"></span>
<p>These two options control the creation of backups of packages <em>before</em>
-updating; that is, backup of packages as currently installed. If
-neither options is given, no backup will made. If <code>--backupdir</code> is
+updating; that is, backing up packages as currently installed. If
+neither option is given, no backup will made. If <code>--backupdir</code> is
given and specifies a writable directory then a backup will be made in
that location. If only <code>--backup</code> is given, then a backup will be made
to the directory previously set via the <a href="#tlmgr-option">option</a> action (see
@@ -5684,6 +5908,10 @@ fallback information, but if you don&rsquo;t like them accumulating (e.g.,
<code>mirror.ctan.org</code> resolves to many different hosts, each resulting in
a possibly different hash), it&rsquo;s harmless to delete them.
</p>
+<p>This action does not automatically add or remove new symlinks in system
+directories; you need to run <code>tlmgr</code> <a href="#tlmgr-path">path</a> yourself if you are using
+this feature and want new symlinks added.
+</p>
<hr>
<span id="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></span><div class="header">
<p>
@@ -5691,8 +5919,8 @@ Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">tlmgr
</div>
<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
+<p><code>tlmgr</code> reads two configuration files: one is system-wide, in
+<code>TEXMFSYSCONFIG/tlmgr/config</code>, and the other is user-specific, in
<code>TEXMFCONFIG/tlmgr/config</code>. The user-specific one is the default for
the <code>conf tlmgr</code> action. (Run <code>kpsewhich
-var-value=TEXMFSYSCONFIG</code> or <code>... TEXMFCONFIG ...</code> to see the actual
@@ -5758,8 +5986,8 @@ disables this process.
</p>
<p>The checksum algorithm is SHA-512. Your system must have one of (looked
for in this order) the Perl <code>Digest::SHA</code> module, the <code>openssl</code>
-program (<a href="http://openssl.org">http://openssl.org</a>), the <code>sha512sum</code> program (from GNU
-Coreutils, <a href="http://www.gnu.org/software/coreutils">http://www.gnu.org/software/coreutils</a>), or finally the
+program (<a href="https://openssl.org">https://openssl.org</a>), the <code>sha512sum</code> program (from GNU
+Coreutils, <a href="https://www.gnu.org/software/coreutils">https://www.gnu.org/software/coreutils</a>), or finally the
<code>shasum</code> program (just to support old Macs). If none of these are
available, a warning is issued and <code>tlmgr</code> proceeds without checking
checksums. (Incidentally, other SHA implementations, such as the pure
@@ -5802,8 +6030,9 @@ above) to succeed, and a working GnuPG (<code>gpg</code>) program (see below for
search method). Then, unless cryptographic verification has been
disabled, a signature file (<code>texlive.tlpdb.*.asc</code>) of the checksum file
is downloaded and the signature verified. The signature is created by
-the TeX Live Distribution GPG key 0x06BAB6BC, which in turn is signed by
-Karl Berry&rsquo;s key 0x30D155AD and Norbert Preining&rsquo;s key 0x6CACA448. All
+the TeX Live Distribution GPG key 0x0D5E5D9106BAB6BC, which in turn is
+signed by Karl Berry&rsquo;s key 0x0716748A30D155AD and
+Norbert Preining&rsquo;s key 0x6CACA448860CDC13. All
of these keys are obtainable from the standard key servers.
</p>
<p>Additional trusted keys can be added using the <code>key</code> action.
@@ -6008,49 +6237,47 @@ only one enabled (as is the case by default):
/var/www/norbert/tlnet
</pre>
<p>Ok. Let&rsquo;s add the <code>tlcontrib</code> repository (this is a real
-repository, hosted at <a href="http://tlcontrib.metatex.org">http://tlcontrib.metatex.org</a>, maintained by
-Taco Hoekwater et al.), with the tag <code>tlcontrib</code>:
+repository hosted at <a href="http://contrib.texlive.info">http://contrib.texlive.info</a>) with the tag <code>tlcontrib</code>:
</p>
-<pre class="verbatim"> $ tlmgr repository add http://tlcontrib.metatex.org/2012 tlcontrib
+<pre class="verbatim"> $ tlmgr repository add http://contrib.texlive.info/current tlcontrib
</pre>
<p>Check the repository list again:
</p>
<pre class="verbatim"> $ tlmgr repository list
List of repositories (with tags if set):
- http://tlcontrib.metatex.org/2012 (tlcontrib)
+ http://contrib.texlive.info/current (tlcontrib)
/var/www/norbert/tlnet (main)
</pre>
-<p>Now we specify a pinning entry to get the package <code>context</code> from
+<p>Now we specify a pinning entry to get the package <code>classico</code> from
<code>tlcontrib</code>:
</p>
-<pre class="verbatim"> $ tlmgr pinning add tlcontrib context
+<pre class="verbatim"> $ tlmgr pinning add tlcontrib classico
</pre>
-<p>Check that we can find <code>context</code>:
+<p>Check that we can find <code>classico</code>:
</p>
-<pre class="verbatim"> $ tlmgr show context
- tlmgr: package repositories:
+<pre class="verbatim"> $ tlmgr show classico
+ package: classico
...
- package: context
- repository: tlcontrib/26867
+ shortdesc: URW Classico fonts
...
</pre>
-<p>- install <code>context</code>:
+<p>- install <code>classico</code>:
</p>
-<pre class="verbatim"> $ tlmgr install context
+<pre class="verbatim"> $ tlmgr install classico
tlmgr: package repositories:
...
- [1/1, ??:??/??:??] install: context @tlcontrib [
+ [1/1, ??:??/??:??] install: classico @tlcontrib [737k]
</pre>
-<p>In the output here you can see that the <code>context</code> package has been
+<p>In the output here you can see that the <code>classico</code> package has been
installed from the <code>tlcontrib</code> repository (<code>@tlcontrib</code>).
</p>
<p>Finally, <code>tlmgr pinning</code> also supports removing certain or all packages
from a given repository:
</p>
-<pre class="verbatim"> $ tlmgr pinning remove tlcontrib context # remove just context
+<pre class="verbatim"> $ tlmgr pinning remove tlcontrib classico # remove just classico
$ tlmgr pinning remove tlcontrib --all # take nothing from tlcontrib
</pre>
-<p>A summary of the <code>tlmgr pinning</code> actions is given above.
+<p>A summary of <code>tlmgr pinning</code> actions is given above.
</p>
<hr>
<span id="tlmgr-GUI-FOR-TLMGR"></span><div class="header">
@@ -6060,16 +6287,22 @@ Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">tlmg
<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
-necessary modules are shipped within TeX Live, for all other (i.e.,
-Unix-based) systems Perl/Tk (as well as Perl of course) has to be
-installed outside of TL. <a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a>
-has a list of invocations for some distros.
-</p>
-<p>The GUI is started with the invocation <code>tlmgr gui</code>; assuming Tk is
-loadable, the graphical user interface will be shown. The main window
-contains a menu bar, the main display, and a status area where messages
-normally shown on the console are displayed.
+<a href="https://search.cpan.org/search?query=perl%2Ftk">https://search.cpan.org/search?query=perl%2Ftk</a>. For Unix-based
+systems Perl/Tk (as well as Perl of course) has to be installed
+outside of TL. <a href="https://tug.org/texlive/distro.html#perltk">https://tug.org/texlive/distro.html#perltk</a> has a
+list of invocations for some distros. For Windows the necessary
+modules are no longer shipped within TeX Live, so you&rsquo;ll have to have an
+external Perl available that includes them.
+</p>
+<p>We are talking here about the GUI built into tlmgr itself, not about the
+other tlmgr GUIs, which are: tlshell (Tcl/Tk-based), tlcockpit
+(Java-based) and, only on Macs, TeX Live Utility. These are invoked as
+separate programs.
+</p>
+<p>The GUI mode of tlmgr is started with the invocation <code>tlmgr gui</code>;
+assuming Tk is loadable, the graphical user interface will be shown.
+The main window contains a menu bar, the main display, and a status
+area where messages normally shown on the console are displayed.
</p>
<p>Within the main display there are three main parts: the <code>Display
configuration</code> area, the list of packages, and the action buttons.
@@ -6306,7 +6539,7 @@ on Windows).
<dt><code>Help menu</code></dt>
<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.
+<a href="https://tug.org/texlive/doc.html">https://tug.org/texlive/doc.html</a>) and the usual &ldquo;About&rdquo; box.
</p>
</dd>
</dl>
@@ -6353,13 +6586,13 @@ of the display.
</dl>
<p>A few other obscure options are recognized but not mentioned here. See
-the Perl/Tk documentation (<a href="http://search.cpan.org/perldoc?Tk">http://search.cpan.org/perldoc?Tk</a>) for the
+the Perl/Tk documentation (<a href="https://search.cpan.org/perldoc?Tk">https://search.cpan.org/perldoc?Tk</a>) for the
complete list, and any X documentation for general information.
</p>
<hr>
<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>
+Next: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">tlmgr ENVIRONMENT VARIABLES</a>, Previous: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="p" rel="prev">tlmgr GUI FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="MACHINE_002dREADABLE-OUTPUT"></span><h3 class="appendixsec">B.12 MACHINE-READABLE OUTPUT</h3>
@@ -6538,17 +6771,110 @@ Previous: <a href="#tlmgr-Machine_002dreadable-update-and-install-output" access
changes would be helpful, do not hesitate to write the mailing list.
</p>
<hr>
+<span id="tlmgr-ENVIRONMENT-VARIABLES"></span><div class="header">
+<p>
+Next: <a href="#tlmgr-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">tlmgr AUTHORS AND COPYRIGHT</a>, Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">tlmgr MACHINE-READABLE OUTPUT</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="ENVIRONMENT-VARIABLES-1"></span><h3 class="appendixsec">B.13 ENVIRONMENT VARIABLES</h3>
+
+<p><code>tlmgr</code> uses many of the standard TeX environment variables, as
+reported by, e.g., <code>tlmgr conf</code> (<a href="#tlmgr-conf">conf</a>).
+</p>
+<p>In addition, for ease in scripting and debugging, <code>tlmgr</code> looks for the
+following environment variables. These are not of interest for normal
+user installations.
+</p>
+<dl compact="compact">
+<dt><code>TEXLIVE_COMPRESSOR</code></dt>
+<dd><span id="tlmgr-TEXLIVE_005fCOMPRESSOR"></span>
+<p>This variable allows selecting a different compressor program for
+backups and intermediate rollback containers. The order of selection is:
+</p>
+<ol>
+<li> If the environment variable <code>TEXLIVE_COMPRESSOR</code> is
+defined, use it; abort if it doesn&rsquo;t work. Possible values:
+<code>lz4</code>, <code>gzip</code>, <code>xz</code>. The necessary options are added internally.
+
+</li><li> If lz4 is available (either from the system or TL) and working, use that.
+
+</li><li> If gzip is available (from the system) and working, use that.
+
+</li><li> If xz is available (either from the system or TL) and working, use that.
+
+</li></ol>
+
+<p>lz4 and gzip are faster in creating tlmgr&rsquo;s local backups, hence they
+are preferred. The unconditional use of xz for the tlnet containers is
+unaffected, to minimize download sizes.
+</p>
+</dd>
+<dt><code>TEXLIVE_DOWNLOADER</code></dt>
+<dd><span id="tlmgr-TEXLIVE_005fDOWNLOADER"></span>
+</dd>
+<dt><code>TL_DOWNLOAD_PROGRAM</code></dt>
+<dd><span id="tlmgr-TL_005fDOWNLOAD_005fPROGRAM"></span>
+</dd>
+<dt><code>TL_DOWNLOAD_ARGS</code></dt>
+<dd><span id="tlmgr-TL_005fDOWNLOAD_005fARGS"></span>
+<p>These options allow selecting different download programs then the ones
+automatically selected by the installer. The order of selection is:
+</p>
+<ol>
+<li> If the environment variable <code>TEXLIVE_DOWNLOADER</code> is defined, use it;
+abort if the specified program doesn&rsquo;t work. Possible values: <code>lwp</code>,
+<code>curl</code>, <code>wget</code>. The necessary options are added internally.
+
+</li><li> If the environment variable <code>TL_DOWNLOAD_PROGRAM</code> is
+defined (can be any value), use it together with
+<code>TL_DOWNLOAD_ARGS</code>; abort if it doesn&rsquo;t work.
+
+</li><li> If LWP is available and working, use that (by far the most
+efficient method, as it supports persistent downloads).
+
+</li><li> If curl is available (from the system) and working, use that.
+
+</li><li> If wget is available (either from the system or TL) and working, use that.
+
+</li></ol>
+
+<p>TL provides <code>wget</code> binaries for platforms where necessary, so some
+download method should always be available.
+</p>
+</dd>
+<dt><code>TEXLIVE_PREFER_OWN</code></dt>
+<dd><span id="tlmgr-TEXLIVE_005fPREFER_005fOWN"></span>
+<p>By default, compression and download programs provided by the system,
+i.e., found along <code>PATH</code> are preferred over those shipped with TeX
+Live.
+</p>
+<p>This can create problems with systems that are too old, and so can be
+overridden by setting the environment variable <code>TEXLIVE_PREFER_OWN</code> to
+1. In this case, executables shipped with TL will be preferred.
+</p>
+<p>Extra compression/download programs not provided by TL, such as gzip,
+lwp, and curl, are still checked for on the system and used if
+available, per the above. <code>TEXLIVE_PREFER_OWN</code> only applies when the
+program being checked for is shipped with TL, namely the lz4 and
+xz compressors and wget downloader.
+</p>
+<p>Exception: on Windows, the <code>tar.exe</code> shipped with TL is always used,
+regardless of any setting.
+</p>
+</dd>
+</dl>
+
+<hr>
<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>
+Previous: <a href="#tlmgr-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">tlmgr ENVIRONMENT VARIABLES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.13 AUTHORS AND COPYRIGHT</h3>
+<span id="AUTHORS-AND-COPYRIGHT-1"></span><h3 class="appendixsec">B.14 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
+distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
-<p>$Id: tlmgr.pl 47303 2018-04-05 17:52:22Z karl $
+<p>$Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $
</p>
<hr>
@@ -6712,6 +7038,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<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 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-removing-dependent-sources">C++11, removing dependent sources</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-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>
diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
index 52c01dc18b4..7d4bd8bad61 100644
--- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
+++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf
Binary files differ