Re: Re: PEAR Quality (vs. Quantity) RFC

From: Date: Tue, 13 May 2003 21:30:27 +0000
Subject: Re: Re: PEAR Quality (vs. Quantity) RFC
References: 1 2 3 4 5  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-16226@lists.php.net to get a copy of this message
Greg Beaver wrote:
Davey wrote:
Martin Jansen wrote:
On Tue May 13, 2003 at 12:4353PM +0100, Davey wrote:
Agreed, but you mention both phpDoc and phpDocumentor...
PHPDoc is the standard, which defines the style of the API documentation. phpDocumentor is the tool to parse and evaluate this documentation.
Packages that are maintained tend to have fewer bugs. The PHPDoc package is not maintained, phpDocumentor is.
http://pear.php.net/package-info.php?pacid=97
Release date 2002-07-26
http://pear.php.net/package-info.php?pacid=137
Release date 2003-04-17
I'd like to think that ZDE isn't 'some random IDE'.
no, but the choice of its non-standard doc tags is pretty random. It's really too bad, as you will find that the documentation tags are useless for anything but development in ZDE.
The only non-standard tag it uses is @desc, it in fact only recognises: @desc @param @return anything else is ignored (so I can put in everything else for apidoc and it will just ignore them). Is it at all possible for phpDocumentor to support that one discrepency as I believe the ZDE is a very liked editor, mainly because its cross platform and it fully supports the PHP syntax... and its auto-complete works off the apidoc :) I am going to test, make sure it can't accept the: /** * description here */ it might just do that, never know, never tried!
Greg -- phpDocumentor http://www.phpdoc.org
- Davey

« previous php.pear.dev (#16226) next »