updmap
Section: TeX Live (1)
Updated: August 2009
Index
Return to Main Contents
NAME
updmap - Update font map files for TeX output drivers.
updmap-sys - Update font map files for TeX output drivers system-wide.
SYNOPSIS
updmap [ OPTION ... ] [
COMMAND ... ]
updmap-sys [ OPTION ... ] [
COMMAND ... ]
DESCRIPTION
updmap is a utility that creates font configuration files for
dvips(1), pdftex(1), xdvi(1),
ps2pk(1), gsftopk(1), dvipdfm(1) and (soon) dvipdfmx(1).
In an ideal world, updmap would be unnecessary -- each of these
programs would read the same configuration file to learn what fonts
are available and how they should be treated. As things stand,
however, each of these tools has subtly different requirements and
thereby needs its own font configuration file. updmap creates
font configuration files for all of these programs from a single
source, allowing you to easily keep all the different configuration
files in sync.
updmap reads a configuration file, updmap.cfg(5) and,
depending on the options specified in that file and on the command
line, updmap will write generated map files to a directory of
your choosing (via one of the --*outputdir options), or automatically
determine where to place the files. In the latter case, it tries to
use the tree where the variable TEXMFVAR -- or TEXMFSYSVAR if called
as updmap-sys -- points to.
When used with the options --edit, --setoption,
--enable, --disable, or --syncwithtrees,
updmap will first write updmap.cfg(5) and regenerate the
map files only if this file has been changed. In Debian, updmap has
been adapted so that --enable and --disable do the "right
thing": change the configuration snippets in updmap.d instead,
call update-updmap(1) to regenerate updmap.cfg(5) and
regenerate the map files afterwards. There are some limitations,
though: updmap will regenerate the map files even if
updmap.cfg(5) has not been changed, and --edit and
--syncwithtrees cannot be used.
OPTIONS
The following command-line options are available:
-
- --cnffile file
-
Specify a configuration file.
-
- --dvipsoutputdir directory
-
Specify the output
directory for map files generated with dvips syntax.
-
- --pdftexoutputdir directory
-
Specify the output
directory for map files generated with pdftex syntax.
-
- --dvipdfmoutputdir directory
-
Specify the output
directory for map files generated with dvipdfm syntax.
-
- --outputdir directory
-
Specify the output
directory for all generated map files.
-
- --nohash
-
Do not run texhash(1).
-
- --nomkmap
-
Do not recreate existing map files.
-
- --quiet
-
Reduce verbosity.
-
The following commands can be substituted for COMMAND:
-
- --edit
-
Edit the updmap.cfg file.
-
- --help
-
Show a command and option summary.
-
- --showoptions item
-
Show alternatives for option
item.
-
- --setoption option value
-
Set
option to value, where option is one of:
-
dvipsPreferOutline
-
LW35
-
dvipsDownloadBase35
-
pdftexDownloadBase14
-
dvipdfmDownloadBase14
-
- --enable maptype mapfile
-
Permanently add or enable a Map or MixedMap for mapfile.
-
- --enable Map=mapfile
-
Permanently add or enable a Map for mapfile.
-
- --enable MixedMap=mapfile
-
Add or enable a MixedMap for mapfile.
-
- --disable mapfile
-
Disable Map or MixedMap for mapfile.
-
- --syncwithtrees
-
Disable entries in the config file that refer to map files which are
unavailable.
-
- --listmaps
-
List all active and inactive maps.
-
- --listavailablemaps
-
List all active and inactive maps, but restrict output to map files
that are available in one of the texmf trees.
FILES
Configuration and input files:
- updmap.cfg
-
Main configuration file. In
texmf/web2c by default, but may be located elsewhere
depending on your distribution. Note for Debian: On Debian
+ that file is generated out of files in /etc/texmf/updmap.d.
+ See update-updmap(8) or the TeX-on-Debian document.
-
- dvips35.map
-
Map file for standard 35 PostScript fonts for
use with dvips(1).
-
- pdftex35.map
-
Map file for standard 35 PostScript fonts for
use with pdftex(1).
-
- dvipdfm35.map
-
Map file for standard 35 PostScript fonts for
use with dvipdfm(1).
-
- ps2pk35.map
-
Map file for standard 35 PostScript fonts for
use with ps2pk(1).
-
Output files:
-
- psfonts.map
-
For dvips(1).
Soft link
against psfonts_t1.map if option dvipsPreferOutline active,
else against psfonts_pk.map.
-
- psfonts_pk.map
-
For dvips(1).
Without information from MixedMap files.
(Setting of dvipsPreferOutline ignored.)
-
- psfonts_t1.map
-
For dvips(1).
With information from MixedMap files.
(Setting of dvipsPreferOutline ignored.)
-
- download35.map
-
For dvips(1).
Always downloads the standard 35 fonts.
(Setting of dvipsDownloadBase35 ignored.)
-
- builtin35.map
-
For dvips(1).
Never downloads the standard 35 fonts.
(Setting of dvipsDownloadBase35 ignored.)
-
- pdftex.map
-
For pdftex(1).
Soft link
against pdftex_dl14.map if option pdftexDownloadBase14 active,
else against pdftex_ndl14.map.
-
- pdftex_dl14.map
-
For pdftex(1).
Always downloads the standard 14 fonts.
-
- pdftex_ndl14.map
-
For pdftex(1).
Never downloads the standard 14 fonts.
-
- dvipdfm.map
-
For dvipdfm(1).
Soft link
against dvipdfm_dl14.map if option dvipdfmDownloadBase14 active,
else against dvipdfm_ndl14.map.
- dvipdfm_dl14.map
-
For dvipdfm(1).
Always downloads the standard 14 fonts.
-
- dvipdfm_ndl14.map
-
For dvipdfm(1).
Never downloads the standard 14 fonts.
-
- ps2pk.map
-
Similar to psfonts.map file, but
forces all fonts to be downloaded, so this map file can be used with
xdvi(1) and ps2pk(1).
-
teTeX configuration files for dvips(1) tuned for use with updmap:
-
- config.builtin35
-
Loads builtin35.map instead
of psfonts.map.
-
- config.download35
-
Loads download35.map instead
of psfonts.map.
-
- config.outline
-
Loads psfonts_t1.map instead
of psfonts.map.
-
- config.pdf
-
Loads psfonts_t1.map instead
of psfonts.map and has additional optimizations for PDF generation.
-
- config.pk
-
Loads psfonts_pk.map instead
of psfonts.map.
-
- config.www
-
Loads psfonts_t1.map instead
of psfonts.map.
(For compatibility with previous versions of teTeX.)
-
- config.gstopk
-
Loads psfonts_t1.map instead
of psfonts.map.
-
SEE ALSO
updmap.cfg(5), update-updmap(8), dvipdfm(1), dvips(1),
gsftopk(1), pdftex(1), ps2pk(1),
texhash(1), xdvi(1).
Web page: <http://tug.org/teTeX/>
BUGS
None known, but report any bugs found to <tetex@dbs.uni-hannover.de> (mailing list).
AUTHOR
updmap was written by Thomas Esser
<te@dbs.uni-hannover.de> and is in the public domain.
This manual page was written by C.M. Connelly
<cmc@debian.org>, for
the Debian GNU/Linux system and later slightly adapted for teTeX 3.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- FILES
-
- SEE ALSO
-
- BUGS
-
- AUTHOR
-
© Andrew Scott 2006 -
2024,
All Rights Reserved