UPDATE-CATALOG(8)

✨ UPDATE-CATALOG(8) ✨

💖 NAME

update-catalog — create or update entry in SGML catalog file 🎀

🦋 SYNOPSIS

update-catalog [options] --add centralized_catalog ordinary_catalog

update-catalog [options] --remove centralized_catalog ordinary_catalog

update-catalog [options] --update-super

🌸 DESCRIPTION

okay so update-catalog is literally the bestie for SGML catalogs 💅 it inserts, updates or removes entries in the SGML centralized catalogs living in /etc/sgml. 🧚

wanna change the SGML super catalog at /etc/sgml/catalog? you can't just edit it directly (more on that below 🙈). instead, drop new files or symbolic links with a .cat extension into /etc/sgml, or remove (or move) existing centralized catalogs, and then regenerate the super catalog with the --update-super option. the whole generation process is explained in the SUPER CATALOG section, so go check that out too ✨

👑 OPTIONS

• --add — adds an entry for the ordinary_catalog in the centralized_catalog 💖
• --remove — removes the entry for the ordinary_catalog from the centralized_catalog 🫶
• --update-super — regenerates the SGML super catalog from whatever is in /etc/sgml. see SUPER CATALOG for the deets 🔥
• --quiet — shhh, prevents the usual diagnostic output 🙈
• --test — prevents the catalog from actually being updated, and instead writes the resulting SGML catalog to standard output 👀
• --version — displays the version information and exits 🌈
• --help — displays the usage information and exits 💜

🧚 SUPER CATALOG

the super catalog at /etc/sgml/catalog cannot be directly modified 😭 it gets generated by update-catalog --update-super, so don't even try to hand-edit it.

okay so the generation considers files in /etc/sgml that have a .cat extension. files ending in .old or .disabled are NOT considered, so they're giving invisible 👻 before a catalog gets added to the super catalog, it's parsed and verified so nothing gets corrupted 🫶 all referenced catalogs are verified to actually exist too. if the check fails, a message is printed and the whole complete catalog is ignored 💀

this check is lowkey genius because it ensures a catalog from a package that was removed but not purged gets removed from the super catalog as well. iconic behavior 🦋

🎀 AUTHOR

Ardo van Rangelrooij <ardo@debian.org> 💅

🌈 COPYRIGHT

Copyright © 2001-2004 Ardo van Rangelrooij Copyright © 2012 Helmut Grohne

this is free software; see the GNU General Public Licence version 2 or later for copying conditions. there is no warranty. 🔥

okay bestie that's the whole page, sourced from Debian Project, June 2004, UPDATE-CATALOG(8) 💖✨ slay forever 💅🌸