DTHELP_HTAG2(1)

🎀 NAME 🎀

dthelp_htag2 — second pass for parse of HelpTag source 💅

okay bestie, this is the dthelp_htag2(user cmd) manual page, and it's lowkey a behind-the-scenes icon.

---

✨ SYNOPSIS ✨

dthelp_htag2  - [cdhot]  [file]  [outfile]

---

💖 DESCRIPTION 💖

The dthelp_htag2 executable is invoked by dthelptag(1) as the second pass of translating HelpTag markup into SDL. It literally accepts the output of the first pass of dthelptag — either dthelp_htag1(1) or dthelp_ctag1(1) — and computes the byte offsets of virtual pages to be used in the runtime display of the SDL volume. main character energy, no cap 🫶

File handling tea, because this part matters:

• If only one file is specified on the command line, the output file will overwrite the input file. 😭
• If two files are specified, the output will be placed in the second.
• If the input file has no .sdl extension, one will be added.
• If a second file name is specified for output, it will be used without modification. periodt.

bestie, the one-file mode overwrites the input file — so maybe don't yolo it unless you mean to 💀

The options to dthelp_ctag2 are:

• -c — compress the SDL document on a per virtual page basis — if the document is already compressed, this command will result in no change to the document. 🗜️
• -d — decompress an SDL document — if the document is already compressed, this command will result in no change to the document; however, the byte offsets of virtual pages will be recomputed. 😭✨
• -h — print a help message and exit. 🫶
• -o — perform peephole optimization of the SDL document. In particular, &<FORM> elements containing only a single &<BLOCK> or &<FORM> without a user supplied identifier are replaced by that single &<BLOCK> or &<FORM> with the identifier of the original (outer) &<FORM>. 👑
• -t — eliminate any &<TOSS> sub-elements that are not used in this SDL document. 🧚

---

🦋 SEE ALSO 🦋

go peek at dthelptag(1), dthelp_htag1(1), dthelp_ctag1(1), and dtsdldtd(4) — iykyk 🌈

---

that's the whole page, bestie — source/version/date tea is just the dthelp_htag2(user cmd) manual tag at the bottom, so here's your cute sign-off instead: mwah 💋✨