Provided by: texlive-binaries_2009-11ubuntu2_i386 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.