#6495: Build the reference manual incrementally
---------------------------------------------------------------+------------
Reporter: mpatel | Owner:
tba
Type: enhancement | Status:
needs_review
Priority: major | Milestone:
sage-pending
Component: documentation | Resolution:
Keywords: days38 | Work issues:
Report Upstream: N/A | Reviewers:
Volker Braun
Authors: Mitesh Patel, John Palmieri, Florent Hivert | Merged in:
Dependencies: #13143 | Stopgaps:
---------------------------------------------------------------+------------
Comment (by jhpalmieri):
I think our Sphinx package needs some work. In particular, the file
`SAGE_ROOT/devel/sage/common/sage-autodoc.py` should be part of the Sphinx
package, built by patching Sphinx's `autodoc.py`. This would make it
easier to incorporate modifications to `autodoc.py`. I don't know if this
has to do with the problems with using Sphinx 1.2, but it might.
It's probably also not a good idea to use Sphinx's parallel building at
the same time as ours, or else we'll be using more threads than we
intended: maybe building 8 pieces of documentation at the same time, and
then writing each of those using 8 processes. That sounds like a bad idea
to me.
Having said all of that, do the errors you get suggest problems with our
parallel code?
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:146>
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
