#14204: Building unchanged documentation takes very long
----------------------------+-----------------------------------------------
Reporter: jdemeyer | Owner: GeorgSWeber
Type: defect | Status: new
Priority: blocker | Milestone: sage-5.8
Component: build | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: | Merged in:
Dependencies: | Stopgaps:
----------------------------+-----------------------------------------------
Changes (by jhpalmieri):
* cc: vbraun, hivert (added)
Comment:
I don't know. I think there are 74 documents that need to be built: 56
modules in the reference manual, 1 master reference manual doc, and 17
others. When you run `make doc`, 57 of those get built twice. For each
build, on my machine, it takes 6 seconds to run Sphinx and decide that
nothing needs to be done. This all adds up.
I wonder if it could be sped up much by calling Sphinx internally in
Python, instead of as a command-line call each time. Otherwise, I don't
have any ideas. Users should be advised to run `sage --docbuild
reference/algebras html`, etc., rather than rebuilding the full reference
manual. They should also be advised to buy a machine with lots of cores
and set `MAKE=make -jN` for some large number `N` :)
Should this really be a blocker?
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14204#comment:1>
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?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
