add documentation for option generate_updmap

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

1 files changed, 14 insertions, 0 deletions

diff --git a/Master/texmf/scripts/texlive/tlmgr.pl b/Master/texmf/scripts/texlive/tlmgr.pl
index 42cd3573c2a..08b972e3a01 100755
--- a/Master/texmf/scripts/texlive/tlmgr.pl
+++ b/Master/texmf/scripts/texlive/tlmgr.pl
@@ -5518,6 +5518,7 @@ the definitive list):
  sys_bin    (directory to which executables are linked by the path action)
  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)
 
 One common use of C<option> is to permanently change the installation to
 get further updates from the Internet, after originally installing from
@@ -5556,6 +5557,19 @@ 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.)
 
+By default C<tlmgr> does not call the equivalent of
+
+  tlmgr generate updmap
+
+to allow for local modifications. But if you keep all your local
+modifications in C<updmap-local.cfg>, then setting the option
+C<generate_updmap> will make C<tlmgr> to recreate the C<updmap.cfg>
+file from the installed packages and C<updmap-local.cfg> every time
+a change occurs. Of course, if you make manual changes to 
+C<updmap-local.cfg> you need to call C<tlmgr generate updmap> manually.
+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.
 
 =head2 conf [texmf|tlmgr [I<key> [I<value>]]]