Re: Re: coding standards: Header Comment Blocks

From: Date: Fri, 18 Jun 2004 11:52:35 +0000
Subject: Re: Re: coding standards: Header Comment Blocks
References: 1  Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-30902@lists.php.net to get a copy of this message
People, Mika Tuupola wrote:
On Tue, 8 Jun 2004, Daniel Convissor wrote:
* @license http://www.php.net/license/3_0.txt PHP License * @version $Id:$
Version might not be the same as the CVS revision.
This is a file level docblock. It should reflect the version of the file, not the package. Along the same lines, JavaDoc guidelines say the @version tag for classes should also be the CVS revision number.
And I think the CVS keyword here should be $Revision$ not $Id$.
+1 for the header comments to be in docblock format. And I agree with Tuupola on @version. -- Ate' Antonio "Can't buy what I want because its FREE!" - Pearl Jam

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