summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-05-05 00:06:40 +0000
committerKarl Berry <karl@freefriends.org>2017-05-05 00:06:40 +0000
commit4754f8e4611a7dfb68d595a52dd1054c33dc2de6 (patch)
tree437bd5d00d0f01dd551f2ca50923819a2621d030 /Master/texmf-dist/doc/man
parent17d0d0848daeb5200221a9264b46d4fe654f9602 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@44199 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/install-tl.14
-rw-r--r--Master/texmf-dist/doc/man/man1/install-tl.man1.pdfbin29712 -> 29918 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.191
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.man1.pdfbin91291 -> 93374 bytes
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
Binary files differ
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
Binary files differ