Explorar el Código

re-format the coding style in rtdef.h

git-svn-id: https://rt-thread.googlecode.com/svn/trunk@2280 bbd45198-f89e-11dd-88c7-29a3b14d5316
dzzxzz@gmail.com hace 12 años
padre
commit
095b0ae5c0
Se han modificado 1 ficheros con 257 adiciones y 254 borrados
  1. 257 254
      include/rtdef.h

+ 257 - 254
include/rtdef.h

@@ -32,46 +32,46 @@ extern "C" {
 /*@{*/
 
 /* RT-Thread version information */
-#define RT_VERSION                      1L      /**< major version number */
-#define RT_SUBVERSION                   1L      /**< minor version number */
-#define RT_REVISION                     0L      /**< revise version number */
+#define RT_VERSION                      1L              /* major version number */
+#define RT_SUBVERSION                   1L              /* minor version number */
+#define RT_REVISION                     0L              /* revise version number */
 
 /* RT-Thread version */
 #define RTTHREAD_VERSION                ((RT_VERSION * 10000) + \
-    (RT_SUBVERSION * 100) + RT_REVISION)
+                                         (RT_SUBVERSION * 100) + RT_REVISION)
 
 /* RT-Thread basic data type definitions */
-typedef signed   char                   rt_int8_t;      /**<  8bit integer type */
-typedef signed   short                  rt_int16_t;     /**< 16bit integer type */
-typedef signed   long                   rt_int32_t;     /**< 32bit integer type */
-typedef unsigned char                   rt_uint8_t;     /**<  8bit unsigned integer type */
-typedef unsigned short                  rt_uint16_t;    /**< 16bit unsigned integer type */
-typedef unsigned long                   rt_uint32_t;    /**< 32bit unsigned integer type */
-typedef int                             rt_bool_t;      /**< boolean type */
+typedef signed   char                   rt_int8_t;      /*  8bit integer type */
+typedef signed   short                  rt_int16_t;     /* 16bit integer type */
+typedef signed   long                   rt_int32_t;     /* 32bit integer type */
+typedef unsigned char                   rt_uint8_t;     /*  8bit unsigned integer type */
+typedef unsigned short                  rt_uint16_t;    /* 16bit unsigned integer type */
+typedef unsigned long                   rt_uint32_t;    /* 32bit unsigned integer type */
+typedef int                             rt_bool_t;      /* boolean type */
 
 /* 32bit CPU */
-typedef long                            rt_base_t;      /**< Nbit CPU related date type */
-typedef unsigned long                   rt_ubase_t;     /**< Nbit unsigned CPU related data type */
+typedef long                            rt_base_t;      /* Nbit CPU related date type */
+typedef unsigned long                   rt_ubase_t;     /* Nbit unsigned CPU related data type */
 
-typedef rt_base_t                       rt_err_t;       /**< Type for error number      */
-typedef rt_uint32_t                     rt_time_t;      /**< Type for time stamp        */
-typedef rt_uint32_t                     rt_tick_t;      /**< Type for tick count        */
-typedef rt_base_t                       rt_flag_t;      /**< Type for flags             */
-typedef rt_ubase_t                      rt_size_t;      /**< Type for size number       */
-typedef rt_ubase_t                      rt_dev_t;       /**< Type for device            */
-typedef rt_base_t                       rt_off_t;       /**< Type for offset            */
+typedef rt_base_t                       rt_err_t;       /* Type for error number */
+typedef rt_uint32_t                     rt_time_t;      /* Type for time stamp */
+typedef rt_uint32_t                     rt_tick_t;      /* Type for tick count */
+typedef rt_base_t                       rt_flag_t;      /* Type for flags */
+typedef rt_ubase_t                      rt_size_t;      /* Type for size number */
+typedef rt_ubase_t                      rt_dev_t;       /* Type for device */
+typedef rt_base_t                       rt_off_t;       /* Type for offset */
 
 /* boolean type definitions */
-#define RT_TRUE                         1               /**< boolean true  */
-#define RT_FALSE                        0               /**< boolean fails */
+#define RT_TRUE                         1               /* boolean true  */
+#define RT_FALSE                        0               /* boolean fails */
 
 /*@}*/
 
 /* maximum value of base type */
-#define RT_UINT8_MAX                    0xff            /* Maxium number of UINT8   */
-#define RT_UINT16_MAX                   0xffff          /* Maxium number of UINT16  */
-#define RT_UINT32_MAX                   0xffffffff      /* Maxium number of UINT32  */
-#define RT_TICK_MAX                     RT_UINT32_MAX   /* Maxium number of tick    */
+#define RT_UINT8_MAX                    0xff            /* Maxium number of UINT8 */
+#define RT_UINT16_MAX                   0xffff          /* Maxium number of UINT16 */
+#define RT_UINT32_MAX                   0xffffffff      /* Maxium number of UINT32 */
+#define RT_TICK_MAX                     RT_UINT32_MAX   /* Maxium number of tick */
 
 /* Compiler Related Definitions */
 #ifdef __CC_ARM                         /* ARM Compiler */
@@ -82,9 +82,9 @@ typedef rt_base_t                       rt_off_t;       /**< Type for offset
     #define rt_inline                   static __inline
     /* module compiling */
     #ifdef RT_USING_MODULE
-        #define RTT_API __declspec(dllimport)
+        #define RTT_API                 __declspec(dllimport)
     #else
-        #define RTT_API __declspec(dllexport)
+        #define RTT_API                 __declspec(dllexport)
     #endif
 
 #elif defined (__IAR_SYSTEMS_ICC__)     /* for IAR Compiler */
@@ -102,22 +102,22 @@ typedef rt_base_t                       rt_off_t;       /**< Type for offset
     #else
         #if __GNUC__ < 4
             typedef void *__sys_va_list;
-            typedef __sys_va_list va_list;
+            typedef __sys_va_list       va_list;
             #define __va_rounded_size(type) \
                 (((sizeof(type) + sizeof(int) - 1) / sizeof(int)) * sizeof(int))
             #define va_start(ap, lastarg)   \
                 (ap = ((char *) &(lastarg) + __va_rounded_size(lastarg)))
-            #define va_end(ap)  ((void)0)
+            #define va_end(ap)          ((void)0)
             /*  little endian */
             #define va_arg(ap, type)    \
                 (ap = (__sys_va_list) ((char *)(ap) + __va_rounded_size(type)),  \
                 *((type *) (void *) ((char *)(ap) - __va_rounded_size(type))))
         #else
-            typedef __builtin_va_list __gnuc_va_list;
-            typedef __gnuc_va_list va_list;
-            #define va_start(v,l)   __builtin_va_start(v,l)
-            #define va_end(v)       __builtin_va_end(v)
-            #define va_arg(v,l)     __builtin_va_arg(v,l)
+            typedef __builtin_va_list   __gnuc_va_list;
+            typedef __gnuc_va_list      va_list;
+            #define va_start(v,l)       __builtin_va_start(v,l)
+            #define va_end(v)           __builtin_va_end(v)
+            #define va_arg(v,l)         __builtin_va_arg(v,l)
         #endif
     #endif
 
@@ -132,7 +132,7 @@ typedef rt_base_t                       rt_off_t;       /**< Type for offset
     #define UNUSED                      __attribute__((unused))
     #define ALIGN(n)                    __attribute__((aligned(n)))
     #define rt_inline                   static inline
-    #define RTT_API	
+    #define RTT_API 
 #endif
 
 /* event length */
@@ -150,15 +150,15 @@ typedef rt_base_t                       rt_off_t;       /**< Type for offset
 /*@{*/
 
 /* RT-Thread error code definitions */
-#define RT_EOK                          0               /**< There is no error       */
-#define RT_ERROR                        1               /**< A generic error happens */
-#define RT_ETIMEOUT                     2               /**< Timed out               */
-#define RT_EFULL                        3               /**< The resource is full    */
-#define RT_EEMPTY                       4               /**< The resource is empty   */
-#define RT_ENOMEM                       5               /**< No memory               */
-#define RT_ENOSYS                       6               /**< No system               */
-#define RT_EBUSY                        7               /**< Busy                    */
-#define RT_EIO                          8               /**< IO error                */
+#define RT_EOK                          0               /* There is no error */
+#define RT_ERROR                        1               /* A generic error happens */
+#define RT_ETIMEOUT                     2               /* Timed out */
+#define RT_EFULL                        3               /* The resource is full */
+#define RT_EEMPTY                       4               /* The resource is empty */
+#define RT_ENOMEM                       5               /* No memory */
+#define RT_ENOSYS                       6               /* No system */
+#define RT_EBUSY                        7               /* Busy */
+#define RT_EIO                          8               /* IO error */
 
 /*@}*/
 
@@ -190,10 +190,10 @@ typedef rt_base_t                       rt_off_t;       /**< Type for offset
 
 struct rt_list_node
 {
-    struct rt_list_node                 *next;          /* point to next node. */
-    struct rt_list_node                 *prev;          /* point to prev node. */
+    struct rt_list_node *next;                          /* point to next node. */
+    struct rt_list_node *prev;                          /* point to prev node. */
 };
-typedef struct rt_list_node rt_list_t;                  /* Type for lists.     */
+typedef struct rt_list_node rt_list_t;                  /* Type for lists. */
 
 /**
  * @addtogroup KernelObject
@@ -204,23 +204,23 @@ typedef struct rt_list_node rt_list_t;                  /* Type for lists.     *
 /*
  * kernel object macros
  */
-#define RT_OBJECT_FLAG_MODULE           0x80            /* is module object.   */
+#define RT_OBJECT_FLAG_MODULE           0x80            /* is module object. */
 
 /**
  * Base structure of Kernel object
  */
 struct rt_object
 {
-    char        name[RT_NAME_MAX];                      /**< name of kernel object      */
-    rt_uint8_t  type;                                   /**< type of kernel object      */
-    rt_uint8_t  flag;                                   /**< flag of kernel object      */
+    char       name[RT_NAME_MAX];                       /* name of kernel object */
+    rt_uint8_t type;                                    /* type of kernel object */
+    rt_uint8_t flag;                                    /* flag of kernel object */
 
 #ifdef RT_USING_MODULE
-    void        *module_id;                             /**< id of application module   */
+    void      *module_id;                               /* id of application module */
 #endif
-    rt_list_t   list;                                   /**< list node of kernel object */
+    rt_list_t  list;                                    /* list node of kernel object */
 };
-typedef struct rt_object *rt_object_t;                  /* Type for kernel objects.     */
+typedef struct rt_object *rt_object_t;                  /* Type for kernel objects. */
 
 /**
  *  The object type can be one of the follows with specific
@@ -241,37 +241,37 @@ typedef struct rt_object *rt_object_t;                  /* Type for kernel objec
  */
 enum rt_object_class_type
 {
-    RT_Object_Class_Thread = 0,                         /**< The object is a thread.                */
+    RT_Object_Class_Thread = 0,                         /* The object is a thread. */
 #ifdef RT_USING_SEMAPHORE
-    RT_Object_Class_Semaphore,                          /**< The object is a semaphore.             */
+    RT_Object_Class_Semaphore,                          /* The object is a semaphore. */
 #endif
 #ifdef RT_USING_MUTEX
-    RT_Object_Class_Mutex,                              /**< The object is a mutex.                 */
+    RT_Object_Class_Mutex,                              /* The object is a mutex. */
 #endif
 #ifdef RT_USING_EVENT
-    RT_Object_Class_Event,                              /**< The object is a event.                 */
+    RT_Object_Class_Event,                              /* The object is a event. */
 #endif
 #ifdef RT_USING_MAILBOX
-    RT_Object_Class_MailBox,                            /**< The object is a mail box.              */
+    RT_Object_Class_MailBox,                            /* The object is a mail box. */
 #endif
 #ifdef RT_USING_MESSAGEQUEUE
-    RT_Object_Class_MessageQueue,                       /**< The object is a message queue.         */
+    RT_Object_Class_MessageQueue,                       /* The object is a message queue. */
 #endif
 #ifdef RT_USING_MEMHEAP
-    RT_Object_Class_MemHeap,                            /**< The object is a memory heap            */
+    RT_Object_Class_MemHeap,                            /* The object is a memory heap */
 #endif
 #ifdef RT_USING_MEMPOOL
-    RT_Object_Class_MemPool,                            /**< The object is a memory pool.           */
+    RT_Object_Class_MemPool,                            /* The object is a memory pool. */
 #endif
 #ifdef RT_USING_DEVICE
-    RT_Object_Class_Device,                             /**< The object is a device                 */
+    RT_Object_Class_Device,                             /* The object is a device */
 #endif
-    RT_Object_Class_Timer,                              /**< The object is a timer.                 */
+    RT_Object_Class_Timer,                              /* The object is a timer. */
 #ifdef RT_USING_MODULE
-    RT_Object_Class_Module,                             /**< The object is a module.                */
+    RT_Object_Class_Module,                             /* The object is a module. */
 #endif
-    RT_Object_Class_Unknown,                            /**< The object is unknown.                 */
-    RT_Object_Class_Static = 0x80                       /**< The object is a static object.         */
+    RT_Object_Class_Unknown,                            /* The object is unknown. */
+    RT_Object_Class_Static = 0x80                       /* The object is a static object. */
 };
 
 /**
@@ -279,9 +279,9 @@ enum rt_object_class_type
  */
 struct rt_object_information
 {
-    enum rt_object_class_type type;                     /**< object class type                      */
-    rt_list_t object_list;                              /**< object list                            */
-    rt_size_t object_size;                              /**< object size                            */
+    enum rt_object_class_type type;                     /* object class type */
+    rt_list_t                 object_list;              /* object list */
+    rt_size_t                 object_size;              /* object size */
 };
 
 /**
@@ -305,33 +305,33 @@ struct rt_object_information
 /**
  * clock & timer macros
  */
-#define RT_TIMER_FLAG_DEACTIVATED       0x0             /**< timer is deactive                      */
-#define RT_TIMER_FLAG_ACTIVATED         0x1             /**< timer is active                        */
-#define RT_TIMER_FLAG_ONE_SHOT          0x0             /**< one shot timer                         */
-#define RT_TIMER_FLAG_PERIODIC          0x2             /**< periodic timer                         */
+#define RT_TIMER_FLAG_DEACTIVATED       0x0             /* timer is deactive */
+#define RT_TIMER_FLAG_ACTIVATED         0x1             /* timer is active */
+#define RT_TIMER_FLAG_ONE_SHOT          0x0             /* one shot timer */
+#define RT_TIMER_FLAG_PERIODIC          0x2             /* periodic timer */
 
-#define RT_TIMER_FLAG_HARD_TIMER        0x0             /**< hard timer,the timer's callback function will be called in tick isr.     */
-#define RT_TIMER_FLAG_SOFT_TIMER        0x4             /**< soft timer,the timer's callback function will be called in timer thread. */
+#define RT_TIMER_FLAG_HARD_TIMER        0x0             /* hard timer,the timer's callback function will be called in tick isr. */
+#define RT_TIMER_FLAG_SOFT_TIMER        0x4             /* soft timer,the timer's callback function will be called in timer thread. */
 
-#define RT_TIMER_CTRL_SET_TIME          0x0             /**< set timer control command              */
-#define RT_TIMER_CTRL_GET_TIME          0x1             /**< get timer control command              */
-#define RT_TIMER_CTRL_SET_ONESHOT       0x2             /**< change timer to one shot               */
-#define RT_TIMER_CTRL_SET_PERIODIC      0x3             /**< change timer to periodic               */
+#define RT_TIMER_CTRL_SET_TIME          0x0             /* set timer control command */
+#define RT_TIMER_CTRL_GET_TIME          0x1             /* get timer control command */
+#define RT_TIMER_CTRL_SET_ONESHOT       0x2             /* change timer to one shot */
+#define RT_TIMER_CTRL_SET_PERIODIC      0x3             /* change timer to periodic */
 
 /**
  * timer structure
  */
 struct rt_timer
 {
-    struct rt_object parent;                            /**< inherit from rt_object                 */
+    struct rt_object parent;                            /* inherit from rt_object */
 
-    rt_list_t list;                                     /**< the node of timer list                 */
+    rt_list_t        list;                              /* the node of timer list */
 
-    void (*timeout_func)(void *parameter);              /**< timeout function                       */
-    void *parameter;                                    /**< timeout function's parameter           */
+    void (*timeout_func)(void *parameter);              /* timeout function */
+    void            *parameter;                         /* timeout function's parameter */
 
-    rt_tick_t init_tick;                                /**< timer timeout tick                     */
-    rt_tick_t timeout_tick;                             /**< timeout tick                           */
+    rt_tick_t        init_tick;                         /* timer timeout tick */
+    rt_tick_t        timeout_tick;                      /* timeout tick */
 };
 typedef struct rt_timer *rt_timer_t;
 
@@ -350,20 +350,20 @@ typedef struct rt_timer *rt_timer_t;
 /*
  * thread state definitions
  */
-#define RT_THREAD_INIT                  0x00                /**< Initialized status                 */
-#define RT_THREAD_READY                 0x01                /**< Ready status                       */
-#define RT_THREAD_SUSPEND               0x02                /**< Suspend status                     */
-#define RT_THREAD_RUNNING               0x03                /**< Running status                     */
-#define RT_THREAD_BLOCK                 RT_THREAD_SUSPEND   /**< Blocked status                     */
-#define RT_THREAD_CLOSE                 0x04                /**< Closed status                      */
+#define RT_THREAD_INIT                  0x00                /* Initialized status */
+#define RT_THREAD_READY                 0x01                /* Ready status */
+#define RT_THREAD_SUSPEND               0x02                /* Suspend status */
+#define RT_THREAD_RUNNING               0x03                /* Running status */
+#define RT_THREAD_BLOCK                 RT_THREAD_SUSPEND   /* Blocked status */
+#define RT_THREAD_CLOSE                 0x04                /* Closed status */
 
 /**
  * thread control command definitions
  */
-#define RT_THREAD_CTRL_STARTUP          0x00                /**< Startup thread.                    */
-#define RT_THREAD_CTRL_CLOSE            0x01                /**< Close thread.                      */
-#define RT_THREAD_CTRL_CHANGE_PRIORITY  0x02                /**< Change thread priority.            */
-#define RT_THREAD_CTRL_INFO             0x03                /**< Get thread information.            */
+#define RT_THREAD_CTRL_STARTUP          0x00                /* Startup thread. */
+#define RT_THREAD_CTRL_CLOSE            0x01                /* Close thread. */
+#define RT_THREAD_CTRL_CHANGE_PRIORITY  0x02                /* Change thread priority. */
+#define RT_THREAD_CTRL_INFO             0x03                /* Get thread information. */
 
 /**
  * Thread structure
@@ -371,32 +371,32 @@ typedef struct rt_timer *rt_timer_t;
 struct rt_thread
 {
     /* rt object */
-    char        name[RT_NAME_MAX];                      /**< the name of thread                     */
-    rt_uint8_t  type;                                   /**< type of object                         */
-    rt_uint8_t  flags;                                  /**< thread's flags                         */
+    char        name[RT_NAME_MAX];                      /* the name of thread */
+    rt_uint8_t  type;                                   /* type of object */
+    rt_uint8_t  flags;                                  /* thread's flags */
     
 #ifdef RT_USING_MODULE
-    void        *module_id;                             /**< id of application module               */
+    void       *module_id;                              /* id of application module */
 #endif
 
-    rt_list_t   list;                                   /**< the object list                        */
-    rt_list_t   tlist;                                  /**< the thread list                        */
+    rt_list_t   list;                                   /* the object list */
+    rt_list_t   tlist;                                  /* the thread list */
 
     /* stack point and entry */
-    void        *sp;                                    /**< stack point                            */
-    void        *entry;                                 /**< entry                                  */
-    void        *parameter;                             /**< parameter                              */
-    void        *stack_addr;                            /**< stack address                          */
-    rt_uint16_t stack_size;                             /**< stack size                             */
+    void       *sp;                                     /* stack point */
+    void       *entry;                                  /* entry */
+    void       *parameter;                              /* parameter */
+    void       *stack_addr;                             /* stack address */
+    rt_uint16_t stack_size;                             /* stack size */
 
     /* error code */
-    rt_err_t    error;                                  /**< error code                             */
+    rt_err_t    error;                                  /* error code */
 
-    rt_uint8_t  stat;                                   /**< thread stat                            */
+    rt_uint8_t  stat;                                   /* thread stat */
 
     /* priority */
-    rt_uint8_t  current_priority;                       /**< current priority                       */
-    rt_uint8_t  init_priority;                          /**< initialized priority                   */
+    rt_uint8_t  current_priority;                       /* current priority */
+    rt_uint8_t  init_priority;                          /* initialized priority */
 #if RT_THREAD_PRIORITY_MAX > 32
     rt_uint8_t  number;
     rt_uint8_t  high_mask;
@@ -409,14 +409,14 @@ struct rt_thread
     rt_uint8_t  event_info;
 #endif
 
-    rt_ubase_t  init_tick;                              /**< thread's initialized tick              */
-    rt_ubase_t  remaining_tick;                         /**< remaining tick                         */
+    rt_ubase_t  init_tick;                              /* thread's initialized tick */
+    rt_ubase_t  remaining_tick;                         /* remaining tick */
 
-    struct rt_timer thread_timer;                       /**< built-in thread timer                   */
+    struct rt_timer thread_timer;                       /* built-in thread timer */
 
-    void (*cleanup)(struct rt_thread *tid);             /**< cleanup function when thread exit      */
+    void (*cleanup)(struct rt_thread *tid);             /* cleanup function when thread exit */
 
-    rt_uint32_t user_data;                              /**< private user data beyond this thread  */
+    rt_uint32_t user_data;                              /* private user data beyond this thread */
 };
 typedef struct rt_thread *rt_thread_t;
 
@@ -431,23 +431,23 @@ typedef struct rt_thread *rt_thread_t;
 /**
  * IPC flags and control command definitions
  */
-#define RT_IPC_FLAG_FIFO                0x00            /**< FIFOed IPC. @ref IPC.                  */
-#define RT_IPC_FLAG_PRIO                0x01            /**< PRIOed IPC. @ref IPC.                  */
+#define RT_IPC_FLAG_FIFO                0x00            /* FIFOed IPC. @ref IPC. */
+#define RT_IPC_FLAG_PRIO                0x01            /* PRIOed IPC. @ref IPC. */
 
-#define RT_IPC_CMD_UNKNOWN              0x00            /**< unknown IPC command                    */
-#define RT_IPC_CMD_RESET                0x01            /**< reset IPC object                       */
+#define RT_IPC_CMD_UNKNOWN              0x00            /* unknown IPC command */
+#define RT_IPC_CMD_RESET                0x01            /* reset IPC object */
 
-#define RT_WAITING_FOREVER              -1              /**< Block forever until get resource.      */
-#define RT_WAITING_NO                   0               /**< Non-block.                             */
+#define RT_WAITING_FOREVER              -1              /* Block forever until get resource. */
+#define RT_WAITING_NO                   0               /* Non-block. */
 
 /**
  * Base structure of IPC object
  */
 struct rt_ipc_object
 {
-    struct rt_object parent;                            /**< inherit from rt_object                 */
+    struct rt_object parent;                            /* inherit from rt_object */
 
-    rt_list_t suspend_thread;                           /**< threads pended on this resource        */
+    rt_list_t        suspend_thread;                    /* threads pended on this resource */
 };
 
 #ifdef RT_USING_SEMAPHORE
@@ -456,9 +456,9 @@ struct rt_ipc_object
  */
 struct rt_semaphore
 {
-    struct rt_ipc_object parent;                        /**< inherit from ipc_object                */
+    struct rt_ipc_object parent;                        /* inherit from ipc_object */
 
-    rt_uint16_t value;                                  /**< value of semaphore.                    */
+    rt_uint16_t          value;                         /* value of semaphore. */
 };
 typedef struct rt_semaphore *rt_sem_t;
 #endif
@@ -469,14 +469,14 @@ typedef struct rt_semaphore *rt_sem_t;
  */
 struct rt_mutex
 {
-    struct rt_ipc_object    parent;                     /**< inherit from ipc_object                */
+    struct rt_ipc_object parent;                        /* inherit from ipc_object */
 
-    rt_uint16_t             value;                      /**< value of mutex                         */
+    rt_uint16_t          value;                         /* value of mutex */
 
-    rt_uint8_t              original_priority;          /**< priority of last thread hold the mutex */
-    rt_uint8_t              hold;                       /**< numbers of thread hold the mutex       */
+    rt_uint8_t           original_priority;             /* priority of last thread hold the mutex */
+    rt_uint8_t           hold;                          /* numbers of thread hold the mutex */
 
-    struct rt_thread        *owner;                     /**< current owner of mutex                 */
+    struct rt_thread    *owner;                         /* current owner of mutex */
 };
 typedef struct rt_mutex *rt_mutex_t;
 #endif
@@ -485,18 +485,18 @@ typedef struct rt_mutex *rt_mutex_t;
 /**
  * flag defintions in event
  */
-#define RT_EVENT_FLAG_AND               0x01            /**< logic and                              */
-#define RT_EVENT_FLAG_OR                0x02            /**< logic or                               */
-#define RT_EVENT_FLAG_CLEAR             0x04            /**< clear flag                             */
+#define RT_EVENT_FLAG_AND               0x01            /* logic and */
+#define RT_EVENT_FLAG_OR                0x02            /* logic or */
+#define RT_EVENT_FLAG_CLEAR             0x04            /* clear flag */
 
 /*
  * event structure
  */
 struct rt_event
 {
-    struct rt_ipc_object parent;                        /**< inherit from ipc_object                */
+    struct rt_ipc_object parent;                        /* inherit from ipc_object */
 
-    rt_uint32_t set;                                    /**< event set                              */
+    rt_uint32_t          set;                           /* event set */
 };
 typedef struct rt_event *rt_event_t;
 #endif
@@ -507,16 +507,17 @@ typedef struct rt_event *rt_event_t;
  */
 struct rt_mailbox
 {
-    struct rt_ipc_object parent;                        /**< inherit from ipc_object                */
+    struct rt_ipc_object parent;                        /* inherit from ipc_object */
 
-    rt_uint32_t *msg_pool;                              /**< start address of message buffer        */
+    rt_uint32_t         *msg_pool;                      /* start address of message buffer */
 
-    rt_uint16_t size;                                   /**< size of message pool                   */
+    rt_uint16_t          size;                          /* size of message pool */
 
-    rt_uint16_t entry;                                  /**< index of messages in msg_pool          */
-    rt_uint16_t in_offset, out_offset;                  /**< in/output offset of the message buffer */
+    rt_uint16_t          entry;                         /* index of messages in msg_pool */
+    rt_uint16_t          in_offset;                     /* input offset of the message buffer */
+    rt_uint16_t          out_offset;                    /* output offset of the message buffer */
 
-    rt_list_t suspend_sender_thread;                    /**< sender thread suspended on this mailbox */
+    rt_list_t            suspend_sender_thread;         /* sender thread suspended on this mailbox */
 };
 typedef struct rt_mailbox *rt_mailbox_t;
 #endif
@@ -527,18 +528,18 @@ typedef struct rt_mailbox *rt_mailbox_t;
  */
 struct rt_messagequeue
 {
-    struct rt_ipc_object parent;                        /**< inherit from ipc_object                */
+    struct rt_ipc_object parent;                        /* inherit from ipc_object */
 
-    void *msg_pool;                                     /**< start address of message queue         */
+    void                *msg_pool;                      /* start address of message queue */
 
-    rt_uint16_t msg_size;                               /**< message size of each message           */
-    rt_uint16_t max_msgs;                               /**< max number of messages                 */
+    rt_uint16_t          msg_size;                      /* message size of each message */
+    rt_uint16_t          max_msgs;                      /* max number of messages */
 
-    rt_uint16_t entry;                                  /**< index of messages in the queue         */
+    rt_uint16_t          entry;                         /* index of messages in the queue */
 
-    void *msg_queue_head;                               /**< list head                              */
-    void *msg_queue_tail;                               /**< list tail                              */
-    void *msg_queue_free;                               /**< pointer indicated the free node of queue */
+    void                *msg_queue_head;                /* list head */
+    void                *msg_queue_tail;                /* list tail */
+    void                *msg_queue_free;                /* pointer indicated the free node of queue */
 };
 typedef struct rt_messagequeue *rt_mq_t;
 #endif
@@ -562,11 +563,13 @@ typedef struct rt_messagequeue *rt_mq_t;
  */
 struct rt_memheap_item
 {
-    rt_uint32_t magic;
-    struct rt_memheap_item *next, *prev;
-    struct rt_memheap_item *next_free, *prev_free;
+    rt_uint32_t             magic;
+    struct rt_memheap_item *next;
+    struct rt_memheap_item *prev;
+    struct rt_memheap_item *next_free;
+    struct rt_memheap_item *prev_free;
 
-    struct rt_memheap* pool_ptr;
+    struct rt_memheap      *pool_ptr;
 };
 
 /**
@@ -574,20 +577,17 @@ struct rt_memheap_item
  */
 struct rt_memheap
 {
-    struct rt_object parent;
+    struct rt_object        parent;
 
-    /* pool start address and size */
-    void *start_addr;
+    void                   *start_addr;                 /* pool start address and size */
 
-    rt_uint32_t pool_size;
-    rt_uint32_t available_size;
+    rt_uint32_t             pool_size;
+    rt_uint32_t             available_size;
 
-    /* used block list */
-    struct rt_memheap_item* block_list;
+    struct rt_memheap_item *block_list;                 /* used block list */
 
-    /* free block list and free block list header */
-    struct rt_memheap_item* free_list;
-    struct rt_memheap_item  free_header;
+    struct rt_memheap_item *free_list;                  /* free block list */
+    struct rt_memheap_item  free_header;                /* free block list header */
 };
 
 /**
@@ -595,19 +595,19 @@ struct rt_memheap
  */
 struct rt_mempool
 {
-    struct rt_object parent;                        /**< inherit from rt_object                     */
+    struct rt_object parent;                            /* inherit from rt_object */
 
-    void        *start_address;                     /**< memory pool start                          */
-    rt_size_t   size;                               /**< size of memory pool                        */
+    void            *start_address;                     /* memory pool start */
+    rt_size_t        size;                              /* size of memory pool */
 
-    rt_size_t   block_size;                         /**< size of memory blocks                      */
-    rt_uint8_t  *block_list;                        /**< memory blocks list                         */
+    rt_size_t        block_size;                        /* size of memory blocks */
+    rt_uint8_t      *block_list;                        /* memory blocks list */
 
-    rt_size_t   block_total_count;                  /**< numbers of memory block                    */
-    rt_size_t   block_free_count;                   /**< numbers of free memory block               */
+    rt_size_t        block_total_count;                 /* numbers of memory block */
+    rt_size_t        block_free_count;                  /* numbers of free memory block */
 
-    rt_list_t   suspend_thread;                     /**< threads pended on this resource            */
-    rt_size_t   suspend_thread_count;               /**< numbers of thread pended on this resource  */
+    rt_list_t        suspend_thread;                    /* threads pended on this resource */
+    rt_size_t        suspend_thread_count;              /* numbers of thread pended on this resource */
 };
 typedef struct rt_mempool *rt_mp_t;
 
@@ -626,65 +626,65 @@ typedef struct rt_mempool *rt_mp_t;
  */
 enum rt_device_class_type
 {
-    RT_Device_Class_Char = 0,                       /**< character device                           */
-    RT_Device_Class_Block,                          /**< block device                               */
-    RT_Device_Class_NetIf,                          /**< net interface                              */
-    RT_Device_Class_MTD,                            /**< memory device                              */
-    RT_Device_Class_CAN,                            /**< CAN device                                 */
-    RT_Device_Class_RTC,                            /**< RTC device                                 */
-    RT_Device_Class_Sound,                          /**< Sound device                               */
-    RT_Device_Class_Graphic,                        /**< Graphic device                             */
-    RT_Device_Class_I2CBUS,                         /**< I2C bus device                                 */
-    RT_Device_Class_USBDevice,                      /**< USB slave device                           */
-    RT_Device_Class_USBHost,                        /**< USB host bus                               */
-    RT_Device_Class_SPIBUS,                         /**< SPI bus device                             */
-    RT_Device_Class_SPIDevice,                      /**< SPI device                                 */
-    RT_Device_Class_SDIO,                           /**< SDIO bus device                            */
-	RT_Device_Class_PM,								/**< PM pseudo device                           */
-    RT_Device_Class_Unknown                         /**< unknown device                             */
+    RT_Device_Class_Char = 0,                           /* character device */
+    RT_Device_Class_Block,                              /* block device */
+    RT_Device_Class_NetIf,                              /* net interface */
+    RT_Device_Class_MTD,                                /* memory device */
+    RT_Device_Class_CAN,                                /* CAN device */
+    RT_Device_Class_RTC,                                /* RTC device */
+    RT_Device_Class_Sound,                              /* Sound device */
+    RT_Device_Class_Graphic,                            /* Graphic device */
+    RT_Device_Class_I2CBUS,                             /* I2C bus device */
+    RT_Device_Class_USBDevice,                          /* USB slave device */
+    RT_Device_Class_USBHost,                            /* USB host bus */
+    RT_Device_Class_SPIBUS,                             /* SPI bus device */
+    RT_Device_Class_SPIDevice,                          /* SPI device */
+    RT_Device_Class_SDIO,                               /* SDIO bus device */
+    RT_Device_Class_PM,                                 /* PM pseudo device */
+    RT_Device_Class_Unknown                             /* unknown device */
 };
 
 /**
  * device flags defitions
  */
-#define RT_DEVICE_FLAG_DEACTIVATE       0x000       /**< device is not not initialized              */
+#define RT_DEVICE_FLAG_DEACTIVATE       0x000           /* device is not not initialized */
 
-#define RT_DEVICE_FLAG_RDONLY           0x001       /**< read only                                  */
-#define RT_DEVICE_FLAG_WRONLY           0x002       /**< write only                                 */
-#define RT_DEVICE_FLAG_RDWR             0x003       /**< read and write                             */
+#define RT_DEVICE_FLAG_RDONLY           0x001           /* read only */
+#define RT_DEVICE_FLAG_WRONLY           0x002           /* write only */
+#define RT_DEVICE_FLAG_RDWR             0x003           /* read and write */
 
-#define RT_DEVICE_FLAG_REMOVABLE        0x004       /**< removable device                           */
-#define RT_DEVICE_FLAG_STANDALONE       0x008       /**< standalone device                          */
-#define RT_DEVICE_FLAG_ACTIVATED        0x010       /**< device is activated                        */
-#define RT_DEVICE_FLAG_SUSPENDED        0x020       /**< device is suspended                        */
-#define RT_DEVICE_FLAG_STREAM           0x040       /**< stream mode                                */
+#define RT_DEVICE_FLAG_REMOVABLE        0x004           /* removable device */
+#define RT_DEVICE_FLAG_STANDALONE       0x008           /* standalone device */
+#define RT_DEVICE_FLAG_ACTIVATED        0x010           /* device is activated */
+#define RT_DEVICE_FLAG_SUSPENDED        0x020           /* device is suspended */
+#define RT_DEVICE_FLAG_STREAM           0x040           /* stream mode */
 
-#define RT_DEVICE_FLAG_INT_RX           0x100       /**< INT mode on Rx                             */
-#define RT_DEVICE_FLAG_DMA_RX           0x200       /**< DMA mode on Rx                             */
-#define RT_DEVICE_FLAG_INT_TX           0x400       /**< INT mode on Tx                             */
-#define RT_DEVICE_FLAG_DMA_TX           0x800       /**< DMA mode on Tx                             */
+#define RT_DEVICE_FLAG_INT_RX           0x100           /* INT mode on Rx */
+#define RT_DEVICE_FLAG_DMA_RX           0x200           /* DMA mode on Rx */
+#define RT_DEVICE_FLAG_INT_TX           0x400           /* INT mode on Tx */
+#define RT_DEVICE_FLAG_DMA_TX           0x800           /* DMA mode on Tx */
 
-#define RT_DEVICE_OFLAG_CLOSE           0x000       /**< device is closed                           */
-#define RT_DEVICE_OFLAG_RDONLY          0x001       /**< read only access                           */
-#define RT_DEVICE_OFLAG_WRONLY          0x002       /**< write only access                          */
-#define RT_DEVICE_OFLAG_RDWR            0x003       /**< read and write                             */
-#define RT_DEVICE_OFLAG_OPEN            0x008       /**< device is opened                           */
+#define RT_DEVICE_OFLAG_CLOSE           0x000           /* device is closed */
+#define RT_DEVICE_OFLAG_RDONLY          0x001           /* read only access */
+#define RT_DEVICE_OFLAG_WRONLY          0x002           /* write only access */
+#define RT_DEVICE_OFLAG_RDWR            0x003           /* read and write */
+#define RT_DEVICE_OFLAG_OPEN            0x008           /* device is opened */
 
 /**
  * general device commands
  */
-#define RT_DEVICE_CTRL_RESUME           0x01        /**< resume device                              */
-#define RT_DEVICE_CTRL_SUSPEND          0x02        /**< suspend device                             */
+#define RT_DEVICE_CTRL_RESUME           0x01            /* resume device */
+#define RT_DEVICE_CTRL_SUSPEND          0x02            /* suspend device */
 
 /**
  * special device commands
  */
-#define RT_DEVICE_CTRL_CHAR_STREAM      0x10        /**< stream mode on char device                 */
-#define RT_DEVICE_CTRL_BLK_GETGEOME     0x10        /**< get geometry information                   */
-#define RT_DEVICE_CTRL_NETIF_GETMAC     0x10        /**< get mac address                            */
-#define RT_DEVICE_CTRL_MTD_FORMAT       0x10        /**< format a MTD device                        */
-#define RT_DEVICE_CTRL_RTC_GET_TIME     0x10        /**< get time                                   */
-#define RT_DEVICE_CTRL_RTC_SET_TIME     0x11        /**< set time                                   */
+#define RT_DEVICE_CTRL_CHAR_STREAM      0x10            /* stream mode on char device */
+#define RT_DEVICE_CTRL_BLK_GETGEOME     0x10            /* get geometry information */
+#define RT_DEVICE_CTRL_NETIF_GETMAC     0x10            /* get mac address */
+#define RT_DEVICE_CTRL_MTD_FORMAT       0x10            /* format a MTD device */
+#define RT_DEVICE_CTRL_RTC_GET_TIME     0x10            /* get time */
+#define RT_DEVICE_CTRL_RTC_SET_TIME     0x11            /* set time */
 
 typedef struct rt_device *rt_device_t;
 /**
@@ -692,16 +692,17 @@ typedef struct rt_device *rt_device_t;
  */
 struct rt_device
 {
-    struct rt_object parent;                        /**< inherit from rt_object                     */
+    struct rt_object          parent;                   /* inherit from rt_object */
 
-    enum rt_device_class_type type;                 /**< device type                                */
-    rt_uint16_t flag, open_flag;                    /**< device flag and device open flag           */
+    enum rt_device_class_type type;                     /* device type */
+    rt_uint16_t               flag;                     /* device flag */
+    rt_uint16_t               open_flag;                /* device open flag */
 
-    rt_uint8_t device_id;                           /* 0 - 255 */
+    rt_uint8_t                device_id;                /* 0 - 255 */
 
     /* device call back */
     rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size);
-    rt_err_t (*tx_complete)(rt_device_t dev, void* buffer);
+    rt_err_t (*tx_complete)(rt_device_t dev, void *buffer);
 
     /* common device interface */
     rt_err_t  (*init)   (rt_device_t dev);
@@ -716,7 +717,7 @@ struct rt_device
     rt_err_t (*resumed) (rt_device_t dev);
 #endif
 
-    void *user_data;                                /**< device private data                        */
+    void                     *user_data;                /* device private data */
 };
 
 /**
@@ -724,19 +725,19 @@ struct rt_device
  */
 struct rt_device_blk_geometry
 {
-    rt_uint32_t sector_count;                       /**< count of sectors                           */
-    rt_uint32_t bytes_per_sector;                   /**< number of bytes per sector                 */
-    rt_uint32_t block_size;                         /**< size to erase one block                    */
+    rt_uint32_t sector_count;                           /* count of sectors */
+    rt_uint32_t bytes_per_sector;                       /* number of bytes per sector */
+    rt_uint32_t block_size;                             /* size to erase one block */
 };
 
 /**
  * graphic device control command
  */
-#define RTGRAPHIC_CTRL_RECT_UPDATE  0
-#define RTGRAPHIC_CTRL_POWERON      1
-#define RTGRAPHIC_CTRL_POWEROFF     2
-#define RTGRAPHIC_CTRL_GET_INFO     3
-#define RTGRAPHIC_CTRL_SET_MODE     4
+#define RTGRAPHIC_CTRL_RECT_UPDATE      0
+#define RTGRAPHIC_CTRL_POWERON          1
+#define RTGRAPHIC_CTRL_POWEROFF         2
+#define RTGRAPHIC_CTRL_GET_INFO         3
+#define RTGRAPHIC_CTRL_SET_MODE         4
 
 /* graphic deice */
 enum
@@ -763,14 +764,14 @@ enum
  */
 struct rt_device_graphic_info
 {
-    rt_uint8_t  pixel_format;       /**< graphic format           */
-    rt_uint8_t  bits_per_pixel;     /**< bits per pixel           */
-    rt_uint16_t reserved;           /**< reserved field           */
+    rt_uint8_t  pixel_format;                           /* graphic format */
+    rt_uint8_t  bits_per_pixel;                         /* bits per pixel */
+    rt_uint16_t reserved;                               /* reserved field */
 
-    rt_uint16_t width;              /**< width of graphic device  */
-    rt_uint16_t height;             /**< height of graphic device */
+    rt_uint16_t width;                                  /* width of graphic device */
+    rt_uint16_t height;                                 /* height of graphic device */
 
-    rt_uint8_t *framebuffer;        /**< frame buffer             */
+    rt_uint8_t *framebuffer;                            /* frame buffer */
 };
 
 /**
@@ -778,8 +779,10 @@ struct rt_device_graphic_info
  */
 struct rt_device_rect_info
 {
-    rt_uint16_t x, y;               /**< x, y coordinate          */
-    rt_uint16_t width, height;      /**< width and height         */
+    rt_uint16_t x;
+    rt_uint16_t y;                                      /* x, y coordinate */
+    rt_uint16_t width;
+    rt_uint16_t height;                                 /* width and height */
 };
 
 /**
@@ -795,7 +798,7 @@ struct rt_device_graphic_ops
 
     void (*blit_line) (const char *pixel, int x, int y, rt_size_t size);
 };
-#define rt_graphix_ops(device)    ((struct rt_device_graphic_ops *)(device->user_data))
+#define rt_graphix_ops(device)          ((struct rt_device_graphic_ops *)(device->user_data))
 
 /*@}*/
 #endif
@@ -811,36 +814,36 @@ struct rt_device_graphic_ops
  * module system
  */
 
-#define RT_MODULE_FLAG_WITHENTRY        0x00        /* with entry point                             */
-#define RT_MODULE_FLAG_WITHOUTENTRY     0x01        /* without entry point                          */
+#define RT_MODULE_FLAG_WITHENTRY        0x00            /* with entry point */
+#define RT_MODULE_FLAG_WITHOUTENTRY     0x01            /* without entry point */
 
 /**
  * Application Module structure
  */
 struct rt_module
 {
-    struct rt_object parent;                        /**< inherit from object                        */
+    struct rt_object             parent;                /* inherit from object */
 
-    rt_uint8_t  *module_space;                      /**< module memory space                        */
+    rt_uint8_t                  *module_space;          /* module memory space */
 
-    void        *module_entry;                      /**< entry address of module's thread           */
-    rt_thread_t module_thread;                      /**< stack size of module's thread              */
-    rt_uint32_t stack_size;                         /**< priority of module's thread                */
-    rt_uint32_t thread_priority;
+    void                        *module_entry;          /* entry address of module's thread */
+    rt_thread_t                  module_thread;         /* stack size of module's thread */
+    rt_uint32_t                  stack_size;            /* priority of module's thread */
+    rt_uint32_t                  thread_priority;
 
 #ifdef RT_USING_SLAB
     /* module memory allocator */
-    void        *mem_list;                          /**< module's free memory list                  */
-    void        *page_array;                        /**< module's using pages                       */
-    rt_uint32_t page_cnt;                           /**< module's using pages count                 */
+    void                        *mem_list;              /* module's free memory list */
+    void                        *page_array;            /* module's using pages */
+    rt_uint32_t                  page_cnt;              /* module's using pages count */
 #endif
 
-    rt_uint32_t nsym;                               /**< number of symbol in the module             */
-    struct rt_module_symtab *symtab;                /**< module symbol table                        */
+    rt_uint32_t                  nsym;                  /* number of symbol in the module */
+    struct rt_module_symtab     *symtab;                /* module symbol table */
 
-    rt_uint32_t nref;                               /**< reference count                            */
+    rt_uint32_t                  nref;                  /* reference count */
     
-    /**< object in this module, module object is the last basic object type */
+    /* object in this module, module object is the last basic object type */
     struct rt_object_information module_object[RT_Object_Class_Unknown];
 };
 typedef struct rt_module *rt_module_t;