Deduplication of flash code for STM32F0 and F1.

Extension of code for STM32F1 to allow for dual bank series XL.
Small changes to documentation for F2, F4 and L1 to add a parameter reference.

Tested with STM32F103RBT6
(note: tests show that the PG bit must be cleared after programming, otherwise
a subsequent erase attempt fails. This has been added to flash_program_half_word
for F0 and F1 only. A fix for the other families is not included in this PR.)

lib/stm32/common/flash_common_f24.c

@@ -21,7 +21,6 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
-/**@{*/
 
 /**@{*/
 
@@ -396,8 +395,7 @@ void flash_erase_all_sectors(uint32_t program_size)
 /** @brief Program the Option Bytes
 
 This performs all operations necessary to program the option bytes.
-The write protect error flag should be checked separately for the event that
-an option byte was not properly erased.
+The option bytes do not need to be erased first.
 
 @param[in] uint32_t data to be programmed.
 */