diff options
author | Karl Berry <karl@freefriends.org> | 2014-05-15 17:25:39 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-05-15 17:25:39 +0000 |
commit | 3a6264f044b1f183cbafb10cf9c87d4cd27c89ec (patch) | |
tree | 3fd076ccde6a12f798bd4f8327624986842c368c | |
parent | b648feec2acc5b84a99afda72aa24ef9bc489fe2 (diff) |
doc revisions for tlmgr conf
git-svn-id: svn://tug.org/texlive/trunk@34043 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-x | Master/texmf-dist/scripts/texlive/tlmgr.pl | 32 |
1 files 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<conf>, show general configuration information for TeX Live, including active configuration files, path settings, and more. This is like the C<texconfig conf> call, but works on all supported platforms. -With either C<conf texmf>, C<conf tlmgr>, or C<conf updmap> given in -addition, shows all key/value pairs (i.e., all settings) as saved in -C<ROOT/texmf.cnf>, the tlmgr configuration file (see below), or the first -found C<updmap.cfg> file (via kpsewhich), respectively. +With either C<conf texmf>, C<conf tlmgr>, or C<conf updmap> given in +addition, shows all key/value pairs (i.e., all settings) as saved in +C<ROOT/texmf.cnf>, the tlmgr configuration file (see below), or the +first found (via kpsewhich) C<updmap.cfg> file, respectively. -If I<key> is given in addition, shows the value of only that given -I<key> 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<key> is given in addition, shows the value of only that I<key> in +the respective file. If option I<--delete> is also given, the +configuration file -- it is removed, not just commented out! If I<value> is given in addition, I<key> is set to I<value> in the respective file. I<No error checking is done!> -In all cases the used config file can be selected via the option -C<--conffile I<file>>, 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<file>>, 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<TEXMFHOME> tree (see the main TeX Live +guide, L<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: + + 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] |