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

[Michel Fortin]

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);

-- 
Michel Fortin
michel.fortin at michelf.com
http://michelf.com/