man page generator (was: plans for 0.0.6 release)

[Michael Ellerman]

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.

cheers

[1] http://docutils.sourceforge.net/
[2] http://docutils.sourceforge.net/docs/user/rst/quickstart.html


-- 
Michael Ellerman
IBM OzLabs

email: michael:ellerman.id.au
inmsg: mpe:jabber.org
wwweb: http://michael.ellerman.id.au
phone: +61 2 6212 1183 (tie line 70 21183)

We do not inherit the earth from our ancestors,
we borrow it from our children. - S.M.A.R.T Person
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20050607/55fea22a/attachment.pgp