diff --git a/include/libopencm3/stm32/common/rtc_common_l1f024.h b/include/libopencm3/stm32/common/rtc_common_l1f024.h
index 66cce5f7..4ae116b8 100644
--- a/include/libopencm3/stm32/common/rtc_common_l1f024.h
+++ b/include/libopencm3/stm32/common/rtc_common_l1f024.h
@@ -1,8 +1,14 @@
 /** @addtogroup rtc_defines
-
-@author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@tweak.net.au>
-
-*/
+ * @author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@tweak.net.au>
+ *
+ * @brief This covers the "version 2" RTC peripheral.
+ *
+ * This is completely different
+ * to the v1 RTC periph on the F1 series devices.  It has BCD counters, with
+ * automatic leapyear corrections and daylight savings support.
+ * This peripheral is used on the F0, F2, F3, F4 and L1 devices, though some
+ * only support a subset.
+ */
 /*
  * This file is part of the libopencm3 project.
  *
@@ -22,14 +28,6 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/*
- * This covers the "version 2" RTC peripheral.  This is completely different
- * to the v1 RTC periph on the F1 series devices.  It has BCD counters, with
- * automatic leapyear corrections and daylight savings support.
- * This peripheral is used on the F0, F2, F3, F4 and L1 devices, though some
- * only support a subset.
- */
-
 /* THIS FILE SHOULD NOT BE INCLUDED DIRECTLY, BUT ONLY VIA RTC.H
 The order of header inclusion is important. rtc.h includes the device
 specific memorymap.h header before including this header file.*/