tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

leds: lm3692x: Fix kernel-doc for struct lm3692x_led

Building with W=1 reports several kernel-doc warnings in
drivers/leds/leds-lm3692x.c:

Warning: leds-lm3692x.c:122 struct member 'boost_ctrl'
not described in 'lm3692x_led'
Warning: leds-lm3692x.c:122 struct member 'brightness_ctrl'
not described in 'lm3692x_led'
Warning: leds-lm3692x.c:122 struct member 'enabled'
not described in 'lm3692x_led'

These fields were added to struct lm3692x_led but the corresponding
kernel-doc comment was not updated. Convert the kernel-doc block to
use the "@member: description" style consistently and document the
boost_ctrl, brightness_ctrl and enabled fields.

This keeps the documentation in sync with the implementation and
silences the W=1 warnings.

Signed-off-by: Vivek BalachandharTN <vivek.balachandhar@gmail.com>
Link: https://patch.msgid.link/20251201042612.2099239-1-vivek.balachandhar@gmail.com
Signed-off-by: Lee Jones <lee@kernel.org>

authored by

Vivek BalachandharTN and committed by
Lee Jones 101bc85a 8f0b4cce

+3
+3
drivers/leds/leds-lm3692x.c
··· 104 104 * @regulator: LED supply regulator pointer 105 105 * @led_enable: LED sync to be enabled 106 106 * @model_id: Current device model ID enumerated 107 + * @boost_ctrl: Cached configuration for the boost control register 108 + * @brightness_ctrl: Cached configuration for brightness/brightness control 109 + * @enabled: Cached enable state of the device 107 110 */ 108 111 struct lm3692x_led { 109 112 struct mutex lock;