2 files changed, 21 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 47b2b17bf09..f4e1a12dc1c 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-05-06" "perl v5.28.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2019-05-07" "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
@@ -789,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:
@@ -844,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
@@ -1024,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:
@@ -1193,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
@@ -1553,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 d3e9d77a877..f0b95786995 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf