doc updates for 2021

git-svn-id: svn://tug.org/texlive/trunk@57972 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 73 insertions, 64 deletions

diff --git a/Build/source/doc/tlbuild-incl/install-tl.texi b/Build/source/doc/tlbuild-incl/install-tl.texi
index 6e0e4d00997..79876653eef 100644
--- a/Build/source/doc/tlbuild-incl/install-tl.texi
+++ b/Build/source/doc/tlbuild-incl/install-tl.texi
@@ -81,46 +81,24 @@ following modules are supported:
 @item @code{text}
 @anchor{install-tl @code{text}}
 
-The text mode user interface (default on Unix systems).  Same as the
-@code{-no-gui} option.
+The text mode user interface (default on Unix systems, including Macs).
+Same as the @code{-no-gui} option.
 
-@item @code{tcl}
-@anchor{install-tl @code{tcl}}
+@item @code{tcl} (or "perltk" or "wizard" or "expert" or nothing)
+@anchor{install-tl @code{tcl} (or "perltk" or "wizard" or "expert" or nothing)}
 
-The Tcl/Tk user interface (default on Macs and Windows).  It starts
+The Tcl/Tk user interface (default on Windows).  It starts
 with a small number of configuration options, roughly equivalent
-to what the wizard option below offers, but a button @code{Advanced}
-takes you to a screen with roughly the same options as the @code{perltk}
-interface.
-
-@item @code{wizard}
-@anchor{install-tl @code{wizard}}
-
-The wizard mode user interface, asking only minimal questions before
-installing all of TeX Live.
-
-@item @code{expert}
-@anchor{install-tl @code{expert}}
-
-A generic name for, currently, @code{perltk}; it may select a different GUI
-in the future.
-
-@item @code{perltk}
-@anchor{install-tl @code{perltk}}
-
-The expert GUI installer, providing access to more options.
+to what the former wizard option offers, but a button @code{Advanced}
+takes you to a screen with roughly the same options as the former
+@code{perltk} interface.
 
 @end table
 
-The @code{perltk} and @code{wizard} modules require the Perl/Tk module
-(@url{https://tug.org/texlive/distro.html#perltk}). if Perl/Tk is not
-available, installation continues in text mode, except on Windows,
-where all gui options except @code{text} are diverted to the default
-@code{tcl} GUI.
-
-The @code{tcl} 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.
+The default GUI requires Tcl/Tk. This is standard on Macs (although it
+is considered deprecated since Catalina) and is often already installed
+on GNU/Linux, or can be easily installed through a distro package
+manager. For Windows, TeX Live provides a Tcl/Tk runtime.
 
 @item @strong{-no-gui}
 @anchor{install-tl @strong{-no-gui}}
@@ -130,10 +108,8 @@ Use the text mode installer (default except on Windows and Macs).
 @item @strong{-lang} @emph{llcode}
 @anchor{install-tl @strong{-lang} @emph{llcode}}
 
-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} environment
-variable. If that fails you can select a different language by
+By default, the Tcl GUI uses the language detection built into
+Tcl/Tk. 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
@@ -165,8 +141,8 @@ will be adjusted accordingly.
 @anchor{install-tl @strong{-select-repository}}
 
 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{wizard} and @code{perltk} installer modes, and will also offer to install
+list of active CTAN mirrors. This option is supported in the @code{text}
+and @code{gui} installer modes, and will also offer to install
 from local media if available, or from a repository specified on the
 command line. It's useful when the (default) automatic redirection does
 not choose a good host for you.
@@ -199,9 +175,10 @@ building TeX Live, see @url{https://tug.org/texlive/build.html}.
 @item @strong{-debug-translation}
 @anchor{install-tl @strong{-debug-translation}}
 
-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.
+In the former Perl/Tk GUI modes, this option reported any missing,
+or more likely untranslated, messages to standard error. Not yet
+implemented for the Tcl interface. Helpful for translators to see
+what remains to be done.
 
 @item @strong{-force-platform} @emph{platform}
 @anchor{install-tl @strong{-force-platform} @emph{platform}}
@@ -517,8 +494,8 @@ variables.
 
 Omit creating the ConTeXt cache.  This is useful for redistributors.
 
-@item @code{TEXLIVE_INSTALL_NO_IMPORT}
-@anchor{install-tl @code{TEXLIVE_INSTALL_NO_IMPORT}}
+@item @code{TEXLIVE_INSTALL_NO_RESUME}
+@anchor{install-tl @code{TEXLIVE_INSTALL_NO_RESUME}}
 
 Omit check for installing on top of a previous installation and then
 asking about importing previous settings.
@@ -529,6 +506,12 @@ asking about importing previous settings.
 Omit printing the welcome message after successful installation, e.g.,
 when testing.
 
+@item @code{TEXLIVE_INSTALL_PAPER}
+@anchor{install-tl @code{TEXLIVE_INSTALL_PAPER}}
+
+Set the default paper size for all relevant programs; must be either
+@code{letter} or @code{a4}. The default is @code{a4}.
+
 @item @code{TEXLIVE_INSTALL_PREFIX}
 @anchor{install-tl @code{TEXLIVE_INSTALL_PREFIX}}
 
@@ -573,5 +556,5 @@ This script and its documentation were written for the TeX Live
 distribution (@url{https://tug.org/texlive}) and both are licensed under the
 GNU General Public License Version 2 or later.
 
-$Id: install-tl 54143 2020-03-06 23:51:18Z karl $
+$Id: install-tl 57970 2021-02-27 14:17:34Z siepo $
 
diff --git a/Build/source/doc/tlbuild-incl/tlmgr.texi b/Build/source/doc/tlbuild-incl/tlmgr.texi
index 690b33848d6..45a1011100c 100644
--- a/Build/source/doc/tlbuild-incl/tlmgr.texi
+++ b/Build/source/doc/tlbuild-incl/tlmgr.texi
@@ -244,6 +244,14 @@ necessarily completely translated) are: @w{English (en, default)},
 
 tlshell shares its message catalog with tlmgr.
 
+@item @strong{--command-logfile} @emph{file}
+@anchor{tlmgr @strong{--command-logfile} @emph{file}}
+
+@code{tlmgr} logs the output of all programs invoked (mktexlr, mtxrun, fmtutil,
+updmap) to a separate log file, by default
+@code{TEXMFSYSVAR/web2c/tlmgr-commands.log}.  This option allows you to specify a
+different file for the log.
+
 @item @strong{--debug-translation}
 @anchor{tlmgr @strong{--debug-translation}}
 
@@ -832,21 +840,36 @@ is available in a remote repository using
 @anchor{tlmgr @strong{--data @code{item1@comma{}item2@comma{}...}}}
 
 If the option @code{--data} is given, its argument must be a comma separated
-list of field names from: @code{name}, @code{category}, @code{localrev}, @code{remoterev},
-@code{shortdesc}, @code{longdesc}, @code{installed}, @code{size}, @code{relocatable}, @code{depends},
-@code{cat-version}, @code{cat-date}, or @code{cat-license}. In this case the requested
-packages' information is listed in CSV format one package per line, and the
-column information is given by the @code{itemN}. The @code{depends} column contains
-the name of all dependencies separated by @code{:}.
+list of field names from: @code{name}, @code{category}, @code{localrev},
+@code{remoterev}, @code{shortdesc}, @code{longdesc}, @code{installed}, @code{size},
+@code{relocatable}, @code{depends}, @code{cat-version}, @code{cat-date}, @code{cat-license},
+plus various @code{cat-contact-*} fields (see below).
+
+The @code{cat-*} fields all come from the TeX Catalogue
+(@url{https://ctan.org/pkg/catalogue}). For each, there are two more
+variants with prefix @code{l} and @code{r}, e.g., @code{lcat-version} and
+@code{rcat-version}, which indicate the local and remote information,
+respectively. The variants without @code{l} and @code{r} show the most current
+one, which is normally the remote value.
+
+The requested packages' information is listed in CSV format, one package
+per line, and the column information is given by the @code{itemN}. The
+@code{depends} column contains the names of all the dependencies separated
+by @code{:} characters.
+
+At this writing, the @code{cat-contact-*} fields include: @code{home},
+@code{repository}, @code{support}, @code{bugs}, @code{announce}, @code{development}. Each
+may be empty or a url value. A brief description is on the CTAN upload
+page for new packages: @url{https://ctan.org/upload}.
 
 @item @strong{--json}
 @anchor{tlmgr @strong{--json} 1}
 
-In case @code{--json} is specified, the output is a
-JSON encoded array where each array element is the JSON representation of
-a single @code{TLPOBJ} but with additional information. For details see
-@code{tlpkg/doc/JSON-formats.txt}, format definition: @code{TLPOBJINFO}.
-If both @code{--json} and @code{--data} are given, @code{--json} takes precedence.
+In case @code{--json} is specified, the output is a JSON encoded array where
+each array element is the JSON representation of a single @code{TLPOBJ} but
+with additional information. For details see
+@code{tlpkg/doc/JSON-formats.txt}, format definition: @code{TLPOBJINFO}. If both
+@code{--json} and @code{--data} are given, @code{--json} takes precedence.
 
 @end table
 
@@ -1842,12 +1865,12 @@ If the package on the server is older than the package already installed
 (e.g., if the selected mirror is out of date), @code{tlmgr} does not
 downgrade.  Also, packages for uninstalled platforms are not installed.
 
-@code{tlmgr} saves a copy of the @code{texlive.tlpdb} file used for an update
-with a suffix representing the repository url, as in
-@code{tlpkg/texlive.tlpdb.}@emph{long-hash-string}.  These can be useful for
-fallback information, but if you don't like them accumulating (e.g.,
-@code{mirror.ctan.org} resolves to many different hosts, each resulting in
-a possibly different hash), it's harmless to delete them.
+@code{tlmgr} saves one copy of the main @code{texlive.tlpdb} file used for an
+update with a suffix representing the repository url, as in
+@code{tlpkg/texlive.tlpdb.main.}@emph{long-hash-string}. Thus, even when many
+mirrors are used, only one main @code{tlpdb} backup is kept. For non-main
+repositories, which do not generally have (m)any mirrors, no pruning of
+backups is done.
 
 This action does not automatically add or remove new symlinks in system
 directories; you need to run @code{tlmgr} @ref{tlmgr path,, path} yourself if you are using
@@ -1897,6 +1920,9 @@ The allowed keys are:
 @item @code{require-verification}, value 0 or 1 (default 0), same as command-line option.
 @anchor{tlmgr @code{require-verification}@comma{} value 0 or 1 (default 0)@comma{} same as command-line option.}
 
+@item @code{tkfontscale}, value any float. Controls the scaling of fonts in the Tk based frontends.
+@anchor{tlmgr @code{tkfontscale}@comma{} value any float. Controls the scaling of fonts in the Tk based frontends.}
+
 @item @code{update-exclude}, value: comma-separated list of packages (no space allowed). Same as the command line option @code{--exclude} for the action @code{update}.
 @anchor{tlmgr @code{update-exclude}@comma{} value: comma-separated list of packages (no space allowed). Same as the command line option @code{--exclude} for the action @code{update}.}
 
@@ -2738,5 +2764,5 @@ This script and its documentation were written for the TeX Live
 distribution (@url{https://tug.org/texlive}) and both are licensed under the
 GNU General Public License Version 2 or later.
 
-$Id: tlmgr.pl 54118 2020-03-05 22:27:22Z karl $
+$Id: tlmgr.pl 57970 2021-02-27 14:17:34Z siepo $