/home/texlive/karl/Master/tlpkg/bin/tl-update-auto

git-svn-id: svn://tug.org/texlive/trunk@34053 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 27 insertions, 14 deletions

diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 537f424faac..0ac9ad951eb 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 "2014-05-10" "perl v5.18.2" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2014-05-15" "perl v5.18.2" "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
@@ -299,7 +299,12 @@ revision number for the loaded TeX Live Perl modules are shown, too.
 .IX Header "ACTIONS"
 .SS "help"
 .IX Subsection "help"
-Gives this help information (same as \f(CW\*(C`\-\-help\*(C'\fR).
+Gives this help information (same as \f(CW\*(C`\-\-help\*(C'\fR, and on the web via
+<http://tug.org/texlive/tlmgr.html>).  Sometimes the \f(CW\*(C`perldoc\*(C'\fR and/or
+\&\f(CW\*(C`PAGER\*(C'\fR programs on the system have problems, resulting in control
+characters being literally output.  We can't control that, but you can
+set the \f(CW\*(C`NOPERLDOC\*(C'\fR environment variable and \f(CW\*(C`perldoc\*(C'\fR will not be
+used.
 .SS "version"
 .IX Subsection "version"
 Gives version information (same as \f(CW\*(C`\-\-version\*(C'\fR).
@@ -382,21 +387,20 @@ With only \f(CW\*(C`conf\*(C'\fR, show general configuration information for TeX
 including active configuration files, path settings, and more.  This is
 like the \f(CW\*(C`texconfig conf\*(C'\fR call, but works on all supported platforms.
 .PP
-With either \f(CW\*(C`conf texmf\*(C'\fR, \f(CW\*(C`conf tlmgr\*(C'\fR, or \f(CW\*(C`conf updmap\*(C'\fR given in 
-addition, shows all key/value pairs (i.e., all settings) as saved in 
-\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the tlmgr configuration file (see below), or the first
-found \f(CW\*(C`updmap.cfg\*(C'\fR file (via kpsewhich), respectively.
+With either \f(CW\*(C`conf texmf\*(C'\fR, \f(CW\*(C`conf tlmgr\*(C'\fR, or \f(CW\*(C`conf updmap\*(C'\fR given in
+addition, shows all key/value pairs (i.e., all settings) as saved in
+\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the tlmgr configuration file (see below), or the
+first found (via kpsewhich) \f(CW\*(C`updmap.cfg\*(C'\fR file, respectively.
 .PP
-If \fIkey\fR is given in addition, shows the value of only that given
-\&\fIkey\fR in the respective file. In case the option \fI\-\-delete\fR is given,
-the respective setting (key value pair) will be removed from the 
-configuration file (note, it is removed, not commented!).
+If \fIkey\fR is given in addition, shows the value of only that \fIkey\fR in
+the respective file.  If option \fI\-\-delete\fR is also given, the
+configuration file \*(-- it is removed, not just commented out!
 .PP
 If \fIvalue\fR is given in addition, \fIkey\fR is set to \fIvalue\fR in the 
 respective file.  \fINo error checking is done!\fR
 .PP
-In all cases the used config file can be selected via the option
-\&\f(CW\*(C`\-\-conffile \f(CIfile\f(CW\*(C'\fR, in case one wants to edit a different file.
+In all cases the file used can be explicitly specified via the option
+\&\f(CW\*(C`\-\-conffile \f(CIfile\f(CW\*(C'\fR, in case one wants to operate on a different file.
 .PP
 Practical application: if the execution of (some or all) system commands
 via \f(CW\*(C`\ewrite18\*(C'\fR was left enabled during installation, you can disable
@@ -406,9 +410,18 @@ it afterwards:
 \&  tlmgr conf texmf shell_escape 0
 .Ve
 .PP
+A more complicated example: the \f(CW\*(C`TEXMFHOME\*(C'\fR tree (see the main TeX Live
+guide, <http://tug.org/texlive/doc.html>) can be set to multiple
+directories, but they must be enclosed in braces and separated by
+commas, so quoting the value to the shell is a good idea.  Thus:
+.PP
+.Vb 1
+\&  tlmgr conf texmf TEXMFHOME "{~/texmf,~/texmfbis}"
+.Ve
+.PP
 Warning: The general facility is here, but tinkering with settings in
-this way is very strongly discouraged.  Again, no error checking is
-done, so any sort of breakage is possible.
+this way is very strongly discouraged.  Again, no error checking on
+either keys or values is done, so any sort of breakage is possible.
 .SS "dump-tlpdb [\-\-local|\-\-remote]"
 .IX Subsection "dump-tlpdb [--local|--remote]"
 Dump complete local or remote \s-1TLPDB\s0 to standard output, as-is.  The
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index e4ad7797c75..f848daeee0d 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
index 45fae7db5d3..6569669f014 100644
--- a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf
index d3c2ec2339e..61426121be4 100644
--- a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf