1UPDMAP.CFG(5)                                                    UPDMAP.CFG(5)
2
3
4

NAME

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

DESCRIPTION

10       The file updmap.cfg is the central font configuration  file  of  a  TeX
11       system  and  is read by updmap(1). It describes if and how fonts should
12       be included (or not included) into PS-/PDF-files. This works  for  Out‐
13       line (Postscript Type1) and Bitmap Fonts (Postscript Type3) mostly com‐
14       ing from MetaFont.
15
16       updmap is a utility that creates font configuration files for dvips(1),
17       pdftex(1),   xdvi(1),   ps2pk(1),  gsftopk(1),  dvipdfm(1)  and  (soon)
18       dvipdfmx(1).  In an ideal world, updmap would be unnecessary -- each of
19       these  programs  would  read  the same configuration file to learn what
20       fonts are available and how they should be treated.  As  things  stand,
21       however,  each  of  these  tools  has subtly different requirements and
22       thereby needs its own font configuration  file.   updmap  creates  font
23       configuration  files  for  all  of these programs from a single source,
24       updmap.cfg, allowing you to easily keep all the different configuration
25       files in sync.
26
27       dvipsPreferOutline
28       Configures  if dvips (by default) should prefer bitmap fonts or outline
29       fonts if both are available? Independent of this setting, outlines  can
30       be  forced  by putting "p psfonts_t1.map" into a config file that dvips
31       reads. Bitmaps can be forced by putting "p psfonts_pk.map" into a  con‐
32       fig  file.  We provide such config files which can be enabled via dvips
33       -Poutline ... resp. dvips -Ppk ...
34       Valid settings for dvipsPreferOutline are true / false.
35
36       LW35
37       Which fonts of the "Basic 35 Laserwriter Fonts" do you want to use  and
38       how are the filenames chosen? Valid settings:
39       URW:     URW fonts with "vendor" filenames (e.g. n019064l.pfb)
40       URWkb:   URW fonts with "berry" filenames (e.g. uhvbo8ac.pfb)
41       ADOBE:   Adobe fonts with "vendor" filenames (e.g. hvnbo___.pfb)
42       ADOBEkb: Adobe fonts with  "berry" filenames (e.g. phvbo8an.pfb)
43
44       dvipsDownloadBase
45       Configures if dvips (by default) should download the standard 35 Laser‐
46       Writer fonts into the document (set true) or should these fonts be used
47       from the ps interpreter / printer (set false).
48       The  user  can  override  the  default by specifying dvips -Pdownload35
49       built-in fonts.
50       Valid settings are true / false.
51
52       pdftexDownloadBase14
53       Should pdftex download the base 14 pdf fonts? Since some configurations
54       (ps / pdf tools / printers) use bad default fonts, it is safer to down‐
55       load the fonts. The pdf files will get bigger, though.
56       Valid settings are true (download the fonts) or false  (don't  download
57       the fonts). Adobe recomments to embed all fonts.
58
59       dvipdfmDownloadBase14
60       Should  dvipdfm  download  the base 14 pdf fonts? Since some configura‐
61       tions (ps / pdf tools / printers) use bad default fonts, it is safer to
62       download the fonts. The pdf files will get bigger, though.
63       Valid  settings  are true (download the fonts) or false (don't download
64       the fonts).
65
66       Map
67       Points to a map file, which describes a mapping from a font (called  in
68       the TeX document) to the pfb file containing the Postscript code.
69       Usage: Map filename.map
70
71       The  syntax of map files is the same as dvips(1) uses, see section 6.4,
72       "'psfonts.map': PostScript font catalog" in  the  manual  of  dvips(1),
73       available as info and pdf file.
74
75       MixedMap
76       Similar  to  Map.  It  should  be used when there is Type1 and a bitmap
77       implementation of the font (the latter mostly  coming  from  MetaFont).
78       These  entries  will  not  be used in the default map of dvips if dvip‐
79       sPreferOutline is set to false.
80       Usage: MixedMap filename.map
81
82       The sign # precedes a comment.
83
84       Not used Map files should be commented out using the string #!  at  the
85       beginning  of the line. These entries can be (de-)activaed using updmap
86       with the options --enable and --disable.
87

SPECIAL TO DEBIAN

89       In Debian the file updmap.cfg is a generated file sitting in  /var.  It
90       is    generated    by    concatenating    the    *.cfg    files    from
91       /etc/texmf/updmap.d/. These files follow the syntax of updmap.cfg,  but
92       contain only parts of it.
93

AUTHOR

95       This  manual  page  was written by Hilmar Preusse <hille42@web.de>, for
96       the Debian  GNU/Linux  system  by  simply  copying  the  comments  from
97       updmap.cfg  and rewriting some of them. It may be used by other distri‐
98       butions without contacting the author. Any mistakes or omissions in the
99       manual page are my fault; inquiries about or corrections to this manual
100       page should be directed to me (and not to the primary author).
101

SEE ALSO

103       updmap(1), info page of dvips(1)
104

THANKS TO

106       Frank Kuester, Thomas Esser.
107
108
109
110Debian/GNU Linux                  AUGUST 2005                    UPDMAP.CFG(5)
Impressum