Skip to contentSkip to conversation

iio: dac: ad5686: fix channels member name in kernel-doc

PATCH Applied Arnav Kapoor 4 participants 4 messages Oct 11 – Oct 17

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 iio: dac: ad5686: fix channels member name in kernel-doc

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

---
Comment-only change, checked with scripts/kernel-doc -Wall.

 drivers/iio/dac/ad5686.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/iio/dac/ad5686.h +1 -1
index 482bc70515f7..4f2ac1e96643 100644
@@ -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 {
Signature · 1 line
2.53.0
Reviewed-by on v1 1/1
#1 lore raw
Quoted 8 lines · CDT Arnav Kapoor

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'

Quoted 8 lines

Rename the entry to match the struct member.

Fixes 0357e488b825 ("iio:dac:ad5686: Refactor the driver")
Assisted-by LLM

---
Comment-only change, checked with scripts/kernel-doc -Wall.

Thanks,
Max

maintainer Reviewed-by on v1 1/1
#2 lore raw
In reply to Arnav Kapoor
Quoted 8 lines · Arnav Kapoor

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'

Quoted 6 lines

Rename the entry to match the struct member.

Fixes 0357e488b825 ("iio:dac:ad5686: Refactor the driver")
Assisted-by LLM

---

Quoted 21 lines

Comment-only change, checked with scripts/kernel-doc -Wall.

 drivers/iio/dac/ad5686.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/iio/dac/ad5686.h +1 -1
index 482bc70515f7..4f2ac1e96643 100644
@@ -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 {
Signature · 1 line
2.53.0
maintainer Applied
#3 lore raw
Quoted 9 lines · On Thu, 15 Oct 2026 09:45:00 +0100 Nuno Sá <[email protected]> wrote:
Quoted 8 lines · Arnav Kapoor

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'

Quoted 8 lines
Quoted 6 lines

Rename the entry to match the struct member.

Fixes 0357e488b825 ("iio:dac:ad5686: Refactor the driver")
Assisted-by LLM

---

Applied.

Quoted 22 lines
Quoted 22 lines

Comment-only change, checked with scripts/kernel-doc -Wall.

 drivers/iio/dac/ad5686.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/iio/dac/ad5686.h +1 -1
index 482bc70515f7..4f2ac1e96643 100644
@@ -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 {
Signature · 1 line
2.53.0