astropy/astropy — pull request #2664 by mdboom (2014-06-26 16:21:55+00:00)
Title: `setup.py build_sphinx` broken on Sphinx 1.2

f0f9bc7c appears to have broken compatibility with building the docs on Sphinx 1.2, resulting in this error:

```
Traceback (most recent call last):
File "", line 30, in
File "/home/mdboom/python/lib/python2.7/site-packages/sphinx/application.py", line 208, in build
self.builder.build_all()
File "/home/mdboom/python/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 177, in build_all
self.build(None, summary='all source files', method='all')
File "/home/mdboom/python/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 234, in build
purple, length):
File "/home/mdboom/python/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 134, in status_iterator
for item in iterable:
File "/home/mdboom/python/lib/python2.7/site-packages/sphinx/environment.py", line 470, in update_generator
self.read_doc(docname, app=app)
File "/home/mdboom/python/lib/python2.7/site-packages/sphinx/environment.py", line 689, in read_doc
pickle.dump(doctree, f, pickle.HIGHEST_PROTOCOL)
cPickle.PicklingError: Can't pickle : it's not the same object as astropy.coordinates.baseframe.RepresentationMapping
```

Upgrading to Sphinx 1.2.2 does resolve the error.

So, the question is:

1) Is this a legitmate bug in the pickling of `astropy.coordinates.baseframe.RepresentationMapping` that needs to be fixed? (I plan to do some further investigation).

2) Is this a bug in Sphinx 1.2 that it can't handle this class (now fixed in 1.2.2), and therefore we just update our minimum version of Sphinx to 1.2.2 and get on with it?

Either way, I think this is probably a blocker for 0.4...