Re: [PATCH v8 00/24] Split sphinx call logic from docs Makefile

Jonathan Corbet
2025-09-18T19:33:55Z

Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:

>> I haven't
>> had the time to figure it out.
>
> I don't remember anymore what "subproject" really means inside
> ".. only::", block, but I guess it is meant to be used when one
> passes SPHINXDIRS.

I found myself in a similar position... it is set in
Documentation/sphinx/load_config.py, it seems a certain Mauro added that
in 2019 :) Since then, it has seemingly been cargo-culted all over the
place; I wonder if we really need it.

jo