diff --git a/CHANGES b/CHANGES index 910b11fee..43600a147 100644 --- a/CHANGES +++ b/CHANGES @@ -1,6 +1,9 @@ Release 1.2 (in development) ============================ +* PR#108: Add experimental support for parallel building with a new + :option:`-j` option. + * #1070: Avoid un-pickling issues when running Python 3 and the saved environment was created under Python 2. diff --git a/doc/invocation.rst b/doc/invocation.rst index 4cfa48433..c6125ecc5 100644 --- a/doc/invocation.rst +++ b/doc/invocation.rst @@ -96,6 +96,15 @@ The :program:`sphinx-build` script has several options: the build directory; with this option you can select a different cache directory (the doctrees can be shared between all builders). +.. option:: -j N + + Distribute the build over *N* processes in parallel, to make building on + multiprocessor machines more effective. Note that not all parts and not all + builders of Sphinx can be parallelized. + + .. versionadded:: 1.2 + This option should be considered *experimental*. + .. option:: -c path Don't look for the :file:`conf.py` in the source directory, but use the given