Re: [PATCH] iio: tsl2772: fix all kernel-doc warnings
From: Randy Dunlap
Date: Thu Feb 26 2026 - 14:24:04 EST
On 2/26/26 12:04 AM, Andy Shevchenko 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?
They are used in drivers/iio/light/tsl2772.c.
> 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>
>
Thanks.
--
~Randy