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

From: Jonathan Corbet

Date: Thu Jul 16 2026 - 18:40:06 EST


Ryszard Knop <ryszard.knop@xxxxxxxxx> writes:

> Since check_sections() now warns if a documentation tag member name is
> the same as defined in the struct, we can suggest names the checker
> knows, so that it's more obvious how to deal with the warning.
>
> Signed-off-by: Ryszard Knop <ryszard.knop@xxxxxxxxx>
> ---
> tools/lib/python/kdoc/kdoc_parser.py | 13 +++++++++++--
> 1 file changed, 11 insertions(+), 2 deletions(-)

So I almost applied this version of this patch. For future reference,
please:

- Post new versions standalone, not as a reply

- Do not include version information in the changelog (put it below the
"---" line)

- Provide a more coherent changelog; the one above does not say what is
actually going on here.

- CC the maintainer (me).

Thanks,

jon