summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rwxr-xr-xMaster/texmf-dist/scripts/texlive/tlmgr.pl32
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]