/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

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

2 files changed, 82 insertions, 51 deletions

diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 44d27d23ef2..289c8535783 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TLMGR 1"
-.TH TLMGR 1 "2016-04-21" "perl v5.22.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2016-04-28" "perl v5.22.1" "User Contributed Perl Documentation"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -399,8 +399,9 @@ like the \f(CW\*(C`texconfig conf\*(C'\fR call, but works on all supported platf
 .PP
 With either \f(CW\*(C`conf texmf\*(C'\fR, \f(CW\*(C`conf tlmgr\*(C'\fR, or \f(CW\*(C`conf updmap\*(C'\fR given in
 addition, shows all key/value pairs (i.e., all settings) as saved in
-\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the \f(CW\*(C`tlmgr\*(C'\fR configuration file (see below), or the
-first found (via kpsewhich) \f(CW\*(C`updmap.cfg\*(C'\fR file, respectively.
+\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the user-specific \f(CW\*(C`tlmgr\*(C'\fR configuration file (see
+below), or the first found (via \f(CW\*(C`kpsewhich\*(C'\fR) \f(CW\*(C`updmap.cfg\*(C'\fR file,
+respectively.
 .PP
 If \fIkey\fR is given in addition, shows the value of only that \fIkey\fR in
 the respective file.  If option \fI\-\-delete\fR is also given, the value in
@@ -417,8 +418,8 @@ The \s-1PATH\s0 value shown is that used by \f(CW\*(C`tlmgr\*(C'\fR.  The direct
 the \f(CW\*(C`tlmgr\*(C'\fR executable is found is automatically prepended to the \s-1PATH\s0
 value inherited from the environment.
 .PP
-Practical application of changing configuration values: if the execution
-of (some or all) system commands via \f(CW\*(C`\ewrite18\*(C'\fR was left enabled during
+Practical example of changing configuration values: if the execution of
+(some or all) system commands via \f(CW\*(C`\ewrite18\*(C'\fR was left enabled during
 installation, you can disable it afterwards:
 .PP
 .Vb 1
@@ -446,10 +447,10 @@ output is analogous to the \f(CW\*(C`\-\-machine\-readable\*(C'\fR output; see
 Options:
 .IP "\fB\-\-local\fR" 4
 .IX Item "--local"
-Dump the local tlpdb.
+Dump the local \s-1TLPDB.\s0
 .IP "\fB\-\-remote\fR" 4
 .IX Item "--remote"
-Dump the remote tlpdb.
+Dump the remote \s-1TLPDB.\s0
 .PP
 Exactly one of \f(CW\*(C`\-\-local\*(C'\fR and \f(CW\*(C`\-\-remote\*(C'\fR must be given.
 .PP
@@ -1219,31 +1220,97 @@ with a suffix representing the repository url, as in
 fallback information, but if you don't like them accumulating (e.g.,
 on each run \f(CW\*(C`mirror.ctan.org\*(C'\fR might resolve to a new host, resulting in
 a different hash), it's harmless to delete them.
+.SH "CONFIGURATION FILE FOR TLMGR"
+.IX Header "CONFIGURATION FILE FOR TLMGR"
+There are two configuration files for \f(CW\*(C`tlmgr\*(C'\fR: One is system-wide in
+\&\f(CW\*(C`TEXMFSYSCONFIG/tlmgr/config\*(C'\fR, and the other is user-specific in
+\&\f(CW\*(C`TEXMFCONFIG/tlmgr/config\*(C'\fR.  The user-specific one is the default for
+the \f(CW\*(C`conf tlmgr\*(C'\fR action.  (Run \f(CW\*(C`kpsewhich
+\&\-var\-value=TEXMFSYSCONFIG\*(C'\fR or \f(CW\*(C`... TEXMFCONFIG ...\*(C'\fR to see the actual
+directory names.)
+.PP
+A few defaults corresponding to command-line options can be set in these
+configuration files.  In addition, the system-wide file can contain a
+directive to restrict the allowed actions.
+.PP
+In these config files, empty lines and lines starting with # are
+ignored.  All other lines must look like:
+.PP
+.Vb 1
+\&  key = value
+.Ve
+.PP
+where the spaces are optional but the \f(CW\*(C`=\*(C'\fR is required.
+.PP
+The allowed keys are:
+.ie n .IP """auto\-remove, value 0 or 1 (default 1), same as command\-line option.""" 4
+.el .IP "\f(CWauto\-remove, value 0 or 1 (default 1), same as command\-line option.\fR" 4
+.IX Item "auto-remove, value 0 or 1 (default 1), same as command-line option."
+.PD 0
+.ie n .IP """gui\-expertmode"", value 0 or 1 (default 1). This switches between the full \s-1GUI\s0 and a simplified \s-1GUI\s0 with only the most common settings." 4
+.el .IP "\f(CWgui\-expertmode\fR, value 0 or 1 (default 1). This switches between the full \s-1GUI\s0 and a simplified \s-1GUI\s0 with only the most common settings." 4
+.IX Item "gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings."
+.ie n .IP """gui\-lang"" \fIllcode\fR, with a language code value as with the command-line option." 4
+.el .IP "\f(CWgui\-lang\fR \fIllcode\fR, with a language code value as with the command-line option." 4
+.IX Item "gui-lang llcode, with a language code value as with the command-line option."
+.ie n .IP """no\-checksums"", value 0 or 1 (default 0, see below)." 4
+.el .IP "\f(CWno\-checksums\fR, value 0 or 1 (default 0, see below)." 4
+.IX Item "no-checksums, value 0 or 1 (default 0, see below)."
+.ie n .IP """persistent\-downloads"", value 0 or 1 (default 1), same as command-line option." 4
+.el .IP "\f(CWpersistent\-downloads\fR, value 0 or 1 (default 1), same as command-line option." 4
+.IX Item "persistent-downloads, value 0 or 1 (default 1), same as command-line option."
+.ie n .IP """verify\-downloads"", value 0 or 1 (default 1), same as command-line option." 4
+.el .IP "\f(CWverify\-downloads\fR, value 0 or 1 (default 1), same as command-line option." 4
+.IX Item "verify-downloads, value 0 or 1 (default 1), same as command-line option."
+.PD
+.PP
+The system-wide config file can contain one additional key:
+.ie n .IP """allowed\-actions"" \fIaction1[,\fIaction\fI,...] The value is a comma-separated list of \fI""tlmgr""\fI actions which are allowed to be executed when \f(CI""tlmgr""\fI is invoked in system mode (that is, without \f(CI""\-\-usermode""\fI).\fR" 4
+.el .IP "\f(CWallowed\-actions\fR \fIaction1[,\fIaction\fI,...] The value is a comma-separated list of \f(CItlmgr\fI actions which are allowed to be executed when \f(CItlmgr\fI is invoked in system mode (that is, without \f(CI\-\-usermode\fI).\fR" 4
+.IX Item "allowed-actions action1[,action,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode)."
+This allows distributors to include the \f(CW\*(C`tlmgr\*(C'\fR in their packaging, but
+allow only a restricted set of actions that do not interfere with the
+distro package managers.  For native TeX Live installations, it doesn't
+make sense to set this.
+.PP
+The <no\-checksums> key needs more explanation.  By default, package
+checksums computed and stored on the server (in the \s-1TLPDB\s0) are compared
+to checksums computed locally after downloading.  \f(CW\*(C`no\-checksums\*(C'\fR
+disables this.
+.PP
+The checksum algorithm is \s-1SHA\-512. \s0 Your system must have (looked for in
+this order) the Perl Digest::SHA module, the \f(CW\*(C`openssl\*(C'\fR program
+(openssl.org), or the \f(CW\*(C`sha512sum\*(C'\fR program (from \s-1GNU\s0 Coreutils,
+<http://www.gnu.org/software/coreutils>).  If none of these are
+available, a warning is issued and \f(CW\*(C`tlmgr\*(C'\fR proceeds without checking
+checksums.  (Incidentally, other \s-1SHA\s0 implementations, such as the pure
+Perl and pure Lua modules, are much too slow to be usable in our
+context.)  \f(CW\*(C`no\-checksums\*(C'\fR also avoids the warning.
 .SH "CRYPTOGRAPHIC VERIFICATION"
 .IX Header "CRYPTOGRAPHIC VERIFICATION"
 If a working GnuPG binary (\f(CW\*(C`gpg\*(C'\fR) is found (see below for the search
 method), by default verification of downloaded files is performed. This
 can be suppressed by specifying \f(CW\*(C`\-\-no\-verify\-downloads\*(C'\fR on the command
 line, or adding an entry \f(CW\*(C`verify\-downloads = 0\*(C'\fR to a tlmgr config file
-(described in another section below).
+(described in \*(L"\s-1CONFIGURATION FILE FOR TLMGR\*(R"\s0).
 .PP
 Verification is performed as follows: For each \f(CW\*(C`texlive.tlpdb\*(C'\fR loaded
 for a repository, the respective checksum \f(CW\*(C`texlive.tlpdb.sha512\*(C'\fR is
-always downloaded, too, and \f(CW\*(C`tlmgr\*(C'\fR confirms whether the checksum
-of the download tlpdb file agrees with the download data. This is done
+always downloaded, too, and \f(CW\*(C`tlmgr\*(C'\fR confirms whether the checksum of
+the downloaded \s-1TLPDB\s0 file agrees with the download data.  This is done
 in any case.
 .PP
-If cryptographic verification is also requested, then a signature of the
+Unless cryptographic verification is disabled, then a signature of the
 checksum file is downloaded and the signature verified. The signature is
-done with the TeX Live Distribution \s-1GPG\s0 key 0x06BAB6BC, which in turn is
-signed by Karl Berry's key 0x9DEB46C0 and Norbert Preining's key
+created by the TeX Live Distribution \s-1GPG\s0 key 0x06BAB6BC, which in turn
+is signed by Karl Berry's key 0x9DEB46C0 and Norbert Preining's key
 0x6CACA448.  All of these keys are obtainable from the standard key
 servers.
 .SS "Configuration of GnuPG invocation"
 .IX Subsection "Configuration of GnuPG invocation"
 The executable used for GnuPG is searched as follows: If the environment
-variable \f(CW\*(C`TL_GNUPG\*(C'\fR is set, it is tested and used. Otherwise \f(CW\*(C`gpg\*(C'\fR is
-checked, and finally \f(CW\*(C`gpg2\*(C'\fR.
+variable \f(CW\*(C`TL_GNUPG\*(C'\fR is set, it is tested and used; otherwise \f(CW\*(C`gpg\*(C'\fR is
+checked; finally \f(CW\*(C`gpg2\*(C'\fR is checked.
 .PP
 Further adaptation of the \f(CW\*(C`gpg\*(C'\fR invocation can be made using the two
 enviroment variables \f(CW\*(C`TL_GNUPGHOME\*(C'\fR, which is passed to \f(CW\*(C`gpg\*(C'\fR as the
@@ -1326,42 +1393,6 @@ just as in normal mode.
 In user mode, these actions operate only on the user tree's
 configuration files and/or \f(CW\*(C`texlive.tlpdb\*(C'\fR.
 creates configuration files in user tree
-.SH "CONFIGURATION FILE FOR TLMGR"
-.IX Header "CONFIGURATION FILE FOR TLMGR"
-There are two configuration files for \f(CW\*(C`tlmgr\*(C'\fR: One is system-wide in
-\&\f(CW\*(C`TEXMFSYSCONFIG/tlmgr/config\*(C'\fR, and the other is user-specific in
-\&\f(CW\*(C`TEXMFCONFIG/tlmgr/config\*(C'\fR (in the default setup, that is
-\&\f(CW\*(C`~/.texliveYYYY/texmf\-config/tlmgr/config\*(C'\fR, where \f(CW\*(C`YYYY\*(C'\fR is the
-release year of your TeX Live installation).
-.PP
-A small subset of the command line options can be set in these
-configuration files.  In addition, the system-wide file can contain a
-directive to restrict the number of allowed actions.
-.PP
-In these config files, empty lines and lines starting with # are
-ignored.  All other lines must look like
-.PP
-.Vb 1
-\&  key = value
-.Ve
-.PP
-where the allowed keys are \f(CW\*(C`gui\-expertmode\*(C'\fR (value 0 or 1),
-\&\f(CW\*(C`persistent\-downloads\*(C'\fR (value 0 or 1), \f(CW\*(C`auto\-remove\*(C'\fR (value 0 or 1),
-\&\f(CW\*(C`verify\-downloads\*(C'\fR (value 0 or 1),
-and \f(CW\*(C`gui\-lang\*(C'\fR (value as with the command-line option).
-.PP
-\&\f(CW\*(C`persistent\-downloads\*(C'\fR, \f(CW\*(C`gui\-lang\*(C'\fR, \f(CW\*(C`auto\-remove\*(C'\fR, and \f(CW\*(C`verify\-downloads\*(C'\fR
-correspond to the respective command line options of the same name.  
-\&\f(CW\*(C`gui\-expertmode\*(C'\fR switches between the full \s-1GUI\s0 and a simplified \s-1GUI\s0
-with only the important and mostly used settings.
-.PP
-In addition, the system-wide config file can contain the key
-\&\f(CW\*(C`allowed\-actions\*(C'\fR. The value is a comma-separated list of actions that
-are allowed to be executed when \f(CW\*(C`tlmgr\*(C'\fR is called in system mode (that
-is, without \f(CW\*(C`\-\-usermode\*(C'\fR).  This allows distributors to include the
-\&\f(CW\*(C`tlmgr\*(C'\fR in their packaging, but allow only a restricted set of actions
-that do not interfere with the distro package managers.  (For native TeX
-Live installations, it doesn't make sense to set this.)
 .SH "MULTIPLE REPOSITORIES"
 .IX Header "MULTIPLE REPOSITORIES"
 The main TeX Live repository contains a vast array of packages.
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index 52b52854a6d..d35eabe8645 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf