On 5 April 2011 09:55, Simone Tripodi <simonetrip...@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 > <grobme...@gmail.com> wrote: >> On Tue, Apr 5, 2011 at 10:28 AM, Torsten Curdt <tcu...@vafer.org> wrote: >>> @version should show the version of artifact. >> >> Isnt this the intention of @since? >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org >> For additional commands, e-mail: dev-h...@commons.apache.org >> >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
