Make generally does not pass any options on since they're options to make, 
not to Sphinx.  We could kind of make this work by looking at MAKEFLAGS; 
 it gets messy when the user indeed intended make to run in parallel (eg., 
html and latexpdf concurrently.)


On Monday, October 13, 2014 12:37:53 AM UTC+2, Vadim Peretokin wrote:
>
> Just a note, it seems the Makefile generated (a long while ago with 
> sphinx-quicktrast) doesn't pass the -j 4 on:
>
> $ make html -j 4
> sphinx-build -b html -d _build/doctrees   . _build/html
> Running Sphinx v1.3b1
>
>
> On Monday, September 22, 2014 11:13:46 PM UTC+10, Georg Brandl wrote:
>>
>> Hi, 
>>
>> in extension of the "parallel write" feature already introduced in 1.2, 
>> I've now started on a "parallel read" functionality for 1.3. 
>>
>> It is activated by the same "-jN" flag as the parallel write.  On the 
>> Python docs (a medium size docset) parallel build now gives a 2x speedup 
>> with "-j4" on my 4-core machine. 
>>
>> I'd be grateful if you consider trying this feature out with your docs, 
>> and reporting any errors you may find. 
>>
>> A caveat: Since parallel read involves updating all sorts of inventories 
>> on the build environment object, many extensions that are not aware of 
>> parallel read will not work correctly; some may even never work. 
>>
>> Therefore extensions have to declare explicitly that they are fine with 
>> parallel read/write, see [1] for details.  Sphinx will warn you if an 
>> extension is not compatible and fall back to serial operation. 
>>
>> Please don't hesitate to give any feedback, including questions on how 
>> to adapt your extensions :) 
>>
>> cheers, 
>> Georg 
>>
>>
>> [1] http://sphinx-doc.org/latest/extdev/index.html#extension-metadata 
>>
>>
>>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" 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/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to