doc: kernel/arch: fix some wrong doxygen references

Remove non-existing references and document parameters.

(cherry picked from commit ca09a4b)

Original-Signed-off-by: Anas Nashif <anas.nashif@intel.com>
GitOrigin-RevId: ca09a4b
Cr-Build-Id: 8736554896755799505
Cr-Build-Url: https://cr-buildbucket.appspot.com/build/8736554896755799505
Copybot-Job-Name: zephyr-main-copybot-downstream
Change-Id: I6628e895407639982adcb3d0cdc2b68d9fbfacbe
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/zephyr/+/5870360
Reviewed-by: Tristan Honscheid <honscheid@google.com>
Tested-by: Tristan Honscheid <honscheid@google.com>
Tested-by: ChromeOS Prod (Robot) <chromeos-ci-prod@chromeos-bot.iam.gserviceaccount.com>
Commit-Queue: Tristan Honscheid <honscheid@google.com>

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 <irq> to trigger an interrupt based on the level or the
- * edge of the signal. Valid values for <trigger> 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 <irq> trigger type.
- * Valid values for <trigger> 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
  */

kernel/sched.c

@@ -912,7 +912,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.
  *