Re: [PEPr] Comment on RFC::Coding standard enhancements
| From: | Chuck Burgess | Date: | Mon, 03 Nov 2008 13:31:00 +0000 |
| Subject: | Re: [PEPr] Comment on RFC::Coding standard enhancements | ||
| References: | 1 2 3 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-51003@lists.php.net to get a copy of this message | ||
On Mon, Nov 3, 2008 at 7:23 AM, Brett Bieber <brett.bieber@gmail.com> wrote:
> I wonder though - is this more of a phpdocumentor limitation, than a
> PEAR CS limitation?
>
I'd say it is... PhpDocumentor expects the file-level docblock to be there,
and will throw warnings if it's not. By omitting it, you leave the first
docblock of the file in an ambiguous position... is it supposed to be a
file-level block, or a block for the first code element?
--
CRB