Re: [PATCH v3] scripts/kernel-doc: Suggest possible names for excess descriptions
Akira Yokosawa <[email protected]> Fri, 31 Jul 2026 12:19:41 +0900
| Newsgroups | org.freedesktop.lists.intel-xe,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <[email protected]> |
Hi,
Daily linux-next documentation build at https://www.kernel.org/doc/html/next/
has stopped working since July 23.
In my bisection using a debian bookworm container (python 3.11.2 +
sphinx 5.3.0), this patch, which is now commit d7758384ccb4
("scripts/kernel-doc: Suggest possible names for excess descriptions"),
is blamed as the first bad commit. Reverting it resolves the build
error.
Error message from "make htmldocs" looks like this:
--------------------------------------------------------
Exception occurred:
File "/linux/tools/lib/python/kdoc/kdoc_files.py", line 16, in <module>
from kdoc.kdoc_parser import KernelDoc
File "/linux/tools/lib/python/kdoc/kdoc_parser.py", line 604
return f"(did you mean one of: '{"', '".join(suggestions)}')"
^
SyntaxError: f-string: expecting '}'
--------------------------------------------------------
I think this needs python3 3.12 or better.
Can you make this script compatible with python3 3.9, which is the
minimal version listed in Documentation/process/changes.rst?
Thanks, Akira