updmap.cfg (5)

Leading comments

Hey, Emacs!  This is an  source file.

Copyright (C) 2004, 2012 Hilmar Preusse <hille42@web.de>
Copyright (C) 2012 Norbert Preining <preining@logic.at>

This is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.

This is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHAN...

(The comments found at the beginning of the groff file "man5/updmap.cfg.5".)

NAME

updmap.cfg - font mapping/inclusion configuration 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 output. This works for outline (PostScript Type1) and bitmap (PostScript Type3, mostly coming from MetaFont) fonts.

updmap is a utility that creates font configuration files used by 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, these tools have subtly different requirements and thereby several font configuration files are needed. 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.cfg. 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 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 character # begins a comment, except that map files to be disabled can 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.

SEE ALSO

updmap(1), dvipdfmx (1), dvips(1), pdftex(1).

THANKS

Frank Kuester, Thomas Esser.

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 authors. It is maintained as part of TeX Live: <tug.org/texlive>.