add documentation about moving of TEXMFLOCA updmap.cfg up in the hierarchy

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

1 files changed, 10 insertions, 13 deletions

diff --git a/Master/tlpkg/dev/multi-updmap.pl b/Master/tlpkg/dev/multi-updmap.pl
index f019b870c10..9b71119bc3a 100644
--- a/Master/tlpkg/dev/multi-updmap.pl
+++ b/Master/tlpkg/dev/multi-updmap.pl
@@ -13,16 +13,6 @@
 # Anyone may freely use, modify, and/or distribute this file, without
 # limitation.
 #
-# TODO:
-# DONE - if a font is defined in two map files, warn and use the top one
-# - in syncwithtrees: if we actually disabled fonts, should we
-#   run mkMap afterwards? The original didn't do it AFAIR?!?
-# DONE - ignore texmf/web2c/updmap.cfg
-# DONE - sort output by map name, not font name!
-# - general problem: we currently ship updmap.cfg in TEXMFSYSCONFIG
-#   which *overrides* TEXMFLOCAL, so local sysadmins cannot disable
-#   any fonts. The updmap.cfg has to me moved into TEXMFDIST/web2c/
-#   and tlmgr needs to update this file from the installed fonts.
 
 $^W=1;
 use strict;
@@ -1524,7 +1514,7 @@ Usage: $prg     [OPTION] ... [COMMAND]
 
 Update the default font map files used by pdftex, dvips, and dvipdfm(x),
 as determined by all configuration files updmap.cfg (the one returned by
-running "kpsewhich --all updmap.cfg").
+running "kpsewhich --all updmap.cfg", but see below).
 
 Among other things, these map files are used to determine which fonts
 should be used as bitmaps and which as outlines, and to determine which
@@ -1595,8 +1585,15 @@ Explanation of trees and files normally used:
 
   updmap reads all the updmap.cfg found by
     kpsewhich -all updmap.cfg
-  or those given on the command line with --cnffile. 
-  According to the actions it might write to one of the given files or
+  or those given on the command line with --cnffile. If kpsewhich is
+  used to determine the list of config files, there is one caveat: An
+  occurrence of updmap.cfg in TEXMFLOCAL is moved up in the priority
+  list just after files from TEXMFCONFIG, TEXMFVAR and TEXMFHOME. This
+  allows system administrator to override settings in 
+  TEXMFSYSCONFIG/web2c/updmap.cfg which is used by tlmgr to manage
+  the installed options.
+
+  According to the actions updmap might write to one of the given files or
   create a new updmap.cfg, see below for details.
 
   If multiple updmap.cfg files are found, all the map files mentioned