doc: kernel/arch: fix some wrong doxygen references

Remove non-existing references and document parameters.

Signed-off-by: Anas Nashif <[email protected]>

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

@@ -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.
  *