Re: [PATCH] scripts/kernel-doc: Suggest possible names for excess descriptions
From: Knop, Ryszard
Date: Fri Jul 17 2026 - 09:12:01 EST
On Thu, 2026-07-16 at 16:40 -0600, Jonathan Corbet wrote:
> 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).
Submitted a v3 with changes Mauro requested, fixed changelog and CC'd,
but accidentally sent it again with In-Reply-To which I had in the
command last time, sorry :/
>
> Thanks,
>
> jon
Thanks, Ryszard