Re: PEAR API docs

From: 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

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