From 3a6264f044b1f183cbafb10cf9c87d4cd27c89ec Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 15 May 2014 17:25:39 +0000 Subject: doc revisions for tlmgr conf git-svn-id: svn://tug.org/texlive/trunk@34043 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/scripts/texlive/tlmgr.pl | 32 ++++++++++++++++++------------ 1 file changed, 19 insertions(+), 13 deletions(-) diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl index d66eccfa3ea..213dcdf5000 100755 --- a/Master/texmf-dist/scripts/texlive/tlmgr.pl +++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl @@ -5329,7 +5329,7 @@ sub action_conf { $fn || ( chomp ($fn = `kpsewhich updmap.cfg`) ) ; $cf = TeXLive::TLConfFile->new($fn, '(#|(Mixed)?Map)', ' '); } else { - # that cannot happen! + die "Should not happen, conf arg=$arg"; } my ($key,$val) = @ARGV; if (!defined($key)) { @@ -6354,21 +6354,20 @@ With only C, show general configuration information for TeX Live, including active configuration files, path settings, and more. This is like the C call, but works on all supported platforms. -With either C, C, or C given in -addition, shows all key/value pairs (i.e., all settings) as saved in -C, the tlmgr configuration file (see below), or the first -found C file (via kpsewhich), respectively. +With either C, C, or C given in +addition, shows all key/value pairs (i.e., all settings) as saved in +C, the tlmgr configuration file (see below), or the +first found (via kpsewhich) C file, respectively. -If I is given in addition, shows the value of only that given -I in the respective file. In case the option I<--delete> is given, -the respective setting (key value pair) will be removed from the -configuration file (note, it is removed, not commented!). +If I is given in addition, shows the value of only that I in +the respective file. If option I<--delete> is also given, the +configuration file -- it is removed, not just commented out! If I is given in addition, I is set to I in the respective file. I -In all cases the used config file can be selected via the option -C<--conffile I>, in case one wants to edit a different file. +In all cases the file used can be explicitly specified via the option +C<--conffile I>, in case one wants to operate on a different file. Practical application: if the execution of (some or all) system commands via C<\write18> was left enabled during installation, you can disable @@ -6376,9 +6375,16 @@ it afterwards: tlmgr conf texmf shell_escape 0 +A more complicated example: the C tree (see the main TeX Live +guide, L) 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: + + tlmgr conf texmf TEXMFHOME "{~/texmf,~/texmfbis}" + 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. =head2 dump-tlpdb [--local|--remote] -- cgit v1.2.3