Re: [PATCH v8 00/24] Split sphinx call logic from docs Makefile
From: Jonathan Corbet
Date: Thu Sep 18 2025 - 15:33:55 EST
Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> 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