[PATCH] mfd: tps6105x: fix kernel-doc warnings

Randy Dunlap posted 1 patch 2 months, 2 weeks ago
include/linux/mfd/tps6105x.h |    5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
[PATCH] mfd: tps6105x: fix kernel-doc warnings
Posted by Randy Dunlap 2 months, 2 weeks ago
Fix spelling of an enum to fix a kernel-doc warning.
Fix kernel-doc of struct tps6105x to prevent kernel-doc warnings.

Warning: include/linux/mfd/tps6105x.h:68 Enum value 'TPS6105X_MODE_TORCH'
 not described in enum 'tps6105x_mode'
Warning: include/linux/mfd/tps6105x.h:68 Excess enum value
 '%TPS61905X_MODE_TORCH' description in 'tps6105x_mode'
Warning: include/linux/mfd/tps6105x.h:93 struct member 'pdata'
 not described in 'tps6105x'
Warning: include/linux/mfd/tps6105x.h:93 struct member 'client'
 not described in 'tps6105x'

Fixes: 798a8eee44da ("mfd: Add a core driver for TI TPS61050/TPS61052 chips v2")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Linus Walleij <linus.walleij@linaro.org>
Cc: Samuel Ortiz <sameo@linux.intel.com>
Cc: Lee Jones <lee@kernel.org>
---
 include/linux/mfd/tps6105x.h |    5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

--- linux-next-20251016.orig/include/linux/mfd/tps6105x.h
+++ linux-next-20251016/include/linux/mfd/tps6105x.h
@@ -53,7 +53,7 @@
 /**
  * enum tps6105x_mode - desired mode for the TPS6105x
  * @TPS6105X_MODE_SHUTDOWN: this instance is inactive, not used for anything
- * @TPS61905X_MODE_TORCH: this instance is used as a LED, usually a while
+ * @TPS6105X_MODE_TORCH: this instance is used as a LED, usually a while
  *	LED, for example as backlight or flashlight. If this is set, the
  *	TPS6105X will register to the LED framework
  * @TPS6105X_MODE_TORCH_FLASH: this instance is used as a flashgun, usually
@@ -82,7 +82,8 @@ struct tps6105x_platform_data {
 
 /**
  * struct tps6105x - state holder for the TPS6105x drivers
- * @i2c_client: corresponding I2C client
+ * @pdata: associated platform data
+ * @client: corresponding I2C client
  * @regulator: regulator device if used in voltage mode
  * @regmap: used for i2c communcation on accessing registers
  */
Re: (subset) [PATCH] mfd: tps6105x: fix kernel-doc warnings
Posted by Lee Jones 1 month, 3 weeks ago
On Mon, 24 Nov 2025 18:27:50 -0800, Randy Dunlap wrote:
> Fix spelling of an enum to fix a kernel-doc warning.
> Fix kernel-doc of struct tps6105x to prevent kernel-doc warnings.
> 
> Warning: include/linux/mfd/tps6105x.h:68 Enum value 'TPS6105X_MODE_TORCH'
>  not described in enum 'tps6105x_mode'
> Warning: include/linux/mfd/tps6105x.h:68 Excess enum value
>  '%TPS61905X_MODE_TORCH' description in 'tps6105x_mode'
> Warning: include/linux/mfd/tps6105x.h:93 struct member 'pdata'
>  not described in 'tps6105x'
> Warning: include/linux/mfd/tps6105x.h:93 struct member 'client'
>  not described in 'tps6105x'
> 
> [...]

Applied, thanks!

[1/1] mfd: tps6105x: fix kernel-doc warnings
      commit: 3d845d25026c5b1050e927e3ee4c515977a9b490

--
Lee Jones [李琼斯]