Re: future of PEAR

--- Stefan Neufeind <stefan@neufeind.net> wrote: > On 11 Nov 2003 at 20:53, Martin Jansen wrote: > > > On Tue Nov 11, 2003 at 08:2057PM +0100, Tobias Schlitt wrote: > > > Correct. It's a real torture to do docbook stuff, if you do not > > > handle that in everyday work. > > > > 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 > > Just a while ago I read an article in the German Linux Magazine about > editing docbook using OpenOffice. Wouldn't that be a point that could > be followed further? Like, writing a doc for everybody how to use > common and freely available tools like OpenOffice to write docs? So > wouldn't following the way of docbook be a good idea since it's a > settled standard for writing docs - although hard to do without > appropriate tools, agreed. IIRC the Docbook filter for OO was in beta, and even now you need to explicitely install it (I am using OO 1.1). I am not sure about taking the exact Docbook output from OO and integrating it in PEARDOC because there are some things like entity refs, ids, and such that will require manual editing. Hey, I have even generated docbook from Latex. It is not a big problem to generate the docs in Docbook, usually the problem is having the time to write the documentation in the first place. Paraphrasing an all saying: "All roads lead to Docbook". ===== -- 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