On Thu, 05 Sep 2024, "Bernhard M. Wiedemann" <bwiedemann@xxxxxxx> wrote: > On 05/09/2024 14.04, Jani Nikula wrote: >> On Thu, 05 Sep 2024, bernhard+linux-doc@xxxxxxxx wrote: >>> From: "Bernhard M. Wiedemann" <bwiedemann@xxxxxxx> >>> >>> Because we want reproducible builds >>> and https://github.com/sphinx-doc/sphinx/issues/6714 >>> did not receive any love from Sphinx devs in five years, >>> let's disable parallel doc builds until that Sphinx issue is fixed. >> >> You mention in [1] that this is likely a duplicate of [2] i.e. multiple >> Sphinx instances running in parallel and racing in doctree access. >> >> In kernel, does the issue then boil down to: >> >> htmldocs: >> @$(srctree)/scripts/sphinx-pre-install --version-check >> @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,html,$(var),,$(var))) >> >> i.e. multiple Sphinx invocations instead of just one? > > If that is the case, then providing a unique doctree dir to each > invocation should also help. I'm not sure that's a good idea, because IIUC there should be one doctree. > However my patch for sphinx -j1 did give good test results, too. > Maybe in your case that would result in 8 sphinx calls with 1 thread > each, which would be more appropriate for your machine. The right thing to do is to have one sphinx-build process and pass -j<N> to that. BR, Jani. -- Jani Nikula, Intel
