Provided by: texlive-binaries_2009-11ubuntu2_amd64 bug

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.