Re: [PATCH v4 08/19] tools/docs: sphinx-build-wrapper: add a wrapper for sphinx-build

[Jani Nikula <jani.nikula@linux.intel.com>]

On Mon, 15 Sep 2025, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> IMHO, long term solution is to change SPHINXDIRS into something
> like:
>
> 	make O=doc_build SPHINXTITLE="Media docs" SPHINXDIRS="admin-guide/media userspace-api/media driver-api/media/"
>
> would create something similar to this(*):
>
> 	doc_build/sphindirs/
> 		|
> 		+--> index.rst
> 		+--> admin-guide -> {srcdir}/Documentation/admin-guide/media/
> 		+--> usespace-api -> {srcdir}/Documentation/admin-guide/media/
> 		\--> driver-api -> {srcdir}/Documentation/admin-guide/media/

So you're basically suggesting the documentation build should support
cherry-picking parts of the documentation with categories different from
what the upstream documentation has? I.e. even if we figured out how to
do intersphinx books, you'd want to grab parts from them and turn them
into something else?

Ugh.


BR,
Jani.


-- 
Jani Nikula, Intel