@hugovk Should we backport to 3.9 and 3.10 too? -j auto was added in Sphinx 1.7, so I don't believe there would be any compatability concerns.

A

Yes, labels added.

I'll have to dig into this a bit later, but at first glance it can't be backported to 3.9. I don't remember all the details but in 3.9 we used a non-compatibile sphinx extention (in pyspecific.py). It has been fixed around 3.10.

That's why on docs.python.org we only use parallel builds since 3.10:

https://github.com/python/docsbuild-scripts/blob/30b98030d78db56b28f8590b877f3c33f79b913d/build_docs.py#L197

We'll also have to check how it goes with the already present -j4 in build_docs.py, (Yes I'll gladly drop the flag in build_docs.py to use the one from the cpython Makefile).

I'll have to dig into this a bit later, but at first glance it can't be backported to 3.9. I don't remember all the details but in 3.9 we used a non-compatibile sphinx extention (in pyspecific.py). It has been fixed around 3.10.

That's why on docs.python.org we only use parallel builds since 3.10:

python/docsbuild-scripts@30b9803/build_docs.py#L197

Thanks, let's keep it simple and drop the 3.9 backport, this change is mainly beneficial for developers building docs, and I expect that will mostly be main and newer versions.

We'll also have to check how it goes with the already present -j4 in build_docs.py, (Yes I'll gladly drop the flag in build_docs.py to use the one from the cpython Makefile).

Yep, what's a good way to check it?

Yep, what's a good way to check it?

By running make SPHINXOPTS="-j4" autobuild-dev-html which is mostly what docsbuild-scripts does.

And it goes well, so it looks good to me. It starts sphinx-build -b html -d build/doctrees -j auto -j4 -Ea -A daily=1 -W . build/html.

we'll just have to remove the -j4 from docsbuild scripts once its merged, but in the meantime sphinx is not surprised by the presence of two -js.

Thanks @hugovk for the PR, and @JulienPalard for merging it 🌮🎉.. I'm working now to backport this PR to: 3.10, 3.11.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

Sorry, @hugovk and @JulienPalard, I could not cleanly backport this to 3.10 due to a conflict.
Please backport using cherry_picker on command line.
cherry_picker a487623c6b784847a8a1e47b4597b0ae2b8def87 3.10

GH-92847 is a backport of this pull request to the 3.11 branch.

GH-92850 is a backport of this pull request to the 3.10 branch.

Flag drop from build_docs.py: python/docsbuild-scripts#129