[nsd-users] nsd manpages

Paul Wouters paul at nohats.ca
Wed Aug 26 13:33:59 UTC 2015

On Wed, 26 Aug 2015, Ondřej Surý wrote:

> I believe a better option would be to rewrite the man pages (and
> documentation) into sphinx-build + build manpages (and documentation) at
> the "make dist" step, so they are included in the final distribution
> tarball.
> The reStructuredText is much more readable (and editable) than man(7) or
> mdoc(7) format.

I agree that editing in roff/man is about as fun as writing sendmail.cf :)

> An example man page for kdig:
> https://gitlab.labs.nic.cz/labs/knot/raw/master/doc/man_kdig.rst

That looks much better. Although to add more options to this, I find
the xml more readable (it converts with 'xmlto man')



More information about the nsd-users mailing list