commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: [POOL2] cleanup: replace all @since tags
Date Fri, 04 May 2012 11:01:02 GMT
On May 4, 2012, at 6:50, sebb <sebbaz@gmail.com> wrote:

> On 4 May 2012 11:16, Mark Thomas <markt@apache.org> wrote:
>> Since pool2 uses a new package, I intend to remove all existing @since
>> tags that refer to 1.x and add @since 2.0 to all public
>> classes,interfaces, methods, constants etc. Any objections?
>
> No point in adding the @since to anything but top-level files, i.e.
> classes and interfaces (and emums).
> I think it would be distracting to see it on every method and constant as well.
> Such nested items only need the @since when they are added to the
> enclosing file in a subsequent release.
>

+1

Gary

> But otherwise it makes sense to me.
>
>> Mark
>>
>> ---------------------------------------------------------------------
>> 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


Mime
View raw message