[Numpy-discussion] Numpydoc warnings for methods

[Ralf Gommers]

On Sun, Jul 17, 2011 at 7:15 PM, Tony Yu <tsyu80 at gmail.com> wrote:

> I'm building documentation using Sphinx, and it seems that numpydoc is
> raising
> a lot of warnings. Specifically, the warnings look like "failed to import
> <method_name>", "toctree
> references unknown document u'<method_name>'", "toctree contains reference
> to nonexisting document '<method_name>'---for each method defined. The
> example below reproduces the issue on my system (Sphinx 1.0.7, numpy HEAD).
> These warnings appear in my build of the numpy docs, as well.
>
> Removing numpydoc from the list of Sphinx extensions gets rid of these
> warnings
> (but, of course, adds new warnings if headings for 'Parameters', 'Returns',
> etc. are present).
>
> Am I doing something wrong here?
>
> You're not, it's a Sphinx bug that Pauli already has a fix for. See
http://projects.scipy.org/numpy/ticket/1772

Ralf
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20110717/1d0e4ce5/attachment.html>