SGML2TXT(1)

📦
version 0.9.86 · 6 versions
, in arch rolling, debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 SGML2TXT — the manual page, bestie edition 💖

okay so this is sgml2txt from the General Commands Manual section (section 1, the classic), and we're gonna go through the whole thing together. grab a strawberry 🍓

✨ NAME ✨

sgml2txt — create plain text output from a LinuxDoc DTD SGML source file 🦋

🌸 SYNOPSIS 🌸

sgml2txt [generic-option...] [--manpage] [--filter] [--blanks=n]
file[.sgml]

💅 DESCRIPTION 💅

okay so sgml2txt is, and I need you to sit down for this, an old and obsoleted form of the text converter command from LinuxDoc-Tools. like, it's the grandma of the command. and the name is lowkey misleading — it is not a tool for any SGML DTD, it only supports the SGML LinuxDoc DTD. no cap.

the glow-up is available though: it is recommended to switch the new form linuxdoc -B text now. periodt. ✨

what it does: it converts a LinuxDoc DTD SGML source file to ASCII, ISO-8859-1, or EUC-JP output. and the output will appear in file.txt where file is the name of the SGML source file. it's giving "here's your text file, you're welcome" 🎀

also, the attribute/value pair "output=txt" is set for conditionals. iykyk.

✨ OPTIONS ✨

sgml2txt accepts all the generic options described in linuxdoc(1), plus these specific ones, bestie 👑

  • --manpage, -m — outputs a groff source file, suitable for formatting with groff -man for man pages. so meta, so iconic 🫶
  • --filter, -f — removes backspace-overstrikes from the intermediate form generated by groff(1). bye bye ugly artifacts 💀
  • --pass, -P — the argument of the pass option is added to the command-line options handed to groff(1). it's giving "hand it off, i trust you" 💅
  • --blanks=n, -b — set the limit of continuous blank lines for generating the output document. the default limit is 3. if 0 (zero) is specified, the result have many continuous blank lines. so like… choose your chaos 🔥
  • file — the SGML source file, named either file or file.sgml 🦋

🎀 FILES 🎀

many files and executables in /usr/share/linuxdoc-tools are used. yes, MANY. they're all chilling in there 🌈

💀 BUGS 💀

None known.

that's it. that's the whole section. she's flawless, apparently. not me being suspicious but okay 👑✨

🌟 AUTHOR 🌟

  • Originally written by Greg Hankins <greg.hankins@cc.gatech.edu>, based on scripts by Tom Gordon and Alexander Horz 🫶
  • and later rewritten by Cees de Groot <cg@cdegroot.com> for SGML-Tools (v1) 💜
  • previously maintained by Taketoshi Sano <sano@debian.org> for Linuxdoc-Tools 🎀
  • currently maintained by Agustin Martin <agustin6martin AT gmail com> ⭐

legends, all of them. the way that this command has a whole lineage 😭💖

🌈 SEE ALSO 🌈

linuxdoc(1), sgml2html(1), sgml2info(1), sgml2latex(1), sgml2lyx(1), sgml2rtf(1), sgmlcheck(1) — the whole friend group, go say hi 💅✨

ok that's the whole page, no skips, no summaries, every single detail accounted for. you're so welcome 🫶

and that's a wrap on this lil page — this version is dated 2025-04-06, and it's the SGML2TXT(1) page from the General Commands Manual. slay, bye bestie! 💖✨🎀🦋🌸

📦 where this page comes from