[PATCH 1/1] docs: kerneldoc.py: don't use Sphinx logger

From: Mauro Carvalho Chehab
Date: Tue May 20 2025 - 01:48:05 EST


Unfortunately, currently Sphinx logger is suppressing too much, not
allowing warnings to be displayed. Disable it.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
---
Documentation/sphinx/kerneldoc.py | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Documentation/sphinx/kerneldoc.py b/Documentation/sphinx/kerneldoc.py
index b713a2c4a615..314479718a01 100644
--- a/Documentation/sphinx/kerneldoc.py
+++ b/Documentation/sphinx/kerneldoc.py
@@ -311,7 +311,11 @@ def setup_kfiles(app):
if kerneldoc_bin and kerneldoc_bin.endswith("kernel-doc.py"):
print("Using Python kernel-doc")
out_style = RestFormat()
- kfiles = KernelFiles(out_style=out_style, logger=logger)
+
+ # Ideally, we should be using Sphinx logger here, but its filtering
+ # rules ending filtering out warnings and errors. So, let's use
+ # Python default logger instead.
+ kfiles = KernelFiles(out_style=out_style)
else:
print(f"Using {kerneldoc_bin}")

--
2.49.0