[PATCH] local_lock: fix all kernel-doc warnings

From: Randy Dunlap

Date: Fri Nov 28 2025 - 01:59:26 EST


Modify kernel-doc comments in local_lock.h to prevent warnings:

Warning: include/linux/local_lock.h:9 function parameter 'lock' not
described in 'local_lock_init'
Warning: include/linux/local_lock.h:56 function parameter 'lock' not
described in 'local_trylock_init'
Warning: include/linux/local_lock.h:56 expecting prototype for
local_lock_init(). Prototype was for local_trylock_init() instead

Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
---
Cc: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
Cc: Thomas Gleixner <tglx@xxxxxxxxxxxxx>
Cc: Peter Zijlstra <peterz@xxxxxxxxxxxxx>
Cc: Ingo Molnar <mingo@xxxxxxxxxx>
Cc: Will Deacon <will@xxxxxxxxxx>
Cc: Waiman Long <longman@xxxxxxxxxx>
---
include/linux/local_lock.h | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)

--- linux-next-20251127.orig/include/linux/local_lock.h
+++ linux-next-20251127/include/linux/local_lock.h
@@ -6,6 +6,7 @@

/**
* local_lock_init - Runtime initialize a lock instance
+ * @lock: The lock variable
*/
#define local_lock_init(lock) __local_lock_init(lock)

@@ -52,7 +53,8 @@
__local_unlock_irqrestore(this_cpu_ptr(lock), flags)

/**
- * local_lock_init - Runtime initialize a lock instance
+ * local_trylock_init - Runtime initialize a lock instance
+ * @lock: The lock variable
*/
#define local_trylock_init(lock) __local_trylock_init(lock)