[doxygen] add doxygen comment for clk.c and clk.h

Accroding to #9947 and #9424, adding doxygen comment for function in .c files and data structure, macro in .h file is a solution.For this pr, I encountered problem following situations.
    - rt_clk_unprepare function return value type is different from rt_clk_ops so I change type of rt_clk_unprepare and its dependencies.
    - clk_get function may be similar as rt_clk_unprepare but I'm not sure so not modify.
    - clk_release implements may be incomplete, so I just marked in comment.

Signed-off-by: 1078249029 <[email protected]>

Author: 1078249029

components/drivers/clk/clk.c

@@ -454,9 +454,9 @@ static void clk_unprepare(struct rt_clk *clk, struct rt_clk_node *clk_np)
     }
 }
 
-
 rt_err_t rt_clk_unprepare(struct rt_clk *clk)
 {
+    rt_err_t err = RT_EOK;
 
     RT_DEBUG_NOT_IN_INTERRUPT;
 
@@ -469,6 +469,7 @@ rt_err_t rt_clk_unprepare(struct rt_clk *clk)
         rt_hw_spin_unlock(&_clk_lock.lock);
     }
 
+    return err;
 }
 
 /**
@@ -646,23 +647,25 @@ rt_err_t rt_clk_array_prepare(struct rt_clk_array *clk_arr)
     return err;
 }
 
-/**
- * @brief   Unprepare clock array for mutipule out clock
- *
- * @param   clk_arr         point to clock array
- *
- */
-void rt_clk_array_unprepare(struct rt_clk_array *clk_arr)
+rt_err_t rt_clk_array_unprepare(struct rt_clk_array *clk_arr)
 {
+    rt_err_t err = RT_EOK;
 
     if (clk_arr)
     {
         for (int i = 0; i < clk_arr->count; ++i)
         {
-            rt_clk_unprepare(clk_arr->clks[i]);
+            if ((err = rt_clk_unprepare(clk_arr->clks[i])))
+            {
+                LOG_E("CLK Array[%d] %s failed error = %s", i,
+                        "unprepare", rt_strerror(err));
+
+                break;
+            }
         }
     }
 
+    return err;
 }
 
 /**