docs: temporarily disable the kernel-doc extension
authorPaolo Bonzini <pbonzini@redhat.com>
Mon, 30 Nov 2020 12:16:11 +0000 (07:16 -0500)
committerPaolo Bonzini <pbonzini@redhat.com>
Thu, 10 Dec 2020 17:15:19 +0000 (12:15 -0500)
Preserve bisectability while we update scripts/kernel-doc from Linux.
Without this patch, building with Sphinx 3 would break while we
revert our own Sphinx 3 support and replace it with Linux's.

Suggested-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
docs/sphinx/kerneldoc.py

index 3ac277d1622464cc4a4bd6a274839692342e3873..9124fcbff1ba1c1aee47f92e84851f3fdb279e28 100644 (file)
@@ -75,6 +75,9 @@ class KernelDocDirective(Directive):
         # Tell sphinx of the dependency
         env.note_dependency(os.path.abspath(filename))
 
+        # Disabled temporarily while scripts/kernel-doc is updated
+        return []
+
         tab_width = self.options.get('tab-width', self.state.document.settings.tab_width)
 
         # FIXME: make this nicer and more robust against errors