commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Phil Steitz <phil.ste...@gmail.com>
Subject Re: [math] @since tag
Date Wed, 21 Sep 2011 16:00:48 GMT
On 9/21/11 5:23 AM, sebb wrote:
> Why not just add some text to the tag to explain what has happened?
>
> Something like:
>
> @since 2.0 (changed to concrete class in 3.0)

+1

Phil
>
> 2011/9/21 Sébastien Brisard <sebastien.brisard@m4x.org>:
>> Maybe that tag should be removed (drastic... but no possible confusion!).
>> Sébastien
>>
>> 2011/9/21 Gilles Sadowski <gilles@harfang.homelinux.org>:
>>> On Wed, Sep 21, 2011 at 06:25:13AM +0200, Sébastien Brisard wrote:
>>>> Hi,
>>>> I'm currently working on MATH-662. So far, I have merged
>>>> CholeskyDecomposition and CholeskyDecompositionImpl. My question is
>>>> very simple: CholeskyDecomposition exists as an interface since
>>>> version 2.0 (as indicated in the current Javadoc), but as a concrete
>>>> class since version 3.0 only. Should the @since tag be updated
>>>> accordingly?
>>> In fact, it depends on whether this tag is intended for tracking the
>>> functionality or the implementation.
>>> And either action could be misleading...
>>>
>>>
>>> Regards,
>>> Gilles
>>>
>>> ---------------------------------------------------------------------
>>> 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
>
>


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


Mime
View raw message