commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Matt Benson <gudnabr...@gmail.com>
Subject Re: [DBCP] @since markers for 2.0 release
Date Wed, 26 Feb 2014 13:46:40 GMT
On Feb 26, 2014 4:35 AM, "Gilles" <gilles@harfang.homelinux.org> wrote:
>
> On Wed, 26 Feb 2014 10:30:00 +0000, Mark Thomas wrote:
>>
>> I'm wondering what to do about @since markers. As DBCP2 is in a
>> completely new package, arguably everything is new for this release. The
>> existing @since markers don't make a lot of sense. Therefore, I am
>> currently considering removing all @since markers from the code base.
>> They would then be used from the next release to indicate what had
changed.
>>
>> Thoughts?
>
>
> In Commons Math, we kept the markers referring to the older major
versions,
> even though the packages have changed twice already.
>

My inclination in general is to follow the example Gilles provides from CM
unless, for instance, the API has been completely rewritten.

Matt

> Gilles
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message