Hi, On Fri, 9 Feb 2024 15:47:16 +0100, Vegard Nossum wrote: > On 30/01/2024 17:23, Vegard Nossum wrote: >> We should still fix the writing of .rst to $(srctree), though -- our >> use of parse-headers.pl seems to sidestep this by writing the >> intermediate .rst output to Documentation/output/, I'll have to look >> a bit more closely. > > I have now spent quite a bit of time investigating this. > > The main result is that Sphinx really does NOT like it when documents > are located outside of the source root. There is a hack extension named "kernel_include". See Documentation/sphinx/kernel_include.py (no, I'm not saying I understand it.) The "kernel-include::" directive is exploited only in Documentation/userspace-api/media/dvb/headers.rst. I have no idea if Jon is happy to see another subsystem to start exploiting this extension. And you should be interested in seeing Documentation/userspace-api/media/Makefile and how it is integrated into Documentation/Makefile. I think media people are doing similar things you'd like to do. HTH, Akira
