Re: [PEPr] Comment on RFC::Coding standard enhancements
| From: | Brett Bieber | Date: | Mon, 03 Nov 2008 14:23:45 +0000 |
| Subject: | Re: [PEPr] Comment on RFC::Coding standard enhancements | ||
| References: | 1 2 3 4 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-51004@lists.php.net to get a copy of this message | ||
On Mon, Nov 3, 2008 at 7:31 AM, Chuck Burgess <demon.gene@gmail.com> wrote:
> 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?
Both! :-p
Any phpdocumentor flag to tell it to handle it that way?
Maybe worth a feature request...? Something like, " --bieberwantedthis
This option tells phpdocumentor if no file-level docblock is present,
document the file with relevant attributes from the first docblock
seen. "
--
Brett Bieber