Problem building docs with Sphinx 1.0.1

[Matt Giuca]

Cannot build Mars documentation with Sphinx 1.0.1 included with Ubuntu 11.04.

Extension error:
Could not import extension mars.desc (exception: No module named desc)

This is quite misleading, as it doesn't refer to mars.desc that cannot be imported. Trying the same code in Python gives a clue:

  File "/home/mgiuca/src/mars/closure-templates/doc/ext/mars/desc.py", line 29, in <module>
    from sphinx.directives.desc import DescDirective
ImportError: No module named desc

It seems that sphinx.directives.desc is now missing or moved.

[Matt Giuca (mgiuca)]

Wow, sphinx.directives.desc is totally missing or moved! Looks like it has been entirely replaced by the new "domains" system, where each language gets its own complete domain and they are no longer second-class citizens to Python (Python is "just another" domain). The problem is, it feels a bit like OpenGL 3.0 -- if you want a domain you need to do a lot of work or copy a lot of boilerplate.

I am preparing a new Mars domain, which will be based off the Python domain.

[Matt Giuca (mgiuca)]

Fixed in trunk r1226.