#14204: Building unchanged documentation takes very long
----------------------------------+-----------------------------------------
       Reporter:  jdemeyer        |         Owner:  jdemeyer      
           Type:  defect          |        Status:  closed        
       Priority:  blocker         |     Milestone:  sage-5.8      
      Component:  build           |    Resolution:  fixed         
       Keywords:                  |   Work issues:                
Report Upstream:  N/A             |     Reviewers:  John Palmieri 
        Authors:  Jeroen Demeyer  |     Merged in:  sage-5.8.beta4
   Dependencies:                  |      Stopgaps:                
----------------------------------+-----------------------------------------

Comment (by jhpalmieri):

 All the more reason to set `MAKE` so it uses multiple threads! On my (not
 reasonably modern) OS X machine, rebuilding the documentation after
 modifying one file, with `MAKE` unset, takes
 {{{
 real    2m44.637s
 user    2m7.278s
 sys     0m22.776s
 }}}
 With `MAKE` set to use two cores:
 {{{
 real    1m55.552s
 user    2m12.224s
 sys     0m24.907s
 }}}
 On sage.math, with `MAKE='make -j12'`:
 {{{
 real    0m34.899s
 user    1m34.650s
 sys     0m16.800s
 }}}
 So using multiple cores is very advantageous. Note also that if you are
 only modifying a single file, be aware that you can do
 {{{
 sage --docbuild reference/homology html
 }}}
 (or `reference/combinat` or `reference/matrices` or ...). This will be
 very fast (except when rebuilding the `combinat` docs ;), even with a
 single core.

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14204#comment:26>
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.


Reply via email to