Re: coding standards: Header Comment Blocks

Hi,

Klaus raised an interseting point on IRC regarding Header Comment Blocks. For phpDocumentor to work correctly, we really need to have a page-level docblocks. The current standard requires a regular comment at the top of each file: http://pear.php.net/manual/en/standards.header.php Can we please modify the standard to make the header comments to be in docblock format? I'd suggest the following for a standard file:

I'd strongly welcome this change! The comments have been adopted from the PHP source and extensions but they make no real sense, when using PEAR. Stephan