doc: stm32: move RCC to peripheral api style

For f7, it was completely missing doc markers

lib/stm32/common/rcc_common_all.c

@@ -1,3 +1,6 @@
+/** @addtogroup rcc_file RCC peripheral API
+ * @ingroup peripheral_apis
+ */
 /*
  * This file is part of the libopencm3 project.
  *

lib/stm32/f0/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup STM32F0xx-rcc-file RCC
+/** @defgroup rcc_file RCC Peripheral API
  *
- * @ingroup STM32F0xx
+ * @ingroup peripheral_apis
  *
  * @brief <b>libopencm3 STM32F0xx Reset and Clock Control</b>
  *

lib/stm32/f1/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup STM32F1xx-rcc-file RCC
+/** @defgroup rcc_file RCC Peripheral API
 
-@ingroup STM32F1xx
+@ingroup peripheral_apis
 
 @brief <b>libopencm3 STM32F1xx Reset and Clock Control</b>
 

lib/stm32/f2/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup rcc_file RCC
+/** @defgroup rcc_file RCC Peripheral API
  *
- * @ingroup STM32F2xx
+ * @ingroup peripheral_apis
  *
  * @section rcc_f2_api_ex Reset and Clock Control API.
  *

lib/stm32/f3/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup rcc_file RCC
+/** @defgroup rcc_file RCC Peripheral API
  *
- * @ingroup STM32F3xx
+ * @ingroup peripheral_apis
  *
  * @brief <b>libopencm3 STM32F3xx Reset and Clock Control</b>
  *

lib/stm32/f4/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup rcc_file RCC
+/** @defgroup rcc_file RCC Peripheral API
  *
- * @ingroup STM32F4xx
+ * @ingroup peripheral_apis
  *
  * @section rcc_f4_api_ex Reset and Clock Control API.
  *

lib/stm32/f7/rcc.c

@@ -1,8 +1,19 @@
+/** @defgroup rcc_file RCC Peripheral API
+ *
+ * @ingroup peripheral_apis
+ * This library supports the Reset and Clock Control System in the STM32 series
+ * of ARM Cortex Microcontrollers by ST Microelectronics.
+ *
+ * LGPL License Terms @ref lgpl_license
+ */
+
 #include <libopencm3/cm3/assert.h>
 #include <libopencm3/stm32/rcc.h>
 #include <libopencm3/stm32/pwr.h>
 #include <libopencm3/stm32/flash.h>
 
+/**@{*/
+
 uint32_t rcc_ahb_frequency = 16000000;
 uint32_t rcc_apb1_frequency = 16000000;
 uint32_t rcc_apb2_frequency = 16000000;
@@ -472,3 +483,5 @@ void rcc_clock_setup_hsi(const struct rcc_clock_scale *clock)
 	rcc_apb1_frequency = clock->apb1_frequency;
 	rcc_apb2_frequency = clock->apb2_frequency;
 }
+
+/**@}*/

lib/stm32/l0/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup STM32L0xx-rcc-file RCC
+/** @defgroup rcc_file RCC peripheral API
  *
- * @ingroup STM32L0xx
+ * @ingroup peripheral_apis
  *
  * @brief <b>libopencm3 STM32L0xx Reset and Clock Control</b>
  *

lib/stm32/l1/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup STM32L1xx-rcc-file RCC
+/** @defgroup rcc_file RCC Peripheral API
 
-@ingroup STM32L1xx
+@ingroup peripheral_apis
 
 @brief <b>libopencm3 STM32L1xx Reset and Clock Control</b>
 

lib/stm32/l4/rcc.c

@@ -1,6 +1,6 @@
-/** @defgroup rcc_file RCC
+/** @defgroup rcc_file RCC peripheral API
  *
- * @ingroup STM32L4xx
+ * @ingroup peripheral_apis
  *
  * @section rcc_l4_api_ex Reset and Clock Control API.
  *