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
signature.asc
Description: PGP signature
