updmap(1)

1updmap(1)                            teTeX                           updmap(1)
2
3
4

NAME

6       updmap - Update font map files for TeX output drivers.
7
8       updmap-sys - Update font map files for TeX output drivers system-wide.
9

SYNOPSIS

11       updmap [ OPTION ... ]  [ COMMAND  ... ]
12
13       updmap-sys [ OPTION ... ]  [ COMMAND  ... ]
14

DESCRIPTION

16       updmap is a utility that creates font configuration files for dvips(1),
17       pdftex(1),  xdvi(1),  ps2pk(1),  gsftopk(1),  dvipdfm(1)   and   (soon)
18       dvipdfmx(1).  In an ideal world, updmap would be unnecessary -- each of
19       these programs would read the same configuration  file  to  learn  what
20       fonts  are  available and how they should be treated.  As things stand,
21       however, each of these tools  has  subtly  different  requirements  and
22       thereby  needs  its  own  font configuration file.  updmap creates font
23       configuration files for all of these programs  from  a  single  source,
24       allowing  you  to  easily keep all the different configuration files in
25       sync.
26
27       updmap reads a configuration file, updmap.cfg(5) and, depending on  the
28       options  specified  in  that  file and on the command line, updmap will
29       write generated map files to a directory of your choosing (via  one  of
30       the  --*outputdir  options),  or automatically determine where to place
31       the files.  In the latter case, it tries to  use  the  tree  where  the
32       variable  TEXMFVAR  points  to.   When  used  with  the options --edit,
33       --setoption, --enable, --disable, or --syncwithtrees, updmap will first
34       write  updmap.cfg(5) and regenerate the map files only if this file has
35       been changed.
36

OPTIONS

38       The following command-line options are available:
39
40       --cnffile file
41              Specify a configuration file.
42
43       --dvipsoutputdir directory
44              Specify the output directory for map files generated with  dvips
45              syntax.
46
47       --pdftexoutputdir directory
48              Specify the output directory for map files generated with pdftex
49              syntax.
50
51       --dvipdfmoutputdir directory
52              Specify the  output  directory  for  map  files  generated  with
53              dvipdfm syntax.
54
55       --outputdir directory
56              Specify the output directory for all generated map files.
57
58       --nohash
59              Do not run texhash(1).
60
61       --nomkmap
62              Do not recreate existing map files.
63
64       --quiet
65              Reduce verbosity.
66
67       The following commands can be substituted for COMMAND:
68
69       --edit Edit the updmap.cfg file.
70
71       --help Show a command and option summary.
72
73       --showoptions item
74              Show alternatives for option item.
75
76       --setoption option value
77              Set option to value, where option is one of:
78
79              dvipsPreferOutline
80
81              LW35
82
83              dvipsDownloadBase35
84
85              pdftexDownloadBase14
86
87              dvipdfmDownloadBase14
88
89       --enable maptype mapfile
90              Add or enable a Map or MixedMap for mapfile.
91
92       --enable Map=mapfile
93              Add or enable a Map for mapfile.
94
95       --enable MixedMap=mapfile
96              Add or enable a MixedMap for mapfile.
97
98       --disable mapfile
99              Disable Map or MixedMap for mapfile.
100
101       --syncwithtrees
102              Disable entries in the config file that refer to map files which
103              are unavailable.
104
105       --listmaps
106              List all active and inactive maps.
107
108       --listavailablemaps
109              List all active and inactive maps, but restrict  output  to  map
110              files that are available in one of the texmf trees.
111

FILES

113       Configuration and input files:
114
115       updmap.cfg
116              Main  configuration file.  In texmf/web2c by default, but may be
117              located elsewhere depending on your distribution.
118
119       dvips35.map
120              Map file for standard 35 PostScript fonts for use with dvips(1).
121
122       pdftex35.map
123              Map file for standard 35 PostScript  fonts  for  use  with  pdf‐
124              tex(1).
125
126       dvipdfm35.map
127              Map   file  for  standard  35  PostScript  fonts  for  use  with
128              dvipdfm(1).
129
130       ps2pk35.map
131              Map file for standard 35 PostScript fonts for use with ps2pk(1).
132
133       Output files:
134
135       psfonts.map
136              For dvips(1).  Soft link against psfonts_t1.map if option  dvip‐
137              sPreferOutline active, else against psfonts_pk.map.
138
139       psfonts_pk.map
140              For  dvips(1).   Without information from MixedMap files.  (Set‐
141              ting of dvipsPreferOutline ignored.)
142
143       psfonts_t1.map
144              For dvips(1).  With information from MixedMap  files.   (Setting
145              of dvipsPreferOutline ignored.)
146
147       download35.map
148              For dvips(1).  Always downloads the standard 35 fonts.  (Setting
149              of dvipsDownloadBase35 ignored.)
150
151       builtin35.map
152              For dvips(1).  Never downloads the standard 35 fonts.   (Setting
153              of dvipsDownloadBase35 ignored.)
154
155       pdftex.map
156              For pdftex(1).  Soft link against pdftex_dl14.map if option pdf‐
157              texDownloadBase14 active, else against pdftex_ndl14.map.
158
159       pdftex_dl14.map
160              For pdftex(1).  Always downloads the standard 14 fonts.
161
162       pdftex_ndl14.map
163              For pdftex(1).  Never downloads the standard 14 fonts.
164
165       dvipdfm.map
166              For dvipdfm(1).  Soft link against  dvipdfm_dl14.map  if  option
167              dvipdfmDownloadBase14 active, else against dvipdfm_ndl14.map.
168
169       dvipdfm_dl14.map
170              For dvipdfm(1).  Always downloads the standard 14 fonts.
171
172       dvipdfm_ndl14.map
173              For dvipdfm(1).  Never downloads the standard 14 fonts.
174
175       ps2pk.map
176              Similar  to  psfonts.map  file, but forces all fonts to be down‐
177              loaded, so this map file can be used with xdvi(1) and ps2pk(1).
178
179       teTeX configuration files for dvips(1) tuned for use with updmap:
180
181       config.builtin35
182              Loads buildin35.map instead of psfonts.map.
183
184       config.download35
185              Loads download35.map instead of psfonts.map.
186
187       config.outline
188              Loads psfonts_t1.map instead of psfonts.map.
189
190       config.pdf
191              Loads psfonts_t1.map instead of psfonts.map and  has  additional
192              optimizations for PDF generation.
193
194       config.pk
195              Loads psfonts_pk.map instead of psfonts.map.
196
197       config.www
198              Loads psfonts_t1.map instead of psfonts.map.  (For compatibility
199              with previous versions of teTeX.)
200
201       config.gstopk
202              Loads psfonts_t1.map instead of psfonts.map.
203

BUGS

211       None  known,  but  report any bugs found to <tetex@dbs.uni-hannover.de>
212       (mailing list).
213

AUTHOR

215       updmap was written by Thomas Esser <te@dbs.uni-hannover.de> and  is  in
216       the public domain.
217
218       This manual page was written by C.M. Connelly <cmc@debian.org>, for the
219       Debian GNU/Linux system and later slightly adapted for teTeX 3.
220
221
222
223teTeX                            February 2005                       updmap(1)