Common Update: Better Doxygen Style

df_datalink_sp/src/include/common.h

@@ -1,20 +1,19 @@
 /*****************************************************************************/
 /**
- * Description: Common definitions
- *
- * Date: 2023-12-21 16:32
- * LastEditors: Fan Hao
- * LastEditTime: 2022-07-16 17:13
- * Revisions: Rev 0.1
- * History:
- * [2023-12-21]: Ensure the code conform ISO C11 standard.
- * [2022-07-16]: New branch for Dijian.
- * [2021-11-16]: Initial version.
- *
- * Copyright(c) 2021 Beijing Institute of Technology.
- * Lab of Communication and Networking
+ * @file common.h
+ * @author FanHao ([email protected])
+ * @brief Common macros
+ * @version 0.0
+ * @date 2022-07-16
+ * @copyright Copyright(c) 2024 Beijing Institute of Technology.\n
+ * Lab of Communication and Network
  *
  ******************************************************************************/
+/**
+ * @defgroup COMMON_MACRO
+ * @{
+ */
+
 /***************************** Include Files *********************************/
 #ifndef __COMMON_H_
 #define __COMMON_H_
@@ -47,8 +46,8 @@
 #endif
 #if _DEBUG_LEVEL >= 1
 #define DBG_ERROR(...) __PRINT_BLOCK( \
-    printf("in "__FILE__               \
-           ":%d [error]\t",         \
+    printf("in "__FILE__              \
+           ":%d [error]\t",           \
            __LINE__);                 \
     printf(__VA_ARGS__);)
 #endif
@@ -90,3 +89,5 @@
 /************************** Function Prototypes ******************************/
 void AppAssert(const char *file, int line);
 #endif /* __COMMON_H_ */
+
+/** @} */