Opened 2 years ago
Last modified 3 months ago
#13323 new enhancement
upgrade docutils to version 0.9.1
Reported by: | slabbe | Owned by: | tbd |
---|---|---|---|
Priority: | major | Milestone: | sage-6.3 |
Component: | packages: standard | Keywords: | |
Cc: | Merged in: | ||
Authors: | Reviewers: | ||
Report Upstream: | N/A | Work issues: | |
Branch: | Commit: | ||
Dependencies: | Stopgaps: |
Change History (8)
comment:1 Changed 2 years ago by slabbe
comment:2 Changed 2 years ago by slabbe
Ok, it is not so easy. Sage compiles fine. But, Sphinx v1.1.2 has trouble building the documentation with the version 0.9.1 of docutils. Here is a part of dochtml.log :
Setting permissions of DOT_SAGE directory so only you can read and write it. sphinx-build -b html -d /home/slabbe/sage-5.2/devel/sage/doc/output/doctrees/en/reference -A hide_pdf_links=1 /home/slabbe/sage-5.2/devel/sage/doc/en/reference /home/slabbe/sage-5.2/devel/sage/doc/output/html/en/reference Running Sphinx v1.1.2 loading pickled environment... not yet created loading intersphinx inventory from /home/slabbe/sage-5.2/devel/sage/doc/common/python.inv... building [html]: targets for 1040 source files that are out of date updating environment: 1040 added, 0 changed, 0 removed reading sources... [ 0%] algebras reading sources... [ 0%] arithgroup reading sources... [ 0%] calculus reading sources... [ 0%] categories reading sources... [ 0%] cmd reading sources... [ 0%] coding reading sources... [ 0%] coercion Exception occurred: File "/home/slabbe/sage-5.2/local/lib/python2.7/site-packages/Sphinx-1.1.2-py2.7.egg/sphinx/util/nodes.py", line 183, in set_role_source_info inliner.reporter.locator(lineno) AttributeError: Reporter instance has no attribute 'locator' The full traceback has been saved in /tmp/sphinx-err-TDfXeg.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! Build finished. The built documents can be found in /home/slabbe/sage-5.2/devel/sage/doc/output/html/en/reference sphinx-build -b html -d /home/slabbe/sage-5.2/devel/sage/doc/output/doctrees/en/faq -A hide_pdf_links=1 /home/slabbe/sage-5.2/devel/sage/doc/en/faq /home/slabbe/sage-5.2/devel/sage/doc/output/html/en/faq Running Sphinx v1.1.2 loading pickled environment... not yet created loading intersphinx inventory from /home/slabbe/sage-5.2/devel/sage/doc/common/python.inv... loading intersphinx inventory from /home/slabbe/sage-5.2/devel/sage/doc/output/html/en/reference/objects.inv... WARNING: intersphinx inventory '/home/slabbe/sage-5.2/devel/sage/doc/output/html/en/reference/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/home/slabbe/sage-5.2/devel/sage/doc/output/html/en/reference/objects.inv' building [html]: targets for 4 source files that are out of date updating environment: 4 added, 0 changed, 0 removed
I tested the compilation here on sage.math.
comment:3 Changed 2 years ago by slabbe
This seems to be fixed here
https://bitbucket.org/birkenfeld/sphinx/changeset/bab0b83c9e02
and available in Sphinx v1.1.3 (Mar 10, 2012).
comment:4 Changed 21 months ago by r.gaia.cs
Hi, I the problem similar to the one reported by slabbe building the documentation of sage-5.4.rc3.
comment:5 Changed 14 months ago by Snark
For your information, you'll also hit errors looking like:
[combinat ] /home/jpuydt/sage-5.9.debian/local/local/lib/python2.7/dist-packages/sage/combinat/free_module.py:docstring of sage.combinat.free_module.CombinatorialFreeModule:60: ERROR: Error in "note" directive: [combinat ] invalid option block. [combinat ] .. note:: These print options may also be accessed and modified using the [combinat ] :meth:`print_options` method, after the module has been defined.
which are explained here.
Notice also that docutils are now up to version 0.10.
comment:6 Changed 11 months ago by jdemeyer
- Milestone changed from sage-5.11 to sage-5.12
comment:7 Changed 6 months ago by vbraun_spam
- Milestone changed from sage-6.1 to sage-6.2
comment:8 Changed 3 months ago by vbraun_spam
- Milestone changed from sage-6.2 to sage-6.3
A new spkg version is here :
http://sage.math.washington.edu/home/slabbe/docutils-0.9.1.p0.spkg
I still haven't build sage from source with this new package. I will change the status to needs review once I did it.