From 692e0ee16fdeefd289e5a0f7ae5c991bb4692c5f Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 14 Nov 2017 21:16:47 +0000 Subject: doc git-svn-id: svn://tug.org/texlive/trunk@45806 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/scripts/texlive/tlmgr.pl | 69 +++++++++++++++--------------- 1 file changed, 35 insertions(+), 34 deletions(-) (limited to 'Master/texmf-dist/scripts') 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 used for changing it in -parentheses. +The first form, C, shows the global TeX Live settings currently +saved in the TLPDB with a short description and the C 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, 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, -format definition C. +Both C 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, format definition C. -In the third form, if I is not given, the setting for I is -displayed. If I is present, I is set to I. +In the third form, with I, if I is not given, the setting +for I is displayed. If I is present, I is set to +I. Possible values for I are (run C for the definitive list): @@ -7902,21 +7903,22 @@ DVD. To do this, you can run The C documentation has more information about the possible values for C. (For backward compatibility, C can -be used as alternative name for C.) +be used as a synonym for C.) If C 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 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 and C 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 and C determine the defaults for the actions C, C and C. These three actions @@ -7936,22 +7938,21 @@ To setup C 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, C, and C options are used on -Unix-like systems to control the generation of links for executables, -info files and man pages. See the C action for details. - -The last three options also affect behavior on Windows installations. -If C is set, then some packages will install items -in a sub-folder of the Start menu for C, documentation, etc. -If C is set, Windows file associations are made (see also -the C action). Finally, if C 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, C, and C options are used on Unix +systems to control the generation of links for executables, Info files +and man pages. See the C action for details. + +The last three options affect behavior on Windows installations. If +C is set, then some packages will install items in +a sub-folder of the Start menu for C, documentation, etc. If +C is set, Windows file associations are made (see also the +C action). Finally, if C 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 -- cgit v1.2.3