[nsd-users] nsd manpages

Michael A. Peters mpeters at domblogger.net
Wed Aug 26 15:35:26 UTC 2015



On 08/26/2015 06:41 AM, Ondřej Surý wrote:
*snip*
>
>> I find the xml more readable (it converts with 'xmlto man')
>
> Do you? Remind me to check for a crazy look in your eyes next time we
> meet :)
>
> Anyway I understand that mdoc might have more formatting options, but
> the question is whether they are really needed for nsd manpages and also
> whether the comfort of the authors have some priority over the tricks
> you can do with the format.
>
> JFTR for the rST you can also have something they call an "option list":
>
> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#option-lists
>
> which works nicely if you don't need an optional parameters to the
> options.
>
> Cheers,
>

I can't speak to man pages but XML is certainly more easy to program 
alternative interface because you can use the DOM interface or an XSLT 
to translate it.

So for something like putting man pages online, XML source to the man 
pages would probably be better than man2html.



More information about the nsd-users mailing list