Re: PEAR API docs
| From: | Lorenzo Alberton | Date: | Tue, 15 Jul 2003 17:00:48 +0000 |
| Subject: | Re: PEAR API docs | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-18267@lists.php.net to get a copy of this message | ||
On Tue, 15 Jul 2003 09:13:52 -0700, Joshua Eichorn wrote:
> I updated my API docs of PEAR, it now includes the majority of PEAR
> packages including BETA and Development ones.
> The docs are available at: http://phpdorks.net/docs/api/
> -joshua eichorn
Hi Joshua,
thanks for your API docs, they're extremely useful for
us developer to spot php-doc errors.
There's one thing that I'm wondering about, though,
and IIRC it's the same thing Jesus had already asked
some time ago, but I haven't seen a reply to that question.
In almost every file, there's a pair of warnings like these:
Warning on line ### - no @package tag was used in a DocBlock for class XXX
Warning on line ### - no @package tag was used in a DocBlock for file
/usr/share/pear/XXX
They're often duplicated, the only difference being the line #,
one is at the beginning of the class, and the other one at the end.
Since the @package tag _is_ used in most of those files,
I wonder what we're doing wrong...
is it placed in the wrong position?
Or is it a phpDocumentor bug?
Best regards,
Lorenzo