more option documentation

git-svn-id: svn://tug.org/texlive/trunk@23009 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 29 insertions, 0 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 08b972e3a01..dc2603b9f77 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -5511,6 +5511,7 @@ the definitive list):
 
  repository (default package repository),
  formats    (create formats at installation time),
+ postcode   (run postinst code blobs)
  docfiles   (install documentation files),
  srcfiles   (install source files),
  backupdir  (default directory for backups),
@@ -5519,6 +5520,9 @@ the definitive list):
  sys_man    (directory to which man pages are linked by the path action)
  sys_info   (directory to which Info files are linked by the path action)
  generate_updmap (call the equivalent of tlmgr generate updmap on changes)
+ desktop_integration (create Start menu shortcuts on Windows)
+ fileassocs (change file associations on Windows)
+ multiuser  (install for all users on Windows)
 
 One common use of C<option> is to permanently change the installation to
 get further updates from the Internet, after originally installing from
@@ -5532,6 +5536,18 @@ values for repository.
 To keep backward compatibility C<location> can be used as alternative
 name for C<repository>.
 
+If the C<formats> is set (this is the default), then formats are
+regenerated when either the engine or the format files have changed.
+Disable that only when you know what you are doing.
+
+The C<postcode> options controls execution of package shipped postinstallation
+action code. By default enabled.
+
+The C<docfiles> and C<srcfiles> options control the installations of
+the respective files of a package. By default the source of packages as
+well as the documentation is installed. This can be disabled in case
+of disk space constraints.
+
 The two options C<autobackup> and C<backupdir> determine defaults for
 the C<update>, C<backup> and C<restore> actions.  These three actions
 need a directory to write to or read from the backups.  If
@@ -5557,6 +5573,10 @@ The C<--> avoids having the C<-1> treated as an option.  (For most
 programs, C<--> stops parsing for arguments at the point where it
 appears; this is a general feature of option parsing.)
 
+The C<sys_*> options are used on Unix like systems to control the
+generation of links for binary files, info files and man pages. See
+the action C<path> for details.
+
 By default C<tlmgr> does not call the equivalent of
 
   tlmgr generate updmap
@@ -5571,6 +5591,15 @@ This option is for those who strictly use only the C<updmap-local.cfg>
 file for local adaptions, and not calls to C<updmap --enableMap> etc.
 See L<"generate updmap"> action's description for details.
 
+The last three options control behaviour on Windows installations.
+If C<desktop_integration> is set, then some packages will install links
+in a sub folder in the Start menu. These links are for the C<tlmgr gui>,
+documentation etc. If C<fileassocs> is set then the default for
+updating/adding file associations is set. Please see C<postaction> action
+for details on file associations handling. If C<multiuser> is set, then
+adaptions to the registry and the menus are done for all users on the
+system. All three options are on by default.
+
 =head2 conf [texmf|tlmgr [I<key> [I<value>]]]
 
 With only the C<conf>, show general configuration information for TeX