DEMANDOC(1)

📦
version 1.14.6 · 2 versions
  • 1.14.6 · alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.14.6 · debian bookworm, ubuntu jammy, ubuntu noble
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ DEMANDOC(1) ✨

ok so bestie, welcome to the demandoc page 💖 this is a General Commands Manual situation, and honestly? she's giving "quietly iconic utility." let's get into it 🎀

🌸 NAME 🌸

demandoc — emit only text of UNIX manuals

like. just the words. the vibes without the markup, yk? 💅

🦋 SYNOPSIS 🦋

demandoc [-w] [file ...]

that's it. that's the whole shape of her. short, sweet, slay ✨

💜 DESCRIPTION 💜

So the demandoc utility does one thing and does it beautifully: it emits only the text portions of well-formed mdoc(7) and man(7) Unix manual files. no macro noise, no escape drama, just text 🫶

By default, demandoc parses standard input and outputs only text nodes, preserving line and column position. Escape sequences are omitted from the output. periodt.

Its arguments are as follows:

  • -w — output a word list. This outputs each word of text on its own line. A "word", in this case, refers to whitespace-delimited terms beginning with at least two letters and not consisting of any escape sequences. Words have their leading and trailing punctuation (double-quotes, sentence punctuation, etc.) stripped. so like, she's doing the tidying for you 🧹✨
  • file ... — the input files.

If a document is not well-formed, it is skipped. no notes, no meltdown, she just moves on 💀

Also, a fun lil lore drop: the -i, -k, -m, and -p flags are silently discarded — they exist purely for calling compatibility with the historical deroff. so if you pass them, nothing happens. ghost flags. spectral. 👻

🔥 EXIT STATUS 🔥

The demandoc utility exits with one of the following values:

  • 0 — No errors occurred. bestie is thriving 🌈
  • 6 — An operating system error occurred, for example memory exhaustion or an error accessing input files. Such errors cause demandoc to exit at once, possibly in the middle of parsing or formatting a file. The output databases are corrupt and should be removed .
⚠️ okay that last one is not a vibe — corrupt output databases, remove them, no cap. if you see exit 6, it's giving chaos 😭

🍓 EXAMPLES 🍓

The traditional usage of demandoc is for spell-checking manuals on BSD. This is accomplished as follows (assuming British spelling):

$ demandoc -w file.1 | spell -b

look at that pipeline. main character energy fr fr 👑

⭐ SEE ALSO ⭐

🧚 HISTORY 🧚

demandoc replaces the historical deroff utility for handling modern man(7) and mdoc(7) documents. out with the old, in with the glow-up 💅✨

👑 AUTHORS 👑

The demandoc utility was written by Kristaps Dzonsons <kristaps@bsd.lv>. thank you king 🫶

and that's the page!! this lil beauty came to you from Debian, dated September 12, 2014 — yes she's vintage, yes she still ate 💖🎀🦋

okay bye bestie, go spell-check something ✨

📦 where this page comes from