EMTime/libopencm3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: use common naming for peripheral apis

Browse Source 
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.
This commit is contained in:
Karl Palsson
2018-02-14 23:33:26 +00:00
parent 7b9baabd69
commit b47b967440
21 changed files with 58 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
lib/stm32/common/adc_common_v1.c
View File

@@ -1,4 +1,5 @@
/** @addtogroup adc_file
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@author @htmlonly © @endhtmlonly
2009 Edward Cheeseman <evbuilder@users.sourceforge.net>

3
lib/stm32/common/adc_common_v2.c
View File

@@ -1,4 +1,5 @@
/** @addtogroup adc_file
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly
2015 Karl Palsson <karlp@tweak.net.au>

3
lib/stm32/common/adc_common_v2_multi.c
View File

@@ -1,4 +1,5 @@
/** @addtogroup adc_file
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly
2016 Karl Palsson <karlp@tweak.net.au>

3
lib/stm32/common/usart_common_all.c
View File

@@ -1,4 +1,5 @@
/** @addtogroup usart_file
/** @addtogroup usart_file USART peripheral API
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>

1
lib/stm32/common/usart_common_f124.c
View File

@@ -1,4 +1,5 @@
/** @addtogroup usart_file
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>

1
lib/stm32/common/usart_common_v2.c
View File

@@ -1,4 +1,5 @@
/** @addtogroup usart_file
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly 2016 Cem Basoglu <cem.basoglu@web.de>

7
lib/stm32/f0/adc.c
View File

@@ -1,8 +1,5 @@
/** @defgroup adc_file ADC
*
* @ingroup STM32F0xx
*
* @brief <b>libopencm3 STM32F0xx Analog to Digital Converters</b>
/** @addtogroup adc_file ADC peripheral API
* @ingroup peripheral_apis
*
* based on F3 file
*

7
lib/stm32/f1/adc.c
View File

@@ -1,8 +1,5 @@
/** @defgroup adc_file ADC
@ingroup STM32F1xx
@brief <b>libopencm3 STM32F1xx Analog to Digital Converters</b>
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@version 1.0.0

7
lib/stm32/f3/adc.c
View File

@@ -1,8 +1,5 @@
/** @defgroup adc_file ADC
*
* @ingroup STM32F3xx
*
* @brief <b>libopencm3 STM32F3xx Analog to Digital Converters</b>
/** @addtogroup adc_file ADC peripheral API
* @ingroup peripheral_apis
*
* @author @htmlonly &copy; @endhtmlonly 2012
* Ken Sarkies <ksarkies@internode.on.net>

7
lib/stm32/f4/adc.c
View File

@@ -1,8 +1,5 @@
/** @defgroup adc_file ADC
@ingroup STM32F4xx
@brief <b>libopencm3 STM32F4xx Analog to Digital Converters</b>
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly 2012
Ken Sarkies <ksarkies@internode.on.net>

7
lib/stm32/l1/adc.c
View File

@@ -1,8 +1,5 @@
/** @defgroup adc_file ADC
@ingroup STM32L1xx
@brief <b>libopencm3 STM32L1xx Analog to Digital Converters</b>
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly 2014 Karl Palsson <karlp@tweak.net.au>

7
lib/stm32/l4/adc.c
View File

@@ -1,8 +1,5 @@
/** @defgroup adc_file ADC
@ingroup STM32L4xx
@brief <b>libopencm3 STM32L4xx Analog to Digital Converters</b>
/** @addtogroup adc_file ADC peripheral API
@ingroup peripheral_apis
@author @htmlonly &copy; @endhtmlonly 2016 Karl Palsson <karlp@tweak.net.au>