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