docs: updated headers for a few sensors as example

Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>

src/adxl335/adxl335.h

@@ -35,14 +35,25 @@
 namespace upm {
 
   /**
-   * @brief C++ API for the ADXL335 3-axis analog acclerometer
+   * @brief ADXL335 accelerometer library
+   * @defgroup adxl335 libupm-adxl335
+   * @ingroup seeed analog accelerometer
+   */
+
+  /**
+   * @library adxl335
+   * @sensor adxl335
+   * @comname ADXL335 3-Axis Analog Accelerometer
+   * @type accelerometer
+   * @man seeed
+   * @con analog
+   *
+   * @brief C++ API for the ADXL335 3-axis Analog Accelerometer
    *
    * UPM module for the ADXL335 3-axis analog accelerometer.  This
    * was tested on a Grove 3-axis Analog Accelerometer.  It uses 3
    * analog pins, one each for X, Y, and Z axis.
    *
-   * @ingroup grove analog
-   * @defgroup adxl335 libupm-adxl335
    * @snippet adxl335.cxx Interesting
    */
   class ADXL335 {

src/adxl345/adxl345.h

@@ -32,9 +32,17 @@ namespace upm {
 /**
  * @brief Adxl345 accelerometer library
  * @defgroup adxl345 libupm-adxl345
+ * @ingroup seeed i2c accelerometer
  */
 
 /**
+ * @library adxl345
+ * @sensor adxl345
+ * @comname Adxl345 3-Axis Digital Accelerometer
+ * @type accelerometer
+ * @man seeed
+ * @con i2c
+ *
  * @brief C++ API for Adxl345 (3-axis digital accelerometer)
  *
  * The Adxl345 is a 3-axis digital accelerometer.
@@ -43,9 +51,8 @@ namespace upm {
  * Note that the sensor it is incompatible and will not be detected on the I2C bus
  * by the Intel Edison using the Arduino breakout board at 5V (3V3 will work fine).
  *
- * @ingroup adxl345 i2c
- * @snippet adxl345.cxx Interesting
  * @image html adxl345.jpeg
+ * @snippet adxl345.cxx Interesting
  */
 class Adxl345 {
 public:

src/hmc5883l/hmc5883l.h

@@ -31,12 +31,20 @@
 namespace upm {
 
 /**
- * @brief HMC5883l magnometer library
+ * @brief Hmc5883l magnometer library
  * @defgroup hmc5883l libupm-hmc5883l
+ * @ingroup seeed i2c compass
  */
 
 /**
- * @brief C++ API for HMC5883l (3-axis digital compass)
+ * @library hmc5883l
+ * @sensor hmc5883l
+ * @comname Hmc5883l 3-Axis Digital Compass
+ * @type compass
+ * @man seeed
+ * @con i2c
+ *
+ * @brief C++ API for Hmc5883l (3-axis digital compass)
  *
  * The Honeywell [HMC5883L]
  * (http://www.adafruit.com/datasheets/HMC5883L_3-Axis_Digital_Compass_IC.pdf)
@@ -44,9 +52,8 @@ namespace upm {
  * all done through an I2C interface. Different breakout boards are available,
  * typically a 3V supply is all that is needed to power the sensor.
  *
- * @ingroup hmc5883l i2c
- * @snippet hmc5883l.cxx Interesting
  * @image html hmc5883l.jpeg
+ * @snippet hmc5883l.cxx Interesting
  */
 class Hmc5883l {
 public:

src/itg3200/itg3200.h

@@ -32,9 +32,17 @@ namespace upm {
 /**
  * @brief Itg3200 gyroscope library
  * @defgroup itg3200 libupm-itg3200
+ * @ingroup seeed i2c compass
  */
 
 /**
+ * @library itg3200
+ * @sensor itg3200
+ * @comname Itg3200 3-Axis Digital Gyroscope
+ * @type compass
+ * @man seeed
+ * @con i2c
+ *
  * @brief C++ API for Itg3200 (3-axis digital gyroscope)
  *
  * The InvenSense Itg3200 is a 3-axis digital gyroscope.
@@ -43,9 +51,8 @@ namespace upm {
  * <strong>However</strong>, it is incompatible and will not be detected on the I2C bus
  * by the Intel Edison using the Arduino breakout board.
  *
- * @ingroup itg3200 i2c
- * @snippet itg3200.cxx Interesting
  * @image html itg3200.jpeg
+ * @snippet itg3200.cxx Interesting
  */
 class Itg3200 {
 public: