On Wed, Sep 29, 2010 at 1:59 PM, Michael Droettboom <md...@stsci.edu> wrote:

> We're having trouble using numpydoc formatted docstrings for one of our
> own project.  It seems that the "Other parameters" section is not
> getting included in the output.
>
> A grep across Numpy's own source code (git master) reveals that this
> kind of section is used in only one place -- the docstring for
> "recarray".  Curiously, the "Other Parameters" section is displayed in
> the documentation editor here:
>
>   http://docs.scipy.org/numpy/docs/numpy.core.records.recarray/
>
> But not in the generated Numpy docs online here:
>
>   http://docs.scipy.org/doc/numpy/reference/generated/numpy.recarray.html
>
> Is this a bug?
>
>
Probably. The Other Parameters section is one of those ideas that sounded
good at the time but didn't end up used in practice. I expect that nobody
noticed its absence before.

Chuck.
_______________________________________________
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
http://mail.scipy.org/mailman/listinfo/numpy-discussion

Reply via email to