NAME

     update-updmap — generate updmap.cfg files for all the system trees

SYNOPSIS

     update-updmap [option ...]

DESCRIPTION

     This manual page documents update-updmap, a program that was written for the Debian
     distribution.

   Overview
     update-updmap is used to generate updmap(1)'s and updmap-sys(8)'s configurations files
     /var/lib/texmf/updmap.cfg-TEXLIVEDIST, which is the link target of
     /usr/share/texlive/texmf-dist/web2c/updmap.cfg, and /var/lib/texmf/updmap.cfg-DEBIAN which
     is the link target of /usr/share/texmf/web2c/updmap.cfg, from the files with names ending in
     ‘.cfg’ located in /var/lib/tex-common/fontmap-cfg/texlive/ and
     /var/lib/tex-common/fontmap-cfg/texmf/, respectively.

     Any TeX package shipping map files in one of the trees /usr/share/texlive/texmf-dist or
     /usr/share/texmf should also provide files in one of the above directories containing the
     respective lines for updmap.cfg file.

     In order to configure (enable additional entries, disable system provided entries, etc), the
     normal updmap(1)mechanism should be used. Please see the man page details.

OPTIONS

     --check    Executes additional checks that all necessary files are present in the kpathsea
                database. Don't use this in maintainer scripts.

     --quiet    don't write anything to the standard output during normal operation

     --help     print a summary of the command-line usage of update-updmap and exit

     --version  output version information and exit

     Note that the -v option, which turns on verbose mode, is deprecated.  We are currently in a
     transition phase where quiet mode is still the default (therefore, --quiet has no effect),
     but update-updmap will be verbose by default as soon as enough packages use --quiet in their
     maintainer scripts.

SYNTAX FOR THE .CFG FILES

     The ‘.cfg’ files under /var/lib/tex-common/fontmap-cfg/ should contain valid configuration
     lines for updmap(1).  Usually, they will consist of lines of following one of these forms:

           Map <foo.map>
           MixedMap <bar.map>
           KanjiMap <baz.map>

     The MixedMap form should only be used if the font is available in both bitmap and scalable
     formats (this way, it won't be declared in the default map file for Dvips that is used when
     dvipsPreferOutline is set to ‘false’ in updmap.cfg).

     The KanjiMap form should only be used for map files defining Japanese font maps.

FILES

     /var/lib/tex-common/fontmap-cfg/texlive/*.cfg
     /var/lib/tex-common/fontmap-cfg/texmf/*.cfg
     /var/lib/texmf/updmap.cfg-TEXLIVEDIST
     /var/lib/texmf/updmap.cfg-DEBIAN

DIAGNOSTICS

     update-updmap returns 0 on success, or a strictly positive integer on error.

SEE ALSO

     updmap(1)

     /usr/share/doc/tex-common/README.Debian.{txt,pdf,html}
     /usr/share/doc/tex-common/Debian-TeX-Policy.{txt,pdf,html}
     /usr/share/doc/tex-common/TeX-on-Debian.{txt,pdf,html}

AUTHORS

     This manual page was written by Atsuhito Kohda <kohda@debian.org> and updated by Florent
     Rougon <f.rougon@free.fr> and Frank Kuester <frank@debian.org> for the Debian distribution
     (and may be used by others).