From 46514e75c0a614c8835d4a360b61b4202b992be1 Mon Sep 17 00:00:00 2001
From: Karl Palsson <karlp@etactica.com>
Date: Tue, 25 Jun 2019 09:27:42 +0000
Subject: [PATCH] doc: efm32: dma: tag headers properly

---
 include/libopencm3/efm32/common/dma_common.h | 10 ++++++----
 include/libopencm3/efm32/ezr32wg/dma.h       | 13 +++++++++----
 include/libopencm3/efm32/lg/dma.h            | 13 +++++++++----
 include/libopencm3/efm32/wg/dma.h            | 13 +++++++++----
 4 files changed, 33 insertions(+), 16 deletions(-)

diff --git a/include/libopencm3/efm32/common/dma_common.h b/include/libopencm3/efm32/common/dma_common.h
index 6e46d9d0..d274979a 100644
--- a/include/libopencm3/efm32/common/dma_common.h
+++ b/include/libopencm3/efm32/common/dma_common.h
@@ -1,3 +1,5 @@
+/** @addtogroup dma_defines
+ */
 /*
  * This file is part of the libopencm3 project.
  *
@@ -17,12 +19,13 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef LIBOPENCM3_EFM32_DMA_H
-#define LIBOPENCM3_EFM32_DMA_H
+#pragma once
 
 #include <libopencm3/efm32/memorymap.h>
 #include <libopencm3/cm3/common.h>
 
+/**@{*/
+
 /*
  * As per the datasheet, it is an PL230 (licenced from ARM)
  *  note: but only implement 12 channel (PL230 can have upto 32 channels)
@@ -908,5 +911,4 @@ void dma_desc_set_mode(uint32_t desc_base, enum dma_ch ch, enum dma_mode mode);
 
 END_DECLS
 
-#endif
-
+/**@}*/
\ No newline at end of file
diff --git a/include/libopencm3/efm32/ezr32wg/dma.h b/include/libopencm3/efm32/ezr32wg/dma.h
index 4f47a448..4697186e 100644
--- a/include/libopencm3/efm32/ezr32wg/dma.h
+++ b/include/libopencm3/efm32/ezr32wg/dma.h
@@ -1,3 +1,11 @@
+/** @defgroup dma_defines DMA Defines
+ *
+ * @brief <b>Defined Constants and Types for the DMA module</b>
+ *
+ * @ingroup EZR32WG_defines
+ *
+ * LGPL License Terms @ref lgpl_license
+ */
 /*
  * This file is part of the libopencm3 project.
  *
@@ -17,9 +25,6 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef LIBOPENCM3_EFM32_EZR32WG_DMA_H
-#define LIBOPENCM3_EFM32_EZR32WG_DMA_H
+#pragma once
 
 #include <libopencm3/efm32/common/dma_common.h>
-
-#endif
diff --git a/include/libopencm3/efm32/lg/dma.h b/include/libopencm3/efm32/lg/dma.h
index f32149a1..57d4ddd0 100644
--- a/include/libopencm3/efm32/lg/dma.h
+++ b/include/libopencm3/efm32/lg/dma.h
@@ -1,3 +1,11 @@
+/** @defgroup dma_defines DMA Defines
+ *
+ * @brief <b>Defined Constants and Types for the DMA module</b>
+ *
+ * @ingroup EFM32LG_defines
+ *
+ * LGPL License Terms @ref lgpl_license
+ */
 /*
  * This file is part of the libopencm3 project.
  *
@@ -17,9 +25,6 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef LIBOPENCM3_EFM32_LG_DMA_H
-#define LIBOPENCM3_EFM32_LG_DMA_H
+#pragma once
 
 #include <libopencm3/efm32/common/dma_common.h>
-
-#endif
diff --git a/include/libopencm3/efm32/wg/dma.h b/include/libopencm3/efm32/wg/dma.h
index cb4e9fa4..803273f9 100644
--- a/include/libopencm3/efm32/wg/dma.h
+++ b/include/libopencm3/efm32/wg/dma.h
@@ -1,3 +1,11 @@
+/** @defgroup dma_defines DMA Defines
+ *
+ * @brief <b>Defined Constants and Types for the DMA module</b>
+ *
+ * @ingroup EFM32WG_defines
+ *
+ * LGPL License Terms @ref lgpl_license
+ */
 /*
  * This file is part of the libopencm3 project.
  *
@@ -17,9 +25,6 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef LIBOPENCM3_EFM32_WG_DMA_H
-#define LIBOPENCM3_EFM32_WG_DMA_H
+#pragma once
 
 #include <libopencm3/efm32/common/dma_common.h>
-
-#endif