On Apr 5, 2011, at 5:45, sebb <seb...@gmail.com> wrote: > 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.
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 >> <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 > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
