From f7d3e88a23bb607abd40b99e346e2fb14dd712c7 Mon Sep 17 00:00:00 2001
From: dherrada <=>
Date: Tue, 26 May 2020 16:49:04 -0400
Subject: [PATCH] Made doxygen pass

---
 Adafruit_LIS2MDL.h | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/Adafruit_LIS2MDL.h b/Adafruit_LIS2MDL.h
index d768739..53e7e56 100644
--- a/Adafruit_LIS2MDL.h
+++ b/Adafruit_LIS2MDL.h
@@ -16,12 +16,16 @@
 /*=========================================================================
     I2C ADDRESS/BITS
     -----------------------------------------------------------------------*/
-#define _ADDRESS_MAG 0x1E //< Default address
-#define _CHIP_ID 0x40     //< Chip ID from WHO_AM_I register
-#define LIS2MDL_MAG_LSB 1.5
-#define LIS2MDL_MILLIGAUSS_TO_MICROTESLA 0.1
+#define _ADDRESS_MAG 0x1E   //!< Default address
+#define _CHIP_ID 0x40       //!< Chip ID from WHO_AM_I register
+#define LIS2MDL_MAG_LSB 1.5 //!< Sensitivity
+#define LIS2MDL_MILLIGAUSS_TO_MICROTESLA                                       \
+  0.1 //!< Conversion rate of Milligauss to Microtesla
 /*=========================================================================*/
 
+/*!
+ * @brief LIS2MDL I2C register address bits
+ */
 typedef enum {
   LIS2MDL_OFFSET_X_REG_L = 0x45,
   LIS2MDL_OFFSET_X_REG_H = 0x46,
@@ -46,14 +50,14 @@ typedef enum {
 } lis2mdl_register_t;
 /*=========================================================================*/
 
-/*=========================================================================
-    MAGNETOMETER UPDATE RATE SETTINGS
-    -----------------------------------------------------------------------*/
+/*!
+ * @brief Magnetometer update rate settings
+ */
 typedef enum {
-  LIS2MDL_RATE_10_HZ,  //< 10 Hz
-  LIS2MDL_RATE_20_HZ,  //< 20 Hz
-  LIS2MDL_RATE_50_HZ,  //< 50 Hz
-  LIS2MDL_RATE_100_HZ, //< 100 Hz
+  LIS2MDL_RATE_10_HZ,  //!< 10 Hz
+  LIS2MDL_RATE_20_HZ,  //!< 20 Hz
+  LIS2MDL_RATE_50_HZ,  //!< 50 Hz
+  LIS2MDL_RATE_100_HZ, //!< 100 Hz
 } lis2mdl_rate_t;
 /*=========================================================================*/