Man Linux: Main Page and Category List

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.