Issue #24 : Doxygen cannot genearete document.

Added :
- "|| DOXYGEN_COMPILE" to second out most #if to allow doxygen picks the definition.
- "|| DOXYGEN_COMPILE" to mock class definition.
- DOXYGEN_DOCUMENT macro to the Doxyfile.

Author: suikan4github

Doxyfile

@@ -2423,7 +2423,7 @@ INCLUDE_FILE_PATTERNS  =
 # recursively expanded use the := operator instead of the = operator.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
 
-PREDEFINED             =
+PREDEFINED             = DOXYGEN_COMPILE 
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
 # tag can be used to specify a list of macro names that should be expanded. The

src/codec/adau1361.hpp

@@ -9,7 +9,7 @@
 
 #ifndef PICO_DRIVER_SRC_CODEC_ADAU1361_HPP_
 #define PICO_DRIVER_SRC_CODEC_ADAU1361_HPP_
-#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>)
+#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 
 #include <i2c/i2cmaster.hpp>
 
@@ -199,8 +199,11 @@ class Adau1361 {
   bool hp_output_mute_;  // headphone
 };
 
-#if __has_include(<gmock/gmock.h>)
+#if __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 // GCOVR_EXCL_START
+/**
+ * @brief Mock class for test.
+ */
 class MockAdau1361 : public Adau1361 {
  public:
   MockAdau1361(Adau1361Lower& adau1361_lower)

src/codec/adau1361lower.hpp

@@ -9,7 +9,7 @@
 
 #ifndef PICO_DRIVER_SRC_CODEC_ADAU1361LOWER_HPP_
 #define PICO_DRIVER_SRC_CODEC_ADAU1361LOWER_HPP_
-#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>)
+#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 
 #include "i2c/i2cmaster.hpp"
 
@@ -231,8 +231,11 @@ class Adau1361Lower {
 };
 
 // #ifdef MOCK_METHOD0
-#if __has_include(<gmock/gmock.h>)
+#if __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 // GCOVR_EXCL_START
+/**
+ * @brief Mock class for test.
+ */
 class MockAdau1361Lower : public Adau1361Lower {
  public:
   explicit MockAdau1361Lower(::rpp_driver::I2cMaster& controller)

src/codec/umbadau1361lower.hpp

@@ -9,7 +9,7 @@
 
 #ifndef PICO_DRIVER_SRC_CODEC_UMBADAU1361LOWER_HPP_
 #define PICO_DRIVER_SRC_CODEC_UMBADAU1361LOWER_HPP_
-#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>)
+#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 
 #include "codec/adau1361lower.hpp"
 #include "i2c/i2cmaster.hpp"

src/i2c/i2cmaster.hpp

@@ -10,7 +10,7 @@
 
 #ifndef PICO_DRIVER_SRC_I2C_I2CMASATER_HPP_
 #define PICO_DRIVER_SRC_I2C_I2CMASATER_HPP_
-#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>)
+#if __has_include(<hardware/i2c.h>) || __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 
 #include <stdint.h>
 
@@ -142,8 +142,11 @@ class I2cMaster {
   SdkWrapper &sdk_;
 };  // I2cMaster
 
-#if __has_include(<gmock/gmock.h>)
+#if __has_include(<gmock/gmock.h>)|| DOXYGEN_COMPILE
 // GCOVR_EXCL_START
+/**
+ * @brief Mock class for test.
+ */
 class MockI2cMaster : public I2cMaster {
  private:
   i2c_inst_t dummy_i2c = 3;

src/i2s/i2sslaveduplex.hpp

@@ -5,7 +5,7 @@
  */
 #ifndef PICO_DRIVER_SRC_I2S_DUPLEXSLAVEI2S_HPP_
 #define PICO_DRIVER_SRC_I2S_DUPLEXSLAVEI2S_HPP_
-#if __has_include(<hardware/pio.h>) || __has_include(<gmock/gmock.h>)
+#if __has_include(<hardware/pio.h>) || __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 
 #if __has_include(<hardware/pio.h>)
 #include "hardware/pio.h"
@@ -179,8 +179,11 @@ class I2sSlaveDuplex {
   virtual void PutFifoBlocking(int32_t value);
 };
 
-#if __has_include(<gmock/gmock.h>)
+#if __has_include(<gmock/gmock.h>) || DOXYGEN_COMPILE
 // GCOVR_EXCL_START
+/**
+ * @brief Mock class for test.
+ */
 class MockI2sSlaveDuplex : public I2sSlaveDuplex {
  public:
   MockI2sSlaveDuplex(SdkWrapper &sdk)
@@ -195,6 +198,6 @@ class MockI2sSlaveDuplex : public I2sSlaveDuplex {
 #endif  // __has_include(<gmock/gmock.h>)
 }  // namespace rpp_driver
 
-#endif // __has_include(<hardware/pio.h>) || __has_include(<gmock/gmock.h>)
+#endif  // __has_include(<hardware/pio.h>) || __has_include(<gmock/gmock.h>)
 
 #endif  // PICO_DRIVER_SRC_I2S_DUPLEXSLAVEI2S_HPP_