summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.140
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.man1.pdfbin133183 -> 134522 bytes
2 files changed, 29 insertions, 11 deletions
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
+<https://ctan.org/mirrors/mirmon>.
.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
-<https://ctan.org/mirrors>.
+<https://ctan.org/mirrors/mirmon>.
.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
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
Binary files differ