Man page format to Docbook XML for New Authors

Tommy Reynolds Tommy.Reynolds at MegaCoder.com
Wed Apr 20 14:28:07 UTC 2005


Uttered "Gavin Henry" <ghenry at suretecsystems.com>, spake thus:

> We used Eric Raymonds Doclifter, which as you can see by the above results
> it's very good:
> 
> http://www.catb.org/~esr/doclifter/
> 
> Man page format is easy to write.

FTIW, I've been toying with the idea of using groff and friends to solve
the PDF generation problem since groff outputs PostScript and we have
utilities to bang that into PDF format, however there seems to be
some aversion to using custom XSLT stylesheets.  

Can most folks get by without WYSIWYG editor capability?  Us old
geezers still think in 1-part-paper-green stripe printouts, but the
I-am-not-a-developer contributor probably needs more patronizing, I
mean "friendly", tools.  Maybe a small DTD for an HTML-like subset;
there are stylesheets out there already to transform HTML into XSL-FO
but we'd need to keep anybody from being really clever and to keep it
simple.

Anybody have a sense of the zeitgeist about this?

Cheers
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20050420/a293a174/attachment.sig>


More information about the fedora-docs-list mailing list