diff options
author | Karl Berry <karl@freefriends.org> | 2017-04-28 00:06:54 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-04-28 00:06:54 +0000 |
commit | b3d34e6b315c0b1974a82195e7770fdc1c72bfcf (patch) | |
tree | 2a17ae35084bff3f4afd8ea2c2a1d7310a4301c7 /Master/texmf-dist/doc/man | |
parent | cf5438eaba34e6860f9afe288a5bea82b5e128bc (diff) |
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@44090 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.1 | 51 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | bin | 91160 -> 91070 bytes |
2 files changed, 27 insertions, 24 deletions
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1 index 4b8a89ade04..07a60de363f 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-04-15" "perl v5.24.1" "User Contributed Perl Documentation" +.TH TLMGR 1 "2017-04-27" "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,17 +405,16 @@ 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]]]" -.IX Subsection "conf [texmf|tlmgr|updmap [--conffile file] [--delete] [key [value]]]" +.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]" 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 the \f(CW\*(C`texconfig conf\*(C'\fR call, but works on all supported platforms. +like running \f(CW\*(C`texconfig conf\*(C'\fR, 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 user-specific \f(CW\*(C`tlmgr\*(C'\fR configuration file (see -below), or the first found (via \f(CW\*(C`kpsewhich\*(C'\fR) \f(CW\*(C`updmap.cfg\*(C'\fR file, -respectively. +With one of \f(CW\*(C`conf texmf\*(C'\fR, \f(CW\*(C`conf tlmgr\*(C'\fR, or \f(CW\*(C`conf updmap\*(C'\fR, shows all +key/value pairs (i.e., all settings) as saved in \f(CW\*(C`ROOT/texmf.cnf\*(C'\fR, the +user-specific \f(CW\*(C`tlmgr\*(C'\fR configuration file (see below), or the first +found (via \f(CW\*(C`kpsewhich\*(C'\fR) \f(CW\*(C`updmap.cfg\*(C'\fR file, respectively. .PP 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 value in @@ -425,14 +424,27 @@ 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 +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). 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 /my/quick/test/tree +\& tlmgr conf texmf auxtrees remove /my/quick/test/tree +.Ve +.PP 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 -The \s-1PATH\s0 value shown is that 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. +The \f(CW\*(C`PATH\*(C'\fR value shown is that 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 -Practical example of changing configuration values: if the execution of +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: .PP @@ -440,18 +452,9 @@ installation, you can disable 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 on -either keys or values is done, so any sort of breakage is possible. +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 diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf Binary files differindex 8b542047c31..88b05a9b413 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf |