Only applied to STM32 doc trees at present. Instead of declaring a group for "STM32blah" in the doc-blah.h files, and then trying to put all the common+specific peripheral code into those groups, (which is what led to the stub doxygen holder empty .c files) Just use a standard name like "Peripheral APIS" and place everything into that. Demonstrated by converting ADC and USART peripherals, which is definitely not complete, but it shows how to make things less magical, and less prone to copy/paste errors. Now, you can copy/paste and it will do the right thing, because everyone uses the same group names. This is also how to unify the mix of "STM32blah->Periphblah" and _also_ the dangling "periph_file" modules in doxygen, it merges them together properly, as they're intended to be really.
37 lines
676 B
C
37 lines
676 B
C
/** @mainpage libopencm3 STM32F3
|
|
*
|
|
* @version 1.0.0
|
|
*
|
|
* @date 11 July 2013
|
|
*
|
|
* API documentation for ST Microelectronics STM32F3 Cortex M3 series.
|
|
*
|
|
* LGPL License Terms @ref lgpl_license
|
|
*/
|
|
|
|
/** @defgroup peripheral_apis Peripheral APIs
|
|
* APIs for device peripherals
|
|
*/
|
|
|
|
/** @defgroup STM32F3xx STM32F3xx
|
|
* Libraries for ST Microelectronics STM32F3xx series.
|
|
*
|
|
* @version 1.0.0
|
|
*
|
|
* @date 11 July 2013
|
|
*
|
|
* LGPL License Terms @ref lgpl_license
|
|
*/
|
|
|
|
/** @defgroup STM32F3xx_defines STM32F3xx Defines
|
|
*
|
|
* @brief Defined Constants and Types for the STM32F3xx series
|
|
*
|
|
* @version 1.0.0
|
|
*
|
|
* @date 11 July 2013
|
|
*
|
|
* LGPL License Terms @ref lgpl_license
|
|
*/
|
|
|