[README] Coarse sweep to use markup in READMEs.

This should improve online readability of the readme files.

examples/lpc/lpc13xx/lpc-p1343/miniblink/README.md

@@ -1,9 +1,7 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This is the smallest-possible example program using libopencm3.
 
-It's intended for the NXP LPC1343-based Olimex LPC-1343 eval board (see
-http://olimex.com/dev/lpc-p1343.html for details). It should blink
-a LED on the board.
+It's intended for the NXP LPC1343-based
+[Olimex LPC-1343 eval board](http://olimex.com/dev/lpc-p1343.html for details).
+It should blink a LED on the board.

examples/lpc/lpc17xx/blueboard-lpc1768-h/miniblink/README.md

@@ -1,9 +1,7 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This is the smallest-possible example program using libopencm3.
 
-It's intended for the NXP LPC1768-based NGX Blueboard-LPC1768-H eval board (see
-http://shop.ngxtechnologies.com/product_info.php?cPath=21&products_id=65). It should blink
-a LED on the board.
+It's intended for the NXP LPC1768-based
+[NGX Blueboard-LPC1768-H eval board](http://shop.ngxtechnologies.com/product_info.php?cPath=21&products_id=65).
+It should blink a LED on the board.

examples/lpc/lpc43xx/diolan-lpc-4350-db1/README.md

@@ -1,3 +1,4 @@
-These example programs are written for the Diolan LPC-4350-DB1:
+# README
 
-http://www.diolan.com/lpc4350-features.html
+These example programs are written for the 
+[Diolan LPC-4350-DB1](http://www.diolan.com/lpc4350-features.html)

examples/lpc/lpc43xx/diolan-lpc-4350-db1/miniblink/README.md

@@ -1,11 +1,7 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This is the smallest-possible example program using libopencm3.
 
-It's intended for the Diolan LPC-4350-DB1:
-
-http://www.diolan.com/lpc4350-features.html
+It's intended for the [Diolan LPC-4350-DB1](http://www.diolan.com/lpc4350-features.html).
 
 It should blink D2 on the board.

examples/lpc/lpc43xx/hackrf-jellybean/README.md

@@ -1,4 +1,4 @@
-These example programs are written for the Jellybean development board from the
-HackRF project:
+# README
 
-https://github.com/mossmann/hackrf
+These example programs are written for the Jellybean development board from the
+[HackRF project](https://github.com/mossmann/hackrf)

examples/lpc/lpc43xx/hackrf-jellybean/i2c/README.md

@@ -1,6 +1,4 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This program exercises the I2C peripheral on Jellybean's LPC43xx.  You can
 scope SCL on P6 pin 3 and SDA on P6 pin 5.  If Lemondrop is connected, LED1
@@ -8,8 +6,8 @@ will illuminate if I2C communication to the Si5351C on Lemondrop is successful.
 
 Required Lemondrop -> Jellybean connections:
 
-SCL: Lemondrop P7 pin 3 -> Jellybean P6 pin 3
-SDA: Lemondrop P7 pin 5 -> Jellybean P6 pin 5
-VCC: Lemondrop P4 pin 2, 4, or 6 -> Jellybean P17 pin 2, 4, or 6
-1V8: Lemondrop P11 pin 2, 4, or 6 -> Jellybean P16 pin 2, 4, or 6
-GND: Lemondrop P5 -> Jellybean P13
+    SCL: Lemondrop P7 pin 3 -> Jellybean P6 pin 3
+    SDA: Lemondrop P7 pin 5 -> Jellybean P6 pin 5
+    VCC: Lemondrop P4 pin 2, 4, or 6 -> Jellybean P17 pin 2, 4, or 6
+    1V8: Lemondrop P11 pin 2, 4, or 6 -> Jellybean P16 pin 2, 4, or 6
+    GND: Lemondrop P5 -> Jellybean P13

examples/lpc/lpc43xx/hackrf-jellybean/miniblink/README.md

@@ -1,11 +1,8 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This is the smallest-possible example program using libopencm3.
 
-It's intended for the Jellybean development board from the HackRF project:
-
-https://github.com/mossmann/hackrf
+It's intended for the Jellybean development board from the
+[HackRF project](https://github.com/mossmann/hackrf)
 
 It should blink LED1 on the board.

examples/lpc/lpc43xx/hackrf-jellybean/miniblink_rom_to_ram/README.md

@@ -1,12 +1,9 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This is the smallest-possible example program using libopencm3.
 
-It's intended for the Jellybean development board from the HackRF project:
-
-https://github.com/mossmann/hackrf
+It's intended for the Jellybean development board from the
+[HackRF project](https://github.com/mossmann/hackrf)
 
 It should blink LED1 on the board.
 This example copy the Code from ROM to RAM and execute code from RAM.

examples/lpc/lpc43xx/hackrf-jellybean/ssp/README.md

@@ -1,6 +1,4 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This program exercises the SSP1 peripheral on Jellybean's LPC43xx.
 
@@ -13,36 +11,36 @@ This program exercises the SSP1 peripheral on Jellybean's LPC43xx.
 ||------|----------|
 |-------|
 
-SSP1_MISO: Jellybean P9 SPI Pin6
-SSP1_MOSI: Jellybean P9 SPI Pin4
-SSP1_SCK:  Jellybean P9 SPI Pin2
-SSP1_SSEL: Jellybean P9 SPI Pin3
-GND: Can be connected to P12 SD Pin1
+    SSP1_MISO: Jellybean P9 SPI Pin6
+    SSP1_MOSI: Jellybean P9 SPI Pin4
+    SSP1_SCK:  Jellybean P9 SPI Pin2
+    SSP1_SSEL: Jellybean P9 SPI Pin3
+    GND: Can be connected to P12 SD Pin1
 
 PCLK clock source is PLL1 288MHz (from IRC 96MHz boot from SPIFI)
 Freq = PCLK / (CPSDVSR * [SCR+1]).
 
 By default (CPSDVSR=0 => Means MAX Divisor)
-SSP1->CR0->SCR = 0x00 => CLK Freq 1.126MHz
-SSP1->CR0->SCR = 0x01 => MOSI Freq 566.9KHz
-...
+    SSP1->CR0->SCR = 0x00 => CLK Freq 1.126MHz
+    SSP1->CR0->SCR = 0x01 => MOSI Freq 566.9KHz
+    ...
 
-Test Oscilloscpe:
-SCR=0, CPSDVSR=32 => CLK 9.025MHz
-SCR=1,  CPSDVSR=2 => CLK 73MHz
-SCR=2,  CPSDVSR=2 => CLK 49MHz
-SCR=4,  CPSDVSR=2 => CLK 29MHz
-SCR=8,  CPSDVSR=2 => CLK 16MHz
-SCR=16, CPSDVSR=2 => CLK 8.5MHz
-SCR=32, CPSDVSR=2 => CLK 4.386MHz
-SCR=64, CPSDVSR=2 => CLK 2.227MHz
-SCR=1, CPSDVSR=64 => CLK 2.262MHz
+_Test Oscilloscpe_:
+    SCR=0, CPSDVSR=32 => CLK 9.025MHz
+    SCR=1,  CPSDVSR=2 => CLK 73MHz
+    SCR=2,  CPSDVSR=2 => CLK 49MHz
+    SCR=4,  CPSDVSR=2 => CLK 29MHz
+    SCR=8,  CPSDVSR=2 => CLK 16MHz
+    SCR=16, CPSDVSR=2 => CLK 8.5MHz
+    SCR=32, CPSDVSR=2 => CLK 4.386MHz
+    SCR=64, CPSDVSR=2 => CLK 2.227MHz
+    SCR=1, CPSDVSR=64 => CLK 2.262MHz
 
-Theory:
-SCR=0,  CPSDVSR=32 => 288MHz / (32*(0+1) = 9MHz
-SCR=1,  CPSDVSR=2 => 288MHz / (2*(1+1) = 72MHz
-SCR=4,  CPSDVSR=2 => 288MHz / (2*(4+1) = 28.8MHz
-SCR=32, CPSDVSR=2 => 288MHz / (2*(32+1) = 4.364MHz
-SCR=64, CPSDVSR=2 => 288MHz / (2*(64+1)) = 2.2154MHz
-SCR=128, CPSDVSR=2 => 288MHz / (2*(128+1)) = 1.116MHz
-SCR=1, CPSDVSR=64 => 288MHz / (64*(1+1)) = 2.25MHz
+_Theory_:
+    SCR=0,  CPSDVSR=32 => 288MHz / (32*(0+1) = 9MHz
+    SCR=1,  CPSDVSR=2 => 288MHz / (2*(1+1) = 72MHz
+    SCR=4,  CPSDVSR=2 => 288MHz / (2*(4+1) = 28.8MHz
+    SCR=32, CPSDVSR=2 => 288MHz / (2*(32+1) = 4.364MHz
+    SCR=64, CPSDVSR=2 => 288MHz / (2*(64+1)) = 2.2154MHz
+    SCR=128, CPSDVSR=2 => 288MHz / (2*(128+1)) = 1.116MHz
+    SCR=1, CPSDVSR=64 => 288MHz / (64*(1+1)) = 2.25MHz

examples/lpc/lpc43xx/hackrf-jellybean/systick/README.md

@@ -1,6 +1,4 @@
-------------------------------------------------------------------------------
-README
-------------------------------------------------------------------------------
+# README
 
 This program exercises the SysTick Interrupt of ARM CortexM4 on Jellybean's LPC43xx.
 It also enable Cycle Counter to be used for accurate delay independant from Clock Frequency.