Re: Step-by-step introduction to PearDoc
| From: | Greg Beaver | 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: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*" Gregthe 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 momentOkay. 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