commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: [ALL] @version tag :)
Date Tue, 05 Apr 2011 12:48:29 GMT
On Apr 5, 2011, at 5:45, 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.

I've dealt with that before. It's a pain.
I like using a version tag with Id for archeological purposes.

Gary

>
>> Danke, alles gute!
>> Simo
>>
>> http://people.apache.org/~simonetripodi/
>> http://www.99soft.org/
>>
>>
>>
>> On Tue, Apr 5, 2011 at 10:39 AM, Christian Grobmeier
>> <grobmeier@gmail.com> wrote:
>>> On Tue, Apr 5, 2011 at 10:28 AM, Torsten Curdt <tcurdt@vafer.org> wrote:
>>>> @version should show the version of artifact.
>>>
>>> Isnt this the intention of @since?
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>

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


Mime
View raw message