Documentation added to flash modules for all STM32 families.

lib/stm32/f3/flash.c

@@ -6,10 +6,22 @@
  *
  * @version 1.0.0
  *
- * @date 11 July 2013
+ * @author @htmlonly © @endhtmlonly 2010
+ * Thomas Otto <tommi@viadmin.org>
+ * @author @htmlonly &copy; @endhtmlonly 2010
+ * Mark Butler <mbutler@physics.otago.ac.nz>
+ *
+ * @date 14 January 2014
+ *
+ * This library supports the FLASH memory controller in the STM32F3
+ * series of ARM Cortex Microcontrollers by ST Microelectronics.
+ *
+ * For the STM32F3xx, accessing FLASH memory is described in
+ * section 3 of the STM32F3xx Reference Manual.
  *
  * LGPL License Terms @ref lgpl_license
  */
+
 /*
  * This file is part of the libopencm3 project.
  *
@@ -30,11 +42,21 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/**@{*/
+
 #include <libopencm3/stm32/flash.h>
 
+/*---------------------------------------------------------------------------*/
+/** @brief Clear All Status Flags
+
+Clears program error, end of operation, busy flags.
+*/
+
 void flash_clear_status_flags(void)
 {
 	flash_clear_pgperr_flag();
 	flash_clear_eop_flag();
 	flash_clear_bsy_flag();
 }
+/**@}*/
+