[nsd-users] nsd manpages

Joerg Sonnenberger joerg at britannica.bec.de
Wed Aug 26 20:45:01 UTC 2015


On Wed, Aug 26, 2015 at 04:59:52PM +0200, Jan Stary wrote:
> On Aug 25 18:19:35, tim at kariliq.nl wrote:
> > Jan Stary (2015-08-25 17:27 +0200):
> > > Currently, the NSD manpages are written in the legacy man(7) language.
> > > I propose to rewrite them into the markup of the mdoc(7) language.
> > > 
> > > Both languages are sets of roff macros, supported for decades
> > > by mostly groff (on linuxes) and mandoc (on the BSD's).
> > > The main difference is that mdoc(7) does _semantic_ markup,
> > > so the macros mean e.g. "this is a command line option"
> > > as opposed to e.g. "make it italics and put brackets around it".
> > > See http://mdocml.bsd.lv/ about the whole story.
> > 
> > The only disadvantage of mdoc, however, is that some systems still don't
> > support it. I believe Solaris is one of them. So, for portability, you'd
> > have to be able to provide man pages in both mdoc and man format.
> 
> mdoc is a language. To support it, you need a formatter.
> Both the standard formatters, groff and mandoc,
> are available on Solaris.

Not out of the box.

Joerg



More information about the nsd-users mailing list