Re: [PATCH v4 00/19] Split sphinx call logic from docs Makefile

From: Jonathan Corbet
Date: Fri Sep 05 2025 - 12:08:11 EST


Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> writes:

> This series does a major cleanup at docs Makefile by moving the
> actual doc build logic to a helper script (scripts/sphinx-build-wrapper).
>
> Such script was written in a way that it can be called either
> directly or via a makefile. When running via makefile, it will
> use GNU jobserver to ensure that, when sphinx-build is
> called, the number of jobs will match at most what it is
> specified by the "-j" parameter.

I will try to make another pass over this stuff later today. I would
really appreciate some more eyes on it, though, and perhaps even some
reports of testing. This is a significant change, and the presence of
surprised would not be ... surprising ...

Thanks,

jon