#18497: Update Sphinx to 1.3.1
-------------------------------------+-------------------------------------
Reporter: aapitzsch | Owner:
Type: enhancement | Status: needs_info
Priority: major | Milestone: sage-6.9
Component: packages: | Resolution:
standard | Merged in:
Keywords: python3 | Reviewers:
Authors: | Work issues:
Report Upstream: N/A | Commit:
Branch: | 832afb701cfaf6b19a446a0d643ab58b3e5d3808
u/aapitzsch/ticket/18497 | Stopgaps:
Dependencies: #17313 |
-------------------------------------+-------------------------------------
Comment (by jhpalmieri):
This works for me, but not perfectly. In addition to the changes here, I
used `sage --pip install` to install `snowballstemmer` and `alabaster`. I
also had to change `exclude_trees` to `exclude_patterns` wherever it
occurred in doc/common: `exclude_trees` was deprecated before and has now
been removed. (This was in `src/doc/common/conf.py`,
`src/doc/en/reference/conf.py`, `src/doc/en/reference/conf_sub.py`.)
I ran into the issue mentioned in comment:3, so I made those references
more explicit (changed `_blah` to `Category._blah`, etc.). Then the file
`sage/lfunctions/zero_sums.pyx` was giving me errors I didn't understand,
for example
{{{
OSError: [lfunction] docstring of
sage.lfunctions.zero_sums.LFunctionZeroSum_EllipticCurve:0: ERROR: Unknown
interpreted text role "class".
}}}
So I removed it from the reference manual. I'll keep looking at that file,
though.
Then in the second pass through the reference manual, the build stopped
with complaints about missing references or citations. Maybe Sphinx is
pickier now, and wants the reference before any citations to it, so I
moved some of them to the top-level docstring in the file, and that
helped. There is a few cross-file references, and I don't know what to do
about that one except to run Sphinx again and hope it resolves the
reference. The build completed this way.
By the way, Sphinx 1.3.2 (a bug-fix release) is supposed to be released in
a few days.
--
Ticket URL: <http://trac.sagemath.org/ticket/18497#comment:10>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
