On Mon, 18 Aug 2025 20:10:01 +0200, Mauro Carvalho Chehab wrote: > Use POSIX jobserver when available or -j<number> to run PDF > builds in parallel, restoring pdf build performance. Yet, > running it when debugging troubles is a bad idea, so, when > calling directly via command line, except if "-j" is splicitly > requested, it will serialize the build. > > With such change, a PDF doc builds now takes around 5 minutes > on a Ryzen 9 machine with 32 cpu threads: > > # Explicitly paralelize both Sphinx and LaTeX pdf builds > $ make cleandocs; time scripts/sphinx-build-wrapper pdfdocs -j 33 > > real 5m17.901s > user 15m1.499s > sys 2m31.482s > > # Use POSIX jobserver to paralelize both sphinx-build and LaTeX > $ make cleandocs; time make pdfdocs > > real 5m22.369s > user 15m9.076s > sys 2m31.419s > > # Serializes PDF build, while keeping Sphinx parallelized. > # it is equivalent of passing -jauto via command line > $ make cleandocs; time scripts/sphinx-build-wrapper pdfdocs > > real 11m20.901s > user 13m2.910s > sys 1m44.553s > Sounds promising to me! I couldn't test this because I couldn't apply your sphinx-build-wrapper series on top of docs-next. :-/ Which commit does it based on? Thanks, Akira > Reported-by: Akira Yokosawa <akiyks@xxxxxxxxx> > Closes: https://lore.kernel.org/linux-doc/9b3b0430-066f-486e-89cc-00e6f1f3b096@xxxxxxxxx/ > Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> > --- > scripts/sphinx-build-wrapper | 141 ++++++++++++++++++++++++++--------- > 1 file changed, 106 insertions(+), 35 deletions(-)
