Skip to contentSkip to conversation

cpuidle: Fix kernel-doc

PATCH Applied Yang Li 2 participants 2 messages Dec 10, 2021 – Dec 17, 2021

Subsystems (2)
lore
Share & tools
lore

Yang Li

author
#0 lore raw

PATCH 1/2 cpuidle: Fix kernel-doc

Fix function name in sysfs.c kernel-doc comment to remove a warning found by running scripts/kernel-doc, which is caused by using 'make W=1'.

drivers/cpuidle/sysfs.c:512: warning: expecting prototype for cpuidle_remove_driver_sysfs(). Prototype was for cpuidle_remove_state_sysfs() instead

---
 drivers/cpuidle/sysfs.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/cpuidle/sysfs.c +1 -1
index 469e18547d06..e708e593db88 100644
@@ -505,7 +505,7 @@ static int cpuidle_add_state_sysfs(struct cpuidle_device *device)
 }
 
 /**
- * cpuidle_remove_driver_sysfs - removes the cpuidle states sysfs attributes
+ * cpuidle_remove_state_sysfs - removes the cpuidle states sysfs attributes
  * @device: the target device
  */
 static void cpuidle_remove_state_sysfs(struct cpuidle_device *device)
Signature · 1 line
2.20.1.7.g153144c
maintainer Applied
#1 lore raw
Quoted 20 lines · Yang Li

Fix function name in sysfs.c kernel-doc comment to remove a warning found by running scripts/kernel-doc, which is caused by using 'make W=1'.

drivers/cpuidle/sysfs.c:512: warning: expecting prototype for cpuidle_remove_driver_sysfs(). Prototype was for cpuidle_remove_state_sysfs() instead

---
 drivers/cpuidle/sysfs.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/cpuidle/sysfs.c +0 -0
index 469e18547d06..e708e593db88 100644

drivers/cpuidle/sysfs.c static int cpuidle_add_state_sysfs(struct cpuidle_device *device)

Quoted 9 lines
drivers/cpuidle/sysfs.c +1 -2
@@ -505,7 +505,7 @@ static int cpuidle_add_state_sysfs(struct cpuidle_device *device)
 }
 
 /**
- * cpuidle_remove_driver_sysfs - removes the cpuidle states sysfs attributes
+ * cpuidle_remove_state_sysfs - removes the cpuidle states sysfs attributes
  * @device: the target device
  */
 static void cpuidle_remove_state_sysfs(struct cpuidle_device *device)
--

Applied as 5.17 under a more precise subject ("cpuidle: Fix cpuidle_remove_state_sysfs() kerneldoc comment").

When you submit changes like this in the future, please always make the subject precise enough to allow the given change to be easily distinguished from other changes in the same category.

Thanks!