From 7ce5219c24495a161caa36ead4925c85d4401936 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 7 Nov 2019 18:35:53 +0000 Subject: doc git-svn-id: svn://tug.org/texlive/trunk@52672 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/scripts/texlive/tlmgr.pl | 30 ++++++++++++++++++++---------- Master/tlpkg/bin/tl-update-asy | 4 ++-- 2 files changed, 22 insertions(+), 12 deletions(-) diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl index b346490df33..8fc8a37fee8 100755 --- a/Master/texmf-dist/scripts/texlive/tlmgr.pl +++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl @@ -8925,9 +8925,9 @@ must be specified. Options: =item B<--all> -Update all installed packages except for C itself. Thus, if -updates to C itself are present, this will simply give an error, -unless also the option C<--force> or C<--self> is given. (See below.) +Update all installed packages except for C itself. If updates to +C itself are present, this gives an error, unless also the option +C<--force> or C<--self> is given. (See below.) In addition to updating the installed packages, during the update of a collection the local installation is (by default) synchronized to the @@ -8944,7 +8944,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 C<--list>. This auto-installation can be -suppressed using the option C<--no-auto-install>. +suppressed using the option C<--no-auto-install> (also not recommended). An exception to the collection dependency checks (including the auto-installation of packages just mentioned) are those that have been @@ -8952,6 +8952,13 @@ auto-installation of packages just mentioned) are those that have been on them. (See the C action documentation.) To reinstall any such forcibly removed packages use C<--reinstall-forcibly-removed>. +To reiterate: automatic removals and additions are entirely determined +by comparison of collections. Thus, if you manually install an +individual package C which is later removed from the server, +C 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.) + If you want to exclude some packages from the current update run (e.g., due to a slow link), see the C<--exclude> option below. @@ -9015,12 +9022,12 @@ the key C. =item B<--no-auto-remove> [I...] -By default, C tries to remove packages which have disappeared on -the server, as described above under C<--all>. This option prevents -such removals, either for all packages (with C<--all>), or for just the -given I 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, C tries to remove packages in an existing collection +which have disappeared on the server, as described above under C<--all>. +This option prevents such removals, either for all packages (with +C<--all>), or for just the given I 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. =item B<--no-auto-install> [I...] @@ -9041,6 +9048,9 @@ is equivalent to tlmgr update --all tlmgr remove --force foobar +Again, since packages are sometimes renamed or replaced, using this +option is not ecommended. + =item B<--reinstall-forcibly-removed> Under normal circumstances C will not install packages that have diff --git a/Master/tlpkg/bin/tl-update-asy b/Master/tlpkg/bin/tl-update-asy index b86006b2c22..9d37f9e1c69 100755 --- a/Master/tlpkg/bin/tl-update-asy +++ b/Master/tlpkg/bin/tl-update-asy @@ -29,9 +29,9 @@ if false && $update_sources_from_ctan; then svn status | sed -n 's/^\?//p' | fgrep -v binaries svn add `!!` - # show list of files to remove (keep gc-7.6.2 until new is working): + # show list of files to remove: diff -qr . /home/ftp/tex-archive/graphics/asymptote/ \ - | egrep -v ' differ' | egrep -v '\.svn|gc-7.6.2' + | egrep -v ' differ' | egrep -v '\.svn' svn rm ... # final check and commit: -- cgit v1.2.3