[Python-checkins] Speedup: build docs in parallel (GH-92733)

miss-islington webhook-mailer at python.org
Mon May 16 08:17:45 EDT 2022


https://github.com/python/cpython/commit/2ef6a986ee7e59461578f7847695f29d0fe1d065
commit: 2ef6a986ee7e59461578f7847695f29d0fe1d065
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-05-16T05:17:20-07:00
summary:

Speedup: build docs in parallel (GH-92733)

(cherry picked from commit a487623c6b784847a8a1e47b4597b0ae2b8def87)

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

files:
M .github/workflows/doc.yml
M Doc/Makefile

diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
index 0d1b85d84746a..8c4a034896126 100644
--- 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 at v3
       with:
diff --git a/Doc/Makefile b/Doc/Makefile
index 8a757a68b6f52..5b6a95813abee 100644
--- 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 \



More information about the Python-checkins mailing list