commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Simone Tripodi <simonetrip...@apache.org>
Subject Re: [ALL] @version tag :)
Date Tue, 05 Apr 2011 09:59:08 GMT
Hi all guys!
I think we all should agree on adopting a common policy, it shouldn't
be dependent by who takes care of a component.
I see different opinion about @version tag usage, so what's next?
shall we calla  vote to make a definitive decision?
I'm worried that this discussion could degenerate in a loooong thread :P
Simo

http://people.apache.org/~simonetripodi/
http://www.99soft.org/



On Tue, Apr 5, 2011 at 11:52 AM, Torsten Curdt <tcurdt@vafer.org> wrote:
> On Tue, Apr 5, 2011 at 10:39, 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?
>
> No, @since shows when the class/method was added to the API
>
> TBH I don't see a good reason for @version and don't use it myself
> ...but if you want to express what version you are talking about in
> the javadocs I would suggest to use the artifact version instead of
> the magic tokens.
>
> cheers,
> Torsten
>
> ---------------------------------------------------------------------
> 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