1UPDMAP(1) User Commands UPDMAP(1)
2
6 updmap - manage TeX font maps, per-user
7 updmap-sys - manage TeX font maps, system-wide
8
10 updmap [OPTION] ... [COMMAND]
11 updmap-sys [OPTION] ... [COMMAND]
12
14 updmap version svn33988 (2014-05-12 15:39:32 +0900)
15 Update the default font map files used by pdftex, dvips, and
17 dvipdfm(x), and optionally pxdvi, as determined by all configuration
18 files updmap.cfg (the ones returned by running "kpsewhich --all
19 updmap.cfg", but see below).
20 Among other things, these map files are used to determine which fonts
22 should be used as bitmaps and which as outlines, and to determine which
23 font files are included in the PDF or PostScript output.
24 updmap-sys is intended to affect the system-wide configuration, while
26 updmap affects personal configuration files only, overriding the system
27 files. As a consequence, once updmap has been run, even a single time,
28 running updmap-sys no longer has any effect. (updmap-sys issues a
29 warning in this situation.)
30 By default, the TeX filename database (ls-R) is also updated.
32
34 --cnffile FILE
35 read FILE for the updmap configuration (can be given multiple
36 times, in which case all the files are used)
37 --dvipdfmxoutputdir DIR
39 specify output directory (dvipdfm(x) syntax)
40 --dvipsoutputdir DIR
42 specify output directory (dvips syntax)
43 --pdftexoutputdir DIR
45 specify output directory (pdftex syntax)
46 --pxdvioutputdir DIR
48 specify output directory (pxdvi syntax)
49 --outputdir DIR
51 specify output directory (for all files)
52 --copy cp generic files rather than using symlinks
54 --force
56 recreate files even if config hasn't changed
57 --nomkmap
59 do not recreate map files
60 --nohash
62 do not run texhash
63 --sys affect system-wide files (equivalent to updmap-sys)
65 -n, --dry-run
67 only show the configuration, no output
68 --quiet, --silent
70 reduce verbosity
71 Commands:
73 --help show this message and exit
74 --version
76 show version information and exit
77 --showoption OPTION
79 show the current setting of OPTION
80 --showoptions OPTION
82 show possible settings for OPTION
83 --setoption OPTION VALUE
85 set OPTION to value; option names below
86 --setoption OPTION=VALUE
88 as above, just different syntax
89 --enable MAPTYPE MAPFILE
91 add "MAPTYPE MAPFILE" to updmap.cfg, where MAPTYPE is Map,
92 MixedMap, or KanjiMap
93 --enable Map=MAPFILE
95 add "Map MAPFILE" to updmap.cfg
96 --enable MixedMap=MAPFILE add "MixedMap MAPFILE" to updmap.cfg
98 --enable KanjiMap=MAPFILE add "KanjiMap MAPFILE" to updmap.cfg
100 --disable MAPFILE
102 disable MAPFILE, of whatever type
103 --listmaps
105 list all active and inactive maps
106 --listavailablemaps
108 same as --listmaps, but without unavailable map files
109 --syncwithtrees
111 disable unavailable map files in updmap.cfg
112 Explanation of the map types: the (only) difference between Map and
114 MixedMap is that MixedMap entries are not added to psfonts_pk.map. The
115 purpose is to help users with devices that render Type 1 outline fonts
116 worse than mode-tuned Type 1 bitmap fonts. So, MixedMap is used for
117 fonts that are available as both Type 1 and Metafont. KanjiMap entries
118 are added to psfonts_t1.map and kanjix.map.
119 Explanation of the OPTION names for --showoptions, --showoption,
121 --setoption:
122 dvipsPreferOutline
124 true,false (default true)
125 Whether dvips uses bitmaps or outlines, when both are available.
127 dvipsDownloadBase35
129 true,false (default true)
130 Whether dvips includes the standard 35 PostScript fonts in its
132 output.
133 pdftexDownloadBase14
135 true,false (default true)
136 Whether pdftex includes the standard 14 PDF fonts in its output.
138 pxdviUse
140 true,false (default false)
141 Whether maps for pxdvi (Japanese-patched xdvi) are under
143 updmap's control.
144 kanjiEmbed
146 (any string)
147 kanjiVariant
149 (any string)
150 See below.
152 LW35 URWkb,URW,ADOBEkb,ADOBE (default URWkb)
154 Adapt the font and file names of the standard 35 PostScript
156 fonts.
157 URWkb URW fonts with "berry" filenames (e.g. uhvbo8ac.pfb)
159 URW URW fonts with "vendor" filenames (e.g. n019064l.pfb)
161 ADOBEkb
163 Adobe fonts with "berry" filenames (e.g. phvbo8an.pfb)
164 ADOBE Adobe fonts with "vendor" filenames (e.g. hvnbo___.pfb)
166 These options are only read and acted on by updmap; dvips, pdf‐
168 tex, etc., do not know anything about them. They work by chang‐
169 ing the default map file which the programs read, so they can be
170 overridden by specifying command-line options or configuration
171 files to the programs, as explained at the beginning of
172 updmap.cfg.
173 The options kanjiEmbed and kanjiVariant specify special replace‐
175 ments in the map lines. If a map contains the string @kanjiEm‐
176 bed@, then this will be replaced by the value of that option;
177 similarly for kanjiVariant. In this way, users of Japanese TeX
178 can select different fonts to be included in the final output.
179
181 Explanation of trees and files normally used:
182 If --cnffile is specified on the command line (possibly multiple
184 times), its value(s) are used. Otherwise, updmap reads all the
185 updmap.cfg files found by running `kpsewhich -all updmap.cfg',
186 in the order returned by kpsewhich.
187 In any case, if multiple updmap.cfg files are found, all the
189 maps mentioned in all the updmap.cfg files are merged.
190 Thus, if updmap.cfg files are present in all trees, and the
192 default layout is used as shipped with TeX Live, the following
193 files are read, in the given order.
194 For updmap-sys:
196 TEXMFSYSCONFIG $TEXLIVE/YYYY/texmf-config/web2c/updmap.cfg
197 TEXMFSYSVAR $TEXLIVE/YYYY/texmf-var/web2c/updmap.cfg
198 TEXMFLOCAL $TEXLIVE/texmf-local/web2c/updmap.cfg
199 TEXMFDIST $TEXLIVE/YYYY/texmf-dist/web2c/updmap.cfg
200 For updmap:
202 TEXMFCONFIG $HOME/.texliveYYYY/texmf-config/web2c/updmap.cfg
203 TEXMFVAR $HOME/.texliveYYYY/texmf-var/web2c/updmap.cfg
204 TEXMFHOME $HOME/texmf/web2c/updmap.cfg
205 TEXMFSYSCONFIG $TEXLIVE/YYYY/texmf-config/web2c/updmap.cfg
206 TEXMFSYSVAR $TEXLIVE/YYYY/texmf-var/web2c/updmap.cfg
207 TEXMFLOCAL $TEXLIVE/texmf-local/web2c/updmap.cfg
208 TEXMFDIST $TEXLIVE/YYYY/texmf-dist/web2c/updmap.cfg
209 (where YYYY is the TeX Live release version).
211 According to the actions, updmap might write to one of the given
213 files or create a new updmap.cfg, described further below.
214 Where changes are saved:
216 If config files are given on the command line, then the first
218 one given will be used to save any changes from --setoption,
219 --enable or --disable. If the config files are taken from kpse‐
220 which output, then the algorithm is more complex:
221 1) If $TEXMFCONFIG/web2c/updmap.cfg or
223 $TEXMFHOME/web2c/updmap.cfg appears in the list of used files,
224 then the one listed first by kpsewhich --all (equivalently, the
225 one returned by kpsewhich updmap.cfg), is used.
226 2) If neither of the above two are present and changes are made,
228 a new config file is created in $TEXMFCONFIG/web2c/updmap.cfg.
229 In general, the idea is that if a given config file is not
231 writable, a higher-level one can be used. That way, the distri‐
232 bution's settings can be overridden for system-wide using TEXM‐
233 FLOCAL, and then system settings can be overridden again for a
234 particular using using TEXMFHOME.
235 Resolving multiple definitions of a font:
237 If a font is defined in more than one map file, then the defini‐
239 tion coming from the first-listed updmap.cfg is used. If a font
240 is defined multiple times within the same map file, one is cho‐
241 sen arbitrarily. In both cases a warning is issued.
242 Disabling maps:
244 updmap.cfg files with higher priority (listed earlier) can dis‐
246 able maps mentioned in lower priority (listed later) updmap.cfg
247 files by writing, e.g.,
248 #! Map mapname.map
250 or
252 #! MixedMap mapname.map
254 in the higher-priority updmap.cfg file.
256 As an example, suppose you have a copy of MathTime Pro fonts and
258 want to disable the Belleek version of the fonts; that is, dis‐
259 able the map belleek.map. You can create the file $TEXMFCON‐
260 FIG/web2c/updmap.cfg with the content
261 #! Map belleek.map Map mt-plus.map Map mt-yy.map
263 and call updmap.
265 updmap writes the map files for dvips (psfonts.map) and pdftex (pdf‐
267 tex.map) to the TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/ directories.
268 The log file is written to TEXMFVAR/web2c/updmap.log.
270 When updmap-sys is run, TEXMFSYSCONFIG and TEXMFSYSVAR are used instead
272 of TEXMFCONFIG and TEXMFVAR, respectively. This is the only difference
273 between updmap-sys and updmap.
274 Other locations may be used if you give them on the command line, or
276 these trees don't exist, or you are not using the original TeX Live.
277 To see the precise locations of the various files that will be read and
279 written, give the -n option (or read the source).
280
282 For step-by-step instructions on making new fonts known to TeX, read
283 http://tug.org/fonts/fontinstall.html. For even more terse instruc‐
284 tions, read the beginning of the main updmap.cfg.
285
287 Configuration and input files:
288 updmap.cfg
290 Main configuration file. In texmf-dist/web2c by default, but
291 may be located elsewhere depending on your distribution. Each
292 texmf tree read should have its own updmap.cfg.
293 dvips35.map
295 Map file for standard 35 PostScript fonts for use with dvips(1).
296 pdftex35.map
298 Map file for standard 35 PostScript fonts for use with pdf‐
299 tex(1).
300 ps2pk35.map
302 Map file for standard 35 PostScript fonts for use with ps2pk(1).
303 Output files:
305 psfonts.map
307 For dvips(1). Same as psfonts_t1.map if option dvipsPreferOut‐
308 line active, else as psfonts_pk.map.
309 psfonts_pk.map
311 For dvips(1). Without information from MixedMap files. (Set‐
312 ting of dvipsPreferOutline ignored.)
313 psfonts_t1.map
315 For dvips(1). With information from MixedMap files. (Setting
316 of dvipsPreferOutline ignored.)
317 download35.map
319 For dvips(1). Always downloads the standard 35 fonts. (Setting
320 of dvipsDownloadBase35 ignored.)
321 builtin35.map
323 For dvips(1). Never downloads the standard 35 fonts. (Setting
324 of dvipsDownloadBase35 ignored.)
325 pdftex.map
327 For pdftex(1). Same as pdftex_dl14.map if option pdftexDown‐
328 loadBase14 active, else as pdftex_ndl14.map.
329 pdftex_dl14.map
331 For pdftex(1). Always downloads the standard 14 fonts.
332 pdftex_ndl14.map
334 For pdftex(1). Never downloads the standard 14 fonts.
335 ps2pk.map
337 Similar to psfonts.map file, but forces all fonts to be down‐
338 loaded, so this map file can be used with xdvi(1) and ps2pk(1).
339 Configuration files for dvips(1):
341 config.builtin35
343 Loads builtin35.map instead of psfonts.map.
344 config.download35
346 Loads download35.map instead of psfonts.map.
347 config.outline
349 Loads psfonts_t1.map instead of psfonts.map.
350 config.pdf
352 Loads psfonts_t1.map instead of psfonts.map and has additional
353 optimizations for PDF generation.
354 config.pk
356 Loads psfonts_pk.map instead of psfonts.map.
357 config.www
359 Loads psfonts_t1.map instead of psfonts.map. (For compatibility
360 with old versions.)
361 config.gstopk
363 Loads psfonts_t1.map instead of psfonts.map.
364
366 Report bugs to: tex-k@tug.org
367 TeX Live home page: <http://tug.org/texlive/>
368TeX Live May 2014 UPDMAP(1)