From e5563636f39c41933f077e53ffe9e7544f27a17d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 9 May 2019 23:38:22 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@51067 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/tlmgr.1 | 40 +++++++++++++++++++------- Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | Bin 133183 -> 134522 bytes 2 files changed, 29 insertions(+), 11 deletions(-) (limited to 'Master/texmf-dist/doc/man') diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index c3fa05f1382..8ffdfe35b24 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-04-05" "perl v5.28.1" "User Contributed Perl Documentation" +.TH TLMGR 1 "2019-05-09" "perl v5.28.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 @@ -178,9 +178,13 @@ with \f(CW\*(C`tlmgr\*(C'\fR: Tell \f(CW\*(C`tlmgr\*(C'\fR to use a nearby \s-1CTAN\s0 mirror for future updates; useful if you installed TeX Live from the \s-1DVD\s0 image and want to have continuing updates. The two commands are equivalent; \f(CW\*(C`ctan\*(C'\fR is just an alias for -the given url. Caveat: \f(CW\*(C`mirror.ctan.org\*(C'\fR 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. +.Sp +Caveat: \f(CW\*(C`mirror.ctan.org\*(C'\fR 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 \s-1CTAN\s0 mirrors with the status of each is at +. .ie n .IP """tlmgr update \-\-list""" 4 .el .IP "\f(CWtlmgr update \-\-list\fR" 4 .IX Item "tlmgr update --list" @@ -227,7 +231,7 @@ like this: .Sp Of course a real hostname and its particular top-level \s-1CTAN\s0 directory have to be specified. The list of \s-1CTAN\s0 mirrors is available at -. +. .Sp Here's an example of using a local directory: .Sp @@ -785,8 +789,8 @@ with \f(CW\*(C`\-\-usertree\*(C'\fR. See \*(L"\s-1USER MODE\*(R"\s0 below. .SS "install [\fIoption\fP...] \fIpkg\fP..." .IX Subsection "install [option...] pkg..." Install each \fIpkg\fR given on the command line, if it is not already -installed. (It does not touch existing packages; see the \f(CW\*(C`update\*(C'\fR -action for how to get the latest version of a package.) +installed. It does not touch existing packages; see the \f(CW\*(C`update\*(C'\fR +action for how to get the latest version of a package. .PP By default this also installs all packages on which the given \fIpkg\fRs are dependent. Options: @@ -840,6 +844,10 @@ after all. You can get them by using these options in conjunction with .Vb 1 \& tlmgr install \-\-reinstall \-\-with\-doc \-\-with\-src fontspec .Ve +.PP +This action does not automatically add new symlinks in system +directories; you need to run \f(CW\*(C`tlmgr path add\*(C'\fR (\*(L"path\*(R") yourself if +you are using this feature and want new symlinks added. .SS "key" .IX Subsection "key" .IP "\fBkey list\fR" 4 @@ -1020,10 +1028,12 @@ settings. .IP "\fBpath [\-\-w32mode=user|admin] remove\fR" 4 .IX Item "path [--w32mode=user|admin] remove" .PD -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\*(R" 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\*(R" 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. .Sp On Windows, the registry part where the binary directory is added or removed is determined in the following way: @@ -1189,6 +1199,10 @@ updated, and will be mentioned as \f(CW\*(C`forcibly removed\*(C'\fR in the outp .IX Item "--dry-run" Nothing is actually removed; instead, the actions to be performed are written to the terminal. +.PP +This action does not automatically remove symlinks to executables from +system directories; you need to run \f(CW\*(C`tlmgr path remove\*(C'\fR (\*(L"path\*(R") +yourself if you are using this feature and want stale symlinks removed. .SS "repository" .IX Subsection "repository" .IP "\fBrepository list\fR" 4 @@ -1549,6 +1563,10 @@ with a suffix representing the repository url, as in fallback information, but if you don't like them accumulating (e.g., \&\f(CW\*(C`mirror.ctan.org\*(C'\fR resolves to many different hosts, each resulting in a possibly different hash), it's harmless to delete them. +.PP +This action does not automatically add or remove new symlinks in system +directories; you need to run \f(CW\*(C`tlmgr\*(C'\fR \*(L"path\*(R" yourself if you are using +this feature and want new symlinks added. .SH "CONFIGURATION FILE FOR TLMGR" .IX Header "CONFIGURATION FILE FOR TLMGR" \&\f(CW\*(C`tlmgr\*(C'\fR reads two configuration files: one is system-wide, in diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf index 7810f2ad159..1cc780ae71c 100644 Binary files a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf and b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf differ -- cgit v1.2.3