Re: [PATCH 1/1] scripts/sphinx-build-wrapper: allow building PDF files in parallel

[Akira Yokosawa <akiyks@gmail.com>]

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@gmail.com>
> Closes: https://lore.kernel.org/linux-doc/9b3b0430-066f-486e-89cc-00e6f1f3b096@gmail.com/
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> ---
>  scripts/sphinx-build-wrapper | 141 ++++++++++++++++++++++++++---------
>  1 file changed, 106 insertions(+), 35 deletions(-)