[tip: timers/core] tick/broadcast: Add kernel-doc for function parameters

[tip-bot2 for Randy Dunlap]

The following commit has been merged into the timers/core branch of tip:

Commit-ID:     4903e1ba798e4d4a9bce1eee0f0285f385d14f15
Gitweb:        https://git.kernel.org/tip/4903e1ba798e4d4a9bce1eee0f0285f385d14f15
Author:        Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
AuthorDate:    Fri, 10 Jan 2025 22:31:48 -08:00
Committer:     Thomas Gleixner <tglx@xxxxxxxxxxxxx>
CommitterDate: Wed, 15 Jan 2025 19:49:14 +01:00

tick/broadcast: Add kernel-doc for function parameters

Add kernel-doc comments for two parameters to eliminate kernel-doc warnings:

tick-broadcast.c:1026: warning: Function parameter or struct member 'bc' not described in 'tick_broadcast_setup_oneshot'
tick-broadcast.c:1026: warning: Function parameter or struct member 'from_periodic' not described in 'tick_broadcast_setup_oneshot'

Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Signed-off-by: Thomas Gleixner <tglx@xxxxxxxxxxxxx>
Link: https://lore.kernel.org/all/20250111063148.910887-1-rdunlap@xxxxxxxxxxxxx

---
 kernel/time/tick-broadcast.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/kernel/time/tick-broadcast.c b/kernel/time/tick-broadcast.c
index ed58eeb..0207868 100644
--- a/kernel/time/tick-broadcast.c
+++ b/kernel/time/tick-broadcast.c
@@ -1020,6 +1020,8 @@ static inline ktime_t tick_get_next_period(void)
 
 /**
  * tick_broadcast_setup_oneshot - setup the broadcast device
+ * @bc: the broadcast device
+ * @from_periodic: true if called from periodic mode
  */
 static void tick_broadcast_setup_oneshot(struct clock_event_device *bc,
 					 bool from_periodic)