Re: PEAR Documentation?

Sterling Hughes schrieb: > > That is a project I have here at Pentap (modifying PHPDoc to output Docbook > XML), however, all I can really say is that I'm working on it, I don't have That's not really a hard job for someone who know XSL in detail. Take the generated XML files and transform them into DocBook. Make sure to use Version 4.12. Prior version don't have any notation for OO language elements as far as I know. And PEAR is OO no matter wheter Pentab Sources are OO or not... Please do not change the XML document generation itself. A change might lead us to different PHPDoc distributions. As long as lots of people use PHP 3, I will keep PHP 3 compatiblity. This means the template renderer will survive for a long time. Reading DocBook XML is much harder than reading the internal XML format. DocBook as an internal format would make it unneccessarily complicated and I do not appreceate DocBook as the internal format. > I think perhaps we should be a little reluctant to document the PEAR classes > in the online manual itself. Perhaps build another repository for PEAR > documentation (with a note that PEAR code is distributed with PHP at the > moment). Then link to this repository in the online manual... That's the way we have to go on the long run. But only very few PEAR elements are already worth to get documented. The primary focus should be a big clean-up and coordination of all the PEAR stuff. The bad thing is that knowbody has the time to do so. Ulf -- Ulf Wendel, NetUSE AG Siemenswall, D-24107 Kiel Tel: +49 431 386 436 00, Fax: +49 431 386 435 99