[Numpy-discussion] trouble building docs with sphinx-0.6.1

[David Cournapeau]

Darren Dale wrote:
> This morning I upgraded to sphinx-0.6.1, hoping to take advantage of
> all the recent work that has been done to clean up and consolidate the
> web of sphinx extensions. I'm seeing segfaults when I try to build my
> own docs, or the h5py docs.

Segfaults ? In sphinx or numpy related ?

> I tried building the numpy documentation after applying the attached
> patch. After building html, updating the environment, reading sources,
> I see a slew of warnings and errors, followed by:
>
> preparing documents... done
> Exception occurred:  0%] contents
>   File "/usr/lib64/python2.6/site-packages/docutils/nodes.py", line
> 471, in __getitem__
>     return self.attributes[key]
> KeyError: 'entries'
> The full traceback has been saved in /tmp/sphinx-err-RDe0NL.log, if
> you want to report the issue to the author.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> Send reports to sphinx-dev at googlegroups.com
> <mailto:sphinx-dev at googlegroups.com>. Thanks!

This often happens for non-clean build. The only solution I got so far
was to start the doc build from scratch...

> Has anyone else tried building numpy's docs with sphinx-0.6.1? Is
> there any interest in sorting these issues out before 1.3 is released?

I am afraid it is too late for the 1.3 release,

cheers,

David