summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-11-14 21:16:47 +0000
committerKarl Berry <karl@freefriends.org>2017-11-14 21:16:47 +0000
commit692e0ee16fdeefd289e5a0f7ae5c991bb4692c5f (patch)
tree5b3df3c5a8957e2ec5e23d0f57d127521227886c
parentf510fd86b82fae49771ecb4bd74b06d51a3939fa (diff)
doc
git-svn-id: svn://tug.org/texlive/trunk@45806 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xMaster/texmf-dist/scripts/texlive/tlmgr.pl69
1 files changed, 35 insertions, 34 deletions
diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl
index 61f8ff5aec8..07b7f656511 100755
--- a/Master/texmf-dist/scripts/texlive/tlmgr.pl
+++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl
@@ -7862,20 +7862,21 @@ from the local keyring.
=back
-The first form shows the global TeX Live settings currently saved in the
-TLPDB with a short description and the C<key> used for changing it in
-parentheses.
+The first form, C<show>, shows the global TeX Live settings currently
+saved in the TLPDB with a short description and the C<key> used for
+changing it in parentheses.
-The second form is similar, but also shows options which can be defined
-but are not currently set to any value.
+The second form, C<showall>, is similar, but also shows options which
+can be defined but are not currently set to any value.
-Both forms take an option C<--json> in which case the options are dumped
-in JSON format. In addition, with C<--json> the two forms dump the same
-data. For the format of JSON output see C<tlpkg/doc/JSON-formats.txt>,
-format definition C<TLOPTION>.
+Both C<show...> forms take an option C<--json>, which dumps the option
+information in JSON format. In this case, both forms dump the same
+data. For the format of the JSON output see
+C<tlpkg/doc/JSON-formats.txt>, format definition C<TLOPTION>.
-In the third form, if I<value> is not given, the setting for I<key> is
-displayed. If I<value> is present, I<key> is set to I<value>.
+In the third form, with I<key>, if I<value> is not given, the setting
+for I<key> is displayed. If I<value> is present, I<key> is set to
+I<value>.
Possible values for I<key> are (run C<tlmgr option showall> for
the definitive list):
@@ -7902,21 +7903,22 @@ DVD. To do this, you can run
The C<install-tl> documentation has more information about the possible
values for C<repository>. (For backward compatibility, C<location> can
-be used as alternative name for C<repository>.)
+be used as a synonym for C<repository>.)
If C<formats> is set (this is the default), then formats are regenerated
when either the engine or the format files have changed. Disable this
-only when you know what you are doing.
+only when you know how and want to regenerate formats yourself.
The C<postcode> option controls execution of per-package
postinstallation action code. It is set by default, and again disabling
-is not likely to be of interest except perhaps to developers.
+is not likely to be of interest except to developers doing debugging.
The C<docfiles> and C<srcfiles> options control the installation of
-their respective files of a package. By default both are enabled (1).
-Either or both can be disabled (set to 0) if disk space is limited or
-for minimal testing installations, etc. When disabled, the respective
-files are not downloaded at all.
+their respective file groups (documentation, sources; grouping is
+approximate) per package. By default both are enabled (1). Either or
+both can be disabled (set to 0) if disk space is limited or for minimal
+testing installations, etc. When disabled, the respective files are not
+downloaded at all.
The options C<autobackup> and C<backupdir> determine the defaults for
the actions C<update>, C<backup> and C<restore>. These three actions
@@ -7936,22 +7938,21 @@ To setup C<autobackup> to C<-1> on the command line, use:
tlmgr option -- autobackup -1
-The C<--> avoids having the C<-1> treated as an option. (C<--> stops
-parsing for options at the point where it appears; this is a general
-feature across most Unix programs.)
-
-The C<sys_bin>, C<sys_man>, and C<sys_info> options are used on
-Unix-like systems to control the generation of links for executables,
-info files and man pages. See the C<path> action for details.
-
-The last three options also affect behavior on Windows installations.
-If C<desktop_integration> is set, then some packages will install items
-in a sub-folder of the Start menu for C<tlmgr gui>, documentation, etc.
-If C<fileassocs> is set, Windows file associations are made (see also
-the C<postaction> action). Finally, if C<multiuser> is set, then
-adaptions to the registry and the menus are done for all users on the
-system instead of only the current user. All three options are on by
-default.
+The C<--> avoids having the C<-1> treated as an option. (The C<-->
+stops parsing for options at the point where it appears; this is a
+general feature across most Unix programs.)
+
+The C<sys_bin>, C<sys_man>, and C<sys_info> options are used on Unix
+systems to control the generation of links for executables, Info files
+and man pages. See the C<path> action for details.
+
+The last three options affect behavior on Windows installations. If
+C<desktop_integration> is set, then some packages will install items in
+a sub-folder of the Start menu for C<tlmgr gui>, documentation, etc. If
+C<fileassocs> is set, Windows file associations are made (see also the
+C<postaction> action). Finally, if C<multiuser> is set, then adaptions
+to the registry and the menus are done for all users on the system
+instead of only the current user. All three options are on by default.
=head2 paper