On Feb 26, 2014 4:35 AM, "Gilles" <gil...@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-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org >