diff options
author | Karl Berry <karl@freefriends.org> | 2017-04-28 23:12:11 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-04-28 23:12:11 +0000 |
commit | 641b36be01441464c489c3d0b15751f14ac78971 (patch) | |
tree | f3240a4f3ed0643bbe27f4a6ccfd762758d37e0c /Master/texmf-dist | |
parent | ea595089250526678b91ba53685f0448a7cb7387 (diff) |
doc,sync,binary locations
git-svn-id: svn://tug.org/texlive/trunk@44109 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rwxr-xr-x | Master/texmf-dist/scripts/texlive/tlmgr.pl | 65 |
1 files changed, 32 insertions, 33 deletions
diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl index dca8716a0c8..ac974fec502 100755 --- a/Master/texmf-dist/scripts/texlive/tlmgr.pl +++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl @@ -4349,7 +4349,7 @@ sub action_platform { } } print "Already installed platforms are marked with (i)\n"; - print "You can add new platforms with: tlmgr platform add ARCH1 ARCH2...\n"; + print "You can add new platforms with: tlmgr platform add PLAT1 PLAT2...\n"; return ($F_OK | $F_NOPOSTACTION); } elsif ($what =~ m/^add$/i) { return ($F_ERROR) if !check_on_writable(); @@ -5562,7 +5562,7 @@ sub action_conf { } return($F_OK); } else { - print "No auxilary texmf trees defined.\n"; + print "No auxiliary texmf trees defined.\n"; return($F_OK); } } elsif ($val eq "add") { @@ -5614,11 +5614,11 @@ sub action_conf { $cf->delete_key($tmfa); } } else { - print ("argument `$str' not defined as auxilary texmf tree\n"); + print ("Not defined as auxiliary texmf tree: $str\n"); return($F_WARNING); } } else { - print "No auxilary texmf trees defined, nothing removed\n"; + print "No auxiliary texmf trees defined, nothing removed\n"; return($F_WARNING); } } else { @@ -5636,7 +5636,8 @@ sub action_conf { } elsif (!defined($val)) { if (defined($opts{'delete'})) { if (defined($cf->value($key))) { - info("removing setting $arg $key value: " . $cf->value($key) . "from $fn\n"); + info("removing setting $arg $key value: " . $cf->value($key) + . "from $fn\n"); $cf->delete_key($key); } else { info("$arg $key not defined, cannot remove ($fn)\n"); @@ -7118,13 +7119,12 @@ checking the TL development repository. 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. +like running C<texconfig conf>, 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 user-specific C<tlmgr> configuration file (see -below), or the first found (via C<kpsewhich>) C<updmap.cfg> file, -respectively. +With one of C<conf texmf>, C<conf tlmgr>, or C<conf updmap>, shows all +key/value pairs (i.e., all settings) as saved in C<ROOT/texmf.cnf>, the +user-specific C<tlmgr> configuration file (see below), or the first +found (via C<kpsewhich>) C<updmap.cfg> file, respectively. 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 value in @@ -7134,34 +7134,33 @@ 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!> -For C<texmf> there is a special key C<auxtrees> which allows adding -and removing auxilary texmf trees. C<auxtrees show> shows the list -of additional trees, C<texmf add> I<tree> adds a tree to the list, -and C<auxtrees remove> I<tree> removes a tree from the list (if present). - -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. - -The PATH value shown is that used by C<tlmgr>. The directory in which -the C<tlmgr> executable is found is automatically prepended to the PATH -value inherited from the environment. - -Practical example of changing configuration values: if the execution of -(some or all) system commands via C<\write18> was left enabled during -installation, you can disable it afterwards: +Here is a practical example of changing configuration values. If the +execution of (some or all) system commands via C<\write18> was left +enabled during installation, you can disable 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: +For C<texmf>, an additional subcommand C<auxtrees> allows adding and +removing arbitrary additional texmf trees, completely under user +control. C<texmf auxtrees show> shows the list of additional trees, +C<texmf auxtrees add> I<tree> adds a tree to the list, and C<texmf +auxtrees remove> I<tree> removes a tree from the list (if present). This +works by manipulating the Kpathsea variable C<TEXMFAUXTREES>, in +C<ROOT/texmf.cnf>. Example: - tlmgr conf texmf TEXMFHOME "{~/texmf,~/texmfbis}" + tlmgr conf texmf auxtrees add /my/quick/test/tree + tlmgr conf texmf auxtrees remove /my/quick/test/tree + +In all cases the configuration file can be explicitly specified via the +option C<--conffile> I<file>, if desired. + +The C<PATH> value shown is as used by C<tlmgr>. The directory in which +the C<tlmgr> executable is found is automatically prepended to the PATH +value inherited from the environment. 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. =head2 dump-tlpdb [--local|--remote] |