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


Attachment: signature.asc
Description: OpenPGP digital signature

Reply via email to