[PATCH v3 2/8] PM: runtime: More kerneldoc formatting
From: Brian Norris
Date: Tue Sep 29 2026 - 22:54:37 EST
In taking another pass at these docs, I found some more inconsistencies.
Signed-off-by: Brian Norris <briannorris@xxxxxxxxxxxx>
---
Changes in v3:
* Wrap/shorten differently
* Resolve a few other inconsistencies with a similar pattern
Changes in v2:
* New in v2
drivers/base/power/runtime.c | 10 +++-------
1 file changed, 3 insertions(+), 7 deletions(-)
diff --git a/drivers/base/power/runtime.c b/drivers/base/power/runtime.c
index 7e75f6d5df07..00d1981763b6 100644
--- a/drivers/base/power/runtime.c
+++ b/drivers/base/power/runtime.c
@@ -1254,12 +1254,11 @@ static int pm_runtime_get_conditional(struct device *dev, bool ign_usage_count)
}
/**
- * pm_runtime_get_if_active - Bump up runtime PM usage counter if the device is
- * in active state
+ * pm_runtime_get_if_active - Conditionally bump up runtime PM usage counter.
* @dev: Target device.
*
* Increment the runtime PM usage counter of @dev if its runtime PM status is
- * already %RPM_ACTIVE
+ * already %RPM_ACTIVE.
*
* Return:
* * %-EINVAL: Runtime PM is disabled for @dev. The usage counter is not incremented.
@@ -1607,7 +1606,6 @@ static void pm_runtime_set_suspended_action(void *data)
/**
* devm_pm_runtime_set_active_enabled - set_active version of devm_pm_runtime_enable.
- *
* @dev: Device to handle.
*/
int devm_pm_runtime_set_active_enabled(struct device *dev)
@@ -1634,11 +1632,10 @@ static void pm_runtime_disable_action(void *data)
/**
* devm_pm_runtime_enable - devres-enabled version of pm_runtime_enable.
+ * @dev: Device to handle.
*
* NOTE: this will also handle calling pm_runtime_dont_use_autosuspend() for
* you at driver exit time if needed.
- *
- * @dev: Device to handle.
*/
int devm_pm_runtime_enable(struct device *dev)
{
@@ -1655,7 +1652,6 @@ static void pm_runtime_put_noidle_action(void *data)
/**
* devm_pm_runtime_get_noresume - devres-enabled version of pm_runtime_get_noresume.
- *
* @dev: Device to handle.
*/
int devm_pm_runtime_get_noresume(struct device *dev)
--
2.56.0.rc1.315.gc6ed9934b7-goog