Re: [PATCH] iio: dac: ad5686: fix channels member name in kernel-doc
From: Jonathan Cameron
Date: Sat Oct 17 2026 - 18:58:36 EST
On Thu, 15 Oct 2026 09:45:00 +0100
Nuno Sá <nuno.sa@xxxxxxxxxx> wrote:
> 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>
Applied.
>
> > 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
> >