Docs build failure on Launchpad.

[takluyver]

Probably due to #2836. I'm starting to think we should make numpydoc more flexible, so not everything has to be a definition list.

reading sources... [  3%] api/figure_api

Exception occurred:
  File "/usr/lib/python2.7/dist-packages/numpydoc/docscrape.py", line 208, in parse_item_name
    raise ValueError("%s is not a item name" % text)
ValueError: :func:`~matplotlib.Figure.set_size_inches` is not a item name

[tacaswell]

Sorry about that. Is there a simple way to change #2836 to fix this?

[takluyver]

I think it's expecting a definition list, so it would probably work if the see also section looked something like this:

set_size_inches
    :func:`~matplotlib.Figure.set_size_inches`

I'm also going to file a bug on numpydoc to try and improve this, because we've run into it several times in IPython.

[takluyver]

Correction after reading the docs docs: it should be just the function name without the Sphinx markup, i.e.

matplotlib.Figure.set_size_inches

[tacaswell]

@takluyver That take care of it?

[takluyver]

Sorry, I don't have a local checkout handy, this was from the Launchpad daily builds. I think it should fix it - if you merge it, I'll let you know tomorrow when the next build runs.

[takluyver]

Yes, that fixed it; we're back to failing on #2916 now.

[tacaswell]

Progress I guess....