OSGMLNORM(1)

🌸 NAME 🌸

osgmlnorm — bestie, it's literally an SGML/XML document normalizer 💖

---

✨ SYNOPSIS ✨

osgmlnorm [-CdeghmnrRvx] [-alinktype] [-Aarchitecture] [-bbctf]
          [-ccatalog] [-Ddirectory...] [-Emax_errors...] [-iname...]
          [-fname...] [-wwarning...] [sysid...]

---

🦋 DESCRIPTION 🦋

okay so the whole vibe of osgmlnorm is: it prints on standard output a normalized document instance for the SGML document contained in the concatenation of the entities with system identifiers. that's it, that's the job, no cap 💅

the way that this actually matters: when the normalized instance is prefixed with the original SGML declaration and prolog, it will have the same ESIS as the original SGML document — except for these lil guys right here:

• the output of osgmlnorm does not protect against the recognition of short reference delimiters, so any USEMAP declarations must be removed from the DTD. yes really, go delete them 🚨
• the normalized instance will use the reference delimiters, even if the original instance did not.
• if marked sections are included in the output using the -m option, the reference reserved names will be used for the status keywords even if the original instance did not.
• any ESIS information relating to the SGML LINK feature will be lost 😭

also, the normalized instance will not use any markup minimization features, except that:

• any attributes that were not specified in the original instance will not be included in the normalized instance. (current attributes will be included.)
• if the declared value of an attribute was a name token group, and a value was specified that was the same as the name of the attribute, then the attribute name and value indicator will be omitted. for example, with HTML osgmlnorm would output <DL COMPACT> rather than <DL COMPACT="COMPACT"> — slay, it's giving minimalism ✨

part of an SGML System Conforming to International Standard ISO 8879 — Standard Generalized Markup Language. an SGML Extended Facilities system conforming to Annex A of International Standard ISO/IEC 10744 — Hypermedia/Time-based Structuring Language. (yes queen, we're standards-compliant AND cute 💖)

the following options are available:

---

👑 OPTIONS 👑

• -aname, --activate=name — make doctype or linktype name active 🔥
• -Aarchitecture, --architecture=architecture — parse with respect to architecture architecture.
• -bbctf, --bctf=bctf — use the BCTF with name bctf for output.
• -csysid, --catalog=sysid — map public identifiers and entity names to system identifiers using the catalog entry file whose system identifier is sysid.
• -C, --catalogs — this has the same effect as in onsgmls(1).
• -d, --dtd — output a document type declaration with the same external identifier as the input document, and with no internal declaration subset. > ngl, no check is performed that the document instance is valid with respect to this DTD. it's just vibes, bestie, don't come for me 💀
• -Ddirectory, --directory=directory — search directory for files specified in system identifiers. this has the same effect as in onsgmls(1).
• -e, --open-entities — describe open entities in error messages.
• --error-numbers — show error numbers in error messages.
• -g, --open-elements — show the generic identifiers of open elements in error messages.
• -h, --help — display a help text and exit. (our fave, honestly 🫶)
• -iname, --include=name — this has the same effect as in onsgmls(1).
• -m, --marked-sections — output any marked sections that were in the input document instance.
• -n, --comments — output any comments that were in the input document instance.
• -r, --raw — raw output. don't perform any conversion on RSs and REs when printing the entity. the entity would typically have the storage manager attribute records=asis.
• -R, --restricted — this has the same effect as in onsgmls(1).
• -v, --version — print the version number.
• -wtype — control warnings and errors according to type. this has the same effect as in onsgmls(1).

---

🌈 SEE ALSO 🌈

• onsgmls(1)
• ospam(1)
• ospent(1)
• osx(1)

---

🎀 AUTHORS 🎀

• James Clark — Author. 👑
• Ian Castle <ian.castle@openjade.org> — Author. 💖

---

💜 COPYRIGHT 💜

bestie, this page is brought to you by OpenJade, dated January 2002 — and the manual it lives in is OSGMLNORM(1) from the Reference manual. ty for coming to my ted talk, go normalize something iconic 💅✨🦋