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

Jan Stary hans at stare.cz
Tue Jan 10 14:06:55 UTC 2023


On Jan 10 13:28:44, jamie at catflap.org wrote:
> 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.

Perhaps what confused me was the sheer nonsequiturity of that.
Yes, we don't want to make the manpages worse. In fact, that's
what lies in the very core of my proposal to make them better.
Thank you.

It's a moot point anyway: it's not gonna happen.


More information about the nsd-users mailing list