diff --git a/components/driver/twai/include/driver/twai.h b/components/driver/twai/include/driver/twai.h
index fe1bd8abb2..78bc71106a 100644
--- a/components/driver/twai/include/driver/twai.h
+++ b/components/driver/twai/include/driver/twai.h
@@ -18,7 +18,9 @@ extern "C" {
 #endif
 
 /* -------------------- Default initializers and flags ---------------------- */
+
 /** @cond */    //Doxy command to hide preprocessor definitions from docs
+
 /**
  * @brief Initializer macro for general configuration structure.
  *
diff --git a/components/esp_hw_support/include/esp_intr_alloc.h b/components/esp_hw_support/include/esp_intr_alloc.h
index 369084886f..3106332c0d 100644
--- a/components/esp_hw_support/include/esp_intr_alloc.h
+++ b/components/esp_hw_support/include/esp_intr_alloc.h
@@ -45,9 +45,10 @@ extern "C" {
 #define ESP_INTR_FLAG_LOWMED    (ESP_INTR_FLAG_LEVEL1|ESP_INTR_FLAG_LEVEL2|ESP_INTR_FLAG_LEVEL3) ///< Low and medium prio interrupts. These can be handled in C.
 #define ESP_INTR_FLAG_HIGH      (ESP_INTR_FLAG_LEVEL4|ESP_INTR_FLAG_LEVEL5|ESP_INTR_FLAG_LEVEL6|ESP_INTR_FLAG_NMI) ///< High level interrupts. Need to be handled in assembly.
 
+/** Mask for all level flags */
 #define ESP_INTR_FLAG_LEVELMASK (ESP_INTR_FLAG_LEVEL1|ESP_INTR_FLAG_LEVEL2|ESP_INTR_FLAG_LEVEL3| \
                                  ESP_INTR_FLAG_LEVEL4|ESP_INTR_FLAG_LEVEL5|ESP_INTR_FLAG_LEVEL6| \
-                                 ESP_INTR_FLAG_NMI) ///< Mask for all level flags
+                                 ESP_INTR_FLAG_NMI)
 
 
 /** @addtogroup Intr_Alloc_Pseudo_Src
diff --git a/components/hal/include/hal/twai_types.h b/components/hal/include/hal/twai_types.h
index 7f3789fe2b..d22c50d3ff 100644
--- a/components/hal/include/hal/twai_types.h
+++ b/components/hal/include/hal/twai_types.h
@@ -27,6 +27,7 @@ extern "C" {
 #define TWAI_ERR_PASS_THRESH            128         /**< Error counter threshold for error passive */
 
 /** @cond */    //Doxy command to hide preprocessor definitions from docs
+
 /**
  * @brief   TWAI Message flags
  *