Re: Step-by-step introduction to PearDoc

From: Date: Thu, 15 Apr 2004 01:02:51 +0000
Subject: Re: Step-by-step introduction to PearDoc
References: 1 2 3 4 5 6 7 8  Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-3469@lists.php.net to get a copy of this message
Daniel Convissor wrote:
Hi Alexander: On Wed, Apr 14, 2004 at 08:18:14PM +0200, Alexander Wirtz wrote:
the automated generating of an APIdoc with PHPDocumentor. Here a proper template is needed to fit into the PearDoc DocBook-style. And this generating of XML isn't including everything needed to fit into PearDoc at the moment
Okay. As you know, the phpDocumentor / PEAR DocBook templates are there -- in the phpDoumentor distribution and CVS repository. They need fixing. How about fixing them? Make the changes then perform "cvs diff -u" against them and then submit those patches to Greg. Thanks, --Dan
I'd like to point out that the documentation for PEAR_PackageFileManager has been automatically generated using phpDocumentor for several months now, and it works out of the box. If you've found problems, it may be that you're trying to fit a round peg into a square hole. I would recommend translating all FUD into requests for support at www.sf.net/projects/phpdocu where we won't bother all the PEAR peoples. If you find a real, actual bug, then it can be fixed. As Dan says here, I respond much better to "I followed the steps, here is my command-line, the incorrect output was XXXXX[, this patch fixes it]" than to "it doesn't work at all, what a waste of time, stupid phpDocumentor *hiss* *boo*" Greg

« previous php.pear.doc (#3469) next »