This should be a separate section of the docstring, and should be numbered.  Please have a look at some of the other function docstrings for examples (or at https://raw.github.com/numpy/numpy/master/doc/EXAMPLE_DOCSTRING.rst.txt)