From dd3ffe8b78ef080f81daa38aa23e890ed7d90b75 Mon Sep 17 00:00:00 2001
From: Brendan Le Foll <brendan.le.foll@intel.com>
Date: Wed, 28 May 2014 11:00:36 +0100
Subject: [PATCH] examples: add Interesting snippet tags to examples and link
 in Readme.md

Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>
---
 README.md               | 16 ++++++++++++++++
 examples/analogin_a0.c  |  2 ++
 examples/cycle-pwm3.c   |  2 ++
 examples/hellomaa.c     |  2 ++
 examples/i2c_HMC5883L.c |  2 ++
 examples/spi_mcp4261.c  |  3 ++-
 6 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 10c76c8..73c13e8 100644
--- a/README.md
+++ b/README.md
@@ -26,8 +26,24 @@ C API Modules        | C++ API Classes
  @ref maa.h "maa"    | @ref maa.h "maa"
 </center>
 
+### Hello Maa
+@snippet hellomaa.c Interesting
+
+### Basic GPIO
 @snippet gpio_read6.c Interesting
 
+### Basic PWM
+@snippet cycle-pwm3.c Interesting
+
+### Basic I2C
+@snippet analogin_a0.c Interesting
+
+### Basic AIO
+@snippet analogin_a0.c Interesting
+
+### Basic SPI
+@snippet spi_mcp4261.c Interesting
+
 ## Supported platforms
 
 - Galileo (Fab D)
diff --git a/examples/analogin_a0.c b/examples/analogin_a0.c
index 721ff84..24f44d5 100644
--- a/examples/analogin_a0.c
+++ b/examples/analogin_a0.c
@@ -31,6 +31,7 @@ int main ()
     maa_aio_context adc_a0;
     uint16_t adc_value = 0;
 
+//! [Interesting]
     adc_a0 = maa_aio_init(0);
     if (adc_a0 == NULL) {
         return 1;
@@ -42,6 +43,7 @@ int main ()
     }
 
     maa_aio_close(adc_a0);
+//! [Interesting]
 
     return MAA_SUCCESS;
 }
diff --git a/examples/cycle-pwm3.c b/examples/cycle-pwm3.c
index 9c1463c..b99d82b 100644
--- a/examples/cycle-pwm3.c
+++ b/examples/cycle-pwm3.c
@@ -30,6 +30,7 @@ int
 main ()
 {
     maa_init();
+//! [Interesting]
     maa_pwm_context pwm;
     pwm = maa_pwm_init(3);
     if (pwm == NULL) {
@@ -49,5 +50,6 @@ main ()
         }
         float output = maa_pwm_read(pwm);
     }
+//! [Interesting]
     return 0;
 }
diff --git a/examples/hellomaa.c b/examples/hellomaa.c
index fd6e1ad..69d6c4b 100644
--- a/examples/hellomaa.c
+++ b/examples/hellomaa.c
@@ -29,6 +29,8 @@
 int
 main(int argc, char **argv)
 {
+//! [Interesting]
     fprintf(stdout, "hello maa\n Version: %s\n", maa_get_version());
     return 0;
+//! [Interesting]
 }
diff --git a/examples/i2c_HMC5883L.c b/examples/i2c_HMC5883L.c
index 4933e24..d21b452 100644
--- a/examples/i2c_HMC5883L.c
+++ b/examples/i2c_HMC5883L.c
@@ -83,6 +83,7 @@ main(int argc, char **argv)
     int16_t x = 0, y = 0, z = 0;
     char rx_tx_buf[MAX_BUFFER_LENGTH];
 
+//! [Interesting]
     maa_i2c_context i2c;
     i2c = maa_i2c_init(0);
 
@@ -90,6 +91,7 @@ main(int argc, char **argv)
     rx_tx_buf[0] = HMC5883L_CONF_REG_B;
     rx_tx_buf[1] = GA_1_3_REG;
     maa_i2c_write(i2c, rx_tx_buf, 2);
+//! [Interesting]
 
     maa_i2c_address(i2c, HMC5883L_I2C_ADDR);
     rx_tx_buf[0] = HMC5883L_MODE_REG;
diff --git a/examples/spi_mcp4261.c b/examples/spi_mcp4261.c
index 52c0de5..b66322d 100644
--- a/examples/spi_mcp4261.c
+++ b/examples/spi_mcp4261.c
@@ -30,6 +30,7 @@ int
 main(int argc, char **argv)
 {
     maa_init();
+//! [Interesting]
     maa_spi_context spi;
     spi = maa_spi_init(0);
     unsigned int response = 0;
@@ -53,5 +54,5 @@ main(int argc, char **argv)
             usleep(100000);
         }
     }
-
+//! [Interesting]
 }