| 12 | | There is a deprecation system to deprecate function in numpy.lib.utils. When deprecating a function in a version N.M.x, it will be removed in N.M+1.0 |
| | 12 | Deprecated uses should issue a !DeprecationWarning using the [http://docs.python.org/lib/module-warnings.html standard library's warnings module]. There are two decorators {{{deprecate()}}} and {{{deprecate_with_doc()}}} in numpy.lib.utils for conveniently deprecating an entire function. |
| | 13 | |
| | 14 | Deprecation warnings should exist for one full minor release cycle before the deprecated features are removed, certainly no less and preferably no more. For example, if a function is deprecated in numpy 1.1.0, it will remain so in all 1.1.x releases, but it can and should be removed in 1.2.0. |
