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

[Darren Dale]

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. 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. Thanks!

Here are the contents of the referenced log file:

Traceback (most recent call last):
  File "//usr/lib64/python2.6/site-packages/sphinx/cmdline.py", line 172, in
main
    app.build(all_files, filenames)
  File "//usr/lib64/python2.6/site-packages/sphinx/application.py", line
129, in build
    self.builder.build_update()
  File "//usr/lib64/python2.6/site-packages/sphinx/builders/__init__.py",
line 255, in build_update
    'out of date' % len(to_build))
  File "//usr/lib64/python2.6/site-packages/sphinx/builders/__init__.py",
line 310, in build
    self.write(docnames, list(updated_docnames), method)
  File "//usr/lib64/python2.6/site-packages/sphinx/builders/__init__.py",
line 348, in write
    doctree = self.env.get_and_resolve_doctree(docname, self)
  File "//usr/lib64/python2.6/site-packages/sphinx/environment.py", line
995, in get_and_resolve_doctree
    prune=prune_toctrees)
  File "//usr/lib64/python2.6/site-packages/sphinx/environment.py", line
1128, in resolve_toctree
    tocentries = _entries_from_toctree(toctree, separate=False)
  File "//usr/lib64/python2.6/site-packages/sphinx/environment.py", line
1109, in _entries_from_toctree
    subtree=True):
  File "//usr/lib64/python2.6/site-packages/sphinx/environment.py", line
1109, in _entries_from_toctree
    subtree=True):
  File "//usr/lib64/python2.6/site-packages/sphinx/environment.py", line
1109, in _entries_from_toctree
    subtree=True):
  File "//usr/lib64/python2.6/site-packages/sphinx/environment.py", line
1051, in _entries_from_toctree
    refs = [(e[0], str(e[1])) for e in toctreenode['entries']]
  File "/usr/lib64/python2.6/site-packages/docutils/nodes.py", line 471, in
__getitem__
    return self.attributes[key]
KeyError: 'entries'

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?

Thanks,
Darren
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20090401/17d4b087/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: numpy_doc.patch
Type: application/octet-stream
Size: 1057 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20090401/17d4b087/attachment.obj>