[phobos] Proposed changes to std.math + introduce std.mathspecial

[Andrei Alexandrescu]

On 11/17/10 2:42 PM, Michel Fortin wrote:
> Le 2010-11-17 à 16:36, Andrei Alexandrescu a écrit :
>
>> On 11/17/10 1:09 PM, Don Clugston wrote:
>>> Move the following functions from std.math into std.mathspecial:
>>> erf()
>>> erfc()
>>> lgamma() ----->   name changes to logGamma(real x)
>>> tgamma() --->   name changes to gamma(real x).
>>> BTW The 't' in the C name exists for extremely silly historical reasons.
>>>
>>> std.math will retain alias for these functions, before they are
>>> eventually deprecated.
>>
>> deprecated("Please use the homonym functions in std.mathspecial.")
>
> But won't that just become a convenient excuse to forget putting the deprecation notice in the documentation? It sounds redundant:
>
> /**
>   * Blah blah blah...
>   * Deprecated: use the homonym functions in std.mathspecial.
>   */
> deprecated("use the homonym functions in std.mathspecial")
> double lgamma(double);

I thought it's pretty clear that having active deprecation notes is not 
redundant at all. The right solution to avoiding redundancy is to have 
ddoc insert the deprecation note in the generated text.

Andrei