[tip: sched/core] sched/wait: correct kernel-doc descriptions

tip-bot2 for Randy Dunlap posted 1 patch 3 weeks, 5 days ago
include/linux/wait_bit.h | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
[tip: sched/core] sched/wait: correct kernel-doc descriptions
Posted by tip-bot2 for Randy Dunlap 3 weeks, 5 days ago
The following commit has been merged into the sched/core branch of tip:

Commit-ID:     49b76317592ecbaefd0969d51d02019966cc994b
Gitweb:        https://git.kernel.org/tip/49b76317592ecbaefd0969d51d02019966cc994b
Author:        Randy Dunlap <rdunlap@infradead.org>
AuthorDate:    Sun, 01 Mar 2026 16:52:37 -08:00
Committer:     Peter Zijlstra <peterz@infradead.org>
CommitterDate: Thu, 12 Mar 2026 07:47:36 +01:00

sched/wait: correct kernel-doc descriptions

Use the correct function name and function parameter name to avoid
these kernel-doc warnings:

Warning: include/linux/wait_bit.h:424 expecting prototype for
 wait_var_event_killable(). Prototype was for
 wait_var_event_interruptible() instead
Warning: include/linux/wait_bit.h:508 function parameter 'lock' not
 described in 'wait_var_event_mutex'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org>
Link: https://patch.msgid.link/20260302005237.3473095-1-rdunlap@infradead.org
---
 include/linux/wait_bit.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/include/linux/wait_bit.h b/include/linux/wait_bit.h
index 9e29d79..ace7379 100644
--- a/include/linux/wait_bit.h
+++ b/include/linux/wait_bit.h
@@ -406,7 +406,7 @@ do {									\
 			  schedule())
 
 /**
- * wait_var_event_killable - wait for a variable to be updated and notified
+ * wait_var_event_interruptible - wait for a variable to be updated and notified
  * @var: the address of variable being waited on
  * @condition: the condition to wait for
  *
@@ -492,7 +492,7 @@ do {									\
  * wait_var_event_mutex - wait for a variable to be updated under a mutex
  * @var: the address of the variable being waited on
  * @condition: condition to wait for
- * @mutex: the mutex which protects updates to the variable
+ * @lock: the mutex which protects updates to the variable
  *
  * Wait for a condition which can only be reliably tested while holding
  * a mutex.  The variables assessed in the condition will normal be