#6495: Build the reference manual incrementally
-----------------------------------------------+----------------------------
Reporter: mpatel | Owner: tba
Type: enhancement | Status: needs_work
Priority: major | Milestone: sage-5.0
Component: documentation | Resolution:
Keywords: | Work issues: citations
Report Upstream: N/A | Reviewers: Volker Braun
Authors: Mitesh Patel, John Palmieri | Merged in:
Dependencies: #12016 | Stopgaps:
-----------------------------------------------+----------------------------
Comment (by hivert):
This is an ''extremely'' useful patch which should go in Sage ASAP. It
effectively reduce the compilation time to 10min on my I7 laptop. This is
brilliant. It will certainly prove more maintainable in the long term than
my
parallelization of Sphinx expertiment. Though, I think we should discuss
of is
with Georges Brandl (the maintainer of Sphinx).
I'm now reviewing the code itself. You'll find below some comments.
Florent
'''Suggestion of improvement''':
- I think we should get rid of the warning on the first pass, maybe by
patching a little bit intersphinx. Also, now the compilation is a lot
more
verbose. Maybe we should silent the info for loading the bunch of
intersphinx load at least in {{{reference/*}}}. If you agree with the
idea,
I'm Ok to look at this one.
- Some directories are much longer than the other (eg: combinat) they
should
be launched first (or maybe in this case broken in even smaller parts).
This
could wait for another ticket.
'''Some remaining problems''':
- Interrupting the compilation with {{{ctrl+C}}} doesn't work. I had to
kill
by hand the master compilation process. I'm not sure what we can do for
solving this problem.
- On the main page, you managed to gather the todos which is great ! Is it
possible to do the same for the index (mine is empty). The module index
is
moreover broken.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:58>
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.
