From ca09a4b91c4a977d743837419f11d7c9d373364e Mon Sep 17 00:00:00 2001 From: Anas Nashif Date: Fri, 13 Sep 2024 06:41:57 -0400 Subject: [PATCH] doc: kernel/arch: fix some wrong doxygen references Remove non-existing references and document parameters. Signed-off-by: Anas Nashif --- include/zephyr/arch/arc/v2/arcv2_irq_unit.h | 12 ++++++++---- kernel/sched.c | 2 +- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/include/zephyr/arch/arc/v2/arcv2_irq_unit.h b/include/zephyr/arch/arc/v2/arcv2_irq_unit.h index 18cb0fa2a47e57..a8f3760a21be51 100644 --- a/include/zephyr/arch/arc/v2/arcv2_irq_unit.h +++ b/include/zephyr/arch/arc/v2/arcv2_irq_unit.h @@ -199,9 +199,11 @@ bool z_arc_v2_irq_unit_is_in_isr(void) /** * @brief Sets an IRQ line to level/pulse trigger * - * Sets the IRQ line to trigger an interrupt based on the level or the - * edge of the signal. Valid values for are _ARC_V2_INT_LEVEL and + * Sets the IRQ line @p irq to trigger an interrupt based on the level or the + * edge of the signal. Valid values for @p trigger are _ARC_V2_INT_LEVEL and * _ARC_V2_INT_PULSE. + * @param irq IRQ line + * @param trigger Trigger state */ static ALWAYS_INLINE void z_arc_v2_irq_unit_trigger_set(int irq, unsigned int trigger) @@ -217,8 +219,10 @@ void z_arc_v2_irq_unit_trigger_set(int irq, unsigned int trigger) /** * @brief Returns an IRQ line trigger type * - * Gets the IRQ line trigger type. - * Valid values for are _ARC_V2_INT_LEVEL and _ARC_V2_INT_PULSE. + * Gets the IRQ line @p irq trigger type. + * Valid values for @retval trigger are _ARC_V2_INT_LEVEL and _ARC_V2_INT_PULSE. + * + * @param irq IRQ line * * @return trigger state */ diff --git a/kernel/sched.c b/kernel/sched.c index 0740d25686b461..6f57bd9558948b 100644 --- a/kernel/sched.c +++ b/kernel/sched.c @@ -905,7 +905,7 @@ static inline void set_current(struct k_thread *new_thread) * function. * * @warning - * The @ref _current value may have changed after this call and not refer + * The _current value may have changed after this call and not refer * to the interrupted thread anymore. It might be necessary to make a local * copy before calling this function. *