UPDATE-UPDMAP(8)

✨ NAME ✨

Okay bestie, so this page is all about update-updmap(8) 💖 (System Manager's Manual, section 8). It's the tool that generates updmap.cfg files for all the system trees 🌸

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

🎀 SYNOPSIS 🎀

update-updmap [option ...]

💅 DESCRIPTION 💅

Okay so this manual page documents update-updmap, a program that was written for the Debian distribution. It's giving very specific Debian energy 🍓

🧚 Overview 🧚

update-updmap is used to generate the configuration files for updmap(1) and updmap-sys(8). It makes two of them: /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 🦋

It builds these from the files ending in .cfg that live in /var/lib/tex-common/fontmap-cfg/texlive/ and /var/lib/tex-common/fontmap-cfg/texmf/, respectively ✨

Any TeX package that ships 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 matching lines for the updmap.cfg file. Main character energy, fr 👑

If you want to configure stuff (enable extra entries, disable system-provided entries, and so on), you use the normal updmap(1) mechanism. Check out the updmap(1) man page for the details 🫶

🌈 OPTIONS 🌈

• --check — Ngl, this one's a whole vibe check 😭 It runs extra checks that all the necessary files are present in the kpathsea database. Don't use this in maintainer scripts 💀
• --quiet — Shh, it keeps update-updmap from writing anything to standard output during normal operation 🙈
• --help — Prints a summary of the command-line usage of update-updmap, then exits 🎀
• --version — Outputs version information, then exits 🌸

Heads up: the -v option, which turns on verbose mode, is deprecated 💀 We're in a transition phase right now. Quiet mode is still the default (so --quiet has no effect), but update-updmap will switch to being verbose by default as soon as enough packages use --quiet in their maintainer scripts. Iykyk 🫠

🦋 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'll be lines in 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. That way it won't get declared in the default map file for Dvips that's 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. So zero means we slayed, anything positive means something went sideways 💀

🔥 SEE ALSO 🔥

• updmap(1)

Also go read these docs, they're literally the tea:

• /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. Others are welcome to use it too 🫶💖

---

Bestie, that's the whole page 🎀 Debian, July 17, 2013, UPDATE-UPDMAP(8) — served, no notes 💅✨