docs: kernel_include.py: add sphinx build dependencies
authorMauro Carvalho Chehab <mchehab@kernel.org>
Sat, 26 Mar 2022 10:27:22 +0000 (11:27 +0100)
committerJonathan Corbet <corbet@lwn.net>
Mon, 28 Mar 2022 19:53:46 +0000 (13:53 -0600)
The files included by kernel-include should be added as build
dependencies, in order for sphinx-build to rebuild the corresponding
docs if any changes at the included file happens.

Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Link: https://lore.kernel.org/r/d30fc4fa422a13b7e1623d690945c46b58a55e79.1648290305.git.mchehab@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/sphinx/kernel_include.py

index f523aa68a36b397b3c6f12998ec597c28e7ad69a..abe7680883771d49b72d7f382b45ca3e2514df7f 100755 (executable)
@@ -59,6 +59,7 @@ class KernelInclude(Include):
     u"""KernelInclude (``kernel-include``) directive"""
 
     def run(self):
+        env = self.state.document.settings.env
         path = os.path.realpath(
             os.path.expandvars(self.arguments[0]))
 
@@ -70,6 +71,8 @@ class KernelInclude(Include):
 
         self.arguments[0] = path
 
+        env.note_dependency(os.path.abspath(path))
+
         #return super(KernelInclude, self).run() # won't work, see HINTs in _run()
         return self._run()