updmap [OPTION] ... [COMMAND]
updmap-sys [OPTION] ... [COMMAND]
updmap version svn33988 (2014-05-12 15:39:32 +0900)
Update the default font map files used by pdftex, dvips, and
dvipdfm(x), and optionally pxdvi, as determined by all configuration
files updmap.cfg (the ones returned by 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
font files are included in the PDF or PostScript output.
updmap-sys is intended to affect the system-wide configuration, while
updmap affects personal configuration files only, overriding the system
files. As a consequence, once updmap has been run, even a single time,
running updmap-sys no longer has any effect. (updmap-sys issues a
warning in this situation.)
By default, the TeX filename database (ls-R) is also updated.
read FILE for the updmap configuration (can be given multiple
times, in which case all the files are used)
specify output directory (dvipdfm(x) syntax)
specify output directory (dvips syntax)
specify output directory (pdftex syntax)
specify output directory (pxdvi syntax)
specify output directory (for all files)
--copy cp generic files rather than using symlinks
recreate files even if config hasn't changed
do not recreate map files
do not run texhash
show version information and exit
show the current setting of OPTION
show possible settings for OPTION
--setoption OPTION VALUE
set OPTION to value; option names below
as above, just different syntax
--enable MAPTYPE MAPFILE
add "MAPTYPE MAPFILE" to updmap.cfg, where MAPTYPE is Map,
MixedMap, or KanjiMap
add "Map MAPFILE" to updmap.cfg
--enable MixedMap=MAPFILE add "MixedMap MAPFILE" to updmap.cfg
--enable KanjiMap=MAPFILE add "KanjiMap MAPFILE" to updmap.cfg
disable MAPFILE, of whatever type
list all active and inactive maps
same as --listmaps, but without unavailable map files
disable unavailable map files in updmap.cfg
Explanation of the map types: the (only) difference between Map and
MixedMap is that MixedMap entries are not added to psfonts_pk.map. The
purpose is to help users with devices that render Type 1 outline fonts
worse than mode-tuned Type 1 bitmap fonts. So, MixedMap is used for
fonts that are available as both Type 1 and Metafont. KanjiMap entries
are added to psfonts_t1.map and kanjix.map.
Explanation of the OPTION names for --showoptions, --showoption,
true,false (default true)
Whether dvips uses bitmaps or outlines, when both are available.
Whether maps for pxdvi (Japanese-patched xdvi) are under
LW35 URWkb,URW,ADOBEkb,ADOBE (default URWkb)
Adapt the font and file names of the standard 35 PostScript
URWkb URW fonts with "berry" filenames (e.g. uhvbo8ac.pfb)
URW URW fonts with "vendor" filenames (e.g. n019064l.pfb)
Adobe fonts with "berry" filenames (e.g. phvbo8an.pfb)
ADOBE Adobe fonts with "vendor" filenames (e.g. hvnbo___.pfb)
These options are only read and acted on by updmap; dvips, pdf-
tex, etc., do not know anything about them. They work by chang-
ing the default map file which the programs read, so they can be
overridden by specifying command-line options or configuration
files to the programs, as explained at the beginning of
The options kanjiEmbed and kanjiVariant specify special replace-
ments in the map lines. If a map contains the string @kanjiEm-
bed@, then this will be replaced by the value of that option;
similarly for kanjiVariant. In this way, users of Japanese TeX
can select different fonts to be included in the final output.
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.
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 on Debian, the
following files are read, in the given order.
According to the actions, updmap might write to one of the given
files or create a new updmap.cfg, described further below.
Where changes are saved:
If config files are given on the command 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 kpse-
which 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 updmap.cfg), is 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.
In general, the idea is that if a given config file is not
writable, a higher-level one can be used. That way, the distri-
bution's settings can be overridden for system-wide using TEXM-
FLOCAL, and then system settings can be overridden again for a
particular using using TEXMFHOME.
Resolving multiple definitions of a font:
If a font is defined in more than one map file, then the defini-
tion coming from the first-listed updmap.cfg is used. If a font
is defined multiple times within the same map file, one is cho-
sen arbitrarily. In both cases a warning is issued.
updmap.cfg files with higher priority (listed earlier) can dis-
able maps mentioned in lower priority (listed later) updmap.cfg
files by writing, e.g.,
#! Map mapname.map
#! MixedMap mapname.map
in the higher-priority updmap.cfg file.
As an example, suppose you have a copy of MathTime Pro fonts and
want to disable the Belleek version of the fonts; that is, dis-
able the map belleek.map. You can create the file $TEXMFCON-
FIG/web2c/updmap.cfg with the content
between updmap-sys and updmap.
Other locations may be used if you give them on the command line, or
these trees don't exist, or you are not using the original TeX Live.
To see the precise locations of the various files that will be read and
written, give the -n option (or read the source).
For step-by-step instructions on making new fonts known to TeX, read
http://tug.org/fonts/fontinstall.html. For even more terse instruc-
tions, read the beginning of the main updmap.cfg.
Configuration and input files:
Main configuration file. In texmf-dist/web2c by default, but
may be located elsewhere depending on your distribution. Each
texmf tree read should have its own updmap.cfg.
Map file for standard 35 PostScript fonts for use with dvips(1).
Map file for standard 35 PostScript fonts for use with pdf-
Map file for standard 35 PostScript fonts for use with ps2pk(1).
For dvips(1). Same as psfonts_t1.map if option dvipsPreferOut-
line active, else as psfonts_pk.map.
For dvips(1). Without information from MixedMap files. (Set-
ting of dvipsPreferOutline ignored.)
For dvips(1). With information from MixedMap files. (Setting
of dvipsPreferOutline ignored.)
For dvips(1). Always downloads the standard 35 fonts. (Setting
of dvipsDownloadBase35 ignored.)
For dvips(1). Never downloads the standard 35 fonts. (Setting
of dvipsDownloadBase35 ignored.)
Configuration files for dvips(1):
Loads builtin35.map instead of psfonts.map.
Loads download35.map instead of psfonts.map.
Loads psfonts_t1.map instead of psfonts.map.
Loads psfonts_t1.map instead of psfonts.map and has additional
optimizations for PDF generation.
Loads psfonts_pk.map instead of psfonts.map.
Loads psfonts_t1.map instead of psfonts.map. (For compatibility
with old versions.)
Loads psfonts_t1.map instead of psfonts.map.
Report bugs to: firstname.lastname@example.org
TeX Live home page: <http://tug.org/texlive/>
TeX Live May 2014 UPDMAP(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2019
All Rights Reserved.