diff --git a/src/cpu_mp.c b/src/cpu_mp.c
index a10e35f479c..0ef5a868a41 100644
--- a/src/cpu_mp.c
+++ b/src/cpu_mp.c
@@ -59,6 +59,8 @@ RTM_EXPORT(rt_spin_lock)
 /**
  * @brief   This function will unlock the spinlock, will unlock the thread scheduler.
  *
+ * @note    If the scheduling function is called before unlocking, it will be scheduled in this function.
+ *
  * @param   lock is a pointer to the spinlock.
  */
 void rt_spin_unlock(struct rt_spinlock *lock)
@@ -95,6 +97,8 @@ RTM_EXPORT(rt_spin_lock_irqsave)
 /**
  * @brief   This function will unlock the spinlock and then restore current cpu interrupt status, will unlock the thread scheduler.
  *
+ * @note    If the scheduling function is called before unlocking, it will be scheduled in this function.
+ *
  * @param   lock is a pointer to the spinlock.
  *
  * @param   level is interrupt status returned by rt_spin_lock_irqsave().
diff --git a/src/cpu_up.c b/src/cpu_up.c
index d1720c94596..b2531b0be44 100644
--- a/src/cpu_up.c
+++ b/src/cpu_up.c
@@ -40,7 +40,8 @@ void rt_spin_lock(struct rt_spinlock *lock)
 
 /**
  * @brief   This function will unlock the spinlock, will unlock the thread scheduler.
- *          If the scheduling function is called before unlocking, it will be scheduled in this function.
+ *
+ * @note    If the scheduling function is called before unlocking, it will be scheduled in this function.
  *
  * @param   lock is a pointer to the spinlock.
  */
@@ -73,7 +74,8 @@ rt_base_t rt_spin_lock_irqsave(struct rt_spinlock *lock)
 
 /**
  * @brief   This function will unlock the spinlock and then restore current cpu interrupt status, will unlock the thread scheduler.
- *          If the scheduling function is called before unlocking, it will be scheduled in this function.
+ *
+ * @note    If the scheduling function is called before unlocking, it will be scheduled in this function.
  *
  * @param   lock is a pointer to the spinlock.
  *