From 6cb093aa272a0b1ef908cbd8e103cbd94120b3c6 Mon Sep 17 00:00:00 2001
From: guozhanxin <guozhanxin@rt-thread.com>
Date: Sat, 11 Sep 2021 18:29:37 +0800
Subject: [PATCH] [kernel] Improve code comments.

---
 src/clock.c      | 2 +-
 src/components.c | 9 +++++----
 src/cpu.c        | 1 -
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/clock.c b/src/clock.c
index e49df94aae..fb7ee447d2 100644
--- a/src/clock.c
+++ b/src/clock.c
@@ -130,7 +130,7 @@ RTM_EXPORT(rt_tick_from_millisecond);
 /**
  * @brief    This function will return the passed millisecond from boot.
  *
- * @note     When the value of RT_TICK_PER_SECOND is lower than 1000 or
+ * @note     if the value of RT_TICK_PER_SECOND is lower than 1000 or
  *           is not an integral multiple of 1000, this function will not
  *           provide the correct 1ms-based tick.
  *
diff --git a/src/components.c b/src/components.c
index 87e76091f2..9433b7457c 100644
--- a/src/components.c
+++ b/src/components.c
@@ -78,7 +78,9 @@ static int rti_end(void)
 INIT_EXPORT(rti_end, "6.end");
 
 /**
- * @brief  RT-Thread Components Initialization for board.
+ * @brief  Onboard components initialization. In this function, the board-level
+ *         initialization function will be called to complete the initialization
+ *         of the on-board peripherals.
  */
 void rt_components_board_init(void)
 {
@@ -225,9 +227,8 @@ void rt_application_init(void)
 }
 
 /**
- * @brief  RT-Thread startup function. This function will call all levels of initialization
- *         functions to complete the initialization of the system, and finally start the
- *         scheduler.
+ * @brief  This function will call all levels of initialization functions to complete
+ *         the initialization of the system, and finally start the scheduler.
  */
 int rtthread_startup(void)
 {
diff --git a/src/cpu.c b/src/cpu.c
index 5466a350ae..b689ecf2d7 100644
--- a/src/cpu.c
+++ b/src/cpu.c
@@ -69,7 +69,6 @@ static void _cpu_preempt_enable(void)
  * @brief   Initialize a static spinlock object.
  *
  * @param   lock is a pointer to the spinlock to initialize.
- *            It is assumed that storage for the spinlock will be allocated in your application.
  */
 void rt_spin_lock_init(struct rt_spinlock *lock)
 {