[SciPy-Dev] Warning of deprecation in doc's ?
Thu Jun 3 09:52:48 CDT 2010
Thu, 03 Jun 2010 22:43:02 +0800, Ralf Gommers wrote:
> It should be made as visible as possible in my opinion. A reST warning
> in between summary and extended summary would work. It should clearly
> state in which version it will be removed. Best to keep the text
> identical to the one passed to the deprecate decorator. A reason or
> alternative should be given as well.
> .. warning::
> `myfunc` is deprecated and will be removed in SciPy 0.9. Look at
> `thatfunc` for equivalent functionality.
Sphinx probably has a special format for deprecations. Best to use that,
More information about the SciPy-Dev