INSTALL-CATALOG(8)

💖 INSTALL-CATALOG — the manual page, bestie edition 💖

okay so real talk: this is install-catalog, from section 8 of the manual (that's the sysadmin girlies section, iykyk). it manages a SGML or XML centralized catalog. that's the whole vibe. let's get into it 🦋

---

✨ SYNOPSIS ✨

install-catalog [ option ]  action  ... [  [ -d]  [ --delegate] ]  [  [
-a centralized ordinary]  [ --add centralized ordinary]

 [ -r centralized ordinary]  [ --remove centralized ordinary]

 [ -h]  [ --help]

 [ -v]  [ --version] ]

like, yes, the spacing is doing its own thing. we don't gatekeep the original formatting. 💅

---

🌸 DESCRIPTION 🌸

so this is a shell script, and what it does is handle a centralized catalog that references other, more "ordinary" SGML or XML Open Catalogs. two levels of catalog. very main character + supporting cast energy. 👑

An Open Catalog contains a set of directives defined by OASIS, and they're mostly used for defining equivalences between FPIs (Formal Public Identifiers) and real actual file names (peep TR9401:1997 on http://www.oasis-open.org <URL:http://www.oasis-open.org>). The Open Catalogs usually live in /usr/share/sgml. cozy little home. 🏠

A centralized catalog is a special Open Catalog that includes only comments and CATALOG directives pointing to other catalogs — or DELEGATE directives if that's supported. she's the connector, the social chair. The centralized catalog can literally be the key to all other SGML resources, no cap. It usually resides in /etc/sgml. 🔑

The centralized catalog can be edited manually or through the install-catalog script to add or remove references to other ordinary catalogs. This script is mainly destined to software package post-installation scripts. so like, automation bestie. it's giving "I run at 3am during a dpkg install and nobody thanks me". 😭

An example of a typical call to install-catalog is:

install-catalog --add \
  /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog \
  /etc/sgml/sgml-docbook-4.0.cat

This call will install in /etc/sgml/sgml-docbook-4.0.cat a reference to /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog. boom. linked. slay. ✨

---

🎀 OPTIONS 🎀

Here is the list of options that can influence the way install-catalog works:

• -d, --delegate — Use DELEGATE instead of CATALOG directives to specify a pointer. spicy variant. 🌶️

---

💅 ACTIONS 💅

Here is the list of actions that can be requested to install-catalog:

• -a centralized ordinary, --add centralized ordinary — Declare a new SGML package. new friend, welcome to the catalog 🫶
• -r centralized ordinary, --remove centralized ordinary — Remove a previously installed SGML package. it's not you it's the dependency graph 💔
• -h, --help — Print a short help message and exit. the classic. 🧚
• -v, --version — Print the version identifier and exit. who am i? ⭐

---

🌈 FILES 🌈

• /etc/sgml/* — The SGML centralized catalogs. the whole lil directory of them 💜

---

👑 AUTHORS 👑

• Eric Bischoff <ebisch@cybercable.tm.fr> — Developper of install-catalog.

(yes we're keeping "Developper" spelled exactly like that, bestie. the 2000s were a lawless time and we respect the original. 🕯️)

---

🦋 SEE ALSO 🦋

• jw(1) — conversion from DocBook to other file formats.
• nsgmls(1) — a base component of Jade DSSSL engine.
• http://sourceware.cygnus.com/docbook-tools/ <URL:http://sourceware.cygnus.com/docbook-tools/> — the home page of the DocBook tools, a compendium of all tools necessary to process DocBook files, including the SGML-common stuff.

---

vibe check passed: this page is from 04 August 2000, and it's INSTALL-CATALOG(8) all the way down. mwah, go install a catalog, you icon 💋🌸