From 962fc70e8d572f3453ac4ef13195346c8cd97226 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 16 May 2014 01:23:07 +0000 Subject: /home/texlive/karl/Master/tlpkg/bin/tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@34053 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/tlmgr.1 | 41 ++++++++++++++------- Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | Bin 79870 -> 81184 bytes Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf | Bin 16946 -> 16915 bytes Master/texmf-dist/doc/man/man1/updmap.man1.pdf | Bin 16946 -> 16915 bytes 4 files changed, 27 insertions(+), 14 deletions(-) (limited to 'Master/texmf-dist/doc/man') 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 +). 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, ) 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 Binary files a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf and b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf differ 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 Binary files a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf and b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf differ 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 Binary files a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf and b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf differ -- cgit v1.2.3