NOWEB(1)

📦 version 2.13, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

👑 NOWEB(1) — the noweb manual, section 1, general commands, bestie 💖

okay so real talk, this is the page for noroff, one of the lil shell scripts that ships with noweb. it's giving "small but mighty" ✨ and we're gonna go through it top to bottom, no skips, no cap.

✨ NAME ✨

noroff — format woven troff documentation 🎀

like, that's the whole job description. it formats. it's troff. it's woven. slay.

🌸 SYNOPSIS 🌸

noroff [ groff options ] files ...

so you hand it some groff options, and then some files ..., and it goes to work. periodt.

💅 DESCRIPTION 💅

Noroff formats documents that have been woven with noweave -troff. that's the whole vibe — if your doc didn't come out of noweave -troff, this isn't the girl for you, bestie.

here's the way it works, and it's lowkey elegant:

  • it passes on any options (flags) straight to groff(1) — like, it does not gatekeep your flags, it forwards them 💌
  • and it treats any remaining non-option arguments as files to be processed. so everything that isn't a flag? that's a file. yes queen.

and the reason those groff options matter so much? because they let you easily invoke the gpic, gtbl, and/or geqn preprocessors. so you get your pictures, your tables, and your equations, all without breaking a sweat 🦋

and if you supply no options at all? ngl bestie it's got you — it defaults to using the -mm macros, with PostScript output. no setup, no drama, just vibes and .ps files ✨

💀 BUGS 💀

okay so, transparency moment 🙈:

the shell script is probably still not as robust as it needs to be.

that's it. that's the whole bug report. it's a mood, honestly. so like, be gentle with it, and don't be shocked if it wobbles 😭

🌈 SEE ALSO 🌈

go read your sisters, they're all iconic 👑

and also, for the lore girlies 📖:

  • Converting noweb markup to troff markup in the file src/shell/roff.nw in the noweb distribution.

like, that's where the actual markup conversion tea lives. iykyk 🍓

⭐ VERSION ⭐

this man page is from noweb version 2.12. old but gold, fr fr 💜

🫶 AUTHOR 🫶

and the origin story, because every icon has one 💖:

  • Noroff was written by Phil Bewig for SoftQuad troff, and then enhanced and ported to GNU troff by Arnold Robbins. legends supporting legends, we love to see it 👑

k that's the whole page bestie!! mwah 💋 it's from the local source, dated 10/40/2008, and yeah the date is 10/40/2008 and no i will not be explaining the 40th of october, that's just what it says, take it up with the footer 😭 anyway go weave something cute, NOWEB(1), bye!! 🌸✨🎀

📦 where this page comes from