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 09:44:56 GMT
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.

> 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


Mime
View raw message