Issues

Issue #477 invalid

'function' directive not registered

Eugeny Rostovtsev
created an issue

In version 0.6.7 in file sphinx/directives/desc.py it registered:

directives.register_directive('function', directive_dwim(ModulelevelDesc))

But in version 1.0.* this file not exist, and building of documentation for client packages (e.g. NumPy) crashed.

More info: http://projects.scipy.org/numpy/ticket/1489

Comments (6)

  1. Sebastian Wiesner

    All directives are "lost", but this isn't a Sphinx bug. Sphinx internals simply changed when introducing domains, and all language-specific directives and roles (e.g. "function" and "class") are now grouped in what Sphinx calls "domains".

    Simply restoring old 0.6.x code isn't the solution. The broken extension must be re-written for Sphinx 1.0. I don't know, what it does, but it seemingly decorates existing directives. In this case, the proper solution is a special "numpy" domain class, which derives from the standard Python domain and extends the directives and functions accordingly. Ask on the mailing list, if you need advice on how to do this.

  2. Log in to comment