Sphinx failed making Django docs
I just installed Sphinx in Python 2.5.1 on Mac OS X 10.4.11 using 'easy_install -U Sphinx' and tried to use it to build html version of Django 1.2.1 docs. It raised an exception:
~/Applications/Django-1.2.1/docs xxx$ make html
sphinx-build -b djangohtml -d _build/doctrees . _build/html
Making output directory...
Running Sphinx v1.0.3
loading pickled environment... not yet created
building [djangohtml]: targets for 187 source files that are out of date
updating environment: 187 added, 0 changed, 0 removed
/Users/xxx/Applications/Django-1.2.1/docs/_ext/djangodocs.py:91: DeprecationWarning: xfileref_role is deprecated, use XRefRole
xrefs = sphinx.roles.xfileref_role('ref', linktext, linktext, lineno, state)
reading sources... [ 39%] ref/contrib/gis/commands
File "/Users/xxx/Applications/Django-1.2.1/docs/_ext/djangodocs.py", line 215, in parse_django_adminopt_node
from sphinx.directives.desc import option_desc_re
ImportError: No module named desc
The full traceback has been saved in /tmp/sphinx-err-JN15dx.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-dev/>,
or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
make: *** [html] Error 1
"/tmp/sphinx-err-JN15dx.log" is attached.