commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: [ALL] @version tag :)
Date Tue, 05 Apr 2011 10:19:08 GMT
On 5 April 2011 10:44, sebb <sebbaz@gmail.com> wrote:
> On 5 April 2011 09:55, Simone Tripodi <simonetripodi@apache.org> wrote:
>> Hi all guys!
>>
>> @Torsten: I agree, question is that I have never understood why the
>> common usage is putting SVN tags in @version javadoc, so since I
>> noticed a mixed usage, I wondered which one is the commonly used;
>>
>> @Christian: I intended @version, because existing source have *a lot*
>> of that tag; for @since instead the common usage seems to be correct
>>
>> BTW I would be +1 for NO @version and putting only @since
>
> I think the intention of the @version tag is to identify code that is
> not stored in SVN - e.g. in a source archive.
>
> $Revision$ and $Id$ (or even $HeadUrl) are fine in @version comments,
> however please don't use $Date$ as that is expressed in local time.
> This really messes up release checking as the dates in source archives
> don't match the dates in SVN tag checkouts unless the same timezone is
> being used.

In case it's not obvious, I am

-1 to banning @version, as it can be useful

+1 to banning $Date$ in @version

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message