Re: [PATCH] scripts: kernel-doc: Report excess struct member descriptions

From: Kees Cook
Date: Thu Dec 14 2023 - 20:01:50 EST


On Thu, Dec 14, 2023 at 04:21:17PM -0800, Randy Dunlap wrote:
> Hi Kees,
>
> On 12/14/23 16:14, Kees Cook wrote:
> > While missing descriptions were already be reported, missing struct
> > members were not. For example, previously this output was empty, but now
> > produces:
> >
> > $ ./scripts/kernel-doc -none ./drivers/leds/leds-mlxreg.c
> > ./drivers/leds/leds-mlxreg.c:42: warning: Excess struct member 'led_data' description in 'mlxreg_led_data'
>
> I just made a patch with similar functionality last night:
>
> https://lore.kernel.org/linux-doc/20231214070200.24405-1-rdunlap@xxxxxxxxxxxxx/

Ah-ha! So you're as confused as me about where the robot was getting
warnings from! Your patch is better.

-Kees

--
Kees Cook