summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-11-08 00:55:25 +0000
committerKarl Berry <karl@freefriends.org>2019-11-08 00:55:25 +0000
commit76d6da77d0189a7627e71be9af26e79f3f7be840 (patch)
tree7b4d9aa20dc743e19cc90792c39aa72c2edfb905 /Master/texmf-dist/doc/man/man1
parent2169f1a318cff6e7eaa0dc7579f151768fc8b36f (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@52690 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1')
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.136
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.man1.pdfbin135633 -> 136107 bytes
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
Binary files differ