PicklingError when building docs

[stefankoegl]

When preparing the release of SoCo 0.10 I noticed that building the docs currently fails with the following exception

doc$ make html
sphinx-build -b html -d _build/doctrees   . _build/html
Running Sphinx v1.2b1
loading pickled environment... not yet created
loading intersphinx inventory from http://docs.python.org/2/objects.inv...
building [html]: targets for 8 source files that are out of date
updating environment: 8 added, 0 changed, 0 removed
reading sources... [ 12%] data-structures-mod                                                                                                                                                   
Exception occurred:
  File "/usr/local/lib/python2.7/dist-packages/sphinx/environment.py", line 677, in read_doc
    pickle.dump(doctree, f, pickle.HIGHEST_PROTOCOL)
PicklingError: Can't pickle <class 'soco.data_structures.DidlMetaClass'>: it's not the same object as soco.data_structures.DidlMetaClass
The full traceback has been saved in /tmp/sphinx-err-ulqee2.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-users/>,
or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Makefile:45: recipe for target 'html' failed
make: *** [html] Error 1

[stefankoegl]

git bisect yields 97002b6 as the first problematic commit.

[stefankoegl]

I found the following pointers, but I couldn't find any working solution

• http://stackoverflow.com/a/15805996/693140
• https://mail.python.org/pipermail/python-list/2011-December/subject.html#617558
• http://bugs.python.org/issue7689

@lawrenceakka, would you mind having a look at the issue?

[lawrenceakka]

Stefan,

I can't reproduce this. Your Sphinx is very old (v1.2b1). Can you try it with the latest version (v1.2.3)? I have fixed a few rst formatting errors I found along the way.

Lawrence

[stefankoegl]

You're right... it was just caused my old version of Sphinx