Re: [PATCH] iio: tsl2772: fix all kernel-doc warnings

[Jonathan Cameron]

On Thu, 26 Feb 2026 10:04:53 +0200
Andy Shevchenko <andriy.shevchenko@xxxxxxxxx> wrote:

> On Wed, Feb 25, 2026 at 09:12:57PM -0800, Randy Dunlap wrote:
> > Use the correct kernel-doc notation for struct members to eliminate
> > kernel-doc warnings:
> > 
> > Warning: include/linux/platform_data/tsl2772.h:88 struct member
> >  'prox_diode' not described in 'tsl2772_settings'
> > Warning: include/linux/platform_data/tsl2772.h:88 struct member
> >  'prox_power' not described in 'tsl2772_settings'  
> 
> Hmm... I do not see any of the user of this header file.
> Have you checked if these values are even used?
> Perhaps we can simply kill all this?
> 
> But if Jonathan wants to take this as a quick fix to make less
> warnings appear effective immediately I'm fine with the change
> Reviewed-by: Andy Shevchenko <andriy.shevchenko@xxxxxxxxx>
I've picked it up because even if we do rip out platform data support
it's likely the structures will remain and then we'll want them
to have correctly formatted docs

So applied

Thanks,

Jonathan

>