<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
                          "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % entities.ent SYSTEM "entities.ent">
%entities.ent;
]>

<refentry id="updmap.cfg">

<?dbhh topicname="MIKTEXHELP_UPDMAP_CFG" topicid="0"?>

<refmeta>
<refentrytitle>updmap.cfg</refentrytitle>
<manvolnum>5</manvolnum>
<refmiscinfo class="source">&PACKAGE_NAME;</refmiscinfo>
<refmiscinfo class="version">&miktexrev;</refmiscinfo>
<refmiscinfo class="manual">File Formats</refmiscinfo>
</refmeta>

<refnamediv>
<refname>updmap.cfg</refname>
<refpurpose>configuration Settings for outline fonts</refpurpose>
</refnamediv>

<refsect1>

<title>Description</title>

<para>The configuration file <filename>updmap.cfg</filename> contains
declarative instructions, which will be used to build font map
files.</para>

<caution><para>Do not edit this file directly.  Run
<userinput>initexmf --edit-config-file updmap</userinput> to edit
configuration settings for outline fonts.</para></caution>

</refsect1>

<refsect1>

<title>Instructions</title>

<indexterm>
<primary>updmap.cfg</primary>
</indexterm>

<para><filename>updmap.cfg</filename> can contain the following
<indexterm>
<primary>updmap.cfg</primary>
<secondary>instructions</secondary>
</indexterm>
instructions:</para>

<variablelist>
<varlistentry>
<term><option>dvipsPreferOutline <replaceable>value</replaceable></option></term>
<listitem><para>Specifies whether &Dvips; prefers
<indexterm>
<primary>updmap.cfg</primary>
<secondary>dvipsPreferOutline</secondary>
</indexterm>
bitmap fonts or outline fonts if both are available.  Valid values are
<constant>true</constant> (default) and
<constant>false</constant>.</para>
<para>
Independend of this setting, outlines can be forced by putting
<programlisting>p psfonts_t1.map</programlisting> into a configuration
file that &Dvips; reads.  Bitmaps (for the fonts in question) can be
forced by putting <programlisting>p psfonts_pk.map</programlisting>
into a configuration file.  Such configuration files are provided,
which can be enabled via
<programlisting>dvips -Poutline ...</programlisting>
resp.
<programlisting>dvips -Ppk ...</programlisting></para></listitem>
</varlistentry>
<varlistentry>
<term><option>LW35 <replaceable>value</replaceable></option></term>
<listitem><para>Specifies which fonts for the <quote>Basic
35 LaserWriter Fonts</quote>
<indexterm>
<primary>updmap.cfg</primary>
<secondary>LW35</secondary>
</indexterm>
will be used and how their file names are chosen.  Valid
values:</para>
<variablelist>
<varlistentry>
<term><constant>URW</constant></term>
<listitem><para>&URW; fonts with <quote>vendor</quote> file names
<indexterm>
<primary>URW fonts</primary>
</indexterm>
<indexterm>
<primary>updmap.cfg</primary>
<secondary>LW35</secondary>
<tertiary>URW</tertiary>
</indexterm>
(e.g., <filename>n019064l.pfb</filename>).</para></listitem>
</varlistentry>
<varlistentry>
<term><constant>URWkb</constant></term>
<listitem><para>&URW; fonts with <quote>berry</quote> file names
<indexterm>
<primary>updmap.cfg</primary>
<secondary>LW35</secondary>
<tertiary>URWkb</tertiary>
</indexterm>
(e.g., <filename>uhvbo8ac.pfb</filename>).
<constant>URWkb</constant> is the default value.</para></listitem>
</varlistentry>
<varlistentry>
<term><constant>ADOBE</constant></term>
<listitem><para>Adobe fonts with <quote>vendor</quote> file names
<indexterm>
<primary>ADOBE fonts</primary>
</indexterm>
<indexterm>
<primary>updmap.cfg</primary>
<secondary>LW35</secondary>
<tertiary>ADOBE</tertiary>
</indexterm>
(e.g. <filename>hvnbo___.pfb</filename>).</para></listitem>
</varlistentry>
<varlistentry>
<term><constant>ADOBEkb</constant></term>
<listitem><para>Adobe fonts with <quote>berry</quote> file names
<indexterm>
<primary>updmap.cfg</primary>
<secondary>LW35</secondary>
<tertiary>ADOBEkb</tertiary>
</indexterm>
(e.g., <filename>phvbo8an.pfb</filename>).</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><option>dvipsDownloadBase35 <replaceable>value</replaceable></option></term>
<listitem><para>Specifies whether &Dvips;
<indexterm>
<primary>updmap.cfg</primary>
<secondary>dvipsDownloadBase35</secondary>
</indexterm>
downloads the standard 35 LaserWriter fonts with the document.  If
these fonts are not downloaded, then they must be available in the
&PostScript; printer (interpreter).  Valid values are
<constant>true</constant> and <constant>false</constant>
(default).</para>
<para>Whatever is specified here, the user can
override it by specifying
<programlisting>dvips -Pdownload35 ...</programlisting>
resp.
<programlisting>dvips -Pbuiltin35 ...</programlisting>
to either download the &LW35; fonts resp. use the build-in fonts.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>pdftexDownloadBase14 <replaceable>value</replaceable></option></term>
<listitem><para>Specifies whether &pdfTeX; downloads the base 14
<indexterm>
<primary>updmap.cfg</primary>
<secondary>pdftexDownloadBase14</secondary>
</indexterm>
&PDF; fonts.  Valid values are
<constant>true</constant> (default) and <constant>false</constant>.</para>
<para>Since some configurations (PostScript /
&PDF; tools / printers) use bad default fonts,
it is safer to download the fonts. The &PDF; files will
get bigger, though.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>dvipdfmDownloadBase14 <replaceable>value</replaceable></option></term>
<listitem><para>Specifies whether &Dvipdfm; downloads
<indexterm>
<primary>updmap.cfg</primary>
<secondary>dvipdfmDownloadBase14</secondary>
</indexterm>
the base 14 &PDF; fonts.  Valid values are <constant>true</constant>
(default) and <constant>false</constant>.</para> <para>Since some
configurations (PostScript / &PDF; tools / printers) use bad default
fonts, it is safer to download the fonts. The &PDF; files will get
bigger, though.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>Map <replaceable>filename</replaceable></option></term>
<listitem><para>Arranges that the contents of
<indexterm>
<primary>updmap.cfg</primary>
<secondary>Map</secondary>
</indexterm>
<replaceable>filename</replaceable>
will be included in <filename>psfonts.map</filename>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>MixedMap <replaceable>filename</replaceable></option></term>
<listitem><para>Arranges that the contents of <replaceable>filename</replaceable>
<indexterm>
<primary>updmap.cfg</primary>
<secondary>MixedMap</secondary>
</indexterm>
will be included in <filename>psfonts.map</filename>, unless
<constant>dvipsPreferOutline</constant> is set to
<constant>false</constant>.</para> <para><quote>Mixed</quote> means
that the fonts referenced in the file are available as bitmap and as
outline.</para></listitem>
</varlistentry>
</variablelist>

</refsect1>

</refentry>
