diff options
author | Karl Berry <karl@freefriends.org> | 2019-05-10 22:23:09 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-05-10 22:23:09 +0000 |
commit | c4e345d20b5df263dab6270c8ed208049cb9cf4f (patch) | |
tree | c09a9ddf8f5580cba930c5ab35e091bb87c746cd /Master/texmf-dist/scripts | |
parent | b01551ccad284a7f20a02ad811599a5f19d524c6 (diff) |
doc,sync
git-svn-id: svn://tug.org/texlive/trunk@51076 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/scripts')
-rwxr-xr-x | Master/texmf-dist/scripts/texlive/tlmgr.pl | 44 |
1 files changed, 31 insertions, 13 deletions
diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl index eed8e75f1a3..6d9e7528bd8 100755 --- a/Master/texmf-dist/scripts/texlive/tlmgr.pl +++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl @@ -6988,10 +6988,11 @@ do not include the version of the local installation # of the main remote repository, then # warn that one needs to call update-tlmgr-latest.sh --update if ($is_main && $TeXLive::TLConfig::ReleaseYear < $texlive_release_year) { - return (undef, "Remote repository is newer than local ($TeXLive::TLConfig::ReleaseYear < $texlive_release_year)\n" + return (undef, "Local TeX Live ($TeXLive::TLConfig::ReleaseYear)" + . " is older than remote repository ($texlive_release_year).\n" . "Cross release updates are only supported with\n" . " update-tlmgr-latest(.sh/.exe) --update\n" - . "Please see https://tug.org/texlive/upgrade.html for details.") + . "See https://tug.org/texlive/upgrade.html for details.") } } else { # $texlive_minrelease not defined, so only one year is valid @@ -7472,9 +7473,13 @@ with C<tlmgr>: Tell C<tlmgr> to use a nearby CTAN mirror for future updates; useful if you installed TeX Live from the DVD image and want to have continuing updates. The two commands are equivalent; C<ctan> is just an alias for -the given url. Caveat: C<mirror.ctan.org> resolves to many different -hosts, and they are not perfectly synchronized; we recommend updating -only daily (at most), and not more often. +the given url. + +Caveat: C<mirror.ctan.org> resolves to many different hosts, and they +are not perfectly synchronized; we recommend updating only daily (at +most), and not more often. You can choose a particular mirror if +problems; the list of all CTAN mirrors with the status of each is at +L<https://ctan.org/mirrors/mirmon>. =item C<tlmgr update --list> @@ -7525,7 +7530,7 @@ like this: Of course a real hostname and its particular top-level CTAN directory have to be specified. The list of CTAN mirrors is available at -L<https://ctan.org/mirrors>. +L<https://ctan.org/mirrors/mirmon>. Here's an example of using a local directory: @@ -8126,8 +8131,8 @@ with C<--usertree>. See L<USER MODE> below. =head2 install [I<option>...] I<pkg>... Install each I<pkg> given on the command line, if it is not already -installed. (It does not touch existing packages; see the C<update> -action for how to get the latest version of a package.) +installed. It does not touch existing packages; see the C<update> +action for how to get the latest version of a package. By default this also installs all packages on which the given I<pkg>s are dependent. Options: @@ -8189,6 +8194,10 @@ C<--reinstall>, as in (using the C<fontspec> package as the example): =back +This action does not automatically add new symlinks in system +directories; you need to run C<tlmgr path add> (L</path>) yourself if +you are using this feature and want new symlinks added. + =head2 key =over 4 @@ -8371,10 +8380,12 @@ settings. =item B<path [--w32mode=user|admin] remove> -On Unix, merely adds or removes symlinks for binaries, man pages, and -info pages in the system directories specified by the respective options -(see the L</option> description above). Does not change any -initialization files, either system or personal. +On Unix, adds or removes symlinks for executables, man pages, and info +pages in the system directories specified by the respective options (see +the L</option> description above). Does not change any initialization +files, either system or personal. Furthermore, any executables added or +removed by future updates are not taken care of automatically; this +command must be rerun as needed. On Windows, the registry part where the binary directory is added or removed is determined in the following way: @@ -8577,6 +8588,10 @@ written to the terminal. =back +This action does not automatically remove symlinks to executables from +system directories; you need to run C<tlmgr path remove> (L</path>) +yourself if you are using this feature and want stale symlinks removed. + =head2 repository =over 4 @@ -8881,7 +8896,6 @@ supported in these circumstances. This option can also be set permanently in the tlmgr config file with the key C<update-exclude>. - =item B<--no-auto-remove> [I<pkg>...] By default, C<tlmgr> tries to remove packages which have disappeared on @@ -8977,6 +8991,10 @@ fallback information, but if you don't like them accumulating (e.g., C<mirror.ctan.org> resolves to many different hosts, each resulting in a possibly different hash), it's harmless to delete them. +This action does not automatically add or remove new symlinks in system +directories; you need to run C<tlmgr> L</path> yourself if you are using +this feature and want new symlinks added. + =head1 CONFIGURATION FILE FOR TLMGR C<tlmgr> reads two configuration files: one is system-wide, in |