Re: Re: coding standards: Header Comment Blocks
| From: | Mika Tuupola | Date: | Tue, 08 Jun 2004 07:04:28 +0000 |
| Subject: | Re: Re: coding standards: Header Comment Blocks | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-30130@lists.php.net to get a copy of this message | ||
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$.
--
Mika Tuupola http://www.appelsiini.net/~tuupola/