Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Received-SPF: pass (nike.apache.org: domain of sebbaz@gmail.com designates
 209.85.212.43 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :content-type;
        b=rU0+oAHe6MbYkPPRJBAzmHLDGP5jD5o8m4QwRf+rVQWoKQ7BmVH87eoBYAnyR3ZWnD
         LIsYCDJxuAWm8nu2hH5KS73Gxyg1/sbm4tzT4M3y+16RWA0JGpZy41JC/TXEtrNtMoxV
         Q3zrE6QAJCJhdqmINStoYi+8uAsQgB7LGFMbE=
MIME-Version: 1.0
In-Reply-To: <BANLkTim0CLPNDHmG0nwig1Snhx43qjwL_Q@mail.gmail.com>
References: <BANLkTi=p_kiYFR=z7n=3-s3RFfivaw+www@mail.gmail.com>
	<BANLkTimffN7djEeHa5o5qa3ht5=RBHDtUA@mail.gmail.com>
	<BANLkTi=hUZndDBYarLpTpdzO--AM9tQCYA@mail.gmail.com>
	<BANLkTim0CLPNDHmG0nwig1Snhx43qjwL_Q@mail.gmail.com>
Date: Tue, 5 Apr 2011 10:44:56 +0100
Message-ID: <BANLkTim8FUpkiOywv7ZZ5+eAOqjtAHmyqw@mail.gmail.com>
Subject: Re: [ALL] @version tag :)
From: sebb <sebbaz@gmail.com>
To: Commons Developers List <dev@commons.apache.org>
Content-Type: text/plain; charset=ISO-8859-1

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