Re: portable code to generate man pages?

[William Brawner <me%wbrawner.com@localhost>]

I think scdoc fits the requirements: <https://git.sr.ht/~sircmpwn/scdoc>

I haven't used it to write man pages myself but I've compiled software that relies on it and it's pretty simple.

Cheers,
William Brawner

PS sorry for the double email Greg, forgot to use reply all 

El 23 de julio de 2026 4:56:22 p.m. GMT-06:00, Greg Troxel <gdt%lexort.com@localhost> escribió:
>I am part of bup upstream, which has manpage source in markdown.  The
>build uses pandoc to convert to mandoc, and also to html.
>
>That would be fine if pandoc were written in a language that had a
>reasonable implementation, but it's the usual Haskell compiler written
>in Haskell with a complicated bootstrap story, with the result that on
>NetBSD it works on amd64 and aarch64 only.  Not even i386!
>
>I would like to hear people's recommendation for a tool that can:
>
>  - process easy-to-write text file to mandoc and html
>    + preference for markdown
>  - does not require anything nonportable
>    (accepting that python doesn't work on vax)
>  - is incrementally lightweight, in a build that already requires
>    python
>
>asciidoctor pulling in ruby is unappealing.
>
>A lot of people use sphinx.   I see hints that it can create man pages.
>Has anyone written or maintained man pages in sphinx, and how did that
>go?
>
>  https://www.sphinx-doc.org/en/master/man/sphinx-build.html
>  https://www.sphinx-doc.org/en/master/usage/builders/index.html
>