NAME

       updmap.cfg - configuration of font mapping/inclusion for dvips and friends.

DESCRIPTION

       The  file  updmap.cfg is the central font configuration file of a teTeX system and is read
       by updmap(1). It describes if and how fonts should be  included  (or  not  included)  into
       PS-/PDF-files.  This  works  for  Outline  (Postscript Type1) and Bitmap Fonts (Postscript
       Type3) mostly coming from MetaFont.

       updmap is a utility  that  creates  font  configuration  files  for  dvips(1),  pdftex(1),
       xdvi(1),  ps2pk(1),  gsftopk(1),  and  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 several
       sources,  namely  all  updmap.cfg,  allowing  you  to  easily  keep  all   the   different
       configuration files in sync.

       Running "updmap --help" will output the main documentation for using updmap.

       dvipsPreferOutline
       Configures  if  dvips (by default) should prefer bitmap fonts or outline fonts if both are
       available?  Independent  of  this  setting,  outlines  can  be  forced   by   putting   "p
       psfonts_t1.map"  into  a config file that dvips reads. Bitmaps can be forced by putting "p
       psfonts_pk.map" into a config file. We provide such config files which can be enabled  via
       dvips -Poutline (resp. dvips -Ppk).
       Valid settings for dvipsPreferOutline are true / false.

       LW35
       Which  fonts  of  the  "Basic  35  Laserwriter  Fonts"  do you want to use and how are the
       filenames chosen? Valid settings:
       URW:     URW fonts with "vendor" filenames (e.g. n019064l.pfb)
       URWkb:   URW fonts with "berry" filenames (e.g. uhvbo8ac.pfb)
       ADOBE:   Adobe fonts with "vendor" filenames (e.g. hvnbo___.pfb)
       ADOBEkb: Adobe fonts with  "berry" filenames (e.g. phvbo8an.pfb)

       dvipsDownloadBase35
       Configures if dvips (by default) should download the 35 base  PostScript  fonts  into  the
       document  (set  true) or should these fonts be used from the ps interpreter / printer (set
       false).
       The  user  can  override  the  default  by  specifying  dvips  -Pdownload35  (resp.  dvips
       -Pbuiltin35) to download the LW35 fonts (resp. use the built-in fonts).
       Valid settings are true / false.

       pdftexDownloadBase14
       Should  pdftex download the 14 base PDF fonts? Since some configurations (ps / pdf tools /
       printers) use bad default fonts, it is safer to download the  fonts.  The  pdf  files  get
       bigger, but that is the cost.
       Valid  settings  are  true (download the fonts) or false (don't download the fonts). Adobe
       recommends embedding all fonts.

       pxdviUse
       Should special map files for pxdvi be created? pxdvi is an adaption of xdvi  with  support
       for reading and displaying files generated by the ptex family of engines.
       Valid     settings     are     true     (generate    configuration)    or    false.    See
       http://www.tug.org/texlive/updmap-kanji.html for detailed discussion.

       kanjiEmbed
       kanjiVariant
       The options kanjiEmbed and kanjiVariant specify special replacements in the map lines.  In
       a  map,  the string "@kanjiEmbed@" will be replaced by the value of that option; similarly
       for kanjiVariant.  In this way, users of Japanese TeX can select  different  fonts  to  be
       included in the final output.

       Map
       Points  to  a map file, which describes a mapping from a font (called in the TeX document)
       to the pfb file containing the Postscript code.
       Usage: Map filename.map

       The syntax of map files is the same as dvips(1) uses, see the section "psfonts.map" in the
       manual of dvips(1).

       MixedMap
       Similar  to  Map. It should be used when there is Type1 and a bitmap implementation of the
       font (the latter mostly coming from MetaFont). These entries  will  not  be  used  in  the
       default map of dvips if dvipsPreferOutline is set to false.
       Usage: MixedMap filename.map

       KanjiMap
       Similar to Map. This should be used for kanji fonts.
       Usage: KanjiMap filename.map

       The sign # precedes a comment.

       Map  files  not to be used should be commented out using the string #! at the beginning of
       the line. Such entries can be (de-)activated using updmap with the  options  --enable  and
       --disable, respectively.

AUTHOR

       This  manual  page  was written by Hilmar Preusse <hille42@web.de> and extended by Norbert
       Preining <preining@logic.at>, for the  Debian  GNU/Linux  system  by  simply  copying  the
       comments from updmap.cfg and rewriting some of them. It may be used by other distributions
       without contacting the author. Any mistakes or omissions in the manual page are our fault;
       inquiries about or corrections to this manual page should be directed to tex-live@tug.org.

SEE ALSO

       updmap(1), dvips(1)

THANKS TO

       Frank Kuester, Thomas Esser.