Re: Re: pear/PHPDoc status

From: Date: Sun, 15 Jul 2001 19:52:52 +0000
Subject: Re: Re: pear/PHPDoc status
References: 1 2 3 4  Groups: php.pear.general 
Request: Send a blank email to pear-general+get-198@lists.php.net to get a copy of this message
Well i've speken to Ulf about it, but its been awhile, last time we talked, he was no longer developing on his code. The problem is our code bases are to different really combine, though i am going to add his templates and use the same xml output when i add that. Actually i just released a new version yesterday, and its getting pretty close to doing everything that is needed for great PEAR docs but its not quite there (i still need to seperate public and private methods and vars and produce indexes). I've also noticed that a lot of the pear code isn't phpdoc documented and that some that is has some errors so that is doesn't produce good docs. Anyway you can look at the newest docs i've generated at Http://phpdocu.sourceforge.net -joshua eichorn Stig S. Bakken wrote:
Hi Joshua, Have you spoken to Ulf Wendel about your project? I would like to see efforts joined into one project that lets us automate doc. generation for pear.php.net. There is a lot of pear docs written that never reach their audience because they sit tight in their docblocks... - Stig Joshua Eichorn wrote:
I've also been working on a PHPDoc documentation tool. It might suit your needs better. It currently has some rought edges also, but I am actively developing it, and will continue to since i rely on it to document projects through my work. If anyone wants to take a look the website is phpdocu.sourceforge.net. I have no problems including it in PEAR or moving it to any locations cvs. However i wasn't going to bring that up until i get it to a stage where i feel it is mainly feature complete. -joshua eichorn btw: i have contacted the author of phpdoc previously and tried hacking on his code, but i found the code i had already created more useful for my needs. Sebastian Bergmann wrote:
skelly@juptech.com wrote:
I noticed that you recently removed the pear/PHPDoc tree from CVS.
I did not remove, but move it: into PEAR's own CVS module.
Does this represent the demise of PHPDoc as far as PHP distributions are concerned?
Yes, PHPDoc will be no longer in the distributions.
Even though it has a few rough edges and development seems to have stalled, I found it kind of useful. Is there a preferred documentation extraction method to use (I find phpdoc => javadoc to be a bit limiting when it comes to PHP language elements).
PHPDoc remains the 'official' source documentation tool for PHP. Yours, Sebastian


« previous php.pear.general (#198) next »