diff --git a/include/libopencm3/stm32/h7/flash.h b/include/libopencm3/stm32/h7/flash.h
index 5fb258c2..1da9d1c6 100644
--- a/include/libopencm3/stm32/h7/flash.h
+++ b/include/libopencm3/stm32/h7/flash.h
@@ -34,7 +34,8 @@
 
 /** @addtogroup flash_acr_values FLASH_ACR values
  * @ingroup flash_registers
-@{*/
+ * @{
+ */
 #define FLASH_ACR_WRHF_VOS1_70MHZ     (0 << FLASH_ACR_WRHIGHFREQ_SHIFT)
 #define FLASH_ACR_WRHF_VOS1_185MHZ    (1 << FLASH_ACR_WRHIGHFREQ_SHIFT)
 #define FLASH_ACR_WRHF_VOS1_225MHZ    (2 << FLASH_ACR_WRHIGHFREQ_SHIFT)
@@ -44,7 +45,7 @@
 #define FLASH_ACR_WRHF_VOS3_45MHZ     (0 << FLASH_ACR_WRHIGHFREQ_SHIFT)
 #define FLASH_ACR_WRHF_VOS3_135MHZ    (1 << FLASH_ACR_WRHIGHFREQ_SHIFT)
 #define FLASH_ACR_WRHF_VOS3_225MHZ    (2 << FLASH_ACR_WRHIGHFREQ_SHIFT)
-/*@}*/
+/**@}*/
 #define FLASH_ACR_WRHIGHFREQ_MASK     (0x3)
 #define FLASH_ACR_WRHIGHFREQ_SHIFT    (0x4)
 
diff --git a/include/libopencm3/stm32/h7/pwr.h b/include/libopencm3/stm32/h7/pwr.h
index e0ef4db6..714d6436 100644
--- a/include/libopencm3/stm32/h7/pwr.h
+++ b/include/libopencm3/stm32/h7/pwr.h
@@ -27,9 +27,7 @@ LGPL License Terms @ref lgpl_license
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef LIBOPENCM3_PWR_H
-#define LIBOPENCM3_PWR_H
-
+#pragma once
 /**@{*/
 
 /** @defgroup pwr_registers PWR Registers
@@ -55,7 +53,7 @@ LGPL License Terms @ref lgpl_license
 /** Wakeup Domain Power Control register. */
 #define PWR_WKUPCR      MMIO32(POWER_CONTROL_BASE + 0x20)
 
-/*@}*/
+/**@}*/
 
 /** VOS[15:14]: Regulator voltage scaling output selection */
 #define PWR_CR1_SVOS_SHIFT        14
@@ -130,5 +128,3 @@ void pwr_set_vos_scale(enum pwr_vos_scale scale);
 END_DECLS
 
 /**@}*/
-
-#endif
diff --git a/include/libopencm3/stm32/h7/rcc.h b/include/libopencm3/stm32/h7/rcc.h
index ebef3935..32a1058e 100644
--- a/include/libopencm3/stm32/h7/rcc.h
+++ b/include/libopencm3/stm32/h7/rcc.h
@@ -810,6 +810,5 @@ void rcc_set_rng_clksel(uint8_t clksel);
 
 END_DECLS
 /**@}*/
-/**@}*/
 
 #endif