[SciPy-Dev] Warning of deprecation in doc's ?

[Vincent Davis]

For example scipy.stats.stats.cov when you view source has
"scipy.stats.cov is deprecated; please update your code to use
numpy.cov." Should this be in the docs ? and is there an example of
how this should be pointed out.
This is something I actually implemented in a program then discovered
that is was deprecated. I would have like that to be in the online
docs.

Thanks
Vincent