Re: [PATCH] iio: dac: ad5686: fix channels member name in kernel-doc

From: Nuno Sá

Date: Thu Oct 15 2026 - 04:44:04 EST


On Sun, Oct 11, 2026 at 10:21:47AM +0530, Arnav Kapoor wrote:
> The kernel-doc for struct ad5686_chip_info describes a member called
> @channel, but the member is named channels. W=1 builds report:
>
> Warning: drivers/iio/dac/ad5686.h:95 struct member 'channels' not
> described in 'ad5686_chip_info'
> Warning: drivers/iio/dac/ad5686.h:95 Excess struct member 'channel'
> description in 'ad5686_chip_info'
>
> Rename the entry to match the struct member.
>
> Fixes: 0357e488b825 ("iio:dac:ad5686: Refactor the driver")
> Assisted-by: LLM
> Signed-off-by: Arnav Kapoor <kapoorarnav43@xxxxxxxxx>
> ---

Reviewed-by: Nuno Sá <nuno.sa@xxxxxxxxxx>

> Comment-only change, checked with scripts/kernel-doc -Wall.
>
> drivers/iio/dac/ad5686.h | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/drivers/iio/dac/ad5686.h b/drivers/iio/dac/ad5686.h
> index 482bc70515f7..4f2ac1e96643 100644
> --- a/drivers/iio/dac/ad5686.h
> +++ b/drivers/iio/dac/ad5686.h
> @@ -85,7 +85,7 @@ struct ad5686_bus_ops {
> * struct ad5686_chip_info - chip specific information
> * @int_vref_mv: the internal reference voltage
> * @num_channels: number of channels
> - * @channel: channel specification
> + * @channels: channel specification
> * @regmap_type: register map layout variant
> */
> struct ad5686_chip_info {
> --
> 2.53.0
>