[Python-modules-team] Bug#608842: python-numpy: FTBFS with Sphinx 1.0: RuntimeError: No directive named 'function' found

[Jakub Wilk]

Source: python-numpy
Version: 1:1.4.1-5
Tags: upstream fixed-upstream
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx1.0
Severity: important

Hello,

When rebuilt with python-sphinx 1.0.5-1 (available in experimental), 
Numpy failed to build. Here are the relevant parts of the build log:

[…]
| # build doc only for default python version
| (export MPLCONFIGDIR=. ; make -C doc html PYTHONPATH=../build/lib.linux-i686-2.6)
| make[1]: Entering directory `/build/sbuild-python-numpy_1.4.1-5-i386-lyAPMt/python-numpy-1.4.1/doc'
| mkdir -p build
| touch build/generate-stamp
| mkdir -p build/html build/doctrees
| LANG=C sphinx-build -b html -d build/doctrees   source build/html
| Running Sphinx v1.0.5
| 
| Exception occurred:
|   File "/build/sbuild-python-numpy_1.4.1-5-i386-lyAPMt/python-numpy-1.4.1/doc/sphinxext/numpydoc.py", line 136, in get_directive
|     raise RuntimeError("No directive named '%s' found" % name)
| RuntimeError: No directive named 'function' found
| The full traceback has been saved in /tmp/sphinx-err-6YAc7o.log, if you want to report the issue to the developers.
| Please also report this if it was a user error, so that a better error message can be provided next time.
| Either send bugs to the mailing list at <http://groups.google.com/group/sphinx-dev/>,
| or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
| 1.4 1.4.1
| make[1]: *** [html] Error 1

The full traceback was:

| # Sphinx version: 1.0.5
| # Python version: 2.6.6
| # Docutils version: 0.7 release
| # Jinja2 version: 2.5.5
| Traceback (most recent call last):
|   File "/usr/lib/pymodules/python2.6/sphinx/cmdline.py", line 172, in main
|     warningiserror, tags)
|   File "/usr/lib/pymodules/python2.6/sphinx/application.py", line 116, in __init__
|     self.setup_extension(extension)
|   File "/usr/lib/pymodules/python2.6/sphinx/application.py", line 259, in setup_extension
|     mod.setup(self)
|   File "/build/sbuild-python-numpy_1.4.1-5-i386-lyAPMt/python-numpy-1.4.1/doc/sphinxext/numpydoc.py", line 119, in setup
|     app.add_directive('np-' + name, wrap_mangling_directive(name, objtype))
|   File "/build/sbuild-python-numpy_1.4.1-5-i386-lyAPMt/python-numpy-1.4.1/doc/sphinxext/numpydoc.py", line 139, in wrap_mangling_directive
|     base_directive = get_directive(base_directive_name)
|   File "/build/sbuild-python-numpy_1.4.1-5-i386-lyAPMt/python-numpy-1.4.1/doc/sphinxext/numpydoc.py", line 136, in get_directive
|     raise RuntimeError("No directive named '%s' found" % name)
| RuntimeError: No directive named 'function' found

This bug has been already reported and fixed upstream:
http://projects.scipy.org/numpy/ticket/1489

-- 
Jakub Wilk