Re: [PATCH] counter: linux/counter.h: fix Excess kernel-doc description warning

From: Randy Dunlap
Date: Wed Dec 27 2023 - 16:40:14 EST




On 12/27/23 06:35, William Breathitt Gray wrote:
> On Fri, Dec 22, 2023 at 09:05:11PM -0800, Randy Dunlap wrote:
>> Remove the @priv: line to prevent the kernel-doc warning:
>>
>> include/linux/counter.h:400: warning: Excess struct member 'priv' description in 'counter_device'
>>
>> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
>> Cc: William Breathitt Gray <william.gray@xxxxxxxxxx>
>> Cc: linux-iio@xxxxxxxxxxxxxxx
>> ---
>> include/linux/counter.h | 1 -
>> 1 file changed, 1 deletion(-)
>>
>> diff -- a/include/linux/counter.h b/include/linux/counter.h
>> --- a/include/linux/counter.h
>> +++ b/include/linux/counter.h
>> @@ -359,7 +359,6 @@ struct counter_ops {
>> * @num_counts: number of Counts specified in @counts
>> * @ext: optional array of Counter device extensions
>> * @num_ext: number of Counter device extensions specified in @ext
>> - * @priv: optional private data supplied by driver
>> * @dev: internal device structure
>> * @chrdev: internal character device structure
>> * @events_list: list of current watching Counter events
>
> Hi Randy,
>
> Would you provide a Fixes tag for the commit that removed the 'priv'
> member so we can track when this warning appeared? You can respond with
> it to this thread and I'll add it in when I merge your patch.

Fixes: f2ee4759fb70 ("counter: remove old and now unused registration API")

Thank you.

--
#Randy