Re: [PATCH v3] scripts/kernel-doc: Suggest possible names for excess descriptions

[Knop, Ryszard]

On Fri, 2026-07-31 at 12:19 +0900, Akira Yokosawa wrote:
> 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.

Yeah, my fault :( Submitted "scripts/kernel-doc: Fix kdoc for Python
3.9-3.11" with a bugfix and tested it by:

uv run --python 3.9 --with sphinx,pyyaml make htmldocs

> 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

Thanks, Ryszard