Re: future of PEAR
| From: | Martin Jansen | Date: | Tue, 11 Nov 2003 20:19:35 +0000 |
| Subject: | Re: future of PEAR | ||
| References: | 1 2 3 4 5 6 7 8 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-23464@lists.php.net to get a copy of this message | ||
On Tue Nov 11, 2003 at 09:1103PM +0100, Tobias Schlitt wrote:
> On Tue, 2003-11-11 at 20:53, 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
>
> This looks and sounds pretty cool! Maybe it's not so hard to generate
> docbook from that automatically (I did not dig to deep into the
> syntax).
Docbook can be generated automagically. But the XML that comes out of
reST can't be merged into peardoc *directly*. Instead some preprocessing
is required.
--
- Martin Martin Jansen
http://martinjansen.com/