Speedup: build docs in parallel (GH-92733)

(cherry picked from commit a487623c6b784847a8a1e47b4597b0ae2b8def87)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index 0d1b85d84746a97461e7e28cddfdcf08b5de9b7f..8c4a03489612661aca8967cfd7f48f239135096e 100644 (file)
--- a/.github/workflows/doc.yml
+++ b/.github/workflows/doc.yml
@@ -43,12 +43,12 @@ jobs:
     # Run "check doctest html" as 3 steps to get a more readable output
     # in the web UI
     - name: 'Check documentation'
-      run: make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" check
+      run: make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going" check
     # Use "xvfb-run" since some doctest tests open GUI windows
     - name: 'Run documentation doctest'
-      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" doctest
+      run: xvfb-run make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going" doctest
     - name: 'Build HTML documentation'
-      run: make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going -j4" html
+      run: make -C Doc/ PYTHON=../python SPHINXOPTS="-q -W --keep-going" html
     - name: 'Upload'
       uses: actions/upload-artifact@v3
       with:

diff --git a/Doc/Makefile b/Doc/Makefile
index 8a757a68b6f523ba5b73e700471d9f9c0617193b..5b6a95813abee59d4af0472af2928a384d92f860 100644 (file)
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -18,7 +18,7 @@ SPHINXERRORHANDLING = -W
 PAPEROPT_a4     = -D latex_elements.papersize=a4paper
 PAPEROPT_letter = -D latex_elements.papersize=letterpaper
 
-ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees $(PAPEROPT_$(PAPER)) \
+ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees $(PAPEROPT_$(PAPER)) -j auto \
                 $(SPHINXOPTS) $(SPHINXERRORHANDLING) . build/$(BUILDER) $(SOURCES)
 
 .PHONY: help build html htmlhelp latex text texinfo changes linkcheck \