[PATCH v2] spmi: clean up kernel-doc in spmi.h

Randy Dunlap posted 1 patch 1 month, 3 weeks ago
include/linux/spmi.h |    3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
[PATCH v2] spmi: clean up kernel-doc in spmi.h
Posted by Randy Dunlap 1 month, 3 weeks ago
Fix all kernel-doc warnings in spmi.h:

Warning: include/linux/spmi.h:114 function parameter 'ctrl' not described
 in 'spmi_controller_put'
Warning: include/linux/spmi.h:144 struct member 'shutdown' not described
 in 'spmi_driver'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
v2: change Cc:<tab> to Cc:<space>; rebase

Cc: Stephen Boyd <sboyd@kernel.org>

 include/linux/spmi.h |    3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

--- linux-next-20260415.orig/include/linux/spmi.h
+++ linux-next-20260415/include/linux/spmi.h
@@ -109,7 +109,7 @@ struct spmi_controller *spmi_controller_
 
 /**
  * spmi_controller_put() - decrement controller refcount
- * @ctrl	SPMI controller.
+ * @ctrl:	SPMI controller.
  */
 static inline void spmi_controller_put(struct spmi_controller *ctrl)
 {
@@ -129,6 +129,7 @@ int devm_spmi_controller_add(struct devi
  *		this structure.
  * @probe:	binds this driver to a SPMI device.
  * @remove:	unbinds this driver from the SPMI device.
+ * @shutdown:	shuts down this driver.
  *
  * If PM runtime support is desired for a slave, a device driver can call
  * pm_runtime_put() from their probe() routine (and a balancing
Re: [PATCH v2] spmi: clean up kernel-doc in spmi.h
Posted by Stephen Boyd 1 week, 5 days ago
Quoting Randy Dunlap (2026-04-16 15:48:33)
> Fix all kernel-doc warnings in spmi.h:
> 
> Warning: include/linux/spmi.h:114 function parameter 'ctrl' not described
>  in 'spmi_controller_put'
> Warning: include/linux/spmi.h:144 struct member 'shutdown' not described
>  in 'spmi_driver'
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> ---

Applied to spmi-next