tl-update-auto

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

2 files changed, 23 insertions, 13 deletions

diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 8251db66f1f..f22b2bd8de6 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 "2019-11-06" "perl v5.30.0" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2019-11-07" "perl v5.30.0" "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
@@ -1230,7 +1230,7 @@ and the respective tags if set. If a path, url, or tag is given after
 the \f(CW\*(C`list\*(C'\fR keyword, it is interpreted as the source from which to
 initialize a \s-1TL\s0 database and lists the contained packages. This can also
 be an otherwise-unused repository, either local or remote. If the option
-\&\f(CW\*(C`\-\-with\-platforms\*(C'\fR is specified in addition, for each package the
+\&\f(CW\*(C`\-\-with\-platforms\*(C'\fR is spcified in addition, for each package the
 available platforms (if any) are also listed.
 .Sp
 The form \f(CW\*(C`repository add\*(C'\fR adds a repository (optionally attaching a
@@ -1408,9 +1408,9 @@ at the installation source.  Either \f(CW\*(C`\-\-all\*(C'\fR or at least one \f
 must be specified.  Options:
 .IP "\fB\-\-all\fR" 4
 .IX Item "--all"
-Update all installed packages except for \f(CW\*(C`tlmgr\*(C'\fR itself.  Thus, if
-updates to \f(CW\*(C`tlmgr\*(C'\fR itself are present, this will simply give an error,
-unless also the option \f(CW\*(C`\-\-force\*(C'\fR or \f(CW\*(C`\-\-self\*(C'\fR is given.  (See below.)
+Update all installed packages except for \f(CW\*(C`tlmgr\*(C'\fR itself. If updates to
+\&\f(CW\*(C`tlmgr\*(C'\fR itself are present, this gives an error, unless also the option
+\&\f(CW\*(C`\-\-force\*(C'\fR or \f(CW\*(C`\-\-self\*(C'\fR is given. (See below.)
 .Sp
 In addition to updating the installed packages, during the update of a
 collection the local installation is (by default) synchronized to the
@@ -1427,7 +1427,7 @@ Analogously, if a package has been added to a collection on the server
 that is also installed locally, it will be added to the local
 installation.  This is called ``auto\-install'' and is announced as such
 when using the option \f(CW\*(C`\-\-list\*(C'\fR.  This auto-installation can be
-suppressed using the option \f(CW\*(C`\-\-no\-auto\-install\*(C'\fR.
+suppressed using the option \f(CW\*(C`\-\-no\-auto\-install\*(C'\fR (also not recommended).
 .Sp
 An exception to the collection dependency checks (including the
 auto-installation of packages just mentioned) are those that have been
@@ -1435,6 +1435,13 @@ auto-installation of packages just mentioned) are those that have been
 on them.  (See the \f(CW\*(C`remove\*(C'\fR action documentation.)  To reinstall any
 such forcibly removed packages use \f(CW\*(C`\-\-reinstall\-forcibly\-removed\*(C'\fR.
 .Sp
+To reiterate: automatic removals and additions are entirely determined
+by comparison of collections. Thus, if you manually install an
+individual package \f(CW\*(C`foo\*(C'\fR which is later removed from the server,
+\&\f(CW\*(C`tlmgr\*(C'\fR 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.)
+.Sp
 If you want to exclude some packages from the current update run (e.g.,
 due to a slow link), see the \f(CW\*(C`\-\-exclude\*(C'\fR option below.
 .IP "\fB\-\-self\fR" 4
@@ -1497,12 +1504,12 @@ This option can also be set permanently in the tlmgr config file with
 the key \f(CW\*(C`update\-exclude\*(C'\fR.
 .IP "\fB\-\-no\-auto\-remove\fR [\fIpkg\fR...]" 4
 .IX Item "--no-auto-remove [pkg...]"
-By default, \f(CW\*(C`tlmgr\*(C'\fR tries to remove packages which have disappeared on
-the server, as described above under \f(CW\*(C`\-\-all\*(C'\fR.  This option prevents
-such removals, either for all packages (with \f(CW\*(C`\-\-all\*(C'\fR), or for just the
-given \fIpkg\fR 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.
+By default, \f(CW\*(C`tlmgr\*(C'\fR tries to remove packages in an existing collection
+which have disappeared on the server, as described above under \f(CW\*(C`\-\-all\*(C'\fR.
+This option prevents such removals, either for all packages (with
+\&\f(CW\*(C`\-\-all\*(C'\fR), or for just the given \fIpkg\fR 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.
 .IP "\fB\-\-no\-auto\-install\fR [\fIpkg\fR...]" 4
 .IX Item "--no-auto-install [pkg...]"
 Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will install packages which are new
@@ -1525,6 +1532,9 @@ is equivalent to
 \&  tlmgr update \-\-all
 \&  tlmgr remove \-\-force foobar
 .Ve
+.Sp
+Again, since packages are sometimes renamed or replaced, using this
+option is not ecommended.
 .IP "\fB\-\-reinstall\-forcibly\-removed\fR" 4
 .IX Item "--reinstall-forcibly-removed"
 Under normal circumstances \f(CW\*(C`tlmgr\*(C'\fR will not install packages that have
@@ -2325,4 +2335,4 @@ This script and its documentation were written for the TeX Live
 distribution (<https://tug.org/texlive>) and both are licensed under the
 \&\s-1GNU\s0 General Public License Version 2 or later.
 .PP
-\&\f(CW$Id:\fR tlmgr.pl 52661 2019\-11\-06 22:48:49Z karl $
+\&\f(CW$Id:\fR tlmgr.pl 52467 2019\-10\-20 22:10:34Z karl $
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index ce72ec07ee1..0f1f4d4da4f 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf