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
_______________________________________________
phobos mailing list
[email protected]
http://lists.puremagic.com/mailman/listinfo/phobos
