diff options
-rwxr-xr-x | Master/texmf-dist/scripts/texlive/tlmgr.pl | 69 |
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 |