Takeshi KOMIYA
Takeshi KOMIYA
Thank you for reporting. At present, autodoc internally generates the following document: ``` .. py:class:: Bad(d) :module: mymodule.bad Bases: :py:class:`object` :param d: This is my parameter. .. py:attribute:: Bad.d :module:...
If the `only` directive contains any sections, it appends an `only` node to the sibling of the current node. And it confuses the label system of Sphinx. Actually, the "troubleshooting"...
+1. refs: #7896
>Do others generally agree or disagree that an overhaul of the theme to be more modern would have a large benefit? +0: I don't have an opinion on this topic....
> Do we need to use sphinx13? No. But if we are making changes to improve the themes, I think it is unfair to users of Sphinx to do so...
Sphinx already provides `app.add_autodocumenter()` API to enhance autodoc from extension. So it's better to create your own extension to support multipledispatch.
It seems this handler is invoked on the bootstrap process of Sphinx (on builder-inited event). So there is no special support from Sphinx framework.
So far, custom extensions for python-doc have accessed internal data structure of sphinx.locale module directly. But, it does not work at present because the structure has changed since Sphinx-1.8 release....