Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> writes: > On Thu, Sep 11, 2025 at 01:23:55PM +0300, Jani Nikula wrote: >> > 1. SPHINXDIRS. It needs a lot of magic to work, both before running >> > sphinx-build and after (inside conf.py); >> >> Makes you wonder if that's the right solution to the original >> problem. It was added as a kind of hack, and it stuck. > > The problem is, IMHO, due to the lack of flexibility of sphinx-build: > It should have a way on it to do partial documentation builds. A couple of times I have looked into using intersphinx, making each book into an actually separate book. The thing I always run into is that doing a complete docs build, with working references, would require building everything twice. This is probably worth another attempt one of these years... jon
