From 03cfd6b1ac540841e81b9aac01043f5a4555de9b Mon Sep 17 00:00:00 2001
From: Karl Palsson <karlp@tweak.net.au>
Date: Sun, 24 Jan 2021 21:38:50 +0000
Subject: [PATCH] stm32: dac: doxygen grouping for register bases

---
 include/libopencm3/stm32/f0/dac.h |  8 +++++---
 include/libopencm3/stm32/f1/dac.h | 10 ++++++----
 include/libopencm3/stm32/f2/dac.h |  9 ++++++---
 include/libopencm3/stm32/f3/dac.h |  4 ++++
 include/libopencm3/stm32/f4/dac.h |  9 ++++++---
 include/libopencm3/stm32/f7/dac.h |  9 ++++++---
 include/libopencm3/stm32/g4/dac.h |  9 ++++++---
 include/libopencm3/stm32/h7/dac.h |  9 ++++++---
 include/libopencm3/stm32/l1/dac.h |  9 ++++++---
 include/libopencm3/stm32/l4/dac.h |  9 ++++++---
 10 files changed, 57 insertions(+), 28 deletions(-)

diff --git a/include/libopencm3/stm32/f0/dac.h b/include/libopencm3/stm32/f0/dac.h
index 24998510..0bb2acc9 100644
--- a/include/libopencm3/stm32/f0/dac.h
+++ b/include/libopencm3/stm32/f0/dac.h
@@ -35,12 +35,14 @@
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
 
 
+/**@}*/
 
 #endif
diff --git a/include/libopencm3/stm32/f1/dac.h b/include/libopencm3/stm32/f1/dac.h
index 4db221be..2b62709d 100644
--- a/include/libopencm3/stm32/f1/dac.h
+++ b/include/libopencm3/stm32/f1/dac.h
@@ -32,12 +32,14 @@ LGPL License Terms @ref lgpl_license
 #define LIBOPENCM3_DAC_H
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
+/**@{*/
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
-
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
 
diff --git a/include/libopencm3/stm32/f2/dac.h b/include/libopencm3/stm32/f2/dac.h
index 60bf6924..50c71143 100644
--- a/include/libopencm3/stm32/f2/dac.h
+++ b/include/libopencm3/stm32/f2/dac.h
@@ -33,11 +33,14 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
 
diff --git a/include/libopencm3/stm32/f3/dac.h b/include/libopencm3/stm32/f3/dac.h
index ab82f494..04dcfc80 100644
--- a/include/libopencm3/stm32/f3/dac.h
+++ b/include/libopencm3/stm32/f3/dac.h
@@ -33,6 +33,8 @@
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
+/**@{*/
+
 /** @defgroup dac_reg_base DAC register base addresses
 @ingroup STM32xx_dac_defines
 @{*/
@@ -40,5 +42,7 @@
 #define DAC2		DAC2_BASE
 /**@}*/
 
+/**@}*/
+
 #endif
 
diff --git a/include/libopencm3/stm32/f4/dac.h b/include/libopencm3/stm32/f4/dac.h
index c6279636..291bfbae 100644
--- a/include/libopencm3/stm32/f4/dac.h
+++ b/include/libopencm3/stm32/f4/dac.h
@@ -33,10 +33,13 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
diff --git a/include/libopencm3/stm32/f7/dac.h b/include/libopencm3/stm32/f7/dac.h
index 5f9df3f5..8628c61e 100644
--- a/include/libopencm3/stm32/f7/dac.h
+++ b/include/libopencm3/stm32/f7/dac.h
@@ -33,10 +33,13 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
diff --git a/include/libopencm3/stm32/g4/dac.h b/include/libopencm3/stm32/g4/dac.h
index bd1c1ce2..b0a5d4a0 100644
--- a/include/libopencm3/stm32/g4/dac.h
+++ b/include/libopencm3/stm32/g4/dac.h
@@ -33,14 +33,17 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v2.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC1_BASE
 #define DAC2				DAC2_BASE
 #define DAC3				DAC3_BASE
 #define DAC4				DAC4_BASE
 #define DAC5				DAC5_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
diff --git a/include/libopencm3/stm32/h7/dac.h b/include/libopencm3/stm32/h7/dac.h
index 834ecd77..54ec1f02 100644
--- a/include/libopencm3/stm32/h7/dac.h
+++ b/include/libopencm3/stm32/h7/dac.h
@@ -33,10 +33,13 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v2.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
diff --git a/include/libopencm3/stm32/l1/dac.h b/include/libopencm3/stm32/l1/dac.h
index 267b6184..0601c0f6 100644
--- a/include/libopencm3/stm32/l1/dac.h
+++ b/include/libopencm3/stm32/l1/dac.h
@@ -33,11 +33,14 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif
 
diff --git a/include/libopencm3/stm32/l4/dac.h b/include/libopencm3/stm32/l4/dac.h
index 82cddded..17f6833f 100644
--- a/include/libopencm3/stm32/l4/dac.h
+++ b/include/libopencm3/stm32/l4/dac.h
@@ -33,11 +33,14 @@ LGPL License Terms @ref lgpl_license
 
 #include <libopencm3/stm32/common/dac_common_v1.h>
 
-/*****************************************************************************/
-/* Module definitions                                                        */
-/*****************************************************************************/
+/**@{*/
 
+/** @defgroup dac_reg_base DAC register base addresses
+@{*/
 #define DAC1				DAC_BASE
+/**@}*/
+
+/**@}*/
 
 #endif