10 files changed, 25 insertions, 17 deletions
diff --git a/src/include/condvars.h b/src/include/condvars.h
index be23bf6d1..ef9a37791 100644
--- a/src/include/condvars.h
+++ b/src/include/condvars.h
@@ -32,7 +32,7 @@
 #if defined(CH_USE_CONDVARS) && defined(CH_USE_MUTEXES)
 
 /**
- * CondVar structure.
+ * @brief CondVar structure.
  */
 typedef struct CondVar {
   ThreadsQueue          c_queue;
diff --git a/src/include/events.h b/src/include/events.h
index 1f2e2a15a..4ae3d3540 100644
--- a/src/include/events.h
+++ b/src/include/events.h
@@ -33,7 +33,7 @@
 typedef struct EventListener EventListener;
 
 /**
- * Event Listener structure.
+ * @brief Event Listener structure.
  */
 struct EventListener {
   /** Next Event Listener registered on the Event Source.*/
@@ -45,7 +45,7 @@ struct EventListener {
 };
 
 /**
- * Event Source structure.
+ * @brief Event Source structure.
  */
 typedef struct EventSource {
   /** First Event Listener registered on the Event Source.*/
diff --git a/src/include/lists.h b/src/include/lists.h
index 10b5d7823..339c6741c 100644
--- a/src/include/lists.h
+++ b/src/include/lists.h
@@ -32,7 +32,7 @@ typedef struct Thread Thread;
 #define notempty(p)     ((p)->p_next != (Thread *)(p))
 
 /**
- * Generic threads queue header and element.
+ * @brief Generic threads queue header and element.
  * @extends ThreadsList
  */
 typedef struct {
@@ -43,17 +43,22 @@ typedef struct {
 } ThreadsQueue;
 
 /**
- * Generic threads single link list, it works like a stack.
+ * @brief Generic threads single link list.
+ * @details This list behaves like a stack.
  */
 typedef struct {
   /** Last pushed @p Thread on the stack list, or @p ThreadList when empty. */
   Thread                *p_next;
 } ThreadsList;
 
-/*
- * Threads Lists functions and macros.
+/**
+ * Queue initialization.
  */
 #define queue_init(tqp) ((tqp)->p_next = (tqp)->p_prev = (Thread *)(tqp));
+
+/**
+ * List initialization.
+ */
 #define list_init(tlp)  ((tlp)->p_next = (Thread *)(tlp))
 
 #ifndef CH_OPTIMIZE_SPEED
diff --git a/src/include/mutexes.h b/src/include/mutexes.h
index 247b5ad7c..2040d64eb 100644
--- a/src/include/mutexes.h
+++ b/src/include/mutexes.h
@@ -28,7 +28,7 @@
 #ifdef CH_USE_MUTEXES
 
 /**
- * Mutex structure.
+ * @brief Mutex structure.
  */
 typedef struct Mutex {
   /** Queue of the threads sleeping on this Mutex.*/
diff --git a/src/include/queues.h b/src/include/queues.h
index 90456f4d1..a11a5a73f 100644
--- a/src/include/queues.h
+++ b/src/include/queues.h
@@ -41,7 +41,8 @@ typedef void (*qnotify_t)(void);
 
 #ifdef CH_USE_QUEUES
 /**
- * I/O queue structure, it is used by both Input and Output Queues,
+ * @brief I/O queue structure.
+ * @details This structure is used by both Input and Output Queues,
  * the difference is on how the semaphore is initialized.
  */
 typedef struct {
@@ -116,7 +117,7 @@ extern "C" {
 
 #ifdef CH_USE_QUEUES_HALFDUPLEX
 /**
- * Half duplex queue structure.
+ * @brief Half duplex queue structure.
  */
 typedef struct {
   /** Pointer to the queue buffer. */
diff --git a/src/include/scheduler.h b/src/include/scheduler.h
index 7d2f95beb..0549f217c 100644
--- a/src/include/scheduler.h
+++ b/src/include/scheduler.h
@@ -53,7 +53,8 @@
 #define firstprio(rlp)  ((rlp)->p_next->p_prio)
 
 /**
- * Ready list header.
+ * @brief Ready list header.
+ *
  * @extends ThreadsQueue
  */
 typedef struct {
diff --git a/src/include/semaphores.h b/src/include/semaphores.h
index ba75d8ba7..0f1a493d4 100644
--- a/src/include/semaphores.h
+++ b/src/include/semaphores.h
@@ -28,7 +28,7 @@
 #ifdef CH_USE_SEMAPHORES
 
 /**
- * Semaphore structure.
+ * @brief Semaphore structure.
  */
 typedef struct Semaphore {
   /** Queue of the threads sleeping on this Semaphore.*/
diff --git a/src/include/serial.h b/src/include/serial.h
index 0dfd02c56..ffe030e4b 100644
--- a/src/include/serial.h
+++ b/src/include/serial.h
@@ -46,7 +46,7 @@ typedef uint16_t dflags_t;
 #ifdef CH_USE_SERIAL_FULLDUPLEX
 
 /**
- * Full Duplex Serial Driver main structure.
+ * @brief Full Duplex Serial Driver main structure.
  */
 typedef struct {
 
@@ -111,7 +111,7 @@ extern "C" {
 #ifdef CH_USE_SERIAL_HALFDUPLEX
 
 /**
- * Full Duplex Serial Driver main structure.
+ * @brief Full Duplex Serial Driver main structure.
  */
 typedef struct {
 
diff --git a/src/include/threads.h b/src/include/threads.h
index 5ca7dd0ce..5877f49da 100644
--- a/src/include/threads.h
+++ b/src/include/threads.h
@@ -26,7 +26,8 @@
 #define _THREADS_H_
 
 /**
- * Structure representing a thread.
+ * @brief Structure representing a thread.
+ *
  * @extends ThreadsQueue
  * @note Not all the listed fields are always needed, by switching off some
  *       not needed ChibiOS/RT subsystems it is possible to save RAM space by
diff --git a/src/include/vt.h b/src/include/vt.h
index 04af725c9..89ad275e4 100644
--- a/src/include/vt.h
+++ b/src/include/vt.h
@@ -48,7 +48,7 @@ typedef void (*vtfunc_t)(void *);
 typedef struct VirtualTimer VirtualTimer;
 
 /**
- * Virtual Timer descriptor structure.
+ * @brief Virtual Timer descriptor structure.
  * @extends DeltaList
  */
 struct VirtualTimer {
@@ -66,7 +66,7 @@ struct VirtualTimer {
 };
 
 /**
- * Delta List header.
+ * @brief Virtual timers list header.
  * @note The delta list is implemented as a double link bidirectional list in
  *       order to make the unlink time constant, the reset of a virtual timer
  *       is often used in the code.