aboutsummaryrefslogtreecommitdiff
path: root/include/libopencm3/stm32
diff options
context:
space:
mode:
authorKen Sarkies2013-03-07 11:14:06 +1030
committerKen Sarkies2013-03-07 11:14:06 +1030
commite2022f588492d5c117743b6b13801940f4a4b03e (patch)
tree8c70e829e69094361afa51489ef097a5e663ea6c /include/libopencm3/stm32
parent31aa3b6f5a9e9afa4d1bc8661cbaef147af55f74 (diff)
Repair to documentation (most documented files)
to remove errors, duplications and inconsistencies. File lib/stm32/f1/pwr.c - all code removed as it duplicates that in common/pwr_common.c Remaining changes do not affect code. Compiles OK. TODO efm32 has no code so generates no modules TODO F2 needs pwr.c TODO L1 needs dma.h and dma.c
Diffstat (limited to 'include/libopencm3/stm32')
-rw-r--r--include/libopencm3/stm32/common/crc_common_all.h8
-rw-r--r--include/libopencm3/stm32/common/dac_common_all.h6
-rw-r--r--include/libopencm3/stm32/common/dma_common_f13.h8
-rw-r--r--include/libopencm3/stm32/common/dma_common_f24.h7
-rw-r--r--include/libopencm3/stm32/common/gpio_common_all.h7
-rw-r--r--include/libopencm3/stm32/common/gpio_common_f24.h7
-rw-r--r--include/libopencm3/stm32/common/i2c_common_all.h6
-rw-r--r--include/libopencm3/stm32/common/i2c_common_f24.h6
-rw-r--r--include/libopencm3/stm32/common/iwdg_common_all.h6
-rw-r--r--include/libopencm3/stm32/common/pwr_common_all.h6
-rw-r--r--include/libopencm3/stm32/common/rtc_common_bcd.h6
-rw-r--r--include/libopencm3/stm32/common/spi_common_all.h6
-rw-r--r--include/libopencm3/stm32/common/spi_common_f24.h6
-rw-r--r--include/libopencm3/stm32/common/usart_common_all.h6
-rw-r--r--include/libopencm3/stm32/common/usart_common_f24.h7
-rw-r--r--include/libopencm3/stm32/doc-stm32f.h29
-rw-r--r--include/libopencm3/stm32/f1/adc.h2
-rw-r--r--include/libopencm3/stm32/f1/crc.h2
-rw-r--r--include/libopencm3/stm32/f1/dac.h2
-rw-r--r--include/libopencm3/stm32/f1/dma.h5
-rw-r--r--include/libopencm3/stm32/f1/gpio.h4
-rw-r--r--include/libopencm3/stm32/f1/i2c.h3
-rw-r--r--include/libopencm3/stm32/f1/iwdg.h2
-rw-r--r--include/libopencm3/stm32/f1/pwr.h2
-rw-r--r--include/libopencm3/stm32/f1/rtc.h14
-rw-r--r--include/libopencm3/stm32/f1/spi.h2
-rw-r--r--include/libopencm3/stm32/f1/usart.h2
-rw-r--r--include/libopencm3/stm32/f2/crc.h2
-rw-r--r--include/libopencm3/stm32/f2/dac.h2
-rw-r--r--include/libopencm3/stm32/f2/dma.h5
-rw-r--r--include/libopencm3/stm32/f2/gpio.h4
-rw-r--r--include/libopencm3/stm32/f2/i2c.h3
-rw-r--r--include/libopencm3/stm32/f2/iwdg.h2
-rw-r--r--include/libopencm3/stm32/f2/pwr.h13
-rw-r--r--include/libopencm3/stm32/f2/rtc.h4
-rw-r--r--include/libopencm3/stm32/f2/spi.h2
-rw-r--r--include/libopencm3/stm32/f2/usart.h2
-rw-r--r--include/libopencm3/stm32/f4/crc.h2
-rw-r--r--include/libopencm3/stm32/f4/dac.h2
-rw-r--r--include/libopencm3/stm32/f4/dma.h5
-rw-r--r--include/libopencm3/stm32/f4/gpio.h4
-rw-r--r--include/libopencm3/stm32/f4/i2c.h3
-rw-r--r--include/libopencm3/stm32/f4/iwdg.h2
-rw-r--r--include/libopencm3/stm32/f4/pwr.h2
-rw-r--r--include/libopencm3/stm32/f4/rtc.h2
-rw-r--r--include/libopencm3/stm32/f4/spi.h2
-rw-r--r--include/libopencm3/stm32/f4/usart.h2
-rw-r--r--include/libopencm3/stm32/l1/crc.h2
-rw-r--r--include/libopencm3/stm32/l1/dac.h2
-rw-r--r--include/libopencm3/stm32/l1/gpio.h4
-rw-r--r--include/libopencm3/stm32/l1/i2c.h3
-rw-r--r--include/libopencm3/stm32/l1/iwdg.h2
-rw-r--r--include/libopencm3/stm32/l1/rtc.h4
-rw-r--r--include/libopencm3/stm32/l1/spi.h2
-rw-r--r--include/libopencm3/stm32/l1/usart.h2
55 files changed, 117 insertions, 136 deletions
diff --git a/include/libopencm3/stm32/common/crc_common_all.h b/include/libopencm3/stm32/common/crc_common_all.h
index 892f41b..209f19b 100644
--- a/include/libopencm3/stm32/common/crc_common_all.h
+++ b/include/libopencm3/stm32/common/crc_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup crc_defines */
+/** @addtogroup crc_defines
+
+@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
+
+*/
/*
* This file is part of the libopencm3 project.
@@ -19,7 +23,7 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-/* THIS FILE SHOULD NOT BE INCLUDED DIRECTLY, BUT ONLY VIA SPI.H */
+/* THIS FILE SHOULD NOT BE INCLUDED DIRECTLY, BUT ONLY VIA CRC.H */
#ifndef LIBOPENCM3_CRC_COMMON_ALL_H
#define LIBOPENCM3_CRC_COMMON_ALL_H
diff --git a/include/libopencm3/stm32/common/dac_common_all.h b/include/libopencm3/stm32/common/dac_common_all.h
index c843c55..94bf01b 100644
--- a/include/libopencm3/stm32/common/dac_common_all.h
+++ b/include/libopencm3/stm32/common/dac_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup dac_defines */
+/** @addtogroup dac_defines
+
+@author @htmlonly &copy; @endhtmlonly 2012 Felix Held <felix-libopencm3@felixheld.de>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/dma_common_f13.h b/include/libopencm3/stm32/common/dma_common_f13.h
index 964bdf1..68ade00 100644
--- a/include/libopencm3/stm32/common/dma_common_f13.h
+++ b/include/libopencm3/stm32/common/dma_common_f13.h
@@ -1,4 +1,10 @@
-/** @addtogroup dma_defines */
+/** @addtogroup dma_defines
+
+@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
+@author @htmlonly &copy; @endhtmlonly 2012 Piotr Esden-Tempski <piotr@esden.net>
+
+*/
+
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/common/dma_common_f24.h b/include/libopencm3/stm32/common/dma_common_f24.h
index e7c5a16..ecf9fcf 100644
--- a/include/libopencm3/stm32/common/dma_common_f24.h
+++ b/include/libopencm3/stm32/common/dma_common_f24.h
@@ -1,4 +1,9 @@
-/** @addtogroup dma_defines */
+/** @addtogroup dma_defines
+
+@author @htmlonly &copy; @endhtmlonly 2011 Fergus Noble <fergusnoble@gmail.com>
+@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
+
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/common/gpio_common_all.h b/include/libopencm3/stm32/common/gpio_common_all.h
index 9b05fde..4d03db0 100644
--- a/include/libopencm3/stm32/common/gpio_common_all.h
+++ b/include/libopencm3/stm32/common/gpio_common_all.h
@@ -1,4 +1,9 @@
-/** @addtogroup gpio_defines */
+/** @addtogroup gpio_defines
+
+@author @htmlonly &copy; @endhtmlonly 2011 Fergus Noble <fergusnoble@gmail.com>
+@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/gpio_common_f24.h b/include/libopencm3/stm32/common/gpio_common_f24.h
index f8bd4fb..2ce0167 100644
--- a/include/libopencm3/stm32/common/gpio_common_f24.h
+++ b/include/libopencm3/stm32/common/gpio_common_f24.h
@@ -1,4 +1,9 @@
-/** @addtogroup gpio_defines */
+/** @addtogroup gpio_defines
+
+@author @htmlonly &copy; @endhtmlonly 2011 Fergus Noble <fergusnoble@gmail.com>
+@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
+
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/common/i2c_common_all.h b/include/libopencm3/stm32/common/i2c_common_all.h
index d5cc490..7f6d447 100644
--- a/include/libopencm3/stm32/common/i2c_common_all.h
+++ b/include/libopencm3/stm32/common/i2c_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup i2c_defines */
+/** @addtogroup i2c_defines
+
+@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/i2c_common_f24.h b/include/libopencm3/stm32/common/i2c_common_f24.h
index 22a5733..c267bd8 100644
--- a/include/libopencm3/stm32/common/i2c_common_f24.h
+++ b/include/libopencm3/stm32/common/i2c_common_f24.h
@@ -1,4 +1,8 @@
-/** @addtogroup i2c_defines */
+/** @addtogroup i2c_defines
+
+@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/iwdg_common_all.h b/include/libopencm3/stm32/common/iwdg_common_all.h
index ea2ad16..b75e4d1 100644
--- a/include/libopencm3/stm32/common/iwdg_common_all.h
+++ b/include/libopencm3/stm32/common/iwdg_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup iwdg_defines */
+/** @addtogroup iwdg_defines
+
+@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
+
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/common/pwr_common_all.h b/include/libopencm3/stm32/common/pwr_common_all.h
index cc9fd22..a6b38d8 100644
--- a/include/libopencm3/stm32/common/pwr_common_all.h
+++ b/include/libopencm3/stm32/common/pwr_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup pwr_defines */
+/** @addtogroup pwr_defines
+
+@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/rtc_common_bcd.h b/include/libopencm3/stm32/common/rtc_common_bcd.h
index 69a46f5..41afe3f 100644
--- a/include/libopencm3/stm32/common/rtc_common_bcd.h
+++ b/include/libopencm3/stm32/common/rtc_common_bcd.h
@@ -1,4 +1,8 @@
-/** @addtogroup rtc_defines */
+/** @addtogroup rtc_defines
+
+@author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@tweak.net.au>
+
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/common/spi_common_all.h b/include/libopencm3/stm32/common/spi_common_all.h
index 976d679..a337c37 100644
--- a/include/libopencm3/stm32/common/spi_common_all.h
+++ b/include/libopencm3/stm32/common/spi_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup spi_defines */
+/** @addtogroup spi_defines
+
+@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/spi_common_f24.h b/include/libopencm3/stm32/common/spi_common_f24.h
index 6b3764e..0a5873d 100644
--- a/include/libopencm3/stm32/common/spi_common_f24.h
+++ b/include/libopencm3/stm32/common/spi_common_f24.h
@@ -1,4 +1,8 @@
-/** @addtogroup spi_defines */
+/** @addtogroup spi_defines
+
+@author @htmlonly &copy; @endhtmlonly 2011 Fergus Noble <fergusnoble@gmail.com>
+
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/common/usart_common_all.h b/include/libopencm3/stm32/common/usart_common_all.h
index 553ba28..b7ab394 100644
--- a/include/libopencm3/stm32/common/usart_common_all.h
+++ b/include/libopencm3/stm32/common/usart_common_all.h
@@ -1,4 +1,8 @@
-/** @addtogroup usart_defines */
+/** @addtogroup usart_defines
+
+@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/include/libopencm3/stm32/common/usart_common_f24.h b/include/libopencm3/stm32/common/usart_common_f24.h
index 089a0c2..301eceb 100644
--- a/include/libopencm3/stm32/common/usart_common_f24.h
+++ b/include/libopencm3/stm32/common/usart_common_f24.h
@@ -1,4 +1,9 @@
-/** @addtogroup usart_defines */
+/** @addtogroup usart_defines
+
+@author @htmlonly &copy; @endhtmlonly 2011 Uwe Hermann <uwe@hermann-uwe.de>
+@author @htmlonly &copy; @endhtmlonly 2011 Stephen Caudle <scaudle@doceme.com>
+
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/doc-stm32f.h b/include/libopencm3/stm32/doc-stm32f.h
deleted file mode 100644
index 7b0a1a3..0000000
--- a/include/libopencm3/stm32/doc-stm32f.h
+++ /dev/null
@@ -1,29 +0,0 @@
-/** @mainpage libopencm3 STM32 Common
-
-@version 1.0.0
-
-@date 7 September 2012
-
-API documentation for common files for ST Microelectronics STM32 Cortex M3 series.
-
-LGPL License Terms @ref lgpl_license
-*/
-
-/** @defgroup STM32F_defines STM32F Common Defines
-
-@brief Defined Constants and Types for the STM32F series
-
-LGPL License Terms @ref lgpl_license
- */
-
-/** @defgroup STM32F_files STM32F Common Files
-
-@brief Common Files for ST Microelectronics STM32F series.
-
-@version 1.0.0
-
-@date 7 September 2012
-
-LGPL License Terms @ref lgpl_license
-*/
-
diff --git a/include/libopencm3/stm32/f1/adc.h b/include/libopencm3/stm32/f1/adc.h
index a382be2..1121bb1 100644
--- a/include/libopencm3/stm32/f1/adc.h
+++ b/include/libopencm3/stm32/f1/adc.h
@@ -1,4 +1,4 @@
-/** @defgroup STM32F1xx_adc_defines ADC Defines
+/** @defgroup adc_defines ADC Defines
@brief <b>Defined Constants and Types for the STM32F1xx Analog to Digital Converters</b>
diff --git a/include/libopencm3/stm32/f1/crc.h b/include/libopencm3/stm32/f1/crc.h
index c3b9939..f31d4de 100644
--- a/include/libopencm3/stm32/f1/crc.h
+++ b/include/libopencm3/stm32/f1/crc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/dac.h b/include/libopencm3/stm32/f1/dac.h
index 1e6ecfa..e68618b 100644
--- a/include/libopencm3/stm32/f1/dac.h
+++ b/include/libopencm3/stm32/f1/dac.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/dma.h b/include/libopencm3/stm32/f1/dma.h
index e0c55a6..bdffa52 100644
--- a/include/libopencm3/stm32/f1/dma.h
+++ b/include/libopencm3/stm32/f1/dma.h
@@ -1,4 +1,4 @@
-/** @defgroup STM32F1xx_dma_defines DMA Defines
+/** @defgroup dma_defines DMA Defines
@ingroup STM32F1xx_defines
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 30 November 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/gpio.h b/include/libopencm3/stm32/f1/gpio.h
index 1e97b73..fb6690c 100644
--- a/include/libopencm3/stm32/f1/gpio.h
+++ b/include/libopencm3/stm32/f1/gpio.h
@@ -6,10 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
-@author @htmlonly &copy; @endhtmlonly 2012 Piotr Esden-Tempski <piotr@esden.net>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 1 July 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/i2c.h b/include/libopencm3/stm32/f1/i2c.h
index 44d906a..8c6ab52 100644
--- a/include/libopencm3/stm32/f1/i2c.h
+++ b/include/libopencm3/stm32/f1/i2c.h
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 12 October 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/iwdg.h b/include/libopencm3/stm32/f1/iwdg.h
index c8a1e85..5a42f08 100644
--- a/include/libopencm3/stm32/f1/iwdg.h
+++ b/include/libopencm3/stm32/f1/iwdg.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/pwr.h b/include/libopencm3/stm32/f1/pwr.h
index 2875492..1cabca3 100644
--- a/include/libopencm3/stm32/f1/pwr.h
+++ b/include/libopencm3/stm32/f1/pwr.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/rtc.h b/include/libopencm3/stm32/f1/rtc.h
index a8a8966..4070919 100644
--- a/include/libopencm3/stm32/f1/rtc.h
+++ b/include/libopencm3/stm32/f1/rtc.h
@@ -1,3 +1,17 @@
+/** @defgroup rtc_defines RTC Defines
+
+@brief <b>Defined Constants and Types for the STM32F1xx Real Time Clock</b>
+
+@ingroup STM32F1xx_defines
+
+@author @htmlonly &copy; @endhtmlonly 2010 Uwe Hermann <uwe@hermann-uwe.de>
+
+@version 1.0.0
+
+@date 4 March 2013
+
+LGPL License Terms @ref lgpl_license
+ */
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/f1/spi.h b/include/libopencm3/stm32/f1/spi.h
index eb434a1..d2fe7c2 100644
--- a/include/libopencm3/stm32/f1/spi.h
+++ b/include/libopencm3/stm32/f1/spi.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f1/usart.h b/include/libopencm3/stm32/f1/usart.h
index 24a8137..f18d255 100644
--- a/include/libopencm3/stm32/f1/usart.h
+++ b/include/libopencm3/stm32/f1/usart.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/crc.h b/include/libopencm3/stm32/f2/crc.h
index bf2d9fe..425eb61 100644
--- a/include/libopencm3/stm32/f2/crc.h
+++ b/include/libopencm3/stm32/f2/crc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/dac.h b/include/libopencm3/stm32/f2/dac.h
index f6e16e7..326706c 100644
--- a/include/libopencm3/stm32/f2/dac.h
+++ b/include/libopencm3/stm32/f2/dac.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/dma.h b/include/libopencm3/stm32/f2/dma.h
index 0eb952c..5396bde 100644
--- a/include/libopencm3/stm32/f2/dma.h
+++ b/include/libopencm3/stm32/f2/dma.h
@@ -1,4 +1,4 @@
-/** @defgroup STM32F2xx_dma_defines DMA Defines
+/** @defgroup dma_defines DMA Defines
@ingroup STM32F2xx_defines
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2011 Fergus Noble <fergusnoble@gmail.com>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 18 October 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/gpio.h b/include/libopencm3/stm32/f2/gpio.h
index 099fb38..f9f000a 100644
--- a/include/libopencm3/stm32/f2/gpio.h
+++ b/include/libopencm3/stm32/f2/gpio.h
@@ -6,10 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
-@author @htmlonly &copy; @endhtmlonly 2012 Piotr Esden-Tempski <piotr@esden.net>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 1 July 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/i2c.h b/include/libopencm3/stm32/f2/i2c.h
index 3dc1652..7cc4bc8 100644
--- a/include/libopencm3/stm32/f2/i2c.h
+++ b/include/libopencm3/stm32/f2/i2c.h
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 12 October 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/iwdg.h b/include/libopencm3/stm32/f2/iwdg.h
index d15f9a9..d25398f 100644
--- a/include/libopencm3/stm32/f2/iwdg.h
+++ b/include/libopencm3/stm32/f2/iwdg.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/pwr.h b/include/libopencm3/stm32/f2/pwr.h
index 7db223d..7c76505 100644
--- a/include/libopencm3/stm32/f2/pwr.h
+++ b/include/libopencm3/stm32/f2/pwr.h
@@ -1,3 +1,16 @@
+/** @defgroup pwr_defines PWR Defines
+
+@brief <b>Defined Constants and Types for the STM32F2xx PWR Control</b>
+
+@ingroup STM32F2xx_defines
+
+@version 1.0.0
+
+@date 4 March 2013
+
+LGPL License Terms @ref lgpl_license
+ */
+
/*
* This file is part of the libopencm3 project.
*
diff --git a/include/libopencm3/stm32/f2/rtc.h b/include/libopencm3/stm32/f2/rtc.h
index ebc0936..e78043c 100644
--- a/include/libopencm3/stm32/f2/rtc.h
+++ b/include/libopencm3/stm32/f2/rtc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
@@ -36,4 +34,4 @@ LGPL License Terms @ref lgpl_license
#include <libopencm3/stm32/memorymap.h>
#include <libopencm3/stm32/common/rtc_common_bcd.h>
-#endif \ No newline at end of file
+#endif
diff --git a/include/libopencm3/stm32/f2/spi.h b/include/libopencm3/stm32/f2/spi.h
index c1a5f45..2c43428 100644
--- a/include/libopencm3/stm32/f2/spi.h
+++ b/include/libopencm3/stm32/f2/spi.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f2/usart.h b/include/libopencm3/stm32/f2/usart.h
index 31314bc..8a4b54c 100644
--- a/include/libopencm3/stm32/f2/usart.h
+++ b/include/libopencm3/stm32/f2/usart.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/crc.h b/include/libopencm3/stm32/f4/crc.h
index 1c375fa..bab8a23 100644
--- a/include/libopencm3/stm32/f4/crc.h
+++ b/include/libopencm3/stm32/f4/crc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/dac.h b/include/libopencm3/stm32/f4/dac.h
index 0961c30..1634fd7 100644
--- a/include/libopencm3/stm32/f4/dac.h
+++ b/include/libopencm3/stm32/f4/dac.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/dma.h b/include/libopencm3/stm32/f4/dma.h
index a3e9db1..1b308de 100644
--- a/include/libopencm3/stm32/f4/dma.h
+++ b/include/libopencm3/stm32/f4/dma.h
@@ -1,4 +1,4 @@
-/** @defgroup STM32F4xx_dma_defines DMA Defines
+/** @defgroup dma_defines DMA Defines
@ingroup STM32F4xx_defines
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2011 Fergus Noble <fergusnoble@gmail.com>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 30 November 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/gpio.h b/include/libopencm3/stm32/f4/gpio.h
index 4eedc6e..dae8b92 100644
--- a/include/libopencm3/stm32/f4/gpio.h
+++ b/include/libopencm3/stm32/f4/gpio.h
@@ -6,10 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
-@author @htmlonly &copy; @endhtmlonly 2012 Piotr Esden-Tempski <piotr@esden.net>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 1 July 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/i2c.h b/include/libopencm3/stm32/f4/i2c.h
index e1a41cf..4f61f40 100644
--- a/include/libopencm3/stm32/f4/i2c.h
+++ b/include/libopencm3/stm32/f4/i2c.h
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 12 October 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/iwdg.h b/include/libopencm3/stm32/f4/iwdg.h
index d5baef4..d708fb5 100644
--- a/include/libopencm3/stm32/f4/iwdg.h
+++ b/include/libopencm3/stm32/f4/iwdg.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/pwr.h b/include/libopencm3/stm32/f4/pwr.h
index c9b27fd..e07d4d7 100644
--- a/include/libopencm3/stm32/f4/pwr.h
+++ b/include/libopencm3/stm32/f4/pwr.h
@@ -8,6 +8,8 @@
@author @htmlonly &copy; @endhtmlonly 2011 Stephen Caudle <scaudle@doceme.com>
+@date 4 March 2013
+
LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/include/libopencm3/stm32/f4/rtc.h b/include/libopencm3/stm32/f4/rtc.h
index 55b5b23..752895b 100644
--- a/include/libopencm3/stm32/f4/rtc.h
+++ b/include/libopencm3/stm32/f4/rtc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/spi.h b/include/libopencm3/stm32/f4/spi.h
index 6589290..5e2c564 100644
--- a/include/libopencm3/stm32/f4/spi.h
+++ b/include/libopencm3/stm32/f4/spi.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/f4/usart.h b/include/libopencm3/stm32/f4/usart.h
index 740f0a8..6669e6b 100644
--- a/include/libopencm3/stm32/f4/usart.h
+++ b/include/libopencm3/stm32/f4/usart.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/crc.h b/include/libopencm3/stm32/l1/crc.h
index 07370f2..8019453 100644
--- a/include/libopencm3/stm32/l1/crc.h
+++ b/include/libopencm3/stm32/l1/crc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/dac.h b/include/libopencm3/stm32/l1/dac.h
index 7f7ea52..8a8854c 100644
--- a/include/libopencm3/stm32/l1/dac.h
+++ b/include/libopencm3/stm32/l1/dac.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/gpio.h b/include/libopencm3/stm32/l1/gpio.h
index 93850a2..c4ab65f 100644
--- a/include/libopencm3/stm32/l1/gpio.h
+++ b/include/libopencm3/stm32/l1/gpio.h
@@ -6,10 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
-@author @htmlonly &copy; @endhtmlonly 2012 Piotr Esden-Tempski <piotr@esden.net>
-@author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@tweak.net.au>
-
@date 1 July 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/i2c.h b/include/libopencm3/stm32/l1/i2c.h
index 1fd419d..c2fd3ab 100644
--- a/include/libopencm3/stm32/l1/i2c.h
+++ b/include/libopencm3/stm32/l1/i2c.h
@@ -6,9 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 12 October 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/iwdg.h b/include/libopencm3/stm32/l1/iwdg.h
index 8ba6c44..54c11eb 100644
--- a/include/libopencm3/stm32/l1/iwdg.h
+++ b/include/libopencm3/stm32/l1/iwdg.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-
@date 18 August 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/rtc.h b/include/libopencm3/stm32/l1/rtc.h
index d364fb5..95331d3 100644
--- a/include/libopencm3/stm32/l1/rtc.h
+++ b/include/libopencm3/stm32/l1/rtc.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
@@ -36,4 +34,4 @@ LGPL License Terms @ref lgpl_license
#include <libopencm3/stm32/memorymap.h>
#include <libopencm3/stm32/common/rtc_common_bcd.h>
-#endif \ No newline at end of file
+#endif
diff --git a/include/libopencm3/stm32/l1/spi.h b/include/libopencm3/stm32/l1/spi.h
index 0484956..92f96d6 100644
--- a/include/libopencm3/stm32/l1/spi.h
+++ b/include/libopencm3/stm32/l1/spi.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license
diff --git a/include/libopencm3/stm32/l1/usart.h b/include/libopencm3/stm32/l1/usart.h
index 5b67a5a..75bb049 100644
--- a/include/libopencm3/stm32/l1/usart.h
+++ b/include/libopencm3/stm32/l1/usart.h
@@ -6,8 +6,6 @@
@version 1.0.0
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-
@date 5 December 2012
LGPL License Terms @ref lgpl_license