From ec116c49103dfd4bac3b703d36e0a83165e075a2 Mon Sep 17 00:00:00 2001 From: chebee7i Date: Sat, 14 Feb 2015 11:23:53 -0600 Subject: DOC: Mention numpydoc 0.6. --- doc/HOWTO_DOCUMENT.rst.txt | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/doc/HOWTO_DOCUMENT.rst.txt b/doc/HOWTO_DOCUMENT.rst.txt index 3192c7ed3..de0190084 100644 --- a/doc/HOWTO_DOCUMENT.rst.txt +++ b/doc/HOWTO_DOCUMENT.rst.txt @@ -13,11 +13,15 @@ A Guide to NumPy/SciPy Documentation numpy conventions, you should use the ``numpydoc`` extension so that your docstrings will be handled correctly. For example, Sphinx will extract the ``Parameters`` section from your docstring and convert it into a field - list. Using numpydoc will also avoid the reStructuredText errors produced + list. Using ``numpydoc`` will also avoid the reStructuredText errors produced by plain Sphinx when it encounters numpy docstring conventions like section headers (e.g. ``-------------``) that sphinx does not expect to find in docstrings. + Some features described in this document require a recent version of + ``numpydoc``. For example, the **Yields** section was added in + ``numpydoc`` 0.6. + It is available from: * `numpydoc on PyPI `_ @@ -267,6 +271,9 @@ The sections of the docstring are: err_msg : str or None Human readable error message, or None on success. + Support for the **Yields** section was added in `numpydoc + `_ version 0.6. + 7. **Other Parameters** An optional section used to describe infrequently used parameters. @@ -546,7 +553,8 @@ Documenting generators ---------------------- Generators should be documented just as functions are documented. The only difference is that one should use the **Yields** section instead -of the **Returns** section. +of the **Returns** section. Support for the **Yields** section was added in +`numpydoc `_ version 0.6. Documenting constants -- cgit v1.2.1