Even if the package names are different and thus binary compatibility is not preserved, the @since tags are still important to delineate new functionality before 3.0. It can help people with migrating.
On Mon, Apr 5, 2010 at 12:26 PM, Gary Gregory <[email protected]> wrote: >> -----Original Message----- >> From: sebb [mailto:[email protected]] >> Sent: Saturday, March 27, 2010 16:19 >> To: Commons Developers List >> Subject: Re: [lang] v3.0 @since >> >> On 27/03/2010, Gary Gregory <[email protected]> wrote: >> > Since multiple @since tags are allowed and are treated like multiple >> > @author >> tags, what about making use of that? For example: >> > >> > ... >> > * @since 2.0 >> > * @since 3.0 >> >> -1, very confusing - what does it mean? >> >> > */ >> > public static String capitalize(CharSequence cs) { >> > ... >> > >> > Or maybe: >> > >> > * @since 2.0 >> > * @since 3.0 changed from capitalize(String) to >> capitalize(CharSequence) >> >> +1 > > I added @since 3.0 tag in this format for StringUtils. > > Gary > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
