Re: future of PEAR

The docbook generated is almost compliant w/ what we need in PEARDOC in terms of the structure of the files. It has some bugs (just contacted the maintainer of the docutils docbook writer a couple of days ago) that are being fixed (like generating some extranous entities in the output). I looked at the code for the RST -> DocBook and it can be modified to generate something we need in PEARDOC directly, after all RST can be represented in an XML-like intermediate fashion. I can see using RST for tutorials and other docs that won't be generated automagically from the inline code documentation. --- Jon Parise <jon@php.net> wrote: > On Tue, Nov 11, 2003 at 08:53:01PM +0100, Martin Jansen wrote: > > > I do not want to promise too much, so please don't take it at face > > value yet. Anyway: The PEAR Group is currently evaluating reST [1] as an > > alternative to Docbook. This will help developers to more easily write > > documentation. > > > > The remaining thing that needs to be figured out, is a smart way to > > integrate the reST markup into peardoc's XML structure. > > > > [1] http://docutils.sf.net/rst.html > > You can see examples of Docutils-generated package documentation here: > > http://www.indelible.org/pear/Log/ > > I have Docbook XML output, as well, if anyone is interested in > integrating it with peardoc. > > -- > Jon Parise (jon@php.net) :: The PHP Project (http://www.php.net/) > > -- > PEAR Development Mailing List (http://pear.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > ===== -- Jesus M. Castagnetto (jcastagnetto@yahoo.com) Research: http://metallo.scripps.edu/ Personal: http://www.castagnetto.org/ PEAR stuff: http://pear.php.net/user/jmcastagnetto __________________________________ Do you Yahoo!? Protect your identity with Yahoo! Mail AddressGuard http://antispam.yahoo.com/whatsnewfree