From 7df670b6aad223a056e341c391c99d8cee07d840 Mon Sep 17 00:00:00 2001
From: Karl Palsson <karlp@tweak.net.au>
Date: Fri, 29 Jan 2021 12:26:03 +0000
Subject: [PATCH] stm32: usart: fix doxygen for h7 at least

The usart_common_fifos uses a very nice style of docs in the headers, so
inline help works in some editors, without having to have the source of
the library available as well.  However, it means that the group
definition with the name doesn't appear until later, and then the title
is ignored.  Move the description to the header definition instead.
---
 include/libopencm3/stm32/common/usart_common_fifos.h | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/include/libopencm3/stm32/common/usart_common_fifos.h b/include/libopencm3/stm32/common/usart_common_fifos.h
index 5eb5d376..1124bd64 100644
--- a/include/libopencm3/stm32/common/usart_common_fifos.h
+++ b/include/libopencm3/stm32/common/usart_common_fifos.h
@@ -92,8 +92,10 @@ typedef enum {
 
 BEGIN_DECLS
 
-/** @addtogroup usart_file
-@{*/
+/** @defgroup usart_file USART peripheral API
+ * @ingroup peripheral_apis
+ * @{
+ */
 /**
  * Enable FIFOs on the specified USART.
  * @param[in] usart  Base address of USART to configure FIFOs.