summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-06-10 22:41:49 +0000
committerKarl Berry <karl@freefriends.org>2012-06-10 22:41:49 +0000
commit528caff145b673211b8d2a23538b7ed0fa34c218 (patch)
tree537e54cced7cc8be8e64c447678aeaac13eb4ab2
parentf17f0f49b8732e1021f417704291ef4f8f9cfd5c (diff)
updmap doc forever
git-svn-id: svn://tug.org/texlive/trunk@26891 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xBuild/source/texk/tetex/updmap.pl27
-rw-r--r--Master/texmf/web2c/updmap-hdr.cfg22
-rw-r--r--Master/texmf/web2c/updmap.cfg15
3 files changed, 36 insertions, 28 deletions
diff --git a/Build/source/texk/tetex/updmap.pl b/Build/source/texk/tetex/updmap.pl
index 96df8868c5b..661e55b43bb 100755
--- a/Build/source/texk/tetex/updmap.pl
+++ b/Build/source/texk/tetex/updmap.pl
@@ -2048,16 +2048,18 @@ Explanation of trees and files normally used:
If --cnffile is specified on the command line (possibly multiple
times), its value(s) are used. Otherwise, updmap reads all the
- updmap.cfg files found by running \`kpsewhich -all updmap.cfg', in
- the order returned by kpsewhich, with the exception that a file found
- in TEXMFLOCAL is moved above the one in TEXMFMAIN, to make sure that
- local adjustments by admins take precedence over what is shipped in
- TeX Live. If multiple updmap.cfg files are found, all the maps
+ updmap.cfg files found by running \`kpsewhich -all updmap.cfg', in the
+ order returned by kpsewhich, with one exception: an updmap.cfg found
+ in TEXMFLOCAL is given higher priority than the updmap.cfg in
+ TEXMFMAIN, to ensure that local adjustments by administrators take
+ precedence over what is shipped in TeX Live.
+
+ In any case, if multiple updmap.cfg files are found, all the maps
mentioned in all the updmap.cfg files are merged.
Thus, if updmap.cfg files are present in all trees, and the default
layout is used as shipped with TeX Live, the following files are
- read in the given order.
+ read, in the given order.
For updmap-sys:
TEXMFSYSCONFIG \$TEXLIVE/YYYY/texmf-config/web2c/updmap.cfg
@@ -2078,10 +2080,10 @@ Explanation of trees and files normally used:
(where YYYY is the TeX Live release version).
- There is another exception to keep upgradability from earlier versions of
- TeX Live: if a file TEXMFLOCAL/web2c/updmap-local.cfg exists (formerly
- used by tlmgr to merge local fonts), then the file
- TEXMFLOCAL/web2c/updmap.cfg is ignored (if it exists) and the
+ There is another exception to keep upgradability from earlier versions
+ of TeX Live: if a file TEXMFLOCAL/web2c/updmap-local.cfg exists
+ (formerly used by tlmgr to merge local fonts), then the file
+ TEXMFLOCAL/web2c/updmap.cfg is ignored (if it exists) and that
updmap-local.cfg is used instead. In this case, updmap recognizes the
previous syntax for disabling map files in updmap-local.cfg (this
syntax is different from what is used now).
@@ -2093,6 +2095,7 @@ Explanation of trees and files normally used:
line, then the first one given will be used to save any changes from
--setoption, --enable or --disable. If the config files are taken
from kpsewhich output, then the algorithm is more complex:
+
1) If \$TEXMFCONFIG/web2c/updmap.cfg or \$TEXMFHOME/web2c/updmap.cfg
appears in the list of used files, then the one listed first by
kpsewhich --all (equivalently, the one returned by kpsewhich
@@ -2101,10 +2104,10 @@ Explanation of trees and files normally used:
2) If neither of the above two are present and changes are made, a
new config file is created in \$TEXMFCONFIG/web2c/updmap.cfg.
- Multiple definitions of a font:
+ Resolving multiple definitions of a font:
If a font is defined in more than one map file, then the definition
coming from the first-listed updmap.cfg is used. If a font is
- defined multiple times in the same map file, one is chosen
+ defined multiple times within the same map file, one is chosen
arbitrarily. In both cases a warning is issued.
Disabling maps:
diff --git a/Master/texmf/web2c/updmap-hdr.cfg b/Master/texmf/web2c/updmap-hdr.cfg
index 5f421eec0d2..07a1f6d97e3 100644
--- a/Master/texmf/web2c/updmap-hdr.cfg
+++ b/Master/texmf/web2c/updmap-hdr.cfg
@@ -2,6 +2,26 @@
#
# The updmap.cfg in this tree (TEXMFDIST) is generated by tlmgr by
# concatenating updmap-hdr.cfg with all updmap.cfg files found.
-# See the updmap --help information and/or
+#
+# To make local customizations to the map files, using one of the
+# following methods is simplest:
+#
+# 1) run
+# updmap-sys --enable Map=foo.map
+# for each map file. (Or MixedMap instead of Map, if your font has
+# both Metafont and outline definitions.) See the updmap --help
+# documentation. This will add lines to the updmap.cfg file in
+# TEXMFSYSCONFIG (creating it if necessary).
+#
+# 2) put all your additional fonts into TEXMFLOCAL, edit
+# TEXMFLOCAL/web2c/updmap.cfg, and run updmap-sys.
+#
+# See the output of updmap --help and/or
# http://tug.org/fonts/fontinstall.html for more.
+#
+# In any case, manual edits to TL's updmap.cfg files, psfonts.map,
+# pdftex.map, etc., will be lost on update. So don't do that.
#
+# The default settings of the updmap options (not maps) are specified in
+# TEXMFMAIN/web2c/updmap.cfg and can be overridden by an updmap.cfg in
+# any other tree.
diff --git a/Master/texmf/web2c/updmap.cfg b/Master/texmf/web2c/updmap.cfg
index dcc0bd8d5c0..c593ae55195 100644
--- a/Master/texmf/web2c/updmap.cfg
+++ b/Master/texmf/web2c/updmap.cfg
@@ -1,20 +1,5 @@
# $Id$
# updmap.cfg for TEXMFMAIN - updmap options.
-#
-# To make local customizations to the map files, please use of the
-# following methods:
-#
-# 1) run
-# updmap-sys --enable Map=foo.map
-# for each map file. (Or MixedMap instead of Map, if your font has
-# both Metafont and outline definitions.) See the updmap --help
-# documentation. This will add lines to the updmap.cfg file in
-# TEXMFSYSCONFIG (creating it if necessary).
-#
-# 2) put all your additional fonts into TEXMFLOCAL and edit
-# TEXMFLOCAL/web2c/updmap.cfg.
-#
-# Manual edits will be lost on update.
################################################################