Numpy 1.5.1/1.6.1 doesn't build doc with sphinx 1.1.2
Hello, with the new sphinx, v1.1.2, numpy documentation of 1.5.1 or 1.6.1 doesn't build. The full log of the debian package build is at: http://people.debian.org/~jwilk/tmp/python-numpy_1.6.1-3_i386.build attached is the file left in /tmp by sphinx for the error. Could you please give it a look? Cheers, -- Sandro Tosi (aka morph, morpheus, matrixhasu) My website: http://matrixhasu.altervista.org/ Me at Debian: http://wiki.debian.org/SandroTosi
24.11.2011 15:22, Sandro Tosi kirjoitti: [clip]
The full log of the debian package build is at: http://people.debian.org/~jwilk/tmp/python-numpy_1.6.1-3_i386.build
attached is the file left in /tmp by sphinx for the error.
Could you please give it a look?
Seems like some sort of a Sphinx bug (rather than having to do with the Sphinx extensions Numpy uses). It appears it doesn't like having a `glossary::` specified in a docstring used in `automodule::`. Or, alternatively, there's something wrong with the formatting in the file `numpy/doc/glossary.py`. Workarounds: copy-paste the glossary list from `glossary.py` to `doc/source/glossary.txt` in place of `automodule:: numpy.doc.glossary` If that doesn't help, then something in the formatting of the glossary list that makes Sphinx to choke (and it's certainly then a Sphinx bug). -- Pauli Virtanen
Note sure if this already has been discussed, but it seems that latest Sphinx, 1.2predev-20120222 directly from their Hg repository, does not have this problem any more. While 1.2 failed to build the documentation on my end, 1.2predev delivered a result. Regards, David On 24/11/11 15:31, Pauli Virtanen wrote:
24.11.2011 15:22, Sandro Tosi kirjoitti: [clip]
The full log of the debian package build is at: http://people.debian.org/~jwilk/tmp/python-numpy_1.6.1-3_i386.build
attached is the file left in /tmp by sphinx for the error.
Could you please give it a look? Seems like some sort of a Sphinx bug (rather than having to do with the Sphinx extensions Numpy uses). It appears it doesn't like having a `glossary::` specified in a docstring used in `automodule::`. Or, alternatively, there's something wrong with the formatting in the file `numpy/doc/glossary.py`.
Workarounds: copy-paste the glossary list from `glossary.py` to `doc/source/glossary.txt` in place of `automodule:: numpy.doc.glossary`
If that doesn't help, then something in the formatting of the glossary list that makes Sphinx to choke (and it's certainly then a Sphinx bug).
On Wed, Feb 22, 2012 at 18:46, David Verelst
Note sure if this already has been discussed, but it seems that latest Sphinx, 1.2predev-20120222 directly from their Hg repository, does not have this problem any more. While 1.2 failed to build the documentation on my end, 1.2predev delivered a result.
I'm sorry I didn't follow this up: the fix is already in the numpy repository, and i've applied in Debian with this patch (url to upstream tracker in the file): http://patch-tracker.debian.org/patch/series/view/python-numpy/1:1.6.1-5/20_... Regards, -- Sandro Tosi (aka morph, morpheus, matrixhasu) My website: http://matrixhasu.altervista.org/ Me at Debian: http://wiki.debian.org/SandroTosi
participants (3)
-
David Verelst -
Pauli Virtanen -
Sandro Tosi