On 5 April 2011 09:55, Simone Tripodi <[email protected]> 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 > <[email protected]> wrote: >> On Tue, Apr 5, 2011 at 10:28 AM, Torsten Curdt <[email protected]> wrote: >>> @version should show the version of artifact. >> >> Isnt this the intention of @since? >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [email protected] >> For additional commands, e-mail: [email protected] >> >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
