[nsd-users] rewrite manpages to mdoc(7)

Jan Stary hans at stare.cz
Sat Dec 31 18:45:43 UTC 2022


On Dec 31 11:43:56, paul at nohats.ca wrote:
> Why not go to xml and use xml2man / pandoc ?

Because it is a terrible manpage format
and the toolchain produces broken crap.

> xml is easier to write and read than man/mdoc.

That's entirely a matter of opinion.
Which is easier to write, read, understand and maintain?
Which has less outside dependencies and produces better output?

(1)

.Sh NAME
.Nm nsd-checkzone
.Nd check NSD zone file syntax

(2)

<names>
<name>nsd-checkzone-conf<desc> checks DNS file syntax</desc></name>
</names>

Jan



More information about the nsd-users mailing list