trouble building docs

[Walter Cruz]

pylons repo get from: http://pylonshq.com/hg/pylons-dev/

(sphinx)walter@stark ~/devel/python/pylons/pylons/docs/en$ make html
mkdir -p _build/html _build/doctrees
sphinx-build -b html -d _build/doctrees   . _build/html
Running Sphinx v0.6.1
loading pickled environment... not found
building [html]: targets for 77 source files that are out of date
updating environment: 77 added, 0 changed, 0 removed
Exception occurred:[ 58%] thirdparty/formencode_api                                                                         
  File "/home/walter/.virtualenvs/sphinx/lib/python2.5/site-packages/Sphinx-0.6.1-py2.5.egg/sphinx/ext/autodoc.py", line 487, in get_object_members
    for mname in self.get_attr(self.object, '__dict__')])
RuntimeError: dictionary changed size during iteration
The full traceback has been saved in /tmp/sphinx-err-OtGUsQ.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 sphin...@googlegroups.com. Thanks!
make: ** [html] Erro 1


The trouble is with pylons docs or sphinx?

--
[]'
- Walter
waltercruz.com

[Philip Jenvey]

Luckily sphinx-build has a pdb option (-P) which let me narrow this
down easily, formencode.Validator triggers it. It's really a sphinx
bug with tricky classes, this fixes it:

http://pylonshq.com/pasties/cd4b0d856ce7efe39b8e7378b931c3ee

Could you maybe log a ticket about this with Sphinx?

I get another even stranger error after this when it's autodocing
WebOb. Do you get this with the patch applied?

Exception occurred:[ 89%] thirdparty/webob
File "/Users/pjenvey/src/python/pylons-apple/lib/python2.5/site-
packages/Sphinx-0.6.1-py2.5.egg/sphinx/ext/autodoc.py", line 844, in
import_object
self.doc_as_attr = (self.objpath[-1] != self.object.__name__)
AttributeError: '_AnyETag' object has no attribute '__name__'

->

>>> from webob.etag import _AnyETag
>>> _AnyETag.__name__
'_AnyETag'

FYI downgrading Sphinx should get around all this.

--
Philip Jenvey

[Walter Cruz]

Yes, I will fill a ticket on sphinx. And I get the error with webob docs too.

Reporting the bug right now!

--
[]'
- Walter
waltercruz.com

[Philip Jenvey]

On May 12, 2009, at 8:14 AM, Walter Cruz wrote:

> Yes, I will fill a ticket on sphinx. And I get the error with webob
> docs too.
>
> Reporting the bug right now!

Thanks! I fixed the WebOb problem and a couple other issues w/ sphinx
0.6 in the latest tip. With that patch it should all build, so
hopefully that fix makes it into 0.6.2 =]

--
Philip Jenvey