Re: reStructuredText

On Thu, 2003-06-12 at 14:03, Martin Jansen wrote: > On Wed Jun 11, 2003 at 02:2140PM -0700, Joshua Eichorn wrote: > > Martin Jansen wrote: > > >In which format will this external documentation be written? Is it > > >interchangeable, so that we can easily export it to Docbook, PDF or > > >HTML? > > > > > > > The format for the external documentation is docbook, with the ability > > to use the same tags as you would in your source. > > Using Docbook will result in the same situation as we have now: The > "normal" developer does not want to learn Docbook and thus we need to > provide him something easier. That's where reST comes into play. Maybe this situation will improve soon. If anyone's attending the phpdoc meeting at linux-tag in Karlsruhe, you'll see what I mean (ie using our browserbased XML Wysiwig Editor (http://bitfluxeditor.org, demo is Mozilla only) At the moment, the Bitflux Editor is not that advanced to be used with full blown docbook as phpdoc is, but we are currently developing a much improved version, so please don't judge about the demo and come to LinuxTag ;) chregu