commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paul Benedict <pbened...@apache.org>
Subject Re: [lang] v3.0 @since
Date Mon, 05 Apr 2010 18:23:34 GMT
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
<GGregory@seagullsoftware.com> wrote:
>> -----Original Message-----
>> From: sebb [mailto:sebbaz@gmail.com]
>> Sent: Saturday, March 27, 2010 16:19
>> To: Commons Developers List
>> Subject: Re: [lang] v3.0 @since
>>
>> On 27/03/2010, Gary Gregory <GGregory@seagullsoftware.com> 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: 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