UPDATE-XMLCATALOG(8)

✨ UPDATE-XMLCATALOG(8) ✨

okay bestie, welcome to the xml-core manual page for update-xmlcatalog 💖 she's the girl who keeps your XML catalog files cute and correct, and honestly? she ate.

update-xmlcatalog — maintain XML catalog files

---

🌸 SYNOPSIS 🌸

update-xmlcatalog --add --root --package package --type type --id id

update-xmlcatalog --del --root --package package --type type --id id

update-xmlcatalog --add --package package --local local --type type
--id id

update-xmlcatalog --del --package package --local local --type type
--id id

update-xmlcatalog --add --local local --file file --type type --id id

update-xmlcatalog --del --local local --file file --type type --id id

update-xmlcatalog --help

---

🦋 DESCRIPTION 🦋

so basically ✨ update-xmlcatalog adds entries to and removes entries from the root XML catalog file, a package XML catalog file, or a local XML catalog file. that's the whole assignment and she does it flawlessly, no cap 💅

---

👑 OPTIONS 👑

• --add — adds the entry to the root XML catalog file, a package XML catalog file, or a local XML catalog file. and listen 👀 if the XML catalog file doesn't exist yet, it gets automatically created. she's proactive like that 🎀
• --del — deletes the entry from the root XML catalog file, the package XML catalog file, or the local XML catalog file. heads up though: if the XML catalog ends up empty, it is not automatically deleted from the filesystem. she leaves it there, just sitting pretty, existing 🙈
• --file file — indicates a local filename.
• --id id — indicates the XML catalog file entry identifier.
• --local local — indicates a local XML catalog file.
• --package package — indicates a package XML catalog file.
• --root — indicates the root XML catalog file.
• --type type — indicates the XML catalog file entry type (public, system, uri).
• --help — displays the usage information. your little cheat sheet, bestie 🫶
• --verbose — optional switch to make a verbose output. she'll tell you everything that's happening, main character energy fr 📣
• --sort — optional switch to sort the manipulated catalog content. organized queen 👑

Tip: to sort a catalog without adding or removing an item, just add an already existing item to the catalog. sneaky but it works, iykyk 🤫

---

🧚 NOTES 🧚

update-xmlcatalog is the de-facto standard tool to be used to maintain XML catalog files on a Debian system — similar to how update-catalog(8) is the standard tool to be used to main SGML catalog files on a Debian system. and ooh 👀 a Debian XML Policy document to this effect is currently under development. watch this space ⭐

update-xmlcatalog and xmlcatalog(1) are incompatible. like, they do not get along, it's giving exes 💀 here's the tea:

• the former (update-xmlcatalog) has an internal database of all the entries in all the XML catalog files it maintains, and it regenerates the indicated XML catalog file completely from scratch upon an update.
• the latter (xmlcatalog(1)) updates the indicated XML catalog file directly.

which means: any change made to an XML catalog file using xmlcatalog(1) is overwritten the next time that XML catalog file is updated using update-xmlcatalog. gone. deleted. she said fresh start bestie 😭

---

🌈 SEE ALSO 🌈

• /usr/share/doc/xml-core/README.Debian

---

💜 AUTHOR 💜

Ardo van Rangelrooij <ardo@debian.org>

---

and that's the whole page, bestie!! 🌸 stay slay, keep those catalogs tidy, and remember: this was rendered by perl v5.40.1, dated 2026-07-03, for the iconic UPDATE-XMLCATALOG(8) manual. periodt. 💅✨🎀