[nsd-users] nsd manpages

[Paul Wouters]

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')

example:
https://github.com/libreswan/libreswan/blob/master/programs/pluto/ipsec_pluto.8.xml

Paul