#6495: Build the reference manual incrementally
---------------------------------------------------------------+------------
       Reporter:  mpatel                                       |         Owner: 
 jdemeyer                    
           Type:  enhancement                                  |        Status: 
 needs_work                  
       Priority:  major                                        |     Milestone: 
 sage-5.7                    
      Component:  documentation                                |    Resolution: 
                             
       Keywords:  days38                                       |   Work issues: 
                             
Report Upstream:  N/A                                          |     Reviewers: 
 Volker Braun, Florent Hivert
        Authors:  Mitesh Patel, John Palmieri, Florent Hivert  |     Merged in: 
                             
   Dependencies:  #13143, #12719                               |      Stopgaps: 
                             
---------------------------------------------------------------+------------

Comment (by vbraun):

 The issue was indeed that the object inventory was written to and read
 from parallel processes. Sphinx makes no attempt to update the
 `object.inv` atomically.

 I've changed things such that
 * the inventory build process outputs to `output/inventory` and does not
 read inventory
 * the second pass then reads the object inventory from `output/inventory`
 and writes to `output/html`

 Now I don't see any races any more. The first stage still warns
 erroneously about a few missing citations, but thats not a big deal.

 Also, the whole thing runs just shy of 200 seconds on my desktop
 (i7-3770K)
 {{{
 sage -docbuild all html
 ...
 Elapsed time: 196.5 seconds.
 Done building the documentation!
 }}}

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