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), 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,
updmap.cfg, allowing you to easily keep all the different configuration
files in sync.
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)
dvipsDownloadBase
Configures if dvips (by default) should download the standard 35
LaserWriter 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
built-in fonts.
Valid settings are true / false.
pdftexDownloadBase14
Should pdftex download the base 14 pdf fonts? Since some configurations
(ps / pdf tools / printers) use bad default fonts, it is safer to
download the fonts. The pdf files will get bigger, though.
Valid settings are true (download the fonts) or false (don’t download
the fonts). Adobe recommends to embed all fonts.
dvipdfmDownloadBase14
Should dvipdfm download the base 14 pdf fonts? Since some
configurations (ps / pdf tools / printers) use bad default fonts, it is
safer to download the fonts. The pdf files will get bigger, though.
Valid settings are true (download the fonts) or false (don’t download
the fonts).
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 section 6.4,
"’psfonts.map’: PostScript font catalog" in the manual of dvips(1),
available as info and pdf file.
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
The sign # precedes a comment.
Not used Map files should be commented out using the string #! at the
beginning of the line. These entries can be (de-)activated using updmap
with the options --enable and --disable.
SPECIAL TO DEBIAN
In Debian the file updmap.cfg is a generated file sitting in /var. It
is generated by concatenating the *.cfg files from
/etc/texmf/updmap.d/. These files follow the syntax of updmap.cfg, but
contain only parts of it.
AUTHOR
This manual page was written by Hilmar Preusse <hille42@web.de>, 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 my fault; inquiries about or corrections to this
manual page should be directed to me (and not to the primary author).
SEE ALSO
updmap(1), info page of dvips(1)
THANKS TO
Frank Kuester, Thomas Esser.