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