TC2HTML(1)

📦
version 1.04 · 2 versions
, in debian bookworm, ubuntu noble

💖 TC2HTML — the tc2html(1) glow-up 💖

okay bestie, this is a General Commands Manual page and it's about tc2html, a lil program that turns troffcvt output into HTML. she's a converter, she's a postprocessor, she's lowkey the main character of your doc pipeline. let's get into it 🫶

✨ NAME ✨

tc2html — convert troffcvt output to Hypertext Markup Language

🌸 SYNTAX 🌸

tc2html [ options ] file ...  ]

(yes the stray bracket is literally in there, i didn't do that, i'm just the messenger 💀)

🦋 DESCRIPTION 🦋

so tc2html is a postprocessor for troffcvt, and what she does is convert troffcvt output into Hypertext Markup Language (HTML). no cap, that's the whole vibe. ✨

and like, usually you don't even call her directly?? she gets invoked by running the troffcvt front end troff2html. so she's giving backstage icon energy, doing the work while troff2html takes the credit. periodt. 💅

tc2html understands the following options:

  • -D — turn on debugging output. all the lil diagnostic messages, unlocked 🔍
  • -E — makes tc2html echo token information to stderr as tokens are read from troffcvt. basically she narrates what she's reading, live 🎙️
  • -T title — set a title for the document. super handy for docs that don't have any recognizable title of their own. but — and this is the important part — if the document does contain a title, this overrides it. so -T wins, always. 👑

🌈 SEE ALSO 🌈

go read those too bestie, they're the whole ecosystem 💜

👑 WHO-TO-BLAME 👑

Paul DuBois, dubois@primate.wisc.edu.

(if something's broken, that's the icon to blame 🫶)

💀 BUGS 💀

okay so here's the tea, and it's giving important caveat energy:

tc2html uses a set of special macros that tell troffcvt how to generate tc2html-specific output — output that indicates HTML structural elements. cute, right?

🚨 but those macros do not work in compatibility mode. fr fr. if you're in compatibility mode, they're just not gonna do the thing. no cap, no workaround listed, just... don't. 💀

and that's the page!! 🌸 it's a General Commands Manual entry, signed off with the classic TC2HTML(1) stamp at the bottom, so you know it's official 💖 slay, go convert some docs, ily bye ✨🎀🦋

📦 where this page comes from