On Sun 15 Oct 2023 17:33:07 +0200, Iustin Pop wrote:
> At least you're not lazy. I am, so what I did many times is add a
> build-depends on pandoc, and write the man page in rst or md. I think
> that's a worse solution (pandoc is really heavy), but at least, I don't
> have to go back to *roff.
FWIW, there are lighter alternatives than pandoc:
pandoc: After this operation, 174 MB of additional disk space will be used.
sphinx-doc (sphinx-build -b man): After this operation, 140 MB of additional disk space will be used.
rst2man (python3-docutils): After this operation, 37.6 MB of additional disk space will be used.
pod2man (perl): perl is already the newest version (5.36.0-9).
I'm not going to bother measuring docbook ;-)
If you are writing manpages by hand, this is an excellent overview:
https://manpages.debian.org/bookworm/manpages/man.7.en.html
See also:
https://www.oreilly.com/library/view/mastering-perl/9780596527242/ch15.html (POD)
https://www.docutils.org/docs/user/manpage.html#todo-open-issues
Attachment:
signature.asc
Description: PGP signature