pod2mdoc, docbook2mdoc

[Kristaps Dzonsons <kristaps@bsd.lv>]

Hiya folks,

Long story short: any Perl POD or DocBook people out there?

In recent chatter on groff's mailing list, there's been talk about 
manpages.  For reasons (maybe) clear to anybody reading these, I thought 
I'd write some tools that might help people start putting their weight 
behind mdoc.

To wit,

  http://mdocml.bsd.lv/pod2mdoc
  http://mdocml.bsd.lv/docbook2mdoc

The second requires libexpat (for the XML parsing), but beyond that, 
they're both standalone utilities.  No Perl.  No weird... XSLT... 
jade... whatever things.

I've little time these days, so I thought maybe somebody would be 
interested in delving into these utilities and seeing how they stack up 
against the real world.  There's a lot of meat to both.

pod2mdoc does a decent job given the many POD manuals out there, but 
could use more "semantic suck".  (E.g., pod2man is able to "recognise" 
functions--that'd be swell for us, too.  The SYNOPSIS is a horror, too.)

docbook2mdoc is a larger project just because docbook has so many 
elements.  So mechanically larger, not larger in terms of brains.  It 
also needs a bit of "doclifter desucking", as many docbook manuals I've 
seen are from doclifter, which mangles some things (e.g., Xr).

Anybody interested?  Bueller?  Bueller?

Best,

Kristaps
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv