From 6f81e492905269fafbd305ccaa2d79a70a94da2e Mon Sep 17 00:00:00 2001
From: Karl Palsson <karlp@tweak.net.au>
Date: Thu, 10 Dec 2020 21:34:49 +0000
Subject: [PATCH] stm32:crc: simplify doxygen and fix groupings

The @cond stuff has always been a lot of work for the rare cases of
people trying to include things by hand.  Just drop it
---
 .../libopencm3/stm32/common/crc_common_all.h  | 26 ++-----------------
 1 file changed, 2 insertions(+), 24 deletions(-)

diff --git a/include/libopencm3/stm32/common/crc_common_all.h b/include/libopencm3/stm32/common/crc_common_all.h
index 360e5cc1..c01b97a3 100644
--- a/include/libopencm3/stm32/common/crc_common_all.h
+++ b/include/libopencm3/stm32/common/crc_common_all.h
@@ -27,12 +27,7 @@
 The order of header inclusion is important. crc.h includes the device
 specific memorymap.h header before including this header file.*/
 
-/** @cond */
-#ifdef LIBOPENCM3_CRC_H
-/** @endcond */
-#ifndef LIBOPENCM3_CRC_COMMON_ALL_H
-#define LIBOPENCM3_CRC_COMMON_ALL_H
-
+#pragma once
 /**@{*/
 
 /*****************************************************************************/
@@ -53,7 +48,7 @@ specific memorymap.h header before including this header file.*/
 
 /** CRC_CR Control register */
 #define CRC_CR				MMIO32(CRC_BASE + 0x08)
-/*@}*/
+/**@}*/
 
 /*****************************************************************************/
 /* Register values                                                           */
@@ -76,17 +71,8 @@ specific memorymap.h header before including this header file.*/
 #define CRC_CR_RESET			(1 << 0)
 /**@}*/
 
-/*****************************************************************************/
-/* API definitions                                                           */
-/*****************************************************************************/
-
-/*****************************************************************************/
-/* API Functions                                                             */
-/*****************************************************************************/
-
 BEGIN_DECLS
 
-/* TODO */
 
 /**
  * Reset the CRC calculator to initial values.
@@ -115,11 +101,3 @@ uint32_t crc_calculate_block(uint32_t *datap, int size);
 END_DECLS
 
 /**@}*/
-
-#endif
-/** @cond */
-#else
-#warning "crc_common_all.h should not be included explicitly, only via crc.h"
-#endif
-/** @endcond */
-