man page generator (was: plans for 0.0.6 release)

[Martin Pool]

On  7 Jun 2005, Michael Ellerman <michael at ellerman.id.au> wrote:
> On Tue, 7 Jun 2005 17:54, Hans Ulrich Niedermann wrote:
> > Martin Pool <mbp at sourcefrog.net> writes:
> > > On  1 Jun 2005, Hans Ulrich Niedermann <arch at n-dimensional.de> wrote:
> > >> I have written a script which autogenerates an (admittedly basic) man
> > >> page from the output of "bzr help".
> > > ...
> > >
> > >  - also generate HTML
> >
> > Before we start doing anything else but creating a simple, we will
> > want to evaluate existing python doc tools to avoid reimplementing
> > stuff.
> 
> There is a Python package called docutils [1] that turns Restructured text [2] 
> into html/xml/latex. http://docutils.sourceforge.net/
> 
> You could write an XSLT stylesheet to transform the XML into a format man can 
> cope with.

Maybe it's just me, but I'd rather write Python than XSLT.

Using docutils to produce HTML would make sense; perhaps we could even
write a rest-to-man translator.

-- 
Martin