tl-update-auto

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

4 files changed, 69 insertions, 26 deletions

diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1
index d55bca9dc8d..9740e7f9244 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.1
+++ b/Master/texmf-dist/doc/man/man1/install-tl.1
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "INSTALL-TL 1"
-.TH INSTALL-TL 1 "2017-05-02" "perl v5.24.1" "User Contributed Perl Documentation"
+.TH INSTALL-TL 1 "2017-05-04" "perl v5.24.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
@@ -591,3 +591,5 @@ Don't try to run the \f(CW\*(C`\-\-help\*(C'\fR message through \f(CW\*(C`perldo
 This script and its documentation were written for the TeX Live
 distribution (<http://tug.org/texlive>) and both are licensed under the
 \&\s-1GNU\s0 General Public License Version 2 or later.
+.PP
+\&\f(CW$Id\fR$
diff --git a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
index 5aadf705b3a..aeb934a8ecd 100644
--- a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index be11c307876..5eed24eddd4 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "TLMGR 1"
-.TH TLMGR 1 "2017-05-03" "perl v5.24.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2017-05-04" "perl v5.24.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
@@ -405,8 +405,8 @@ Options:
 .IX Item "--use-svn"
 Use the output of \f(CW\*(C`svn status\*(C'\fR instead of listing the files; for
 checking the \s-1TL\s0 development repository.
-.SS "conf [texmf|tlmgr|updmap [\-\-conffile \fIfile\fP] [\-\-delete] [\fIkey\fP [\fIvalue\fP]]] =head2 conf texmf [\-\-conffile \fIfile\fP] auxtrees [show|add|delete] [\fIvalue\fP]"
-.IX Subsection "conf [texmf|tlmgr|updmap [--conffile file] [--delete] [key [value]]] =head2 conf texmf [--conffile file] auxtrees [show|add|delete] [value]"
+.SS "conf [texmf|tlmgr|updmap [\-\-conffile \fIfile\fP] [\-\-delete] [\fIkey\fP [\fIvalue\fP]]] =head2 conf auxtrees [\-\-conffile \fIfile\fP] [show|add|delete] [\fIvalue\fP]"
+.IX Subsection "conf [texmf|tlmgr|updmap [--conffile file] [--delete] [key [value]]] =head2 conf auxtrees [--conffile file] [show|add|delete] [value]"
 With only \f(CW\*(C`conf\*(C'\fR, show general configuration information for TeX Live,
 including active configuration files, path settings, and more.  This is
 like running \f(CW\*(C`texconfig conf\*(C'\fR, but works on all supported platforms.
@@ -424,6 +424,10 @@ out).
 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
+The \f(CW\*(C`PATH\*(C'\fR value shown by \f(CW\*(C`conf\*(C'\fR is as used by \f(CW\*(C`tlmgr\*(C'\fR.  The
+directory in which the \f(CW\*(C`tlmgr\*(C'\fR executable is found is automatically
+prepended to the \s-1PATH\s0 value inherited from the environment.
+.PP
 Here is a practical example of changing configuration values. If the
 execution of (some or all) system commands via \f(CW\*(C`\ewrite18\*(C'\fR was left
 enabled during installation, you can disable it afterwards:
@@ -432,29 +436,26 @@ enabled during installation, you can disable it afterwards:
 \&  tlmgr conf texmf shell_escape 0
 .Ve
 .PP
-For \f(CW\*(C`texmf\*(C'\fR, an additional subcommand \f(CW\*(C`auxtrees\*(C'\fR allows adding and
-removing arbitrary additional texmf trees, completely under user
-control.  \f(CW\*(C`texmf auxtrees show\*(C'\fR shows the list of additional trees,
-\&\f(CW\*(C`texmf auxtrees add\*(C'\fR \fItree\fR adds a tree to the list, and \f(CW\*(C`texmf
-auxtrees remove\*(C'\fR \fItree\fR removes a tree from the list (if present). Such
-trees should not contain an \f(CW\*(C`ls\-R\*(C'\fR file. This works by manipulating the
-Kpathsea variable \f(CW\*(C`TEXMFAUXTREES\*(C'\fR, in \f(CW\*(C`ROOT/texmf.cnf\*(C'\fR.  Example:
+The subcommand \f(CW\*(C`auxtrees\*(C'\fR allows adding and removing arbitrary
+additional texmf trees, completely under user control.  \f(CW\*(C`auxtrees show\*(C'\fR
+shows the list of additional trees, \f(CW\*(C`auxtrees add\*(C'\fR \fItree\fR adds a tree
+to the list, and \f(CW\*(C`auxtrees remove\*(C'\fR \fItree\fR removes a tree from the list
+(if present). The trees should not contain an \f(CW\*(C`ls\-R\*(C'\fR file. This works
+by manipulating the Kpathsea variable \f(CW\*(C`TEXMFAUXTREES\*(C'\fR, in
+\&\f(CW\*(C`ROOT/texmf.cnf\*(C'\fR.  Example:
 .PP
 .Vb 2
-\&  tlmgr conf texmf auxtrees add /quick/test/tree
-\&  tlmgr conf texmf auxtrees remove /quick/test/tree
+\&  tlmgr conf auxtrees add /quick/test/tree
+\&  tlmgr conf auxtrees remove /quick/test/tree
 .Ve
 .PP
 In all cases the configuration file can be explicitly specified via the
 option \f(CW\*(C`\-\-conffile\*(C'\fR \fIfile\fR, if desired.
 .PP
-The \f(CW\*(C`PATH\*(C'\fR value shown by \f(CW\*(C`conf\*(C'\fR is as used by \f(CW\*(C`tlmgr\*(C'\fR.  The
-directory in which the \f(CW\*(C`tlmgr\*(C'\fR executable is found is automatically
-prepended to the \s-1PATH\s0 value inherited from the environment.
-.PP
-Warning: The general facility is here, but tinkering with settings in
-this way is strongly discouraged.  Again, no error checking on either
-keys or values is done, so any sort of breakage is possible.
+Warning: The general facility for changing configuration values is here,
+but tinkering with settings in this way is 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
@@ -1066,12 +1067,50 @@ filenames) to match only full words.  For example, searching for
 \&\f(CW\*(C`tables\*(C'\fR (unless they also contain the word \f(CW\*(C`table\*(C'\fR on its own).
 .SS "shell"
 .IX Subsection "shell"
-Starts an interactive \*(L"shell\*(R" mode, where tlmgr prompts for
-commands. This can be used directly, or for scripting. The first line of
-output is \f(CW\*(C`protocol\*(C'\fR \fIn\fR, where \fIn\fR is an unsigned number identifying
-the protocol version (currently 1).
-.PP
-Each
+Starts an interactive mode, where tlmgr prompts for commands. This can
+be used directly, or for scripting. The first line of output is
+\&\f(CW\*(C`protocol\*(C'\fR \fIn\fR, where \fIn\fR is an unsigned number identifying the
+protocol version (currently 1).
+.PP
+In general, tlmgr actions that can be given on the command line
+translate to commands in this shell mode.  For example, you can say
+\&\f(CW\*(C`update \-\-list\*(C'\fR to see what would be updated. The \s-1TLPDB\s0 is loaded the
+first time it is needed (not at the beginning), and used for the rest of
+the session.
+.PP
+Besides these actions, a few commands are specific to shell mode:
+.IP "protocol" 4
+.IX Item "protocol"
+Print \f(CW\*(C`protocol \f(CIn\f(CW\*(C'\fR, the current protocol version.
+.IP "help" 4
+.IX Item "help"
+Print pointers to this documentation.
+.IP "version" 4
+.IX Item "version"
+Print tlmgr version information.
+.IP "quit, end, bye, byebye, \s-1EOF\s0" 4
+.IX Item "quit, end, bye, byebye, EOF"
+Exit.
+.IP "restart" 4
+.IX Item "restart"
+Restart \f(CW\*(C`tlmgr shell\*(C'\fR with the original command line; most useful when
+developing \f(CW\*(C`tlmgr\*(C'\fR.
+.IP "load [local|remote]" 4
+.IX Item "load [local|remote]"
+Explicitly load the local or remote, respectively, \s-1TLPDB.\s0
+.IP "save" 4
+.IX Item "save"
+Save the local \s-1TLPDB,\s0 presumably after other operations have changed it.
+.IP "get [\fIvar\fR] =item set [\fIvar\fR [\fIval\fR]]" 4
+.IX Item "get [var] =item set [var [val]]"
+Get the value of \fIvar\fR, or set it to \fIval\fR.  Possible \fIvar\fR names:
+\&\f(CW\*(C`debug\-translation\*(C'\fR, \f(CW\*(C`machine\-readable\*(C'\fR, \f(CW\*(C`no\-execute\-actions\*(C'\fR,
+\&\f(CW\*(C`require\-verification\*(C'\fR, \f(CW\*(C`verify\-downloads\*(C'\fR, and \f(CW\*(C`repository\*(C'\fR. All
+except \f(CW\*(C`repository\*(C'\fR are booleans, taking values 0 and 1, and behave
+like the corresponding command line option.  The \f(CW\*(C`repository\*(C'\fR variable
+takes a string, and sets the remote repository location.
+.Sp
+If \fIvar\fR or then \fIval\fR is not specified, it is prompted for.
 .SS "uninstall"
 .IX Subsection "uninstall"
 Uninstalls the entire TeX Live installation.  Options:
@@ -1890,3 +1929,5 @@ changes would be helpful, do not hesitate to write the mailing list.
 This script and its documentation were written for the TeX Live
 distribution (<http://tug.org/texlive>) and both are licensed under the
 \&\s-1GNU\s0 General Public License Version 2 or later.
+.PP
+\&\f(CW$Id\fR$
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
index 31c5f795fee..568bd21b1a4 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf