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

Jamie Landeg-Jones jamie at catflap.org
Tue Jan 10 13:28:44 UTC 2023


Jan Stary <hans at stare.cz> wrote:

> On Jan 01 00:05:09, jamie at catflap.org wrote:
> > Jan Stary via nsd-users <nsd-users at lists.nlnetlabs.nl> wrote:
> > 
> > > 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.
> > 
> > I have no specific knowledge on this, but would just like to "me too"
> > to this thread that whatever format is used, it MUSTN'T impact on the
> > quality of any resultant man/mdoc conversion.
>
> What I am proposing is to _write_ the mdoc(7) manpages,
> not have them produced by some toolchain or another.

I know. And Paul suggested xml, and you replied that it's crap. Other people
were suggesting other tools. I was just adding to the conversation that if
some other route was taken, it WASN'T at the expense of the manpages.

> > </bikeshed>
>
> I am concerned that you consider the quality of documentation bikeshiding.

Don't be a prick. I was making a humourous remark regarding my contribution.
If I wasn't concerned about the quality of the documentation, I wouldn't
have made my reply (which you obviously were unable to read)


More information about the nsd-users mailing list