[SciPy-dev] Documenting Warnings
Fri Jun 26 15:48:00 CDT 2009
On Fri, Jun 26, 2009 at 3:24 PM, Pierre GM <firstname.lastname@example.org> wrote:
> How do we document a warning, a note that should be displayed
> differently as a note ? Don't we have a "Warnings" entry in the
> docstrings standard ?
For longer reST doc files you can use (see for example
*There is no Warnings heading in the docstring standard. Why can't you put
it either under Notes or under Raises? And special reST markup like the
above is discouraged in docstrings because it looks bad on text terminals.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Scipy-dev